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

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

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

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

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

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

דרישות

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

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

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

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

מעברון

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

ההטבה הופעלה

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

בדף Application Management (ניהול אפליקציות), רושמים את מזהה המדיה. הוא נדרש כדי להגדיר את יחידת המודעות שלכם ב-AdMob בקטע הבא.

בדף Zone Management (ניהול אזורים), רושמים את מזהה האזור. תצטרכו אותו גם כדי להגדיר את יחידת המודעות שלכם ב-AdMob בקטע הבא.

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

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

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

צריך להוסיף את maio להגדרת תהליך בחירת הרשת של יחידת המודעות.

קודם כול, נכנסים לחשבון AdMob. לאחר מכן, עוברים לכרטיסייה גישור. אם יש לכם קבוצה קיימת לבחירת רשת שאתם רוצים לשנות, לוחצים על השם של הקבוצה כדי לערוך אותה וממשיכים אל הוספת maio כמקור מודעות.

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

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

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

משייכים את הקבוצה הזו לבחירת רשת (Mediation) לאחת או יותר מיחידות המודעות הקיימות ב-AdMob. לאחר מכן לוחצים על סיום.

עכשיו אמור להופיע כרטיס של יחידות מודעות עם יחידות המודעות שבחרתם:

הוספה של maio כמקור מודעות


בכרטיס Waterfall שבקטע Ad Sources, בוחרים באפשרות Add Ad Source.

בוחרים באפשרות maio ומפעילים את המתג Optimize. מזינים את מזהה ה-API ואת מפתח ה-API שהתקבלו בקטע הקודם כדי להגדיר אופטימיזציה של מקורות תנועה ל-maio. לאחר מכן מזינים ערך של עלות בפועל לאלף חשיפות עבור maio ולוחצים על המשך.



אם כבר יש לכם מיפוי ל-maio, אתם יכולים לבחור אותו. אחרת, לוחצים על הוספת מיפוי.

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


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

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

    pod 'GoogleMobileAdsMediationMaio'

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

    pod install --repo-update

שילוב ידני

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

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

שילוב עם SKAdNetwork

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

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

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

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

בעלי אפליקציות שמשתמשים בגרסה 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 כבר נטענה מודעה להגדרת הרשת הזו.

יומן השינויים של מתאם הגישור של maio ל-iOS

הגרסה הבאה

  • מפעילים את האפשרויות ‎-fobjc-arc ו-‎-fstack-protector-all.

גרסה 2.1.6.1

  • מעכשיו נדרשת גרסה 12.0.0 ואילך של Google Mobile Ads SDK.

נבנה ונבדק באמצעות:

  • גרסה 12.0.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 2.1.6.

גרסה 2.1.6.0

  • תאימות מאומתת לגרסה 2.1.6 של maio SDK.

נבנה ונבדק באמצעות:

  • גרסה 11.13.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 2.1.6.

גרסה 2.1.5.1

  • העדכון של CFBundleShortVersionString כולל שלושה רכיבים במקום ארבעה.

נבנה ונבדק באמצעות:

  • גרסה 11.10.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 2.1.5.

גרסה 2.1.5.0

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

נבנה ונבדק באמצעות:

  • גרסה 11.6.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 2.1.5.

גרסה 2.1.4.0

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

נבנה ונבדק באמצעות:

  • גרסה 11.2.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 2.1.4.

גרסה 2.1.3.0

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

נבנה ונבדק באמצעות:

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

גרסה 2.1.2.1

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

נבנה ונבדק באמצעות:

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

גרסה 2.1.2.0

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

נבנה ונבדק באמצעות:

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

גרסה 2.1.1.0

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

נבנה ונבדק באמצעות:

  • גרסה 10.12.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 2.1.1.

גרסה 2.0.0.0

  • תאימות מאומתת לגרסה 2.0.0 של maio SDK.
  • הוסרה התלות ב-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.

נבנה ונבדק באמצעות:

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

גרסה 1.6.3.0

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

נבנה ונבדק באמצעות:

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

גרסה 1.6.2.0

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

נבנה ונבדק באמצעות:

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

גרסה 1.6.1.0

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

נבנה ונבדק באמצעות:

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

גרסה 1.6.0.1

  • תאימות מאומתת לגרסה 9.0.0 של Google Mobile Ads SDK.
  • מעכשיו נדרשת גרסה 9.0.0 ואילך של Google Mobile Ads SDK.

נבנה ונבדק באמצעות:

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

גרסה 1.6.0.0

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

נבנה ונבדק באמצעות:

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

גרסה 1.5.8.0

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

נבנה ונבדק באמצעות:

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

גרסה 1.5.6.1

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

נבנה ונבדק באמצעות:

  • גרסה 8.3.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 1.5.6.

גרסה 1.5.6.0

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

נבנה ונבדק באמצעות:

  • גרסה 7.68.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 1.5.6.

גרסה 1.5.5.0

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

נבנה ונבדק באמצעות:

  • גרסה 7.64.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 1.5.5.

גרסה 1.5.4.0

  • תאימות מאומתת לגרסה 1.5.4 של maio SDK.
  • מעכשיו נדרשת גרסה 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.

נבנה ונבדק באמצעות:

  • גרסה 7.58.0 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 1.5.3.

גרסה 1.5.3.0

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

נבנה ונבדק באמצעות:

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

גרסה 1.5.2.1

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

נבנה ונבדק באמצעות:

  • גרסה 7.53.1 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 1.5.2.

גרסה 1.5.2.0

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

נבנה ונבדק באמצעות:

  • גרסה 7.53.1 של Google Mobile Ads SDK.
  • גרסת Maio SDK‏ 1.5.2.

גרסה 1.5.1.0

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

נבנה ונבדק באמצעות:

  • גרסה 7.52.0 של Google Mobile Ads SDK.
  • גרסת SDK‏ Maio‏ 1.5.1.

גרסה 1.5.0.0

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

נבנה ונבדק באמצעות

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

גרסה 1.4.8.0

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

גרסה 1.4.6.0

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

גרסה 1.4.2.0

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

גרסה 1.4.1.0

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

גרסה 1.4.0.0

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

גרסה 1.3.2.0

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

גרסה 1.3.1.1

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

גרסה 1.3.1.0

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

גרסה 1.3.0.0

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

גרסה 1.2.19.0

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

גרסה 1.2.18.0

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