במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads Unity Plugin כדי לטעון ולהציג מודעות מ-BidMachine באמצעות תהליך בחירת הרשת (Mediation) ב-AdMob, כולל שילובים של בידינג. המאמר מסביר איך להוסיף את BidMachine להגדרה של תהליך בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK והמתאם של BidMachine באפליקציית Unity.
שילובים ופורמטים נתמכים של מודעות
המתאם של תהליך בחירת הרשת ב-AdMob ל-BidMachine כולל את היכולות הבאות:
| שילוב | |
|---|---|
| בידינג | |
| מפל | 1 |
| פורמטים | |
| מודעות בפתיחת האפליקציה | |
| מודעת באנר | |
| מעברון | |
| מודעה מתגמלת | |
| מודעות מעברון מתגמלות | |
1 השילוב של Waterfall נמצא בגרסת בטא סגורה. כדי לבקש גישה, פנו למנהל החשבון שלכם.
דרישות מוקדמות
לפני שממשיכים, צריך לוודא את הפרטים הבאים:
- הגרסה העדכנית של Google Mobile Ads Unity Plugin.
- Unity Editor בגרסה 2019.4 ואילך.
- כדי לפרוס ב-Android
- Android API ברמה 24 ואילך.
- כדי לפרוס ב-iOS
- יעד פריסה 13.0 ומעלה ב-iOS.
- פרויקט Unity פעיל שמוגדר עם Google Mobile Ads Unity Plugin. פרטים נוספים מופיעים במאמר על תחילת העבודה.
שלב 1: קובעים את ההגדרות בממשק המשתמש של BidMachine
מתחברים למרכז הבקרה של החשבון ב-BidMachine.
יצירת מיקומי מודעות חדשים
עוברים לכרטיסייה Source ובטבלה Sources לוחצים על Edit.
תוצג רשימה של כל מיקומי המודעות שלכם. כדי ליצור מיקום מודעה חדש, לוחצים על הלחצן הוספת מיקום מודעה בתיבת הדו-שיח.
בוחרים באפשרות בידינג בתור סוג מיקום המודעה. ממלאים את הטופס ולוחצים על שמירה.
Android
iOS
לבסוף, שימו לב למזהה מיקום המודעה.
Android
iOS
עדכון של הקובץ app-ads.txt
Authorized Sellers for Apps (או app-ads.txt) היא יוזמה של IAB Tech Lab שעוזרת להבטיח שמלאי שטחי הפרסום באפליקציה שלכם יימכר רק דרך ערוצים שציינתם שהם מורשים. כדי למנוע אובדן משמעותי בהכנסות מפרסום, מומלץ להטמיע קובץ app-ads.txt.
אם עדיין לא עשיתם זאת, הגדירו קובץ app-ads.txt לאפליקציה.
כדי להטמיע את app-ads.txt ב-BidMachine, עוברים לכרטיסייה app-ads.txt ממרכז הבקרה. אחר כך מעתיקים את הרשימה ומוסיפים אותה לקובץ app-ads.txt של האתר.
שלב 2: מגדירים את הביקוש של BidMachine בממשק המשתמש של AdMob
קביעת ההגדרות של תהליך בחירת הרשת ליחידת המודעות
Android
הוראות מפורטות זמינות בשלב 2 במדריך ל-Android.
iOS
הוראות מפורטות מופיעות בשלב 2 במדריך ל-iOS.
הוספת BidMachine לרשימת שותפי הפרסום שפועלים בהתאם ל-GDPR ולתקנות במדינות בארה"ב
כדי להוסיף בממשק המשתמש של AdMob את BidMachine לרשימת שותפי הפרסום שפועלים בהתאם לתקנות האירופאיות ולתקנות במדינות בארה"ב, צריך לפעול לפי השלבים שמתוארים במאמרים בנושא הגדרות בנושא תקנות אירופאיות והגדרות בנושא תקנות במדינות בארה"ב.
שלב 3: מייבאים את ה-SDK והמתאם של BidMachine
OpenUPM-CLI
אם התקנתם את OpenUPM-CLI, אתם יכולים להתקין את הפלאגין של BidMachine לתהליך בחירת הרשת (Mediation) ב-Google Mobile Ads לפרויקט ב-Unity. כדי לעשות את זה, מריצים את הפקודה הבאה מתיקיית השורש של הפרויקט:
openupm add com.google.ads.mobile.mediation.bidmachineOpenUPM
בעורך הפרויקט ב-Unity, בוחרים באפשרות Edit > Project Settings > Package Manager כדי לפתוח את Unity Package Manager Settings.
בכרטיסייה Scoped Registries, מוסיפים את OpenUPM כמרשם מוגדר עם הפרטים הבאים:
- שם:
OpenUPM - כתובת אתר:
https://package.openupm.com - היקף ההרשאות:
com.google
אחר כך עוברים אל Window (חלון) > Package Manager (מנהל החבילות) כדי לפתוח את Unity Package Manager (מנהל החבילות של Unity) ובוחרים באפשרות My Registries (המרשמים שלי) בתפריט הנפתח.
בוחרים את החבילה Google Mobile Ads BidMachine Mediation ולוחצים על Install.
חבילת Unity
מורידים את הגרסה העדכנית של הפלאגין של Google Mobile Ads לתהליך בחירת הרשת עבור BidMachine מהקישור להורדה ביומן השינויים, ומחלצים את הקובץ GoogleMobileAdsBidMachineMediation.unitypackage מקובץ ה-ZIP.
בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets (נכסים) > Import Package (ייבוא חבילה) > Custom Package (חבילה בהתאמה אישית) ומוצאים את הקובץ GoogleMobileAdsBidMachineMediation.unitypackage שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על Import.
אחר כך בוחרים באפשרות Assets (נכסים) > External Dependency Manager (מנהל יחסי תלות חיצוניים) > Android Resolver (מזהה Android) > Force Resolve (זיהוי מאולץ). ספריית External Dependency Manager תפתור את יחסי התלות מאפס ותעתיק את יחסי התלות שהוצהרו לספרייה Assets/Plugins/Android של אפליקציית Unity.
שלב 4: מטמיעים את הגדרות הפרטיות ב-BidMachine SDK
GDPR והסכמה בהתאם ולתקנות האירופאיות
כדי לעמוד בדרישות של מדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, עליכם להציג הודעות גילוי נאות מסוימות למשתמשים שנמצאים באזור הכלכלי האירופי (EEA), בבריטניה ובשוויץ. במקומות שבהם זה נדרש על פי חוק, אתם צריכים גם לקבל את הסכמתם לשימוש בקובצי cookie או באמצעים אחרים לאחסון מקומי. נוסף לכך אתם צריכים לקבל את ההסכמה שלהם לאיסוף ולשיתוף של המידע האישי שלהם ולשימוש בו לצורך התאמה אישית של מודעות. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (הדירקטיבה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנות הכלליות להגנה על מידע, GDPR) של האיחוד האירופי. באחריותכם לוודא שההסכמה מועברת לכל מקור מודעות בשרשרת לבחירת רשת.
פלטפורמת BidMachine קוראת באופן אוטומטי את ההסכמה בהתאם ל-GDPR שמוגדרת על ידי פלטפורמות לניהול הסכמה, כולל UMP SDK. מידע נוסף זמין במדריך של BidMachine בנושא GDPR ל-Android ול-iOS.
דיני פרטיות במדינות בארה"ב
דיני הפרטיות במדינות בארה"ב מחייבים אתכם לתת למשתמשים את הזכות לבטל את ההסכמה ל"מכירה" של "המידע האישי" שלהם (כפי שהמונחים האלה מוגדרים בחוק). האפשרות לביטול ההסכמה חייבת להיות מוצעת בקישור בולט בדף הבית של הצד המוֹכֵר. בקישור צריך להיות כתוב "אין למכור את המידע האישי שלי". במדריך בנושא עמידה בדרישות של דיני הפרטיות במדינות בארה"ב יש אפשרות להפעיל עיבוד נתונים מוגבל בהצגת מודעות Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת לבחירת רשת. לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא שאתם עומדים בדרישות.
פלטפורמת BidMachine קוראת באופן אוטומטי את ההסכמה לפי GPP שמוגדרת על ידי פלטפורמות לניהול הסכמה, כולל UMP SDK. מידע נוסף זמין במדריך של BidMachine בנושא GPP ל-Android ול-iOS.
שלב 5: מוסיפים את הקוד הנדרש
Android
לא נדרש קוד נוסף לשילוב של BidMachine.
iOS
שילוב של SKAdNetwork
פועלים לפי ההוראות במאמרי העזרה של BidMachine בנושא תמיכה ב-SKAdNetwork כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist של הפרויקט.
שלב 6: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לוודא שרשמתם את מכשיר הבדיקה ב-AdMob.
כדי להפעיל את מצב הבדיקה של BidMachine, פועלים לפי ההוראות במסמכי התיעוד של BidMachine ל-Android ול-iOS.
אימות מודעות בדיקה
כדי לוודא שאתם מקבלים מודעות בדיקה מ-BidMachine, הפעילו את האפשרות בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות מקורות המודעות של BidMachine (בידינג).
קודי שגיאה
אם המתאם לא מצליח לקבל מודעה מ-BidMachine, בעלי האפליקציות יכולים לבדוק את השגיאה הבסיסית בתגובה לבקשה להצגת מודעה באמצעות ResponseInfo במחלקות הבאות:
Android
io.bidmachine
com.google.ads.mediation.bidmachine
iOS
GADMediationAdapterBidMachine
אלה הקודים וההודעות הנלוות שמוחזרים על ידי המתאם של BidMachine כשהטעינה של מודעה נכשלת:
Android
| קוד שגיאה | דומיין | סיבה |
|---|---|---|
| 100 | com.google.ads.mediation.bidmachine | התקבל מזהה מיקום מודעה לא תקין או ריק. |
| 101 | com.google.ads.mediation.bidmachine | שגיאה במהלך איסוף האותות: לא נמצאה הגדרה של נתוני אותות. |
| 102 | com.google.ads.mediation.bidmachine | התקבל פורמט מודעה לא תקין במהלך איסוף האותות. |
| 103 | com.google.ads.mediation.bidmachine | לא ניתן למפות את גודל המודעה המבוקש אל bidmachine.BannerSize |
| 104 | com.google.ads.mediation.bidmachine | פג התוקף של בקשה להצגת מודעה שנטענה ב-BidMachine. |
| 105 | com.google.ads.mediation.bidmachine | לא ניתן להציג מודעה במסך מלא. |
| 106 | com.google.ads.mediation.bidmachine | ערכת ה-SDK של BidMachine החזירה קריאה חוזרת (callback) מסוג onAdLoaded() עם נתוני מודעות מסוג null. |
iOS
| קוד שגיאה | דומיין | סיבה |
|---|---|---|
| 101 | com.google.mediation.bidmachine | בהגדרות השרת חסר מזהה בעל אפליקציה שנדרש. |
| 102 | com.google.mediation.bidmachine | הבקשה לאיסוף אותות בידינג נכשלה כי הפרמטרים של הבידינג בזמן אמת (RTB) לא מכילים פורמט מודעה, או שהפורמט שצוין לא נתמך. |
| 103 | com.google.mediation.bidmachine | הגדרת המודעה לא תקינה לטעינת מודעה. |
| 104 | com.google.mediation.bidmachine | ערכת ה-SDK של BidMachine החזירה מודעה שהיא לא מודעת באנר ל-delegate method BidMachineAdProtocol didLoadAd של מודעת הבאנר. לא אמור לקרות אף פעם. |
| 105 | com.google.mediation.bidmachine | המודעה במסך מלא לא מוכנה להצגה. |
| 106 | com.google.mediation.bidmachine | ערכת ה-SDK של Bid Machine החזירה מודעה לא מותאמת ל-method הנציג BidMachineAdProtocol didLoadAd של המודעה המותאמת. לא אמור לקרות אף פעם. |
| 107 | com.google.mediation.bidmachine | טעינת אחד ממקורות התמונות של המודעה המותאמת נכשלה. |
| 108 | com.google.mediation.bidmachine | BidMachine לא תומכת בגודל הזה של מודעות באנר. |
יומן השינויים של הפלאגין של BidMachine לתהליך בחירת הרשת ב-Unity
גרסה 1.5.2
- תמיכה בגרסה 3.8.0.1 של מתאם BidMachine ל-Android.
- תמיכה בגרסה 3.8.1.0 של מתאם BidMachine ל-iOS.
- נבנה ונבדק עם גרסה 11.6.0 של הפלאגין של Google Mobile Ads ל-Unity.
גרסה 1.5.1
- תמיכה בגרסה 3.8.0.1 של מתאם BidMachine ל-Android.
- תמיכה בגרסה 3.8.0.0 של מתאם BidMachine ל-iOS.
- נבנה ונבדק עם גרסה 11.5.0 של הפלאגין של Google Mobile Ads ל-Unity.
גרסה 1.5.0
- תמיכה בגרסה 3.8.0.0 של מתאם BidMachine ל-Android.
- תמיכה בגרסה 3.8.0.0 של מתאם BidMachine ל-iOS.
- נבנה ונבדק עם גרסה 11.5.0 של הפלאגין של Google Mobile Ads ל-Unity.
גרסה 1.4.2
- תמיכה בגרסה 3.7.1.1 של מתאם BidMachine ל-Android.
- תמיכה בגרסה 3.7.1.0.1 של מתאם BidMachine ל-iOS.
- נבנה ונבדק עם גרסה 11.1.0 של הפלאגין של Google Mobile Ads ל-Unity.
גרסה 1.4.1
- תמיכה בגרסה 3.7.0.0 של מתאם BidMachine ל-Android.
- תמיכה בגרסה 3.7.1.0 של המתאם של BidMachine ל-iOS.
- נבנה ונבדק עם גרסה 11.1.0 של הפלאגין של Google Mobile Ads ל-Unity.
גרסה 1.4.0
- תמיכה בגרסה 3.7.0.0 של מתאם BidMachine ל-Android.
- תמיכה בגרסה 3.7.0.0 של מתאם BidMachine ל-iOS.
- נבנה ונבדק עם גרסה 11.1.0 של הפלאגין של Google Mobile Ads ל-Unity.
גרסה 1.3.0
- תמיכה בגרסה 3.7.0.0 של מתאם BidMachine ל-Android.
- תמיכה בגרסה 3.6.1.1 של מתאם BidMachine ל-iOS.
- נבנה ונבדק עם גרסה 11.1.0 של הפלאגין של Google Mobile Ads ל-Unity.
גרסה 1.2.1
- תמיכה בגרסה 3.6.1.0 של מתאם BidMachine ל-Android.
- תמיכה בגרסה 3.6.1.0 של מתאם BidMachine ל-iOS.
- נבנה ונבדק עם גרסה 11.0.0 של הפלאגין של Google Mobile Ads ל-Unity.
גרסה 1.2.0
- תמיכה בגרסה 3.6.1.0 של מתאם BidMachine ל-Android.
- תמיכה בגרסה 3.6.0.0 של מתאם BidMachine ל-iOS.
- נבנה ונבדק עם גרסה 11.0.0 של הפלאגין של Google Mobile Ads ל-Unity.
גרסה 1.1.0
- תמיכה בגרסה 3.5.1.2 של מתאם BidMachine ל-Android.
- תמיכה בגרסה 3.6.0.0 של מתאם BidMachine ל-iOS.
- נבנה ונבדק עם גרסה 11.0.0 של הפלאגין של Google Mobile Ads ל-Unity.
גרסה 1.0.2
- תמיכה בגרסה 3.5.1.2 של מתאם BidMachine ל-Android.
- תמיכה בגרסה 3.5.1.2 של מתאם BidMachine ל-iOS.
- נבנה ונבדק עם גרסה 11.0.0 של הפלאגין של Google Mobile Ads ל-Unity.
גרסה 1.0.1
- תמיכה בגרסה 3.5.1.1 של מתאם BidMachine ל-Android.
- תמיכה בגרסה 3.5.1.0 של מתאם BidMachine ל-iOS.
- נבנה ונבדק עם גרסה 10.7.0 של הפלאגין של Google Mobile Ads ל-Unity.
גרסה 1.0.0
- זו הגרסה הראשונה.
- תמיכה בגרסה 3.5.1.0 של מתאם BidMachine ל-Android.
- תמיכה בגרסה 3.5.1.0 של מתאם BidMachine ל-iOS.
- נבנה ונבדק עם גרסה 10.6.0 של הפלאגין של Google Mobile Ads ל-Unity.