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

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

בממשק מרכז הבקרה של maio נעשה שימוש בטקסט ביפנית בתור התוויות, הלחצנים ותיאורים, וצילומי המסך במדריך הזה לא תורגמו. עם זאת, בתיאורים ובהוראות של מדריך זה, תוויות ולחצנים ומזכירים את המונחים המקבילים להם באנגלית. "URL insertーム", לדוגמה, היא 'סכמת כתובת ה-URL'.

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

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

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

דרישות

  • יעד הפריסה של iOS מגרסה 12.0 ואילך

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

קודם כל, נרשמים או מתחברים לחשבון maio. בסרגל הצד שמשמאל, לוחצים על Application management ואז על New app.

בוחרים את הכרטיסייה שתואמת לסוג המודעה המועדף.

פרסומת מרווח ביניים

נותנים שם לאפליקציה, בוחרים את הפלטפורמה ומזינים את כתובת ה-URL של האפליקציה. בחר באפשרות מודעת מעברון בווידאו בתור סוג המודעה, ולחץ על עדכון.

Android

iOS

ההטבה הופעלה

נותנים שם לאפליקציה, בוחרים את הפלטפורמה ומזינים את כתובת ה-URL של האפליקציה. בוחרים באפשרות Video Rewards בתור סוג המודעה ולוחצים על עדכון.

Android

iOS

בדף Application Management שים לב למזהה המדיה. תצטרכו להגדיר את יחידת המודעות Ad Manager בקטע הבא.

Android

iOS

בדף Zone Management מציינים את Zone ID. בקטע הבא תצטרכו גם להגדיר את Ad Manager יחידת המודעות.

Android

iOS

(Waterfall בלבד) בנוסף למזהה מדיה ולמזהה אזור, צריך מזהה API ומפתח API כדי להגדיר מזהה יחידת מודעות לתהליך בחירת הרשת. שימו לב למזהה API ול-API KEY בדף Reporting API.

שלב 2: הגדרת ביקוש ב-maio Ad Manager בממשק המשתמש

קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות

Android

לקבלת הוראות, עיינו בשלב 2 במדריך עבור Android.

iOS

לקבלת הוראות, עיינו בשלב 2 במדריך iOS.

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

  • מוסיפים את השורה הבאה ל-Podfile של הפרויקט:

    pod 'GoogleMobileAdsMediationMaio'

  • מריצים את שורת הפקודה:

    pod install --repo-update

שילוב ידני

  • להוריד את הגרסה האחרונה של maio SDK.
  • אפשר להוריד את הגרסה האחרונה של מתאם maio דרך הקישור להורדה Changelog (יומן שינויים), ולקשר את maioAdapter.framework בפרויקט שלך.

שלב 4: מוסיפים את הקוד הנדרש

שילוב של SKAdNetwork

פועלים לפי מסמכי התיעוד של Maio. כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist של הפרויקט.

שלב 5: בודקים את ההטמעה

הפעלת מודעות בדיקה

חשוב לרשום את מכשיר הבדיקה ל- Ad Manager

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

אימות מודעות בדיקה

כדי לוודא שמוצגות לך מודעות לבדיקה מ-maio, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות maio (Waterfall) מקורות המודעות.

קודי שגיאה

אם המתאם לא מקבל מודעה מ-maio, בעלי התוכן הדיגיטלי יכולים לבדוק את השגיאה הבסיסית בתגובה עם המודעה באמצעות GADResponseInfo.adNetworkInfoArray בסיווגים הבאים:

פורמט שם הכיתה
מעברון GADMMaioInterstitialAdapter
ההטבה הופעלה GADMMaioRewardedAdapter

אלה הקודים וההודעות הנלוות שמתאם maio זורק כשטעינה של מודעה נכשלת:

קוד שגיאה סיבה
0-10 maio החזירה שגיאה ספציפית ל-SDK. צפייה הקוד של maio אפשר לקבל פרטים נוספים.
101 עדיין אין מודעה זמינה ב-maio.
102 פרמטרים לא חוקיים של שרת (למשל, חסר מזהה מיקום).
103 המתאם maio לא תומך בפורמט המודעה המבוקש.
104 כבר נטענה מודעה לתצורת הרשת הזו.

יומן שינויים של מתאם תהליך בחירת הרשת (Mediation) ב-maio iOS

גרסה 2.1.5.0

  • תאימות מאומתת ל-maio SDK גרסה 2.1.5.

פותח ונבדק בעזרת:

  • Google Mobile Ads SDK גרסה 11.6.0.
  • Maio SDK גרסה 2.1.5.

גרסה 2.1.4.0

  • תאימות מאומתת ל-maio SDK גרסה 2.1.4.

פותח ונבדק בעזרת:

  • Google Mobile Ads SDK גרסה 11.2.0.
  • Maio SDK גרסה 2.1.4.

גרסה 2.1.3.0

  • תאימות מאומתת ל-maio SDK גרסה 2.1.3.

פותח ונבדק בעזרת:

  • גרסה 11.1.0 של Google Mobile Ads SDK.
  • Maio SDK גרסה 2.1.3.

