שילוב Mintegral בבידינג (בטא)

במדריך הזה נסביר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון מודעות מ-Mintegral ולהציג אותן באמצעות Mediation, כדי להציג גם שילובים של Waterfall וגם שילובים של בידינג. נסביר איך להוסיף את Mintegral להגדרה של תהליך בחירת הרשת ביחידת מודעות, ואיך לשלב את ה-SDK והמתאם של Mintegral באפליקציהAndroid .

השילובים והפורמטים של המודעות שנתמכים

למתאם בחירת הרשת של Mintegral יש את היכולות הבאות:

שילוב
בידינג  1
מפל  2
פורמטים
מודעות בפתיחת האפליקציה
מודעת באנר
מעברון
ההטבה הופעלה
מודעות מעברון מתגמלות
מותאם
1 שילוב הבידינג נמצא בגרסת בטא סגורה (למעט פורמט המודעות המותאמות שנמצא בגרסת בטא פתוחה).

2 השילוב עם Waterfall נמצא בגרסת בטא סגורה.

דרישות

  • Android API ברמה 21 ואילך

שלב 1: הגדרת ההגדרות בממשק המשתמש של Mintegral

נרשמים או נכנסים לחשבון Mintegral.

איתור מפתח האפליקציה

עוברים לכרטיסייה APP Setting (הגדרת אפליקציה) ורושמים את המקש APP Key (מפתח האפליקציה).

הוספת אפליקציה חדשה

בכרטיסייה APP Setting, לוחצים על הלחצן Add APP.

בוחרים את הפלטפורמה וממלאים את שאר הטופס. לאחר מכן לוחצים על שמירה.

מציינים את מזהה האפליקציה.

יצירה של מיקום מודעה

אחרי שיוצרים את הבקשה, עוברים לכרטיסייה Placements & Units ולוחצים על הלחצן Add Placement (הוספת מיקום מודעה), כפי שמוצג בהמשך, כדי ליצור את מיקום המודעה.

מזינים שם מיקום מודעה ופורמט מודעה.

בידינג

בוחרים באפשרות בידינג בכותרות בתור סוג הבידינג. ממלאים את שאר הפרטים בטופס ולוחצים על Save.

מפל

בוחרים באפשרות Traditional בתור Bidding Type. ממלאים את שאר הפרטים בטופס ולוחצים על שמירה.

אחרי שיוצרים את מיקום המודעה, חשוב לשים לב למזהה המיקום.

לוחצים על התפריט הנפתח 1 AD Units ומתעדים את מזהה יחידת המודעות.

איתור מפתח ה-Reporting API של Mintegral

בידינג

השלב הזה לא נדרש בשילובי בידינג.

מפל

כדי להגדיר את מזהה יחידת המודעות ב-AdMob, יש צורך במפתח של Mintegral Reporting API. עוברים אל Account (חשבון) > API Tools (כלים ל-API). שימו לב ל-Skey ול-Secret.

שלב 2: הגדרת הביקוש מ-Mintegral בממשק המשתמש Ad Manager

הוספה של Mintegral לרשימת שותפי הפרסום בהתאם ל-GDPR ולתקנות במדינות בארה"ב

פועלים לפי השלבים שמפורטים בקטע הגדרות GDPR ובהגדרות בנושא תקנות במדינות בארה"ב כדי להוסיף בממשק המשתמש של AdMob את Mobvista/Mintegral לרשימת שותפי הפרסום ל-GDPR ולהתקנות במדינות בארה"ב.

שלב 3: מייבאים את ה-SDK ואת המתאם של Mintegral

מוסיפים את המאגרים הבאים לקובץ settings.gradle.kts ברמת הפרויקט:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea")
    }
  }
}

לאחר מכן, מוסיפים את יחסי התלות וההגדרות הבאים להטמעה בקובץ build.gradle.kts ברמת האפליקציה. להשתמש בגרסאות העדכניות ביותר של ה-SDK והמתאם של Mintegral:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:mintegral:16.8.61.0")
}

שילוב ידני

  1. כדי לכלול את Mintegral SDK, עוברים אל Mintegral SDK ל-Android.

  2. עוברים אל ארטיפקטים של מתאם Mintegral ב-Maven Repository של Google. בוחרים את הגרסה האחרונה, מורידים את הקובץ .aar של המתאם של Mintegral ומוסיפים אותו לפרויקט.

