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

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

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

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

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

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

דרישות

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

• הגרסה העדכנית ביותר של Google Mobile Ads SDK

• מדריך לתחילת העבודה בנושא בחירת הרשת

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

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

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

מעברון

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

הערה: כברירת מחדל, אפשר לדלג על מודעות מעברון מ-Maio.

ההטבה הופעלה

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

הערה: כברירת מחדל, אי אפשר לדלג על מודעות וידאו מתגמלות מ-Maio.

בדף Application Management, מציינים את Media ID. בשלב הבא תצטרכו להגדיר את יחידת המודעות ב-Ad Manager.

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

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

הערה: (Waterfall בלבד) אם זו הפעם הראשונה שאתם מגדירים את חשבון maio, יכול להיות שתצטרכו ליצור קשר עם צוות התמיכה של maio כדי לקבל את מזהה ה-API ומפתח ה-API.

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

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

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

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

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

לאחר מכן, לוחצים על הלחצן Add yield partner (הוספת שותף להגדלת התשואה).

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

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

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

אחרי שבוחרים את שותף ה-Yield, בוחרים באפשרות Mobile SDK Mediation בתור סוג השילוב, באפשרות iOS בתור פלטפורמה ובאפשרות Active בתור סטטוס. מזינים את Media ID ואת Zone ID שהתקבלו בקטע הקודם. לאחר מכן, מזינים ערך Default CPM.

חשוב: מזהה המדיה צריך להיות משויך לאפליקציה המטורגטת, כמו בממשק המשתמש של MAIO.

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

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

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

הערה: אי-שילוב של הגרסאות התואמות של MAI ו-Google Mobile Ads SDK עלול להוביל לבעיות ב-build.

שימוש ב-CocoaPods (מומלץ)

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

חשוב: לפני השקת האפליקציה, צריך להשבית את מצב הבדיקה ב-Ad Manager וב-maio.

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

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

קודי שגיאה

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

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

אלה הקודים וההודעות הנלוות שמתקבלים מהמתאם של Maio כשהטעינה של מודעה נכשלת:

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

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

גרסה 2.1.5.1

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

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

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

גרסה 2.1.5.0

• תאימות מאומתת עם גרסת SDK של maio‏ 2.1.5.

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

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

גרסה 2.1.4.0

• תאימות מאומתת עם גרסת SDK של maio‏ 2.1.4.

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

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

גרסה 2.1.3.0

• תאימות מאומתת עם גרסת SDK של maio‏ 2.1.3.

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

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

גרסה 2.1.2.1

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

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

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

גרסה 2.1.2.0

• תאימות מאומתת עם גרסת SDK של maio‏ 2.1.2.

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

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

גרסה 2.1.1.0

• תאימות מאומתת עם גרסת SDK של maio‏ 2.1.1.

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

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

גרסה 2.0.0.0

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

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

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

גרסה 1.6.3.1

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

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

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

גרסה 1.6.3.0

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

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

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

גרסה 1.6.2.0

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

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

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

גרסה 1.6.1.0

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

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

• Google Mobile Ads SDK בגרסה 9.2.0.
• גרסת SDK של Maio‏ 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.

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

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

גרסה 1.6.0.0

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

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

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

גרסה 1.5.8.0

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

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

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

גרסה 1.5.6.1

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

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

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

גרסה 1.5.6.0

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

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

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

גרסה 1.5.5.0

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

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

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

גרסה 1.5.4.0

• תאימות מאומתת עם גרסת SDK של maio‏ 1.5.4.
• מעכשיו נדרשת גרסה 7.60.0 ואילך של Google Mobile Ads SDK.

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

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

גרסה 1.5.3.1

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

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

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

גרסה 1.5.3.0

• תאימות מאומתת עם גרסת SDK של maio‏ 1.5.3.

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

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

גרסה 1.5.2.1

• תוקנה בעיה שבה המתאם לא הפעיל את פונקציית ה-callback‏ -rewardedAdDidPresent:.

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

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

גרסה 1.5.2.0

• תאימות מאומתת עם גרסת SDK של maio‏ 1.5.2.

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

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

גרסה 1.5.1.0

• תאימות מאומתת עם גרסת SDK של maio‏ 1.5.1.

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

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

גרסה 1.5.0.0

• תאימות מאומתת עם גרסת SDK של maio‏ 1.5.0.

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

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

גרסה 1.4.8.0

• תאימות מאומתת עם גרסת SDK של maio‏ 1.4.8.

גרסה 1.4.6.0

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

גרסה 1.4.2.0

• תאימות מאומתת עם גרסת SDK של maio‏ 1.4.2.

גרסה 1.4.1.0

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

גרסה 1.4.0.0

• תאימות מאומתת עם גרסת SDK של maio‏ 1.4.0.

גרסה 1.3.2.0

• תאימות מאומתת עם גרסת SDK של maio‏ 1.3.2.

גרסה 1.3.1.1

• הוספנו קריאה חוזרת (callback) מסוג adapterDidCompletePlayingRewardBasedVideoAd: למתאם.

גרסה 1.3.1.0

• תאימות מאומתת עם גרסת SDK של maio‏ 1.3.1.

גרסה 1.3.0.0

• תאימות מאומתת עם גרסת SDK של maio‏ 1.3.0.

גרסה 1.2.19.0

• תאימות מאומתת עם גרסת SDK של maio‏ 1.2.19.

גרסה 1.2.18.0

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