גרסה 2.1.2.1

  • כדי להשתמש עכשיו באפליקציה נדרשת גרסה 11.0 ואילך של Google Mobile Ads SDK.
  • Info.plist כלול ב-frameworks בתוך MaioAdapter.xcframework.

פותח ונבדק בעזרת:

  • גרסה 11.0.1 של Google Mobile Ads SDK.
  • Maio SDK גרסה 2.1.2.

גרסה 2.1.2.0

  • תאימות מאומתת ל-maio SDK גרסה 2.1.2.

פותח ונבדק בעזרת:

  • גרסה 10.14.0 של Google Mobile Ads SDK
  • Maio SDK גרסה 2.1.2.

גרסה 2.1.1.0

  • תאימות מאומתת ל-maio SDK גרסה 2.1.1.

פותח ונבדק בעזרת:

  • Google Mobile Ads SDK גרסה 10.12.0.
  • Maio SDK גרסה 2.1.1.

גרסה 2.0.0.0

  • תאימות מאומתת ל-maio SDK גרסה 2.0.0.
  • הוסרה התלות ב-MaioOB SDK.
  • התמיכה בארכיטקטורה של armv7 הוסרה.
  • עכשיו נדרשת גרסת iOS 12.0 מינימלית.
  • כדי להשתמש עכשיו באפליקציה נדרשת גרסה 10.4.0 ואילך של Google Mobile Ads SDK.

פותח ונבדק בעזרת:

  • גרסה 10.10.0 של Google Mobile Ads SDK.
  • Maio SDK גרסה 2.0.0.

גרסה 1.6.3.1

  • כדי להשתמש עכשיו באפליקציה נדרשת גרסה 10.0.0 ואילך של Google Mobile Ads SDK.

פותח ונבדק בעזרת:

  • Google Mobile Ads SDK גרסה 10.0.0.
  • Maio SDK גרסה 1.6.3.
  • MaioOB SDK גרסה 2.0.0-alpha.

גרסה 1.6.3.0

  • המתאם עודכן לשימוש ב-API של didRewardUser.
  • כדי להשתמש עכשיו באפליקציה נדרשת גרסה 9.8.0 ואילך של Google Mobile Ads SDK.
  • תאימות מאומתת ל-maio SDK בגרסה 1.6.3 ול-maioOB SDK בגרסה 2.0.0-alpha.

פותח ונבדק בעזרת:

  • Google Mobile Ads SDK גרסה 9.12.0.
  • Maio SDK גרסה 1.6.3.
  • MaioOB SDK גרסה 2.0.0-alpha.

גרסה 1.6.2.0

  • תאימות מאומתת ל-maio SDK בגרסה 1.6.2 ול-maioOB SDK בגרסה 2.0.0-alpha.

פותח ונבדק בעזרת:

  • גרסה 9.5.0 של Google Mobile Ads SDK.
  • Maio SDK גרסה 1.6.2.
  • MaioOB SDK גרסה 2.0.0-alpha.

גרסה 1.6.1.0

  • תאימות מאומתת ל-maio SDK בגרסה 1.6.1 ול-maioOB SDK בגרסה 2.0.0-alpha.

פותח ונבדק בעזרת:

  • גרסה 9.2.0 של Google Mobile Ads SDK.
  • Maio SDK גרסה 1.6.1.
  • MaioOB SDK גרסה 2.0.0-alpha.

גרסה 1.6.0.1

  • תאימות מאומתת ל-Google Mobile Ads SDK גרסה 9.0.0.
  • כדי להשתמש בתכונה הזו, צריך Google Mobile Ads SDK בגרסה 9.0.0 ואילך.

פותח ונבדק בעזרת:

  • גרסה 9.0.0 של Google Mobile Ads SDK.
  • Maio SDK גרסה 1.6.0.
  • MaioOB SDK גרסה 2.0.0-alpha.

גרסה 1.6.0.0

  • תאימות מאומתת ל-maio SDK בגרסה 1.6.0 ול-maioOB SDK בגרסה 2.0.0-alpha.

פותח ונבדק בעזרת:

  • Google Mobile Ads SDK גרסה 8.13.0.
  • עכשיו נדרשת גרסת iOS 10.0 מינימלית.
  • Maio SDK גרסה 1.6.0.
  • MaioOB SDK גרסה 2.0.0-alpha.

גרסה 1.5.8.0

  • תאימות מאומתת ל-maio SDK בגרסה 1.5.8 ול-maioOB SDK בגרסה 2.0.0-alpha.
  • נוספה יכולת בידינג במתאם לפורמטים של מודעות מעברון ושל מודעות מתגמלות.
  • תלות רגועה ב-Google Mobile Ads SDK בגרסה 8.0.0 ואילך.

פותח ונבדק בעזרת:

  • Google Mobile Ads SDK גרסה 8.7.0.
  • Maio SDK גרסה 1.5.8.
  • MaioOB SDK גרסה 2.0.0-alpha.