שלב 4: הטמעת הגדרות הפרטיות ב-Mintegral SDK

בהתאם למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, אתם צריכים לוודא שהמשתמשים באזור הכלכלי האירופי (EEA) מקבלים גילויים נאותים מסוימים לגבי השימוש במזהי מכשירים ובמידע אישי, ומאשרים את השימוש הזה. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (הדירקטיבה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנה הכללית להגנה על מידע, GDPR) של האיחוד האירופי. כשמבקשים הסכמה, צריך לזהות כל רשת מודעות בשרשרת בחירת הרשת (Mediation) שעשויה לאסוף, לקבל או להשתמש במידע אישי, ולספק מידע על השימוש של כל רשת. בשלב זה, Google לא יכולה להעביר באופן אוטומטי את הבחירה של המשתמש לגבי הסכמה לרשתות כאלה.

ערכת ה-SDK של Mintegral כוללת את השיטה setConsentStatus להעברת פרטי ההסכמה ל-SDK של Mintegral.

דוגמת הקוד הבאה מראה איך להעביר את פרטי ההסכמה ל-SDK של Mintegral. צריך להגדיר את האפשרויות האלה לפני שמפעילים את Google Mobile Ads SDK כדי לוודא שהן יועברו כראוי ל-Mintegral SDK.

Java 

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

MBridgeSDK sdk = MBridgeSDKFactory.getMBridgeSDK();
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON);

Kotlin 

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

var sdk = MBridgeSDKFactory.getMBridgeSDK()
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON)

מידע נוסף זמין במסמכי התיעוד של Mintegral בנושא פרטיות.

חוקי פרטיות במדינות בארה"ב

חוקי פרטיות במדינות בארה"ב מחייבים לתת למשתמשים את הזכות לבטל את ההסכמה ל"מכירה" של "המידע האישי" שלהם (כפי שהחוק מגדיר את התנאים האלה). האפשרות לבטל את ההסכמה מוצעת בקישור בולט בדף הבית של הצד המוכר. במדריך התאימות לחוקי הפרטיות במדינות ארה"ב מוסבר איך מפעילים עיבוד נתונים מוגבל להצגת מודעות של Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת המודעות בשרשרת בחירת הרשת. לכן צריך לזהות כל רשת מודעות בשרשרת לבחירת רשת שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי להבטיח תאימות.

ערכת ה-SDK של Mintegral כוללת את השיטה setDoNotTrackStatus להעברת פרטי ההסכמה ל-SDK של Mintegral.

דוגמת הקוד הבאה מראה איך להעביר את פרטי ההסכמה ל-SDK של Mintegral. אם צריך להפעיל את השיטה הזו, צריך להפעיל אותה אחרי הפעלת Google Mobile Ads SDK אבל לפני שליחת בקשה להצגת מודעות דרך Google Mobile Ads SDK.

Java 

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

MBridgeSDK mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK();
mBridgeSDK.setDoNotTrackStatus(false);

Kotlin 

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

var mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK()
mBridgeSDK.setDoNotTrackStatus(false)

מידע נוסף זמין במסמכי התיעוד של Mintegral בנושא פרטיות.

שלב 5: מוסיפים את הקוד הנדרש

לא נדרש קוד נוסף לשילוב עם Mintegral.

שלב 6: בודקים את ההטמעה

שלבים אופציונליים

הוספת Mintegral לרשימת שותפי הפרסום בכפוף ל-CCPA

פועלים לפי השלבים המפורטים בקטע הגדרות CCPA כדי להוסיף את Mintegral לרשימת שותפי הפרסום בכפוף ל-CCPA בממשק המשתמשAd Manager .

מודעות מותאמות

רינדור המודעות

מתאם Mintegral מחזיר את המודעות המותאמות שלו כאובייקטים מסוג NativeAd . היא מאכלסת את השדות הבאים של NativeAd.

שדה נכסים שתמיד נכללים במתאם של Mintegral
כותרת
תמונה 1
גוף
סמל
קריאה לפעולה
Star rating
חנות
מחיר
מפרסם

