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

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

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

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

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

דרישות

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

• [לצורכי בידינג]: כדי לשלב את כל הפורמטים הנתמכים של המודעות בבידינג, צריך להשתמש במתאם Mintegral בגרסה 16.5.91.1 ואילך (מומלץ להשתמש בגרסה העדכנית ביותר)

• הגרסה העדכנית ביותר של Google Mobile Ads SDK

• מדריך לתחילת העבודה בנושא בחירת הרשת

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

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

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

עוברים לכרטיסייה APP Setting ומתעדים את APP Key.

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

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

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

שימו לב למזהה האפליקציה.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

פועלים לפי השלבים המפורטים בקטע הגדרות GDPR ובקטע הגדרות בנושא תקנות במדינות בארה"ב כדי להוסיף את Mobvista/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 ברמת האפליקציה. להשתמש בגרסאות העדכניות ביותר של ה-SDK והמתאם של Mintegral:

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

שילוב ידני

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

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

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

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

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

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

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

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

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

יומן השינויים של מתאם בחירת הרשת ל-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.
• גרסת SDK של Mintegral‏ 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.
• גרסת ה-SDK של Mintegral היא 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.
• גרסת ה-SDK של Mintegral היא 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.
• גרסת ה-SDK של Mintegral היא 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.
• גרסת SDK של Mintegral‏ 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

• נוספה תמיכה במפל המים לפורמטים של מודעות באנר (כולל 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.