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

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

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

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

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

דרישות

  • הגרסה העדכנית של Google Mobile Ads SDK
    • ‫Unity 5.6 ואילך
    • ‫[For bidding]: כדי לשלב את כל פורמטי המודעות הנתמכים בבידינג, צריך להשתמש בתוסף Google Mobile Ads mediation ל-Mintegral בגרסה 1.4.0 ואילך (מומלץ להשתמש בגרסה העדכנית ביותר)
    • כדי לפרוס ב-Android
      • רמת API ‏23 ואילך ב-Android
    • כדי לפרוס ב-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

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

בידינג

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

מפל

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

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

Android

iOS

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

Android

iOS

איתור מפתח Mintegral Reporting API

בידינג

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

מפל

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

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

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

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

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

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

Android

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

iOS

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

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

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

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

OpenUPM-CLI

אם התקנתם את OpenUPM-CLI, אתם יכולים להתקין את Google Mobile Ads Mintegral Mediation Plugin for Unity בפרויקט שלכם על ידי הפעלת הפקודה הבאה מספריית הבסיס של הפרויקט:

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 (מנהל החבילות של Unity) ובוחרים באפשרות My Registries (המאגרים שלי) בתפריט הנפתח.

Unity Registries

בוחרים בחבילה Google Mobile Ads Mintegral Mediation ולוחצים על Install (התקנה).

התקנה מ-OpenUPM

חבילת Unity

מורידים את הגרסה האחרונה של הפלאגין Google Mobile Ads mediation ל-Mintegral מקישור ההורדה ביומן השינויים ומחלצים את GoogleMobileAdsMintegralMediation.unitypackage מקובץ ה-ZIP.

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

ייבוא מ-Unity

לאחר מכן בוחרים באפשרות נכסים > מנהל תלות חיצוני > 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 ‫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.

יומן השינויים של Mintegral Unity Mediation Plugin

גרסה 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