Notes:

• Supports developers to use for detection after integrating Taku SDK
• The test tool is only for checking SDK integration and cannot replace the app's own ad logic testing
• Developers should delete the code that calls the test tool before going live after testing is complete
• Version requirements: Android (v6.2.78 and above), iOS (v6.2.78 and above)

1. Product Introduction

Improve the efficiency of developer integration testing by using the test tool:

• Basic Info: Check application, device, and SDK related information
• Taku SDK Settings: Check whether privacy settings and permissions are successfully configured
• Integration Check: Check the integration status of third-party platform SDKs and adapters, testing suggestions, and test ad loading for third-party ad platforms

Version Description

• Android Test Tool Version Description
• iOS Test Tool Version Description

2. Integration Process

Note: Before integrating the test tool, you need to integrate the Taku SDK first. For SDK integration methods, see the Unity Plugin Usage Instructions.

Android Integration Process

1. Import the test tool's dependency library by following these two steps:
   Step 1: First, create a folder named Editor in the Unity project/Assets/AnyThinkAds/Plugins/Android directory;
   Step 2: Create a Dependencies.xml file, add the following content to the file, and then place it in the Editor directory created in Step 1.

   Copy

   <dependencies>
       <androidPackages>
           <repositories>
               <repository>https://jfrog.anythinktech.com/artifactory/debugger</repository>
           </repositories>
           <androidPackage spec="com.anythink.sdk:debugger-ui:1.1.2"/>
       </androidPackages>
   </dependencies>

   Note: The folder in Step 1 must be named Editor, and the file in Step 2 must be named Dependencies.xml.

2. After completing the import of the test tool's dependency library, you can directly call the C# API in the Unity layer. First call SDK Initialization, then call the following method to navigate to the test tool page:

   Copy

   //Debug Key: To obtain it, go to Log in to the dashboard -> Account Management -> Key -> SDK Debug Key
   ATSDKAPI.showDebuggerUI("Your Debug Key");

   Note: You must initialize the SDK first before navigating to the test tool page.

iOS Integration Process

1. Import the test tool's dependency library by following these two steps:
   Step 1: First, create a folder named Editor in the Unity project/Assets/AnyThinkAds/Plugins/iOS directory;
   Step 2: Create a Dependencies.xml file, add the following content to the file, and then place it in the Editor directory created in Step 1.

   Copy

   <?xml version="1.0" encoding="utf-8"?>
   <dependencies>
       <iosPods>
           <iosPod name="AnyThinkDebugUISDK" version="1.0.3" />
       </iosPods>
   </dependencies>

   Note: The folder in Step 1 must be named Editor, and the file in Step 2 must be named Dependencies.xml.

2. After completing the import of the test tool's dependency library, you can directly call the C# API in the Unity layer. First call SDK Initialization, then call the following method to navigate to the test tool page:

   Copy

   //Debug Key: To obtain it, go to Log in to the dashboard -> Account Management -> Key -> SDK Debug Key
   ATSDKAPI.showDebuggerUI("Your Debug Key");

   Note:
   a. You must initialize the SDK first before navigating to the test tool page.
   b. The features in the test tool also require the app side to obtain IDFA first before they can be used. Currently, SDK Initialization does not obtain IDFA.

Note: Before going live, you need to delete the code that calls the test tool.

3. Test Tool Usage

1. Basic Info

Features: Supports long press to copy information and share current page data.

Android Basic Info

• GAID is the Google Advertising ID. If GAID is displayed as empty, please check the following factors:

  1. Whether the phone has Google services.
  2. Whether the following method was called before entering this page to restrict GAID acquisition.
  Copy

  string[] deniedInfos = new string[] { "gaid" };
  ATSDKAPI.deniedUploadDeviceInfo(deniedInfos);

• Android ID is a device unique identifier. If AndroidId is displayed as empty, please check whether the following method was called to restrict AndroidId acquisition:

  Copy

  string[] deniedInfos = new string[] { "android_id" };
  ATSDKAPI.deniedUploadDeviceInfo(deniedInfos);

• Note: If the integrated SDK is an overseas SDK, enabling the debug mode below requires GAID not to be empty. If it is a domestic SDK, AndroidId must not be empty.
  

iOS Basic Info

• IDFA is a device unique identifier. If IDFA is displayed as empty, please check whether the tracking permission has been granted.
• Note: If IDFA is empty, ad debugging cannot be successfully enabled. Please grant tracking permission in Settings.
  

2. Taku SDK Settings

Taku SDK Settings consist of two parts: Privacy Settings and Permission Settings.

• Privacy Settings
  Domestic: There are personalized ad recommendation switches and privacy information control switches. Setup method: Export to Android and iOS native projects from Unity respectively for setup. For details, see Android Domestic Privacy Configuration and iOS Domestic Privacy Configuration.
  Overseas: Set GDPR. Setup method: 1. Supported to set directly in Unity, click to view; 2. Export to Android and iOS native projects for setup. For details, see Android GDPR Settings and iOS GDPR Settings.
• Permission Settings: List of permissions requested by the app.
• Android Page
  
• iOS Page
  

3. Integration Check

1. View the integration status of the ad platform list: Integration Abnormal, Integrated, Not Integrated.
   
2. Check the switch to enable debug mode.
   
3. Select an integrated ad platform to enter Debug Mode.
4. Select the ad platform's ad format for testing operations.
   
5. You can click the share button in the upper right corner to share the current page's ad platform debugging information.