1 מתאם Mintegral לא מספק גישה ישירה לנכס התמונה הראשי במודעות הנתמכות שלו. במקום זאת, המתאם מאכלס את MediaView בסרטון או בתמונה.

קודי שגיאה

אם המתאם לא מצליח לקבל מודעה מ-Mintegral, אפשר לבדוק את השגיאה הבסיסית בתגובה של המודעה באמצעות ResponseInfo.getAdapterResponses() בכיתות הבאות:

com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter

אלה הקודים וההודעות הנלוות שמתקבלים מהמתאם של Mintegral כשלא ניתן לטעון מודעה:

קוד שגיאה דומיין סיבה
101 com.google.ads.mediation.mintegral פרמטרים לא חוקיים של שרת (למשל, חסר מזהה אפליקציה או מזהה מיקום מודעה).
102 com.google.ads.mediation.mintegral גודל המודעה המבוקש לא תואם לגודל באנר נתמך ב-Mintegral.
103 com.google.ads.mediation.mintegral תגובה לא חוקית או חסרה של הצעת מחיר.
104 com.google.ads.mediation.mintegral ה-SDK של Mintegral החזיר שגיאת 'לא מולאה'.

יומן השינויים של מתאם בחירת הרשת ל-Android של Mintegral

הגרסה הבאה

  • אתחול Mintegral SDK בשרשור רקע (כדי לתקן שגיאות ANR).

גרסה 16.8.61.0

  • תאימות מאומתת עם Mintegral SDK 16.8.61.

פותח ונבדק בעזרת:

  • Google Mobile Ads SDK בגרסה 23.3.0.
  • גרסת Mintegral SDK‏ 16.8.61.

גרסה 16.8.51.0

  • תאימות מאומתת ל-Mintegral SDK 16.8.51.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK גרסה 23.3.0.
  • גרסת ה-SDK של Mintegral היא 16.8.51.

גרסה 16.8.41.0

  • תאימות מאומתת ל-Mintegral SDK בגרסה 16.8.41.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK גרסה 23.3.0.
  • Mintegral SDK גרסה 16.8.41.

גרסה 16.8.31.0

  • תאימות מאומתת עם Mintegral SDK 16.8.31.

פותח ונבדק בעזרת:

  • Google Mobile Ads SDK בגרסה 23.2.0.
  • גרסת SDK של Mintegral‏ 16.8.31.

גרסה 16.8.11.0

  • תאימות מאומתת עם Mintegral SDK 16.8.11.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK בגרסה 23.2.0.
  • גרסת ה-SDK של Mintegral היא 16.8.11.

גרסה 16.7.91.0

  • תאימות מאומתת ל-Mintegral SDK 16.7.91.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK בגרסה 23.2.0.
  • גרסת ה-SDK של Mintegral היא 16.7.91.

גרסה 16.7.81.0

  • תאימות מאומתת עם Mintegral SDK 16.7.81.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK גרסה 23.2.0.
  • גרסת Mintegral SDK‏ 16.7.81.

גרסה 16.7.71.0

  • תאימות מאומתת ל-Mintegral SDK בגרסה 16.7.71.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK בגרסה 23.1.0.
  • גרסת Mintegral SDK‏ 16.7.71.

גרסה 16.7.61.0

  • תאימות מאומתת עם Mintegral SDK 16.7.61.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK בגרסה 23.1.0.
  • Mintegral SDK גרסה 16.7.61.

גרסה 16.7.51.0

  • תאימות מאומתת ל-Mintegral SDK 16.7.51.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK בגרסה 23.1.0.
  • גרסת ה-SDK של Mintegral היא 16.7.51.

גרסה 16.7.41.0

  • תאימות מאומתת עם Mintegral SDK 16.7.41.

פותח ונבדק בעזרת:

  • Google Mobile Ads SDK בגרסה 23.1.0.
  • Mintegral SDK גרסה 16.7.41.

גרסה 16.7.31.0

  • תאימות מאומתת ל-Mintegral SDK 16.7.31.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK בגרסה 23.1.0.
  • גרסת ה-SDK של Mintegral היא 16.7.31.

גרסה 16.7.21.0

  • תאימות מאומתת ל-Mintegral SDK בגרסה 16.7.21.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK בגרסה 23.0.0.
  • Mintegral SDK גרסה 16.7.21.

