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

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

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

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

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

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

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

דרישות

  • הגרסה העדכנית ביותר של Google Mobile Ads SDK
  • Flutter מגרסה 3.7.0 ואילך
  • כדי לפרוס ב-Android
    • Android API ברמה 21 ואילך
  • לפריסה ב-iOS
    • יעד הפריסה של iOS מגרסה 12.0 ואילך
  • פרויקט Flutter פעיל שהוגדרה בו ה-SDK של Google Mobile Ads. פרטים נוספים זמינים במאמר תחילת השימוש.
  • מדריך לתחילת העבודה בנושא בחירת הרשת

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

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

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

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

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

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

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

Android

iOS

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

Android

iOS

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

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

Android

iOS

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

בידינג

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

מפל

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

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

Android

iOS

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

Android

iOS

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

בידינג

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

מפל

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

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

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

Android

לקבלת הוראות, עיינו בשלב 2 במדריך עבור Android.

iOS

לקבלת הוראות, עיינו בשלב 2 במדריך iOS.

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

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

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

שילוב באמצעות pub.dev

מוסיפים את התלות הבאה עם הגרסאות האחרונות של ה-SDK ושל המתאם שלMintegral בקובץ pubspec.yaml של החבילה:

dependencies:
  gma_mediation_mintegral: ^1.0.0

שילוב ידני

מורידים את הגרסה האחרונה של הפלאגין של Google Mobile Ads לבחירת רשת (Mediation) עבור Mintegral, מנתקים את הקובץ שהורדתם ומוסיפים את תיקיית הפלאגין שחולצה (ואת התוכן שלה) לפרויקט Flutter. לאחר מכן, מוסיפים את הפלאגין לקובץ pubspec.yaml באמצעות יחסי התלות הבאים:

dependencies:
  gma_mediation_mintegral:
    path: path/to/local/package

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

Android

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

iOS

שילוב עם SKAdNetwork

פועלים לפי מסמכי התיעוד של Mintegral כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist של הפרויקט.

שלב 5: בדיקה מעשית של ההטמעה

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

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

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

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

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

קודי שגיאה

אם המתאם לא מקבל מודעה מ-Mintegral, בעלי התוכן הדיגיטלי יכולים לבדוק את השגיאה הבסיסית בתגובה באמצעות ResponseInfo, בסיווגים הבאים:

Android

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

iOS

GADMediationAdapterMintegral

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

Android

קוד שגיאה דומיין סיבה
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 אירעה שגיאה מסוג 'לא מולאה' ב-Mintegral SDK.

iOS

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

יומן שינויים של מתאם ל-Fintegral Flutter Mediation

הגרסה הבאה

  • נוצר ונבדק באמצעות גרסה 5.2.0 של הפלאגין של Google Mobile Ads Flutter.

1.1.0

  • תאימות מאומתת למתאם Mintegral ל-Android בגרסה 16.8.31.0.
  • התאימות אומתה עם מתאם Mintegral ל-iOS בגרסה 7.7.1.0.
  • הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.1.0.

1.0.0

  • הגרסה הראשונית.
  • תאימות מאומתת למתאם Mintegral של Android בגרסה 16.7.21.0.
  • התאימות אומתה עם מתאם Mintegral ל-iOS בגרסה 7.6.3.0.
  • הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.1.0.