This guide shows you how to use the Google Mobile Ads SDK to load and display ads from Mintegral using mediation, covering both waterfall and bidding integrations. It covers how to add Mintegral to an ad unit's mediation configuration, and how to integrate the Mintegral SDK and adapter into a Unity app.
Supported integrations and ad formats
The AdMob mediation adapter for Mintegral has the following capabilities:
Integration | |
---|---|
Bidding | |
Waterfall | |
Formats | |
App Open | 1 2 |
Banner | |
Interstitial | |
Rewarded | |
Rewarded Interstitial |
1 Bidding integration for this format is in closed beta.
2 Waterfall integration for this format is in closed beta.
Requirements
- Latest Google Mobile Ads SDK
- Unity 5.6 or higher
- To deploy on Android
- Android API level 21 or higher
- To deploy on iOS
- iOS deployment target of 12.0 or higher
- A working Unity project configured with the Google Mobile Ads SDK. See Get Started for details.
- Complete the mediation Get started guide
Step 1: Set up configurations in Mintegral UI
נרשמים או מתחברים לחשבון Mintegral.
איתור מפתח האפליקציה
עוברים לכרטיסייה הגדרות אפליקציה ורושמים את מפתח האפליקציה.
הוספת אפליקציה חדשה
בכרטיסייה הגדרות אפליקציה, לוחצים על הלחצן הוספת אפליקציה.
בוחרים את הפלטפורמה וממלאים את שאר הטופס. לאחר מכן לוחצים על שמירה.
Android
iOS
חשוב לרשום את מזהה האפליקציה של האפליקציה.
Android
iOS
יצירת מיקום מודעה
אחרי שיוצרים את האפליקציה, נכנסים לכרטיסייה Locations & Units (מיקומי מודעות ויחידות מידה) ולוחצים על Add Placement (הוספת מיקום) כפי שמוצג בהמשך כדי ליצור את מיקום המודעה.
Android
iOS
מזינים שם מיקום ופורמט מודעה.
בידינג
בוחרים באפשרות header Bidding בתור סוג הבידינג. ממלאים את שאר הפרטים בטופס ולוחצים על Save.
מפל
בוחרים באפשרות מסורתית בתור סוג הבידינג. ממלאים את שאר הטופס ולוחצים על Save.
אחרי שיוצרים את מיקום המודעה, חשוב לשים לב למזהה המיקום.
Android
iOS
לוחצים על התפריט הנפתח יחידת מודעות אחת ורושמים את מזהה יחידת המודעות.
Android
iOS
איתור מפתח ה-API של Mintegral Reporting
בידינג
לא צריך לבצע את השלב הזה בשילובי בידינג.
מפל
כדי להגדיר את AdMob מזהה יחידת המודעות, תצטרכו את מפתח Mintegral Reporting API. עוברים אל Account (חשבון) > API Tools (כלים ל-API). רשמו לעצמכם את המפתח והסוד שלכם.
Step 2: Set up Mintegral demand in AdMob UI
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
Add Mintegral to GDPR and US state regulations ad partners list
פועלים לפי השלבים המפורטים בקטע הגדרות GDPR וגם הגדרות של תקנות במדינות בארה"ב כדי להוסיף את Mintegral לרשימת שותפי הפרסום לתקנות GDPR ומדינות בארה"ב בממשק המשתמש AdMob .
Step 3: Import the Mintegral SDK and adapter
Download the latest version of Google Mobile Ads mediation plugin for Mintegral
from the download link in the
Changelog and extract the
GoogleMobileAdsMintegralMediation.unitypackage
from the zip file.
In your Unity project editor, select Assets > Import Package >Custom
Package and find the GoogleMobileAdsMintegralMediation.unitypackage
file you downloaded. Make sure that all the files are selected and click
Import.
Then, select Assets > Play Services Resolver > Android Resolver > Force
Resolve. The Unity Play Services Resolver library will perform dependency
resolution from scratch and copy the declared dependencies into the
Assets/Plugins/Android
directory of your Unity app.
Step 4: Add required code
Android
No additional code is required for Mintegral integration.
iOS
SKAdNetwork integration
Follow Mintegral's documentation
to add the SKAdNetwork identifiers to your project's Info.plist
file.
Step 5: Test your implementation
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ל- AdMob
רוצה להציג מודעות בדיקה של Mintegral למודעות באנר, מעברונים, מודעות מתגמלות ומודעות מותאמות? ההמלצה של Mintegral היא להשתמש במפתחות האפליקציות, במזהי האפליקציות, במזהי המיקומים ובמזהי יחידות המודעות שצוינו הדף של מזהה בדיקת Mintegral.
אימות מודעות בדיקה
כדי לוודא שמוצגות לך מודעות לבדיקה מ-Mintegral, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות Mintegral (Bidding) and Mintegral (Waterfall) מקורות המודעות.
Error codes
If the adapter fails to receive an ad from Mintegral, publishers can check the
underlying error from the ad response using
ResponseInfo
under the following classes:
Android
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
iOS
GADMediationAdapterMintegral
Here are the codes and accompanying messages thrown by the Mintegral adapter when an ad fails to load:
Android
Error code | Domain | Reason |
---|---|---|
101 | com.google.ads.mediation.mintegral | Invalid server parameters (e.g. Missing app ID or placement ID). |
102 | com.google.ads.mediation.mintegral | The requested ad size does not match a Mintegral supported banner size. |
103 | com.google.ads.mediation.mintegral | Missing or invalid bid response. |
104 | com.google.ads.mediation.mintegral | Mintegral SDK returned a no fill error. |
iOS
Error code | Domain | Reason |
---|---|---|
101 | com.google.mediation.mintegral | Invalid server parameters (e.g. Missing app ID or placement ID). |
102 | com.google.mediation.mintegral | Mintegral SDK returned a no fill error. |
103 | com.google.mediation.mintegral | Mintegral SDK failed to show an ad. |
104 | com.google.mediation.mintegral | The requested ad size does not match a Mintegral supported banner size. |
Mintegral Unity Mediation Plugin Changelog
Version 1.6.4
- Supports Mintegral Android adapter version 16.7.61.0.
- Supports Mintegral iOS adapter version 7.6.7.0.
- Built and tested with the Google Mobile Ads Unity Plugin version 9.1.0.
Version 1.6.3
- Supports Mintegral Android adapter version 16.7.41.0.
- Supports Mintegral iOS adapter version 7.6.6.0.
- Built and tested with the Google Mobile Ads Unity Plugin version 9.1.0.
Version 1.6.2
- Supports Mintegral Android adapter version 16.7.41.0.
- Supports Mintegral iOS adapter version 7.6.4.0.
- Built and tested with the Google Mobile Ads Unity Plugin version 9.1.0.
Version 1.6.1
- Supports Mintegral Android adapter version 16.7.21.0.
- Supports Mintegral iOS adapter version 7.6.3.0.
- Built and tested with the Google Mobile Ads Unity Plugin version 9.1.0.
Version 1.6.0
- Supports Mintegral Android adapter version 16.7.11.0.
- Supports Mintegral iOS adapter version 7.6.2.0.
- Built and tested with the Google Mobile Ads Unity Plugin version 9.0.0.
Version 1.5.0
- Supports Mintegral Android adapter version 16.6.71.0.
- Supports Mintegral iOS adapter version 7.6.0.0.
- Built and tested with the Google Mobile Ads Unity Plugin version 9.0.0.
Version 1.4.0
- Supports Mintegral Android adapter version 16.6.34.0.
- Supports Mintegral iOS adapter version 7.5.6.0.
- Built and tested with the Google Mobile Ads Unity Plugin version 8.7.0.
Version 1.3.0
- Supports Mintegral Android adapter version 16.5.91.0.
- Supports Mintegral iOS adapter version 7.5.3.0.
- Added the following methods to the
Mintegral
class:SetConsentStatus(bool)
SetDoNotTrackStatus(bool)
- Built and tested with the Google Mobile Ads Unity Plugin version 8.6.0.
Version 1.2.1
- Supports Mintegral Android adapter version 16.4.61.0.
- Supports Mintegral iOS adapter version 7.3.8.0.
- Built and tested with the Google Mobile Ads Unity Plugin version 8.3.0.
Version 1.2.0
- Moved adapter content to
GoogleMobileAds/Mediation/Mintegral/
. - Supports Mintegral Android adapter version 16.4.41.0.
- Supports Mintegral iOS adapter version 7.3.6.0.
- Built and tested with the Google Mobile Ads Unity Plugin version 8.3.0.
Version 1.1.0
- Supports Mintegral Android adapter version 16.3.61.0.
- Supports Mintegral iOS adapter version 7.2.9.1.
- Built and tested with the Google Mobile Ads Unity Plugin version 7.4.1.
Version 1.0.0
- Initial Release!
- Supports Mintegral Android adapter version 16.2.61.0.
- Supports Mintegral iOS adapter version 7.2.6.0.
- Built and tested with the Google Mobile Ads Unity Plugin version 7.3.1.