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

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

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

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

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

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

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

דרישות

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

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

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

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

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

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

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

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

Android

iOS

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

Android

iOS

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

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

Android

iOS

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

בידינג

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

מפל

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

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

Android

iOS

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

Android

iOS

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

בידינג

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

מפל

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

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

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

Android

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

iOS

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

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

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

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

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

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

dependencies:
  gma_mediation_mintegral: ^1.0.0

שילוב ידני

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

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

1.0.0

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