גרסה 16.7.11.0

  • תאימות מאומתת עם Mintegral SDK 16.7.11.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK בגרסה 23.0.0.
  • גרסת ה-SDK של Mintegral היא 16.7.11.

גרסה 16.6.71.0

  • תאימות מאומתת עם Mintegral SDK 16.6.71.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK גרסה 23.0.0.
  • גרסת ה-SDK של Mintegral היא 16.6.71.

גרסה 16.6.61.0

  • עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-23.0.0.
  • תאימות מאומתת עם Mintegral SDK 16.6.61.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK גרסה 23.0.0.
  • גרסת Mintegral SDK‏ 16.6.61.

גרסה 16.6.51.0

  • תאימות מאומתת עם Mintegral SDK 16.6.51.

פותח ונבדק בעזרת:

  • Google Mobile Ads SDK גרסה 22.6.0.
  • גרסת SDK של Mintegral‏ 16.6.51.

גרסה 16.6.41.0

  • תאימות מאומתת עם Mintegral SDK 16.6.41.

פותח ונבדק בעזרת:

  • Google Mobile Ads SDK גרסה 22.6.0.
  • גרסת ה-SDK של Mintegral היא 16.6.41.

גרסה 16.6.34.0

  • תאימות מאומתת עם Mintegral SDK 16.6.34.

פותח ונבדק בעזרת:

  • Google Mobile Ads SDK בגרסה 22.6.0.
  • גרסת ה-SDK של Mintegral היא 16.6.34.

גרסה 16.6.21.0

  • תאימות מאומתת עם Mintegral SDK 16.6.21.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK גרסה 22.6.0.
  • Mintegral SDK גרסה 16.6.21.

גרסה 16.5.91.1

  • הוספנו תמיכה בבידינג בפורמט מודעות לפתיחת אפליקציה.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK גרסה 22.6.0.
  • גרסת SDK של Mintegral‏ 16.5.91.

גרסה 16.5.91.0

  • תאימות מאומתת ל-Mintegral SDK 16.5.91.
  • עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK לגרסה 22.6.0.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK גרסה 22.6.0.
  • Mintegral SDK גרסה 16.5.91.

גרסה 16.5.51.0

  • תאימות מאומתת ל-Mintegral SDK 16.5.51.

פותח ונבדק בעזרת:

  • Google Mobile Ads SDK גרסה 22.3.0.
  • גרסת Mintegral SDK‏ 16.5.51.

גרסה 16.5.41.0

  • תאימות מאומתת ל-Mintegral SDK 16.5.41.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK בגרסה 22.3.0.
  • גרסת ה-SDK של Mintegral היא 16.5.41.

גרסה 16.5.31.0

  • תאימות מאומתת ל-Mintegral SDK בגרסה 16.5.31.
  • הושבתה התלות של המתאם ב-Google Mobile Ads SDK בגרסה 22.3.0.
  • הוספנו תמיכה ב-Waterfall לפורמט מודעות בפתיחת אפליקציה.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK גרסה 22.3.0.
  • Mintegral SDK גרסה 16.5.31.

גרסה 16.5.21.0

  • תאימות מאומתת ל-Mintegral SDK 16.5.21.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה לגרסה 22.4.0.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK בגרסה 22.4.0.
  • Mintegral SDK גרסה 16.5.21.

גרסה 16.5.11.0

  • נוספה תמיכה בסימני מים למודעות לבידינג.
  • תאימות מאומתת ל-Mintegral SDK 16.5.11.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK בגרסה 22.2.0.
  • גרסת ה-SDK של Mintegral היא 16.5.11.

גרסה 16.4.91.0

  • תאימות מאומתת ל-Mintegral SDK 16.4.91.

פותח ונבדק בעזרת:

  • Google Mobile Ads SDK גרסה 22.2.0.
  • גרסת ה-SDK של Mintegral היא 16.4.91.

גרסה 16.4.81.0

  • תאימות מאומתת ל-Mintegral SDK 16.4.81.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK בגרסה 22.2.0.
  • Mintegral SDK גרסה 16.4.81.

