1. Feature Overview

GroMore now supports several top ad networks in China. If you need to add other ad networks that are not yet supported because you are selling ads yourself, using an SDK from a vendor or an SDK customized for an ADN, or other reasons, you can do so by using this feature. Currently, the Custom ADN feature supports adding standard ad slots and ad slots that use bidding.

1.1 Ad Types

1.2 Feature Modules

2. Usage Guidelines

2.1 Usage Procedure

- Preparations:

- Currently, a whitelist mechanism is used for the Custom ADN feature, which means if you want to use it, you have to ask your Business Manager to enable it for you;

- If you want to use ad slots from third-party ADNs, please create ad accounts, apps, and ad slots on those ADNs in advance;

- If you want to use bidding ad slots from third-party ADNs through the Custom ADN, please ensure that you have obtained the permissions to use bidding from those ADNs and created the ad slots you need;

- Update MSDK: You need to update your GroMore SDK to version 3100 or above to use the Custom ADN feature. The Custom ADN now supports the configuration of ad slots using bidding. To use this feature, version 3221 or above is recommended;

- Develop a custom adapter: For development details, please refer to the technical integration documents for iOS and Android (Note: The adapter class name needs to be configured on the platform first). Please refer to the demo for information on how to integrate with a custom adapter;

- Perform configuration on the platform: This includes adding and configuring custom ADN information. After the configuration is complete, you can start to add ad slots;

2.2 Usage Recommendations

2.2.1 Implementation Diagrams

- Self-built mediation integrated through custom ADN

- Third-party ADN integrated through custom ADN

2.2.2 Usage Recommendations

Standard Ad Slots

1. A GroMore ad slot corresponds to a self-built mediation/third-party ADN ad slot;

2. An ad request will be sent to the ad slots in a standard waterfall according to the order configured in GroMore;

3. Ad slots that have been integrated into GroMore should not be integrated again through the Custom ADN.

Bidding Ad Slots

- Integrating a Self-Built Mediation

1. An ad slot that uses bidding in GroMore may correspond to N bidding ad slots in a self-built mediation;

2. In this case, N bidders complete for a bid in the self-built mediation, and the result is reported to GroMore through the adapter;

3. Then, in GroMore, the winning price is compared to the prices of ad slots that use bidding and other standard ad slots from CSJ. The highest bidder gets the impression opportunity.

-Third-Party ADN Integration

1. An ad slot that uses bidding in GroMore corresponds to bidding ad slots from a third-party ADN;

2. Prices from bidders will be reported to GroMore through the adapter;

3. Then, in GroMore, the winning price is compared to the prices of ad slots that use bidding and other standard ad slots from CSJ. The highest bidder gets the impression opportunity.

2.2.3 Price Comparison Process

When an ad request is initiated, GroMore will send a request to bidders, and each bidder and the standard waterfall will return their prices. The highest bidder gets the impression opportunity.

3. Platform Configuration Process

3.1 Create a custom ADN account and fill in related information

- On the ad network that you want to use as a custom ADN, create ad accounts, apps, and ad slots as necessary;

3.2 Add custom ADNs at the GroMore backend

- Click Add a custom ADN on the Ad Network page in GroMore;

*Note: If you are using this feature for the first time, you need to sign a Declaration of Compliance;

- Fill in an Ad Network Name and an Account Name for the custom ADN

3.3 Add ad networks in App Details

- On the App Details page in Mediation, click the "Add an ad network" button, pick the custom ADN you have added to your chosen ad network, then select an ad type and adapter class name;

* Note: You must define different adapter class names for different ad formats. GroMore will call adapters based on their names. (You need to implement adapter classes for custom ad platforms according to integration specifications provided by Gromore. To avoid confusion, you can also define adapter class names based on your own naming convention.)

3.4 Add ad slots to a waterfall

- Select the custom ADN you added, then add the ad slots (both standard and bidding are supported) you need. For ad slot ID, please fill in the ad slot ID you obtained from the third-party ADN or the custom ID you used in the self-built mediation;

- Here is an example of using YLH Bidding through the Custom ADN feature:

4. FAQs

1. Can I use the same standard ad slot in a custom ADN and an ad network that Gromore already supports?

A: You are not recommended to do so since it may lead to issues like API data being indistinguishable for different ad networks. For third-party ad networks already supported by GroMore, it is recommended that you use their standard ad slots directly in GroMore.

2. There is traffic filling for an ad slot that uses bidding in a custom ADN, but why did the bid not enter the bidding process/return any ad impressions?

A: MSDK for Android versions 3000-3310/iOS versions 3200-3310 supports configuring the "timeout for bidding result on client" in "Waterfall Attribute Settings". The default value is 2 seconds. GroMore will only wait for that duration; any filling after that will not enter the bidding process. This does not apply to clients with versions 3400 and above. A bid will enter the bidding process as long as it is returned within the overall timeout.

3. Is there a problem if I only have bidding ad slots and no standard ad slots configured in GroMore?

A: If you do that, some bids may be excluded from the bidding process, and data analysis may also be affected. It is not recommended to return to GroMore after comparing all bidding prices in a self-built mediation, as the default timeout for bidding ad slots of a custom ADN is 2 seconds. Any filling after that will not enter the bidding process. Hence, it is recommended to report the bidding result of bidding ad slots in the self-built mediation to GroMore, and configure standard ad slots directly in GroMore.