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

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

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

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

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

¹ השילוב של הבידינג בפורמט הזה הוא בגרסת בטא סגורה.

² השילוב של Waterfall בפורמט הזה הוא בגרסת בטא סגורה.

³ השילוב של Waterfall בפורמט הזה הוא בגרסת בטא פתוחה.

דרישות

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

שלב 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, CPRA ופלטפורמה להעברת הודעות למשתמשים. לפרטים נוספים, ראו ניהול גישת המשתמשים לחשבון.

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

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

הערה: אם אין שילוב בין הגרסה התואמת של Mintegral והגרסה של Google Mobile Ads SDK, עלולות להיווצר בעיות ב-build.

שילוב דרך pub.dev

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

dependencies:
  gma_mediation_mintegral: ^1.0.0

שילוב ידני

הורד את הגרסה האחרונה של פלאגין הגישור של Google Mobile 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.

חשוב: צריך להשבית את מצב הבדיקה עבור AdMob וגם 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	ה-SDK של Mintegral החזיר שגיאת 'לא מולאה'.

iOS

קוד שגיאה	דומיין	הסיבה
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 Flutter

1.0.0

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