TestSuite

AdTiming Test Suite

With the AdTiming mobile ad aggregation test suite, you can test whether apps and ad units are correctly configured so that they can display ads from third-party ad networks through aggregation. This guide briefly describes how to integrate the AdTiming mobile ad aggregation test suite into your iOS app to use this tool in your app.

Precondition

1. Xcode 12 or higher.

2. iOS 9.0 or better.

3. iOS AdTiming SDK V4.4.1 or higher.

4. Create an AdTiming account and register the app.

Install

The aggregation function test suite needs to be installed using Cocoapods. Please add the following code to your Podfile:

pod 'AdTimingTestSuite', '1.0.1'
Copy

 

Manual Download SDK

Download iOS AdTimingTestSuite V1.0.1

Start the aggregation function test suite

#import <ADTimingTestSuite/ADTimingTestSuite.h>
[AdTimingTestSuite presentWithAppKey:@"YOUR_ADTIMING_APP_KEY" onViewController:YOUR_CONTROLLER];
import AdTimingTestSuite
AdTimingTestSuite.present(withAppKey:"YOUR_ADTIMING_APP_KEY", on:YOUR_CONTROLLER)

Test Suite: HomePage

The following disclaimer will be displayed when the tool is opened:

TS1.png

A disclaimer will be displayed every time the test suite is launched to remind you that you should turn on test mode for aggregate ad sources.

 

Check the box and click "GOT IT" to continue. Enter the homepage to display the Ad Network integration status of your current App. Each Ad Network has three configurations, including SDK/Adapter/Configure.

For each Ad Network, this screen will display a warning if the following conditions occur:

  • Ad source SDK is not installed
  • Ad source adapter not installed
  • The background configuration information is incorrect

TS2.png

 

If the three configurations of each Ad Network are all right, the homepage will display "Good", as shown in the figure below:

TS3.png

 

If you verify the instance of Ad Network and it fails, the home page will display the number of failed instances. At the same time, the corresponding Ad Network unit column will display a red prompt on the right.

IMG_DFDC84DB4A1E-1.jpeg

 

Exit

Click the "More" button in the upper right corner of the homepage. In the pop-up drop-down box, click "Device ID" to choose to view your current Device ID, and click "Exit" to exit the test suite.

Simulator_Screen_Shot_-_iPhone_11_-_2020-10-29_at_14.27.35.png

Ad Network Details Page

The details page displays the detailed information of Ad Network, including the integration status of Ad Network STATUS, testID list TEST ID (if included) and Instance list INSTANCE:

TS4.png

 

STATUS

The screen indicates, for the given ad source:

  • If the SDK is installed and, if available, the SDK version (Some AdNetwork SDK version cannot be obtained, such as Facebook、MoPub、Mintegral and Helium).
  • If the adapter is installed and, if available, the adapter version.
  • The parameters for the configuration that were entered in the AdTiming dashboard.

Simulator_Screen_Shot_-_iPhone_11_-_2020-10-29_at_11.42.24.png

 

INSTANCE

The INSTANCE list page lists all the Instances configured in the foreground of the Ad Network in the "Enabled" state, and distinguishes 3 states by different colors:

  • Not verified (Blue)
  • Ad verified but failed to load (Yellow)
  • The ad has been verified and successfully loaded (Green)

The information displayed by a single Instance Item includes:

  • Instance Name
  • Unit ID
  • Instance belongs to the type of ad unit
  • Instance belongs to the name of ad unit

Simulator_Screen_Shot_-_iPhone_11_-_2020-10-29_at_11.42.34.png

 

FILTER

On the Instance list page, click the "Filter button (funnel shape)" and the filter page will pop up. You can filter the Instance results according to the Instance status and advertising type.

Simulator_Screen_Shot_-_iPhone_11_-_2020-10-29_at_11.47.27.png

Load And Show Ad

On the TESTID and INSTANCE list pages, click the "LOAD AD" button to send the ad request to the SDK of the ad source. After the ad request is completed, an update prompt will be displayed, stating whether the request was successful or failed.

TS5.png

 

Ads loaded successfully page

If the request is successful, the "LOAD AD" button will change to "SHOW AD" and there will be a "Success" prompt on the page.

  • For banner ads and native ads, the ads are displayed directly on the current page.
  • For interstitial ads and rewarded video ads, the ads will be displayed on the newly pop-up page.

TS6.png

 

Ad display page

The ad opens on the current page, for example:

TS7.png

Data Reporting

After clicking the upload button, your AdNetwork integration results and Instance verification results will be uploaded to the AdTiming dashboard - SDK Testing - Test Suite Result, For more information.

WechatIMG17.png

TS11.png

 

Was this article helpful?
1 out of 1 found this helpful

Comments

0 comments

Please sign in to leave a comment.