גרסה 16.4.71.0

  • תאימות מאומתת עם Mintegral SDK 16.4.71.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK בגרסה 22.2.0.
  • גרסת ה-SDK של Mintegral היא 16.4.71.

גרסה 16.4.61.0

  • תאימות מאומתת עם Mintegral SDK 16.4.61.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK בגרסה 22.1.0.
  • גרסת Mintegral SDK‏ 16.4.61.

גרסה 16.4.51.0

  • תאימות מאומתת ל-Mintegral SDK 16.4.51.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK בגרסה 22.1.0.
  • גרסת ה-SDK של Mintegral היא 16.4.51.

גרסה 16.4.41.0

  • תוקנה בעיה שבה מודעות באנר פורמטировались בגדלים שגויים.
  • תאימות מאומתת עם Mintegral SDK 16.4.41.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK בגרסה 22.0.0.
  • גרסת ה-SDK של Mintegral היא 16.4.41.

גרסה 16.4.31.0

  • תאימות מאומתת ל-Mintegral SDK 16.4.31.

פותח ונבדק בעזרת:

  • Google Mobile Ads SDK גרסה 22.0.0.
  • גרסת ה-SDK של Mintegral היא 16.4.31.

גרסה 16.4.21.0

  • מתאם מעודכן שמשתמש במחלקה החדשה VersionInfo.
  • עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK לגרסה 22.0.0.
  • תאימות מאומתת ל-Mintegral SDK בגרסה 16.4.21.

פותח ונבדק בעזרת:

  • Google Mobile Ads SDK בגרסה 22.0.0.
  • גרסת ה-SDK של Mintegral היא 16.4.21.

גרסה 16.3.91.0

  • תאימות מאומתת ל-Mintegral SDK 16.3.91.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK בגרסה 21.5.0.
  • גרסת ה-SDK של Mintegral היא 16.3.91.

גרסה 16.3.81.0

  • תאימות מאומתת ל-Mintegral SDK 16.3.81.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK בגרסה 21.5.0.
  • גרסת ה-SDK של Mintegral היא 16.3.81.

גרסה 16.3.71.0

  • תאימות מאומתת ל-Mintegral SDK בגרסה 16.3.71.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK בגרסה 21.5.0.
  • גרסת Mintegral SDK‏ 16.3.71.

גרסה 16.3.61.0

  • תאימות מאומתת עם Mintegral SDK 16.3.61.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK בגרסה 21.5.0.
  • גרסת ה-SDK של Mintegral היא 16.3.61.

גרסה 16.3.51.1

  • נוספה תמיכה ב-Waterfall בפורמטים של מודעות באנר (כולל MREC), מודעות מעברון, מודעות מתגמלות ומודעות מותאמות.
  • עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK לגרסה 21.5.0.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK בגרסה 21.5.0.
  • גרסת ה-SDK של Mintegral היא 16.3.51.

גרסה 16.3.51.0

  • תאימות מאומתת ל-Mintegral SDK 16.3.51.

פותח ונבדק בעזרת:

  • Google Mobile Ads SDK בגרסה 21.4.0.
  • גרסת ה-SDK של Mintegral היא 16.3.51.

גרסה 16.3.41.0

  • תאימות מאומתת ל-Mintegral SDK 16.3.41.
  • עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-21.4.0.

הקוד נוצר ונבדק באמצעות:

  • Google Mobile Ads SDK בגרסה 21.4.0.
  • גרסת ה-SDK של Mintegral היא 16.3.41.

גרסה 16.3.11.0

  • תאימות מאומתת ל-Mintegral SDK 16.3.11.
  • עדכנו את המתאם כך שיעביר את onUserEarnedReward() לפני onAdClosed() כשמוצגות מודעות מתגמלות.

פותח ונבדק בעזרת:

  • Google Mobile Ads SDK בגרסה 21.3.0.
  • גרסת ה-SDK של Mintegral היא 16.3.11.

גרסה 16.2.61.0

  • זו הגרסה הראשונה
  • נוספה תמיכה בבידינג בפורמטים של מודעות באנר (כולל MREC), מודעות מעברון, מודעות מתגמלות ומודעות מותאמות.

פותח ונבדק בעזרת:

  • Google Mobile Ads SDK בגרסה 21.3.0.
  • גרסת Mintegral SDK‏ 16.2.61.