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 |
Banner | |
Interstitial | |
Rewarded | |
Rewarded Interstitial |
1 Bidding and waterfall integrations for app open ad format are 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
Sign up or Log in to your Mintegral account.
Locate the App Key
Navigate to the APP Setting tab and take note of the APP Key.
Add a new application
From the APP Setting tab, click the Add APP button.
Select the Platform and fill out the rest of the form. Then, click Save.
Android
iOS
Take note of your application's APP ID.
Android
iOS
Create an ad placement
Once your application has been created, navigate to the Placements & Units tab and click on the Add Placement button as shown below to create your ad placement.
Android
iOS
Enter a Placement Name and AD Format.
Bidding
Select Header Bidding as the Bidding Type. Fill out the rest of the form and click Save.
Waterfall
Select Traditional as the Bidding Type. Fill out the rest of the form and click Save.
Once your ad placement is created, take note of the Placement ID.
Android
iOS
Click the 1 AD Units drop down and take note of the AD Unit ID.
Android
iOS
Locate your Mintegral Reporting API Key
Bidding
This step isn't required for bidding integrations.
Waterfall
You will need your Mintegral Reporting API Key for setting up your AdMob ad unit ID. Navigate to Account > API Tools. Take note of your Skey and Secret.
Step 2: Set up Mintegral demand in AdMob UI
Định cấu hình cài đặt dàn xếp cho đơn vị quảng cáo của bạn
Android
Để biết hướng dẫn, hãy xem bước 2 trong hướng dẫn dành cho Android.
iOS
Để biết hướng dẫn, hãy xem bước 2 trong hướng dẫn dành cho iOS.
Add Mintegral to GDPR and US state regulations ad partners list
Hãy làm theo các bước trong cài đặt GDPR và cài đặt quy định của chính phủ Hoa Kỳ để thêm Mintegral vào GDPR và danh sách đối tác quảng cáo theo quy định của tiểu bang Hoa Kỳ trong AdMob giao diện người dùng.
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
Bật quảng cáo thử nghiệm
Hãy nhớ đăng ký thiết bị thử nghiệm cho AdMob.
Để tải quảng cáo thử nghiệm Mintegral cho định dạng quảng cáo biểu ngữ, quảng cáo xen kẽ, quảng cáo có tặng thưởng và quảng cáo gốc, Mintegral bạn nên sử dụng Khoá ứng dụng, Mã ứng dụng, Mã vị trí và Mã đơn vị quảng cáo được cung cấp trên Trang Mã kiểm thử Mintegral.
Xác minh quảng cáo thử nghiệm
Để xác minh rằng bạn đang nhận quảng cáo thử nghiệm từ Mintegral, hãy bật thử nghiệm riêng một nguồn quảng cáo trong công cụ kiểm tra quảng cáo bằng cách sử dụng Mintegral (Bidding) and Mintegral (Waterfall) (các) nguồn quảng cáo.
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.7.0
- Renamed
DummyClient
toPlaceholderClient
. - Supports Mintegral Android adapter version 16.8.11.0.
- Supports Mintegral iOS adapter version 7.6.9.0.
- Built and tested with the Google Mobile Ads Unity Plugin version 9.2.0.
Version 1.6.5
- Supports Mintegral Android adapter version 16.7.81.0.
- Supports Mintegral iOS adapter version 7.6.8.0.
- Built and tested with the Google Mobile Ads Unity Plugin version 9.2.0.
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.