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

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

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

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

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

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

דרישות

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

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

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

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

מעברון

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

ההטבה הופעלה

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

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

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

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

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

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

נכנסים לחשבון Ad Manager.

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

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

אחר כך לוחצים על הלחצן הוספת שותף להגדלת נפח תנועה.

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

בוחרים באפשרות maio בתור רשת המודעות, מזינים שם ייחודי ומפעילים את האפשרות בחירת רשת.

מפעילים את האפשרות איסוף נתונים אוטומטי ומזינים את מזהה ה-API ואת מפתח ה-API שקיבלתם בקטע הקודם.

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

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

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

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

    pod 'GoogleMobileAdsMediationMaio'

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

    pod install --repo-update

שילוב ידני

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

יומן השינויים של מתאם הגישור של 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.
  • גרסת SDK‏ Maio‏ 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.
  • גרסת SDK‏ Maio‏ 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

  • הוספתי את פונקציית ה-callback‏ 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

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