גרסה 1.5.6.1

  • נוספו הודעות וקודי שגיאה של מתאם סטנדרטי.
  • המתאם עודכן לפורמט .xcframework.
  • תוקן באג שגרם לכך שאירועים של מודעות מתגמלות לא הועברו לפעמים.
  • כדי להשתמש בתכונה הזו נדרשת עכשיו Google Mobile Ads SDK גרסה 8.3.0 ואילך.

פותח ונבדק בעזרת:

  • Google Mobile Ads SDK גרסה 8.3.0.
  • Maio SDK גרסה 1.5.6.

גרסה 1.5.6.0

  • תאימות מאומתת ל-maio SDK גרסה 1.5.6.
  • כדי להשתמש עכשיו באפליקציה נדרשת גרסה 7.68.0 ואילך של Google Mobile Ads SDK.

פותח ונבדק בעזרת:

  • Google Mobile Ads SDK גרסה 7.68.0.
  • Maio SDK גרסה 1.5.6.

גרסה 1.5.5.0

  • תאימות מאומתת ל-maio SDK גרסה 1.5.5.
  • כדי להשתמש עכשיו באפליקציה נדרשת גרסה 7.64.0 ואילך של Google Mobile Ads SDK.

פותח ונבדק בעזרת:

  • Google Mobile Ads SDK גרסה 7.64.0.
  • Maio SDK גרסה 1.5.5.

גרסה 1.5.4.0

  • תאימות מאומתת ל-maio SDK בגרסה 1.5.4.
  • כדי להשתמש עכשיו באפליקציה נדרשת גרסה 7.60.0 ואילך של Google Mobile Ads SDK.

פותח ונבדק בעזרת:

  • גרסה 7.60.0 של Google Mobile Ads SDK.
  • Maio SDK גרסה 1.5.4.

גרסה 1.5.3.1

  • כדי להגביל את הזמן הקצוב לתפוגה, בקשות להצגת מודעות ייכשלו באופן מיידי אם אין ל-maio מודעה מוכנה להצגה.
  • התמיכה בארכיטקטורה של i386 הוסרה.

פותח ונבדק בעזרת:

  • Google Mobile Ads SDK גרסה 7.58.0.
  • Maio SDK גרסה 1.5.3.

גרסה 1.5.3.0

  • תאימות מאומתת ל-maio SDK גרסה 1.5.3.

פותח ונבדק בעזרת:

  • גרסה 7.55.1 של Google Mobile Ads SDK.
  • Maio SDK גרסה 1.5.3.

גרסה 1.5.2.1

  • תוקנה בעיה שבה המתאם לא הפעיל את הקריאה החוזרת (callback) של -rewardedAdDidPresent:.

פותח ונבדק בעזרת:

  • Google Mobile Ads SDK גרסה 7.53.1.
  • Maio SDK גרסה 1.5.2.

גרסה 1.5.2.0

  • תאימות מאומתת ל-maio SDK גרסה 1.5.2.

פותח ונבדק בעזרת:

  • Google Mobile Ads SDK גרסה 7.53.1.
  • Maio SDK גרסה 1.5.2.

גרסה 1.5.1.0

  • תאימות מאומתת ל-maio SDK גרסה 1.5.1.

פותח ונבדק בעזרת:

  • Google Mobile Ads SDK גרסה 7.52.0.
  • Maio SDK גרסה 1.5.1.

גרסה 1.5.0.0

  • תאימות מאומתת ל-maio SDK גרסה 1.5.0.

פותח ונבדק עם

  • גרסה 7.51.0 של Google Mobile Ads SDK.
  • Maio Ads SDK גרסה 1.5.0.

גרסה 1.4.8.0

  • תאימות מאומתת ל-maio SDK בגרסה 1.4.8.

גרסה 1.4.6.0

  • תאימות מאומתת ל-maio SDK בגרסה 1.4.6.
  • המתאם עודכן לשימוש בממשק ה-API החדש של מתגמלות.
  • כדי להשתמש עכשיו באפליקציה נדרשת גרסה 7.42.2 ואילך של Google Mobile Ads SDK.

גרסה 1.4.2.0

  • תאימות מאומתת ל-maio SDK גרסה 1.4.2.

גרסה 1.4.1.0

  • תאימות מאומתת ל-maio SDK גרסה 1.4.1.
  • תוקנה בעיה שבה מתאם maio עלול להיכשל אם יסופקו כמה מזהי MediaId מ-AdMob.

גרסה 1.4.0.0

  • תאימות מאומתת ל-maio SDK גרסה 1.4.0.

גרסה 1.3.2.0

  • תאימות מאומתת ל-maio SDK גרסה 1.3.2.

גרסה 1.3.1.1

  • הקריאה החוזרת של adapterDidCompletePlayingRewardBasedVideoAd: נוספה למתאם.

גרסה 1.3.1.0

  • תאימות מאומתת ל-maio SDK גרסה 1.3.1.

גרסה 1.3.0.0

  • תאימות מאומתת ל-maio SDK גרסה 1.3.0.

גרסה 1.2.19.0

  • תאימות מאומתת ל-maio SDK בגרסה 1.2.19.

גרסה 1.2.18.0

  • גרסה ראשונה!
  • הוספנו תמיכה במודעות מעברון ובמודעות וידאו מתגמלות.