שילוב Mintegral עם תהליך בחירת הרשת (Mediation)

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

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

המתאם לתהליך בחירת הרשת (Mediation) ב-Mintegral כולל את היכולות הבאות:

² בידינג ו-Waterfall שילובים לפורמטים של מודעות מותאמות הם בגרסת בטא פתוחה.

דרישות

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

• ה-SDK העדכני של Google Mobile Ads

• השלמת תהליך בחירת הרשת (Mediation) מדריך לתחילת העבודה

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

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

קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות

עליך להוסיף Mintegral לתצורה של תהליך בחירת הרשת של יחידת המודעות.

קודם נכנסים לחשבון AdMob. לאחר מכן נכנסים לכרטיסייה תהליך בחירת הרשת (Mediation). אם יש קבוצה קיימת לבחירת רשת שאתם רוצים לשנות, צריך ללחוץ על השם של הקבוצה לבחירת רשת כדי לערוך אותה, ולדלג לקטע הוספה Mintegral כמקור מודעות.

כדי ליצור קבוצה חדשה לבחירת רשת, בוחרים באפשרות יצירת קבוצה לבחירת רשת (Mediation).

מזינים את פורמט המודעה ואת הפלטפורמה, ולוחצים על המשך.

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

משייכים את הקבוצה הזו לבחירת רשת לאחת או יותר מיחידות המודעותAdMob הקיימות. לאחר מכן לוחצים על סיום.

עכשיו אתם אמורים לראות שהכרטיס של יחידות המודעות מאוכלס ביחידות של המודעות שבחרתם:

הוספה של Mintegral כמקור מודעות

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

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

שילוב עם Android Studio (מומלץ)

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

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

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

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

שילוב ידני

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

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

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

הסכמה באיחוד האירופי ו-GDPR

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

לא צריך קוד נוסף כדי לשלב את Mintegral.

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

הפעלת מודעות בדיקה

חשוב לרשום את מכשיר הבדיקה ל- AdMob

רוצה להציג מודעות בדיקה של Mintegral למודעות באנר, מעברונים, מודעות מתגמלות ומודעות מותאמות? ההמלצה של Mintegral היא להשתמש במפתחות האפליקציות, במזהי האפליקציות, במזהי המיקומים ובמזהי יחידות המודעות שצוינו בדף מזהה הבדיקה של Mintegral.

אימות מודעות בדיקה

כדי לוודא שמוצגות לך מודעות לבדיקה מ-Mintegral, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות Mintegral (Bidding) and Mintegral (Waterfall) מקורות המודעות.

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

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

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

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

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

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

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

קודי שגיאה

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

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

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

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

גרסה 16.8.31.0

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

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

• Google Mobile Ads SDK גרסה 23.2.0.
• Mintegral SDK גרסה 16.8.31.

גרסה 16.8.11.0

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

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

• Google Mobile Ads SDK גרסה 23.2.0.
• Mintegral SDK גרסה 16.8.11.

גרסה 16.7.91.0

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

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

• Google Mobile Ads SDK גרסה 23.2.0.
• Mintegral SDK גרסה 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.

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

• גרסה 23.1.0 של Google Mobile Ads SDK
• Mintegral SDK גרסה 16.7.71.

גרסה 16.7.61.0

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

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

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

גרסה 16.7.51.0

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

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

• גרסה 23.1.0 של Google Mobile Ads SDK
• Mintegral SDK גרסה 16.7.51.

גרסה 16.7.41.0

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

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

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

גרסה 16.7.31.0

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

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

• גרסה 23.1.0 של Google Mobile Ads SDK
• Mintegral SDK גרסה 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.
• Mintegral SDK גרסה 16.7.11.

גרסה 16.6.71.0

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

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

• Google Mobile Ads SDK גרסה 23.0.0.
• Mintegral SDK גרסה 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.
• Mintegral SDK גרסה 16.6.51.

גרסה 16.6.41.0

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

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

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

גרסה 16.6.34.0

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

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

• Google Mobile Ads SDK גרסה 22.6.0.
• Mintegral SDK גרסה 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.
• Mintegral SDK גרסה 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.
• Mintegral SDK גרסה 16.5.41.

גרסה 16.5.31.0

• תאימות מאומתת ל-Mintegral SDK בגרסה 16.5.31.
• החזרנו את המתאם כך שיהיה תלוי בגרסה 22.3.0 של Google Mobile Ads SDK.
• נוספה תמיכה ב-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.

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

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

גרסה 16.5.11.0

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

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

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

גרסה 16.4.91.0

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

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

• Google Mobile Ads SDK גרסה 22.2.0.
• Mintegral SDK גרסה 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.
• Mintegral SDK גרסה 16.4.71.

גרסה 16.4.61.0

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

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

• גרסה 22.1.0 של Google Mobile Ads SDK.
• Mintegral SDK גרסה 16.4.61.

גרסה 16.4.51.0

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

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

• גרסה 22.1.0 של Google Mobile Ads SDK.
• Mintegral SDK גרסה 16.4.51.

גרסה 16.4.41.0

• תוקנה בעיה שבה מודעות באנר הוצגו בגדלים שגויים.
• תאימות מאומתת ל-Mintegral SDK בגרסה 16.4.41.

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

• Google Mobile Ads SDK גרסה 22.0.0.
• Mintegral SDK גרסה 16.4.41.

גרסה 16.4.31.0

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

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

• Google Mobile Ads SDK גרסה 22.0.0.
• Mintegral SDK גרסה 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.
• Mintegral SDK גרסה 16.4.21.

גרסה 16.3.91.0

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

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

• Google Mobile Ads SDK גרסה 21.5.0.
• Mintegral SDK גרסה 16.3.91.

גרסה 16.3.81.0

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

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

• Google Mobile Ads SDK גרסה 21.5.0.
• Mintegral SDK גרסה 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.
• Mintegral SDK גרסה 16.3.61.

גרסה 16.3.51.1

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

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

• Google Mobile Ads SDK גרסה 21.5.0.
• Mintegral SDK גרסה 16.3.51.

גרסה 16.3.51.0

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

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

• גרסה 21.4.0 של Google Mobile Ads SDK.
• Mintegral SDK גרסה 16.3.51.

גרסה 16.3.41.0

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

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

• גרסה 21.4.0 של Google Mobile Ads SDK.
• Mintegral SDK גרסה 16.3.41.

גרסה 16.3.11.0

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

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

• Google Mobile Ads SDK גרסה 21.3.0.
• Mintegral SDK גרסה 16.3.11.

גרסה 16.2.61.0

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

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

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