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

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

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

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

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

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

דרישות

  • Unity 5.6 ואילך
  • ה-SDK העדכני של מודעות Google לנייד
  • כדי לפרוס ב-Android
    • Android API ברמת 19 ואילך
  • כדי לפרוס ב-iOS
    • יעד הפריסה של iOS הוא 12.0 ומעלה
  • פרויקט Unity פועל שהוגדר באמצעות 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

מורידים את הגרסה האחרונה של הפלאגין של תהליך בחירת הרשת (Mediation) ב-Google Mobile Ads עבור Mintegral דרך קישור ההורדה ב-Changelog, ומחלצים את GoogleMobileAdsMintegralMediation.unitypackage מקובץ ה-ZIP.

בעורך הפרויקטים ב-Unity, בוחרים באפשרות Assets > Import Package >Custom Package (נכסים) ומוצאים את הקובץ GoogleMobileAdsMintegralMediation.unitypackage שהורדת. מוודאים שכל הקבצים מסומנים ולוחצים על Import.

לאחר מכן, בוחרים נכסים > Play Services Solutionr > Android Solutionr > Force resolve. ספריית Unity Play Services Solutionr תבצע פתרון בעיות מאפס ותעתיק את יחסי התלות המוצהרים לספרייה Assets/Plugins/Android של אפליקציית Unity.

שלב 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 ה-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 Unity

גרסה 1.4.0

גרסה 1.3.0

גרסה 1.2.1

גרסה 1.2.0

גרסה 1.1.0

גרסה 1.0.0