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

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

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

המתאם של Ad Manager תהליך בחירת הרשת ב-Mintegral כולל את היכולות הבאות:

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

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

דרישות

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

בידינג

לא צריך לבצע את השלב הזה בשילובי בידינג.

מפל

כדי להגדיר את Ad Manager מזהה יחידת המודעות, תצטרכו את מפתח Mintegral Reporting API. עוברים אל Account (חשבון) > API Tools (כלים ל-API). רשמו לעצמכם את המפתח והסוד שלכם.

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

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

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

בידינג

לא צריך לבצע את השלב הזה בשילובי בידינג.

מפל

עוברים אל Admin > Companies, ואז לוחצים על הלחצן New company בכרטיסייה All company. בוחרים באפשרות רשת מודעות.

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

לא צריך להזין שם משתמש או סיסמה. בסיום, לוחצים על Save.

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

בידינג

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

מפל

השלב הזה לא נדרש לשילוב עם Waterfall.

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

בידינג

עוברים אל הצגה > Bidders, ולוחצים על New bidder (מגיש הצעות מחיר חדש) בכרטיסייה SDK Bidding.

בוחרים באפשרות Mintegral בתור מגיש הצעות המחיר.

מפעילים את האפשרויות הוספת ספריית האותות של מגיש הצעות המחיר לרשימת האותות המורשים ואפשר לשתף אותות עם מגיש הצעות המחיר הזה. אחר כך לוחצים על Continue.

לוחצים על המשך.

לוחצים על סיום.

מפל

השלב הזה לא נדרש לשילוב עם Waterfall.

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

בידינג

מנווטים אל delivery > Bidders, ובוחרים את החברה Mintegral בכרטיסייה SDK Bidding.

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

בוחרים באפשרות יחידת מודעות ספציפית. בחר יחידת מודעות ופורמט, Mobile app בשדה Inventory type ו-Mobile app. לאחר מכן, מזינים את הערךApp Key, App ID, Placement ID, and Ad Unit ID שתקבל בקטע הקודם. לסיום, לוחצים על שמירה.

מפל

עוברים אל delivery > Yield groups (קבוצות תפוקה) ולוחצים על New yield group (קבוצת תפוקה חדשה). בוחרים את האפליקציה לנייד.

גוללים למטה ולוחצים על הוספת שותף תפוקה.

בקטע הקודם, בוחרים את החברה שיצרתם Mintegral. בחר את Mobile SDKMediation בתור סוג השילוב,Android בתור הפלטפורמה ו-Active בתור Status.

מזינים את App Key, App ID, Placement ID, and Ad Unit ID שקיבלתם בקטע הקודם ואת הערך של ברירת המחדל לעלות לאלף חשיפות. לוחצים על שמירה.

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

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

שלב 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.0.0")
    implementation("com.google.ads.mediation:mintegral:16.6.61.0")
}

שילוב ידני

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

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

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

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

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

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

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

חוקי הפרטיות במדינות בארה"ב דורשים למשתמשים את הזכות לא להסכים ל'מכירה' של 'המידע האישי' שלהם (כפי שהחוק מגדיר את המונחים האלה). אפשרות ביטול ההסכמה מוצעת באמצעות קישור בולט בשם 'Do Not Sell My Personal Information' (אל תמכרו את המידע האישי שלי) בדף הבית של הצד המוֹכֵר. במדריך לתאימות לחוקי הפרטיות במדינות ארה"ב אפשר להפעיל עיבוד נתונים מוגבל של הצגת המודעות ב-Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת לבחירת הרשת. לכן, צריך לזהות כל רשת מודעות בשרשרת לבחירת רשת שעשוית להשתתף במכירה של מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא שהן עומדות בדרישות.

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

הקוד לדוגמה הבא מראה איך להעביר את פרטי ההסכמה ל-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: בודקים את ההטמעה

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

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

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

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

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

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

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

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

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

הצגת מודעות

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

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

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

קודי שגיאה

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

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 החזיר שגיאת 'לא מולאה'.
101 com.google.mediation.mintegral פרמטרים לא חוקיים של השרת (למשל, מזהה אפליקציה או מזהה מיקום חסרים).
102 com.google.mediation.mintegral ה-SDK של Mintegral החזיר שגיאת 'לא מולאה'.
103 com.google.mediation.mintegral הצגת המודעה של Mintegral SDK נכשלה.
104 com.google.mediation.mintegral גודל המודעה המבוקש לא תואם לגודל מודעת באנר שנתמך על ידי Mintegral.

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

גרסה 16.6.51.0

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

נוצר ונבדק בעזרת:

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

גרסה 16.6.41.0

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

נוצר ונבדק בעזרת:

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

גרסה 16.6.34.0

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

נוצר ונבדק בעזרת:

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

גרסה 16.6.21.0

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

נוצר ונבדק בעזרת:

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

גרסה 16.5.91.1

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

נוצר ונבדק בעזרת:

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

גרסה 16.5.91.0

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

נוצר ונבדק בעזרת:

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

גרסה 16.5.51.0

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

נוצר ונבדק בעזרת:

  • גרסה 22.3.0 של Google Mobile Ads SDK.
  • Mintegral SDK בגרסה 16.5.51.

גרסה 16.5.41.0

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

נוצר ונבדק בעזרת:

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

גרסה 16.5.31.0

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

נוצר ונבדק בעזרת:

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

נוצר ונבדק בעזרת:

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

גרסה 16.4.91.0

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

נוצר ונבדק בעזרת:

  • גרסה 22.2.0 של Google Mobile Ads SDK.
  • Mintegral SDK בגרסה 16.4.91.

גרסה 16.4.81.0

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

נוצר ונבדק בעזרת:

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

גרסה 16.4.71.0

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

נוצר ונבדק בעזרת:

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

נוצר ונבדק בעזרת:

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

גרסה 16.4.31.0

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

נוצר ונבדק בעזרת:

  • גרסה 22.0.0 של Google Mobile Ads SDK.
  • Mintegral SDK בגרסה 16.4.31.

גרסה 16.4.21.0

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

נוצר ונבדק בעזרת:

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

גרסה 16.3.91.0

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

נוצר ונבדק בעזרת:

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

גרסה 16.3.81.0

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

נוצר ונבדק בעזרת:

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

גרסה 16.3.71.0

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

נוצר ונבדק בעזרת:

  • גרסה 21.5.0 של Google Mobile Ads SDK.
  • Mintegral SDK בגרסה 16.3.71.

גרסה 16.3.61.0

  • התאימות מאומתת ל-Mintegral SDK 16.3.61.

נוצר ונבדק בעזרת:

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

גרסה 16.3.51.1

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

נוצר ונבדק בעזרת:

  • גרסה 21.5.0 של Google Mobile Ads SDK.
  • 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() בזמן הצגת מודעות מתגמלות.

נוצר ונבדק בעזרת:

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

גרסה 16.2.61.0

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

נוצר ונבדק בעזרת:

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