במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Meta Audience Network באמצעות תהליך בחירת הרשת (Mediation), שכולל שילובים של בידינג. נסביר איך להוסיף את Meta Audience Network להגדרת תהליך בחירת הרשת של יחידת מודעות, ואיך לשלב את Meta Audience Network והמתאם שלהם באפליקציית Unity.
שילובים נתמכים ופורמטים נתמכים של מודעות
המתאם של AdMob תהליך בחירת הרשת עבור Meta Audience Network כולל את היכולות הבאות:
| שילוב | |
|---|---|
| בידינג | |
| מפל 1 | |
| פורמטים | |
| כרזה | |
| פרסומת מרווח ביניים | |
| ההטבה הופעלה | |
| מודעת מעברון מתגמלת | |
1 Meta Audience Network הפכה לבידינג בלבד ב-2021.
דרישות
- ה-SDK העדכני של מודעות Google לנייד
- Unity 5.6 ואילך
- הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) עבור Meta Audience Network 2.11.0 (מומלץ להשתמש בגרסה העדכנית ביותר)
- כדי לפרוס ב-Android
- Android API ברמת 21 ואילך
- כדי לפרוס ב-iOS
- יעד פריסת iOS של 10.0 ומעלה
- כדי להשתמש בגרסה העדכנית ביותר של Meta Audience Network SDK, נדרשת בדרך כלל הגרסה האחרונה של Xcode.
- פרויקט Unity עבודה שמוגדר באמצעות Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה.
- השלמת המדריך לתחילת העבודה של תהליך בחירת הרשת (Mediation)
שלב 1: מגדירים הגדרות בממשק המשתמש של Meta Audience Network
נרשמים ומתחברים אל דף הפתיחה של Business Manager.
לוחצים על קדימה, מתחילים ואז על יצירת חשבון חדש.
ממלאים את פרטי העסק בשדות החובה ולוחצים על הבא.
יצירת נכס
אחרי שממלאים את הפרטים הנדרשים, מופיעה הודעה שבה אתם מתבקשים ליצור נכס לאפליקציה. מזינים את שם המאפיין הרצוי לאפליקציה ולוחצים על Next.
בשלב הבא, צריך לבחור את הפלטפורמה שלכם למונטיזציה.
מוסיפים את פרטי האפליקציה ולוחצים על הבא.
Android
iOS
כדי להגדיר את חשבון התשלומים, לוחצים על הוספת חשבון תשלומים חדש. תועברו לדף חדש שבו תצטרכו להזין את פרטי התשלום. ממלאים את הפרטים הנחוצים ולוחצים על Next.
בוחרים באפשרות Google AdMob בתור הפלטפורמה לתהליך בחירת הרשת ולוחצים על יצירת מיקום.
בוחרים פורמט, ממלאים את הטופס ולוחצים על יצירה.
חשוב לשים לב למזהה המיקום.
לוחצים על סיום.
הפעלת מצב בדיקה
לקבלת הוראות מפורטות להפעלת מודעות בדיקה של Meta Audience Network, עיינו במדריך Testing Audience Network הטמעה.
שלב 2: הגדרת 'ביקוש ב-Meta Audience Network' AdMob בממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
הוספה של Facebook לרשימת שותפי הפרסום של תקנות GDPR ותקנות במדינות בארה"ב
פועלים לפי השלבים המפורטים בקטע הגדרות GDPR וגם הגדרות של תקנות במדינות בארה"ב כדי להוסיף את Facebook לרשימת שותפי הפרסום לתקנות GDPR ומדינות בארה"ב בממשק המשתמש AdMob .
שלב 3: מייבאים את ה-SDK והמתאם של Meta Audience Network
צריך להוריד את הגרסה האחרונה של הפלאגין של Google Mobile Ads לתהליך בחירת הרשת עבור Meta
Audience Network מהקישור להורדה ב-Changelog ולחלץ את
GoogleMobileAdsFacebookMediation.unitypackage מקובץ ה-ZIP.
בעורך הפרויקטים ב-Unity, בוחרים באפשרות Assets > Import Package > Custom Package ומוצאים את הקובץ GoogleMobileAdsFacebookMediation.unitypackage שהורדתם. מוודאים שכל הקבצים מסומנים ולוחצים על Import.
בוחרים באפשרות נכסים > Play Services Solutionr > Android Solutionr > אילוץ סגירה.
לאחר מכן, ספריית Unity Play Services Solutionr מבצעת רזולוציה של תלות מההתחלה ומעתיקת את יחסי התלות המוצהרים לספרייה Assets/Plugins/Android של אפליקציית Unity.
שלב 4: מטמיעים את הגדרות הפרטיות ב-Meta Audience Network SDK
הסכמה באיחוד האירופי ו-GDPR
בהתאם למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, עליכם לוודא שהודעות גילוי נאות מסוימות נמסרות למשתמשים באזור הכלכלי האירופי (EEA) בנוגע לשימוש במזהי מכשירים ובמידע אישי, ושהם מקובלים עליכם. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (ההנחיה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנה הכללית להגנה על מידע, GDPR) של האיחוד האירופי. כשמבקשים הסכמה, צריך לזהות כל רשת מודעות בשרשרת לבחירת הרשת שעשויה לאסוף מידע אישי, לקבל אותו או להשתמש בו, ולספק מידע על השימוש בכל רשת. בשלב זה Google לא יכולה להעביר את בחירת המשתמש לגבי הסכמה לרשתות כאלה באופן אוטומטי.
כדאי לעיין בהנחיות של Meta למידע על GDPR ועל פרסום מטא-נתונים.
חוקי הפרטיות במדינות בארה"ב
חוקי פרטיות במדינות בארה"ב דורשים למשתמשים את הזכות לא להסכים ל'מכירה' של 'המידע האישי' שלהם (כפי שהחוק מגדיר את המונחים האלה). אפשרות ביטול ההסכמה מוצעת באמצעות קישור בולט בשם 'Do Not Sell My Personal Information' (אל תמכרו את המידע האישי שלי) בדף הבית של הצד המוֹכֵר. במדריך לתאימות לחוקי הפרטיות במדינות ארה"ב אפשר להפעיל עיבוד נתונים מוגבל של הצגת המודעות ב-Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת לבחירת הרשת. לכן, צריך לזהות כל רשת מודעות בשרשרת לבחירת רשת שעשוית להשתתף במכירה של מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא שהן עומדות בדרישות.
למשתמשים בקליפורניה, יש לעיין באפשרויות עיבוד הנתונים של Meta.
שלב 5: מוסיפים את קוד החובה
Android
לא נדרש קוד נוסף לשילוב של Meta Audience Network.
iOS
שילוב של SKAdNetwork
פועלים לפי חומרי העזר של Meta Audience Network כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist של הפרויקט.
המעקב אחר הפרסום הופעל
אם אתם מפתחים ל-iOS 14 ואילך, עיינו בהוראות של Meta Audience Network כדי להגדיר את סימון מעקב אחר פרסום.
שלב 6: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לרשום את מכשיר הבדיקה ל- AdMob ולהפעיל את מצב הבדיקה ב Meta Audience Network ממשק המשתמש.
אימות מודעות בדיקה
כדי לוודא שמוצגות לך מודעות לבדיקה מ-Meta Audience Network, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות Meta Audience Network (Bidding) מקורות המודעות.
שלבים אופציונליים
שמירה במטמון ב-Android 9
Android
החל מ-Android 9 (רמת API 28), התמיכה ב-cleartext מושבתת כברירת מחדל. זה ישפיע על הפונקציונליות של שמירת מדיה במטמון של Meta Audience Network SDK, ועשוי להשפיע על חוויית המשתמש ועל ההכנסות מפרסום. פועלים לפי המסמכים של Meta כדי לעדכן את הגדרות אבטחת הרשת באפליקציה.
iOS
לא רלוונטי לשילובים ב-iOS.
קודי שגיאה
אם המתאם לא מצליח לקבל מודעה מ-Audience Network, אפשר לבדוק את השגיאה הבסיסית מתגובת המודעה באמצעות ResponseInfo במחלקות הבאות:
Android
com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter
iOS
GADMAdapterFacebook
GADMediationAdapterFacebook
ריכזנו כאן את הקודים וההודעות הנלוות שהתקבלו ממתאם הרשת של Meta Audience במקרים שבהם טעינת מודעה נכשלת:
Android
| קוד שגיאה | סיבה |
|---|---|
| 101 | פרמטרים לא חוקיים של השרת (למשל, חסר מזהה מיקום). |
| 102 | גודל המודעה המבוקש אינו תואם לגודל מודעת באנר הנתמך על ידי Meta Audience Network. |
| 103 | בעל האתר חייב לבקש מודעות עם הקשר Activity. |
| 104 | ההפעלה של Meta Audience Network נכשלה. |
| 105 | בעל האתר לא ביקש מודעות מותאמות אחידות. |
| 106 | המודעה המותאמת שנטענה היא אובייקט שונה מהאובייקט הצפוי. |
| 107 | האובייקט Context שבו נעשה שימוש אינו חוקי. |
| 108 | במודעה שנטענה חסרים הנכסים הנדרשים של המודעה המותאמת. |
| 109 | יצירת מודעה מותאמת ממטען הייעודי (payload) של הצעת המחיר נכשלה. |
| 110 | לא הצלחנו להציג את מודעת המעברון/המתגמלת של Meta Audience Network. |
| 111 | אירעה חריגת אזהרה בעת יצירת אובייקט AdView של Meta Audience Network. |
| 1000-9999 | מערכת Meta Audience Network החזירה שגיאה ספציפית ל-SDK. אפשר לקרוא פרטים נוספים במסמכי התיעוד של Meta Audience Network. |
iOS
| קוד שגיאה | סיבה |
|---|---|
| 101 | פרמטרים לא חוקיים של השרת (למשל, חסר מזהה מיקום). |
| 102 | גודל המודעה המבוקש אינו תואם לגודל מודעת באנר הנתמך על ידי Meta Audience Network. |
| 103 | ההפעלה של אובייקט המודעה Meta Audience Network נכשלה. |
| 104 | לא הצלחנו להציג את מודעת המעברון/המתגמלת של Meta Audience Network. |
| 105 | הבקר של תצוגת הבסיס של מודעת הבאנר הוא nil. |
| 106 | ההפעלה של Meta Audience Network נכשלה. |
| 1000-9999 | מערכת Meta Audience Network החזירה שגיאה ספציפית ל-SDK. אפשר לקרוא פרטים נוספים במסמכי התיעוד של Meta Audience Network. |
יומן שינויים של פלאגין Unity Mediation של Meta Audience Network
גרסה 3.12.0
- יש תמיכה במתאם ל-Android בגרסה 6.17.0.0 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.15.0.0.
- אפליקציית Google Mobile Ads Unity גרסה 9.0.0 נוצרה ונבדקה.
גרסה 3.11.0
- יש תמיכה במתאם ל-Android בגרסה 6.15.0.0 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.14.0.0.
- אפליקציית Google Mobile Ads Unity גרסה 8.5.1 נוצרה ונבדקה.
גרסה 3.10.0
- תוכן המתאם הועבר אל
GoogleMobileAds/Mediation/MetaAudienceNetwork/. - יש תמיכה במתאם ל-Android בגרסה 6.14.0.0 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.12.0.1.
- אפליקציית Google Mobile Ads Unity גרסה 8.1.0 נוצרה ונבדקה.
גרסה 3.9.1
- יש תמיכה במתאם ל-Android בגרסה 6.12.0.0 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.12.0.1.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.4.1.
גרסה 3.9.0
- יש תמיכה במתאם ל-Android בגרסה 6.12.0.0 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.12.0.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.3.0.
גרסה 3.8.0
- שם הפלאגין של תהליך בחירת הרשת ב-Unity השתנה ל-'Meta Audience Network'.
- יש תמיכה במתאם ל-Android בגרסה 6.11.0.1 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.11.1.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.0.2.
גרסה 3.7.0
- יש תמיכה במתאם ל-Android בגרסה 6.10.0.0 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.10.0.0.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.0.0.
גרסה 3.6.1
- יש תמיכה במתאם ל-Android בגרסה 6.8.0.0 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.9.0.1.
- נוצר ונבדק עם פלאגין Google Mobile Ads Unity גרסה 7.0.0.
גרסה 3.6.0
- יש תמיכה במתאם ל-Android בגרסה 6.8.0.0 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.8.0.0.
גרסה 3.5.0
- יש תמיכה במתאם ל-Android בגרסה 6.7.0.0 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.7.0.0.
גרסה 3.4.0
- יש תמיכה במתאם ל-Android בגרסה 6.6.0.0 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.6.0.0.
גרסה 3.3.2
- יש תמיכה במתאם ל-Android בגרסה 6.5.1.1 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.5.1.0.
גרסה 3.3.1
- יש תמיכה במתאם ל-Android בגרסה 6.5.1.0 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.5.1.0.
גרסה 3.3.0
- יש תמיכה במתאם ל-Android בגרסה 6.4.0.0 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.4.1.0.
גרסה 3.2.0
- יש תמיכה במתאם ל-Android בגרסה 6.2.0.1 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.2.1.0.
גרסה 3.1.0
- יש תמיכה במתאם ל-Android בגרסה 6.2.0.0 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.2.0.0.
גרסה 3.0.0
- יש תמיכה במתאם ל-Android בגרסה 6.1.0.0 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.0.0.0.
גרסה 2.12.0
- יש תמיכה במתאם ל-Android בגרסה 5.11.0.0 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 5.10.1.0.
גרסה 2.11.1
- יש תמיכה במתאם ל-Android בגרסה 5.10.1.0 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 5.10.1.0.
גרסה 2.11.0
- יש תמיכה במתאם ל-Android בגרסה 5.10.0.0 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 5.10.0.0.
גרסה 2.10.0
- יש תמיכה במתאם ל-Android בגרסה 5.9.1.0 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 5.9.0.1.
גרסה 2.9.2
- יש תמיכה במתאם ל-Android בגרסה 5.9.0.2 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 5.9.0.1.
גרסה 2.9.1
- יש תמיכה במתאם ל-Android בגרסה 5.9.0.1 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 5.9.0.1.
גרסה 2.9.0
- יש תמיכה במתאם ל-Android בגרסה 5.9.0.0 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 5.9.0.0.
גרסה 2.8.1
- יש תמיכה במתאם ל-Android בגרסה 5.8.0.1 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 5.8.0.2.
גרסה 2.8.0
- יש תמיכה במתאם ל-Android בגרסה 5.8.0.0 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 5.8.0.1.
גרסה 2.7.1 (הוצאה משימוש, יש להשתמש ב-2.8.0 ואילך)
- יש תמיכה במתאם ל-Android בגרסה 5.7.1.0 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 5.7.1.1.
גרסה 2.7.0 (הוצאה משימוש, יש להשתמש ב-2.8.0 ואילך)
- יש תמיכה במתאם ל-Android בגרסה 5.7.0.0 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 5.7.0.0.
גרסה 2.6.1 (הוצאה משימוש, יש להשתמש ב-2.8.0 ואילך)
- יש תמיכה במתאם ל-Android בגרסה 5.6.1.0 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 5.6.1.0.
גרסה
- יש תמיכה במתאם ל-Android בגרסה 5.6.0.0 של Meta Audience Network.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 5.6.0.0.
גרסה 2.5.1
- תמיכה במתאם ל-Facebook בגרסה 5.5.0.0.
- תומך בגרסה 5.5.1.0 של מתאם iOS ל-Facebook.
גרסה
- תמיכה במתאם ל-Facebook בגרסה 5.5.0.0.
- תמיכה בגרסה 5.5.0.0 של מתאם iOS ל-Facebook.
גרסה 2.4.1
- תומך בגרסה 5.4.1.1 של מתאם Android ל-Facebook.
- תמיכה בגרסה 5.4.0.0 של מתאם iOS ל-Facebook.
גרסה
- תומך בגרסה 5.4.0.0 של מתאם Android ל-Facebook.
- תמיכה בגרסה 5.4.0.0 של מתאם iOS ל-Facebook.
גרסה 2.3.2
- תומך בגרסה 5.3.1.2 של מתאם Android ל-Facebook.
- תומך בגרסה 5.3.2.0 של מתאם iOS ל-Facebook.
גרסה 2.3.1
- תומך בגרסה 5.3.1.0 של מתאם Android ל-Facebook.
- תומך בגרסה 5.3.2.0 של מתאם iOS ל-Facebook.
גרסה
- תומך בגרסה 5.3.0.0 של מתאם Android ל-Facebook.
- תומך בגרסה 5.3.0.0 של מתאם iOS ל-Facebook.
גרסה
- הפלאגין עודכן ועכשיו הוא יתמוך ב-API החדש של תוכנית הבטא הפתוחה.
- תומך בגרסה 5.2.0.1 של מתאם Android ל-Facebook.
- תומך בגרסה 5.2.0.1 של מתאם iOS של Facebook.
גרסה 2.1.1
- תומך בגרסה 5.1.0.1 של מתאם Android ל-Facebook.
- תומך בגרסה 5.1.0.0 של מתאם iOS של Facebook.
גרסה
- תומך בגרסה 5.1.0.0 של מתאם Android ל-Facebook.
- תומך בגרסה 5.1.0.0 של מתאם iOS של Facebook.
גרסה
- תומך בגרסה 5.0.1.0 של מתאם Android ל-Facebook.
- תמיכה בגרסה 5.0.1.0 של מתאם iOS ל-Facebook.
גרסה 1.2.1
- תומך בגרסה 4.99.3.0 של מתאם Android ל-Facebook.
- תומך בגרסה 4.99.3.0 של מתאם iOS ל-Facebook.
גרסה 1.2.0
- תומך בגרסה 4.99.1.1 של מתאם Android ל-Facebook.
- תומך בגרסה 4.99.2.0 של מתאם Facebook ל-iOS.
גרסה 1.1.3
- תומך בגרסה 4.28.2.1 של מתאם Android ל-Facebook.
- תומך בגרסה 4.28.1.2 של המתאם ל-Facebook ב-iOS.
גרסה 1.1.2
- תוקנה התנגשות אפשרית עם פלאגין תהליך בחירת הרשת של Unity Ads Unity.
גרסה 1.1.1
- תומך בגרסה 4.28.2.0 של מתאם Android ל-Facebook.
- תומך בגרסה 4.28.1.1 של המתאם ל-Facebook ב-iOS.
גרסה 1.1.0
- תומך בגרסה 4.28.1 של Facebook Android SDK.
- תומך בגרסה 4.28.1 של Facebook iOS SDK.
גרסה 1.0.0
- השקה ראשונה!
- תומך בגרסה 4.27.0 של Facebook Android SDK.
- תומך בגרסה 4.27.1 של Facebook iOS SDK.