במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Meta Audience Network באמצעות תהליך בחירת הרשת (Mediation), שכולל שילובים של בידינג. במאמר הזה נסביר איך מוסיפים את Meta Audience Network להגדרה של תהליך בחירת הרשת (Mediation) של יחידת מודעות, ואיך לשלב את Meta Audience Network ואת המתאם באפליקציה Unity .
השילובים והפורמטים של המודעות שנתמכים
AdMob מתאם הגישור עבור Meta Audience Network כולל את היכולות הבאות:
| שילוב | |
|---|---|
| בידינג | |
| Waterfall 1 | |
| פורמטים | |
| כרזה | |
| פרסומת מרווח ביניים | |
| ההטבה הופעלה | |
| מודעות מעברון מתגמלות | |
1 ב-2021 Meta Audience Network עברה לבידינג בלבד.
דרישות
- ה-SDK העדכני של Google Mobile Ads
- Unity 5.6 ומעלה
- הפלאגין של Google Mobile Ads לתהליך בחירת הרשת (Mediation) ל-Meta Audience Network 2.11.0 (מומלץ להשתמש בגרסה העדכנית)
- לפריסה ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 10.0 ואילך
- בדרך כלל, כדי להשתמש ב-SDK העדכני ביותר של Meta Audience Network צריך להשתמש בגרסה האחרונה של Xcode.
- פרויקט Unity פעיל שהוגדר באמצעות Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה.
- מבצעים את ההוראות שבמדריך לתחילת העבודה.
שלב 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 לנייד עבור Meta
Audience Network, מקישור ההורדה ב-Changelog ומחלצים את GoogleMobileAdsFacebookMediation.unitypackage מקובץ ה-ZIP.
בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets > Import Package >
Custom Package (חבילה מותאמת אישית) ומוצאים את הקובץ GoogleMobileAdsFacebookMediation.unitypackage שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על Import.
בוחרים באפשרות נכסים > המקודד של שירותי Play > Android resolver > אילוץ פתרון.
לאחר מכן, ספריית Unity Play Services resolver מבצעת רזולוציית תלות מאפס ומעתיקה את יחסי התלות המוצהרים לספרייה Assets/Plugins/Android באפליקציה Unity.
שלב 4: מטמיעים את הגדרות הפרטיות ב-Meta Audience Network SDK
הסכמה באיחוד האירופי ו-GDPR
בהתאם למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, אתם חייבים לוודא שהודעות גילוי נאות מסוימות נשלחות למשתמשים באזור הכלכלי האירופי (EEA) ושהסכמתם לקבל מהם הסכמה בנוגע לשימוש במזהי מכשירים ובמידע אישי. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (הדירקטיבה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנה הכללית להגנה על מידע, GDPR) של האיחוד האירופי. כשמבקשים הסכמה, צריך לציין כל רשת מודעות בשרשרת לבחירת רשת שיכולה לאסוף מידע אישי, לקבל אותו או להשתמש בו, ולספק מידע על השימוש בכל רשת. בשלב הזה, Google לא יכולה להעביר לרשתות כאלה באופן אוטומטי את הבחירות של המשתמשים בנושא פרטיות.
למידע נוסף על GDPR ועל פרסום במטא-נתונים, יש לעיין בהנחיות של Meta.
חוקי פרטיות במדינות בארה"ב
חוקי פרטיות במדינות בארה"ב מחייבים לתת למשתמשים את הזכות לבטל את ההסכמה ל"מכירה" של "המידע האישי" שלהם (כפי שהחוק מגדיר את התנאים האלה). אפשרות ביטול ההסכמה מוצעת בקישור בולט בדף הבית של הצד המוכר. המדריך לציות לחוקי הפרטיות במדינות בארה"ב מאפשר להפעיל עיבוד נתונים מוגבל לצורך הצגת מודעות ב-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 Network כשמודעה לא נטענת:
Android
| קוד שגיאה | הסיבה |
|---|---|
| 101 | פרמטרים לא חוקיים של שרת (למשל, חסר מזהה מיקום). |
| 102 | גודל המודעה המבוקש לא תואם לגודל הבאנר שנתמך ב-Meta Audience Network. |
| 103 | בעל האפליקציה חייב לבקש מודעות עם הקשר Activity. |
| 104 | אתחול ה-SDK של 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 | בקר התצוגה הבסיסית (root) של מודעת הבאנר הוא nil. |
| 106 | אתחול ה-SDK של Meta Audience Network נכשל. |
| 1000-9999 | מערכת Meta Audience Network החזירה שגיאה ספציפית ל-SDK. פרטים נוספים זמינים במסמכי התיעוד של Meta Audience Network. |
יומן שינויים בפלאגין של Meta Audience Network בפלאגין לתהליך בחירת הרשת (Mediation) של Meta Audience Network
גרסה 3.12.1
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 6.17.0.0.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.15.1.0.
- נוצר ונבדק באמצעות גרסה 9.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.12.0
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 6.17.0.0.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.15.0.0.
- נוצר ונבדק באמצעות גרסה 9.0.0 של פלאגין Google Mobile Ads Unity.
גרסה 3.11.0
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 6.15.0.0.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.14.0.0.
- נוצר ונבדק באמצעות גרסה 8.5.1 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.10.0
- תוכן המתאם הועבר אל
GoogleMobileAds/Mediation/MetaAudienceNetwork/. - יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 6.14.0.0.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.12.0.1.
- נוצר ונבדק באמצעות גרסה 8.1.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.9.1
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 6.12.0.0.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.12.0.1.
- נוצר ונבדק באמצעות גרסה 7.4.1 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.9.0
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 6.12.0.0.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.12.0.0.
- נוצר ונבדק באמצעות גרסה 7.3.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.8.0
- שם הפלאגין של תהליך בחירת הרשת ב-Unity ממותג מחדש ל-Meta Audience Network.
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 6.11.0.1.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.11.1.0.
- נוצר ונבדק באמצעות גרסה 7.0.2 של פלאגין Google Mobile Ads Unity.
גרסה 3.7.0
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 6.10.0.0.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.10.0.0.
- נוצר ונבדק באמצעות גרסה 7.0.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.6.1
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 6.8.0.0.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.9.0.1.
- נוצר ונבדק באמצעות גרסה 7.0.0 של פלאגין Unity של המודעות לנייד של Google.
גרסה 3.6.0
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 6.8.0.0.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.8.0.0.
גרסה 3.5.0
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 6.7.0.0.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.7.0.0.
גרסה 3.4.0
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 6.6.0.0.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.6.0.0.
גרסה 3.3.2
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 6.5.1.1.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.5.1.0.
גרסה 3.3.1
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 6.5.1.0.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.5.1.0.
גרסה 3.3.0
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 6.4.0.0.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.4.1.0.
גרסה 3.2.0
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 6.2.0.1.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.2.1.0.
גרסה 3.1.0
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 6.2.0.0.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.2.0.0.
גרסה 3.0.0
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 6.1.0.0.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 6.0.0.0.
גרסה 2.12.0
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 5.11.0.0.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 5.10.1.0.
גרסה 2.11.1
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 5.10.1.0.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 5.10.1.0.
גרסה 2.11.0
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 5.10.0.0.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 5.10.0.0.
גרסה 2.10.0
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 5.9.1.0.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 5.9.0.1.
גרסה 2.9.2
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 5.9.0.2.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 5.9.0.1.
גרסה 2.9.1
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 5.9.0.1.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 5.9.0.1.
גרסה 2.9.0
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 5.9.0.0.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 5.9.0.0.
גרסה 2.8.1
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 5.8.0.1.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 5.8.0.2.
גרסה 2.8.0
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 5.8.0.0.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 5.8.0.1.
גרסה 2.7.1 (הוצאה משימוש, שימוש בגרסה 2.8.0 ואילך)
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 5.7.1.0.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 5.7.1.1.
גרסה 2.7.0 (הוצאה משימוש, שימוש בגרסה 2.8.0 ואילך)
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 5.7.0.0.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 5.7.0.0.
גרסה 2.6.1 (הוצאה משימוש, שימוש בגרסה 2.8.0 ואילך)
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 5.6.1.0.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 5.6.1.0.
גרסה 2.6.0
- יש תמיכה במתאם ל-Android של Meta Audience Network בגרסה 5.6.0.0.
- יש תמיכה במתאם ל-iOS של Meta Audience Network בגרסה 5.6.0.0.
גרסה 2.5.1
- תומך בגרסה 5.5.0.0 של מתאם ל-Android ל-Facebook.
- יש תמיכה בגרסה 5.5.1.0 של מתאם ל-iOS של Facebook.
גרסה 2.5.0
- תומך בגרסה 5.5.0.0 של מתאם ל-Android ל-Facebook.
- יש תמיכה בגרסה 5.5.0.0 של מתאם ל-iOS של Facebook.
גרסה 2.4.1
- תומך בגרסה 5.4.1.1 של מתאם ל-Android ל-Facebook.
- יש תמיכה בגרסה 5.4.0.0 של מתאם ל-iOS של Facebook.
גרסה 2.4.0
- תומך בגרסה 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.
גרסה 2.3.0
- תומך בגרסה 5.3.0.0 של מתאם ל-Android ל-Facebook.
- יש תמיכה בגרסה 5.3.0.0 של מתאם ל-iOS של Facebook.
גרסה 2.2.0
- הפלאגין עודכן כך שיתמוך בממשק ה-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.
גרסה 2.1.0
- תומך בגרסה 5.1.0.0 של מתאם ל-Android ל-Facebook.
- יש תמיכה בגרסה 5.1.0.0 של מתאם ל-iOS של Facebook.
גרסה 2.0.0
- תומך בגרסה 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 של מתאם ל-iOS של Facebook.
גרסה 1.1.3
- תומך בגרסה 4.28.2.1 של מתאם Facebook ל-Android.
- תומך בגרסה 4.28.1.2 של מתאם ל-iOS של Facebook.
גרסה 1.1.2
- תוקנה התנגשות אפשרית עם הפלאגין לבחירת רשת ב-Unity Ads של Unity.
גרסה 1.1.1
- תומך בגרסה 4.28.2.0 של מתאם ל-Android ל-Facebook.
- תומך בגרסה 4.28.1.1 של מתאם ל-iOS של Facebook.
גרסה 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.