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

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

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

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

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

דרישות

  • הגרסה העדכנית ביותר של Google Mobile Ads SDK
    • Unity 5.6 ואילך
    • [לבידינג]: כדי לשלב את כל הפורמטים הנתמכים של המודעות בבידינג, צריך להשתמש בפלאגין של Google Mobile Ads לבחירת הרשת ב-Mintegral בגרסה 1.4.0 ואילך (מומלץ להשתמש בגרסה העדכנית ביותר)
    • כדי לפרוס ב-Android
      • Android API ברמה 23 ואילך
    • לפריסה ב-iOS
      • יעד הפריסה של iOS מגרסה 12.0 ואילך
    • פרויקט פעיל ב-Unity שמוגדר בו Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת השימוש.
    • מדריך לתחילת העבודה בנושא בחירת הרשת

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

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

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

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

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

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

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

Android

iOS

שימו לב למזהה האפליקציה.

Android

iOS

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

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

Android

iOS

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

בידינג

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

מפל

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

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

Android

iOS

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

Android

iOS

איך מוצאים את מפתח ה-Reporting API של Mintegral

בידינג

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

מפל

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

עדכון קובץ app-ads.txt

Authorized Sellers for Apps app-ads.txt היא יוזמה של IAB Tech Lab שעוזרת להבטיח שמלאי שטחי הפרסום באפליקציה שלכם יימכר רק דרך ערוצים שציינתם שהם מורשים. כדי למנוע אובדן משמעותי בהכנסות מפרסום, מומלץ להטמיע קובץ app-ads.txt. אם עדיין לא עשיתם זאת, יוצרים קובץ app-ads.txt ל-Ad Manager.

כדי להטמיע את app-ads.txt ב-Mintegral, אפשר לעיין במאמר איך קובץ app-ads.txt יכול לעזור במאבק נגד הונאת מודעות.

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

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

Android

להוראות, אפשר לעיין בשלב 2 במדריך ל-Android.

iOS

להוראות, אפשר לעיין בשלב 2 במדריך ל-iOS.

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

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

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

OpenUPM-CLI

אם התקנתם את OpenUPM-CLI, תוכלו להתקין את הפלאגין של Mintegral לתהליך בחירת הרשת (Mediation) של Google Mobile Ads ל-Unity בפרויקט שלכם. לשם כך, מריצים את הפקודה הבאה מהספרייה ברמה הבסיסית (root) של הפרויקט:

openupm add com.google.ads.mobile.mediation.mintegral

OpenUPM

בעורך הפרויקט ב-Unity, בוחרים באפשרות Edit (עריכה) > Project Settings (הגדרות הפרויקט) > Package Manager (מנהל החבילות) כדי לפתוח את הגדרות מנהל החבילות של Unity.

בכרטיסייה Scoped Registries, מוסיפים את OpenUPM כמאגר שמוגדר להיקף מסוים עם הפרטים הבאים:

  • שם: OpenUPM
  • כתובת אתר: https://package.openupm.com
  • היקפים: com.google

פרטי OpenUPM

לאחר מכן, עוברים אל Window‏ > Package Manager כדי לפתוח את Unity Package Manager ובוחרים באפשרות My Registries בתפריט הנפתח.

Unity Registries

בוחרים בחבילה Google Mobile Ads Mintegral Mediation ולוחצים על Install.

התקנה מ-OpenUPM

חבילת Unity

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

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

ייבוא מ-Unity

לאחר מכן בוחרים באפשרות Assets‏ > External Dependency Manager‏ > Android Resolver‏ > Force Resolve. ספריית External Dependency Manager תפתור את יחסי התלות מהתחלה ותעתיק את יחסי התלות שהוצהרו לתיקייה Assets/Plugins/Android באפליקציה שלכם ב-Unity.

אילוץ פתרון

שלב 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 ה-SDK של Mintegral החזיר שגיאת 'לא מולאה'.

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.

יומן השינויים של פלאגין תהליך בחירת הרשת (Mediation) של Mintegral ל-Unity

גרסה 1.9.3

גרסה 1.9.2

גרסה 1.9.1

גרסה 1.9.0

גרסה 1.8.4

גרסה 1.8.3

גרסה 1.8.2

גרסה 1.8.1

גרסה 1.8.0

גרסה 1.7.0

גרסה 1.6.5

גרסה 1.6.4

גרסה 1.6.3

גרסה 1.6.2

גרסה 1.6.1

גרסה 1.6.0

גרסה 1.5.0

גרסה 1.4.0

גרסה 1.3.0

גרסה 1.2.1

גרסה 1.2.0

גרסה 1.1.0

גרסה 1.0.0