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

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

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

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

² השילוב של Waterfall נמצא ב- בגרסת בטא סגורה.

דרישות

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

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

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

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

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

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

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

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

בכרטיסייה הגדרות אפליקציה, לוחצים על הלחצן הוספת אפליקציה.

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

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

יצירת מיקום מודעה

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

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

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

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

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

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

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

נכנסים לחשבון Ad Manager.

הוספת Mintegral בחברות

הפעלה של שיתוף אותות מאובטחים

הגדרת הבידינג Mintegral

הגדרת מיפוי של יחידת מודעות

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

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

שלב 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 בנושא פרטיות אפשר לקבל מידע נוסף.

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

ארה"ב חוקי הפרטיות במדינות (States) צריך לתת למשתמשים כדי לבטל את ההצטרפות ל"מבצע" של "המידע האישי" שלהם (כפי שהחוק מגדיר את התנאים האלה), באמצעות ביטול ההסכמה לכך שניתן יהיה ללחוץ על מידע" בדף "מכירה" דף הבית של המסיבה. ארה"ב פרטיות במדינות המדריך לציות לחוקים מאפשר להפעיל עיבוד נתונים מוגבל להצגת מודעות ב-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: בודקים את ההטמעה

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

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

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

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

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

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

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

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

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

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

מתאם 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.