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

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

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

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

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

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

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

דרישות

  • ה-SDK העדכני של Google Mobile Ads
    • Unity 5.6 ומעלה
    • לפריסה ב-Android
      • Android API ברמה 21 ואילך
    • לפריסה ב-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 > (נכסים >) ייבוא חבילה > מותאם אישית Package ומוצאים את GoogleMobileAdsMintegralMediation.unitypackage שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על ייבוא.

בשלב הבא בוחרים באפשרות נכסים > המקודד של Play Services > מקודד Android > אילוץ לפתרון הבעיה. ספריית Unity Play Services resolver תבצע תלות ומעתיקים את יחסי התלות המוצהרים הספרייה 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 אירעה שגיאה מסוג 'לא מולאה' ב-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

הגרסה הבאה

  • השם של DummyClient השתנה. השם החדש הוא PlaceholderClient.

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