Note:

Support developers to perform testing after accessing TopOn SDK
The testing tool is only integrated with the testing SDK. It cannot replace the APP's own advertising logic testing
Development After the test is completed, the relevant code that calls the test tool will be deleted before going online
Version requirements: Android (v6.2.78 and above), iOS (v6.2.78 and above)

1. Product Introduction

Improving the efficiency of developer access testing by using testing tools:

Basic information: detecting applications, equipment, sdk related information
TopOn SDK setting information: Check whether privacy settings and permissions are successfully configured
Integration detection: Check the integration status and testing suggestions of the integrated third-party platform SDK and adapter, and test the third-party Ad loading of advertising platform

Release Notes

2. Access process

Note: Before connecting to the test tool, you need to integrate the TopOn SDK first. For SDK integration methods, please refer to unity plug-in usage instructions.

Android access process

Import the dependent library of the test tool and follow the following two operations:
Step 1: First Create a new folder named Editor in the Unity project/Assets/AnyThinkAds/Plugins/Android directory;
Step 2: Create Dependencies.xml file and add the following content in the file, and then place it in the Editor directory created in the first step.
```
<dependencies>
    <androidPackages>
        <repositories>
            <repository>https://jfrog.anythinktech.com/artifactory/debugger</repository>
        </repositories>
        <androidPackage spec="com.anythink.sdk:debugger-ui:1.0.8"/>
    </androidPackages>
</dependencies>
```
Note: The first step folder name must be Editor, the second step file name must be Dependencies.xml.

After completing the import of the test tool dependency library, you can directly call the C# API on the Unity layer. First call the SDK for initialization, and then call the following method to jump to the test tool page:

//If you do not need to use online advertising ID testing, you can use ATSDKAPI.showDebuggerUI()
//ATSDKAPI.showDebuggerUI();

//Debug Key：used for online ID testing. You can get it from Backstage -> Account Management -> Key. 
//Requirements: 1. SDK version 6.3.68 and above  2. Debugger UI tool version 1.0.8 and above
ATSDKAPI.showDebuggerUI("Your Debug Key");

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

iOS access process

Import the dependent library of the test tool and follow the following two operations:
Step 1: First install in Unity Create a new folder named Editor in the project/Assets/AnyThinkAds/Plugins/iOS directory;
Step 2: Create Dependencies.xml< /strong> file and add the following content in the file, and then place it in the Editor directory created in the first step.
```
<?xml version="1.0" encoding="utf-8"?>
<dependencies>
    <iosPods>
        <iosPod name="AnyThinkDebugUISDK" version="1.0.1" />
    </iosPods>
</dependencies>
```
Note: The first step folder name must be Editor, the second step file name must be Dependencies.xml.

After completing the import of the test tool dependency library, you can directly call the C# API on the Unity layer. First call the SDK for initialization, and then call the following method to jump to the test tool page:

ATSDKAPI.showDebuggerUI();

Note:

The SDK must be initialized before jumping to the test tool page.

The functions in the test tool also require the media side to obtain IDFA before they can be used. Currently, the SDK will not obtain IDFA during initialization.

The relevant code that calls the test tool needs to be deleted before going online.

3. Test Tool usage

1. Basic information

Function: Support long press to copy information and share data on the current page.

Android basic information

GAID is Google Advertising ID, if GAID appears empty, Please check the following factors:
1.Whether the phone has Google services.
2.Before entering this page, did you call the following Method restrictionsGAID Get.
```
string[] deniedInfos = new string[] { "gaid" };
ATSDKAPI.deniedUploadDeviceInfo(deniedInfos);
```

Android ID is the unique identifier of the device. If AndroidId is displayed as empty, please check whether the following method is called to limit the acquisition of AndroidId:
```
string[] deniedInfos = new string[] { "android_id" };
ATSDKAPI.deniedUploadDeviceInfo(deniedInfos);
```

Note: You need to enable the following debugging mode with GAID Not empty.

iOS basic information

IDFA is the unique identifier of the device. If the IDFA is displayed as empty, please check whether permission is granted. Track permissions.

Note: If the IDFA is empty, ad debugging cannot be successfully enabled. Please grant tracking permissions in the settings.

2.TopOnSDK settings

TopOn SDK settings include two parts: privacy settings and permission settings.

Privacy Settings
Domestic: Yes Personalized recommendation advertising switch, setting privacy information control switch. Setting method: Export Android and iOS native projects in Unity respectively to set up. For details, please check Android Domestic Privacy Configuration and iOS domestic privacy configuration.
Overseas: Set up GDPR. Setting method: 1. Supports direct setting in unity, click to view; 2. Export Android and iOS native projects to set up, details Please review Android Settings GDPR and iOS settings GDPR.
Permission settings: List of permissions applied for by the application.
Android page
iOS page

3. Integrated detection

Look at the integration status of the advertising platform list: Integration exception, integration completed, not integrated.
Check Select the switch to turn on debugging mode.
Select the integrated advertising platform to enter debugging mode.
Select the advertising style of the advertising platform for testing.
You can click the share button in the upper right corner to share the advertising platform debugging information of the current page.

Integration Testing