במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Meta Audience Network באמצעות תהליך בחירת הרשת (Mediation), שכולל את תכונת הבידינג של Google. הוא מסביר איך להוסיף את Meta Audience Network הגדרת תהליך בחירת הרשת, ואיך לשלב את Meta Audience Network את המתאם לאפליקציה Unity .
השילובים והפורמטים של המודעות שנתמכים
מתאם הגישור של AdMob ל-Meta Audience לרשת יש את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל 1 | |
פורמטים | |
כרזה | |
מעברון | |
ההטבה הופעלה | |
מודעות מעברון מתגמלות |
1 Meta Audience Network (רשת קהלים של Meta) הפך בידינג בלבד בשנת 2021.
דרישות
- ה-SDK העדכני של Google Mobile Ads
- Unity 5.6 ומעלה
- פלאגין בחירת הרשת של Google Mobile Ads עבור 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
שלב 2: הגדרת ביקוש ב-Meta Audience Network AdMob בממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
הוספה Facebook לרשימת שותפי הפרסום בנושא תקנות GDPR ומדינות בארה"ב
פועלים לפי השלבים המפורטים בקטע הגדרות GDPR וגם הגדרות של תקנות במדינות בארה"ב כדי להוסיף את Facebook לרשימת שותפי הפרסום לתקנות GDPR ומדינות בארה"ב בממשק המשתמש AdMob .
שלב 3: מייבאים את ה-SDK והמתאם של Meta Audience Network
OpenUPM-CLI
אם יש לכם את OpenUPM-CLI של Google Mobile Ads, ניתן להתקין את Meta Audience Network הפלאגין של תהליך בחירת הרשת (Mediation) ל-Unity לפרויקט שלך, על ידי הרצת הפקודה הבאה מספריית השורש של הפרויקט:
openupm add com.google.ads.mobile.mediation.metaaudiencenetwork
OpenUPM
בעורך הפרויקט ב-Unity, בוחרים באפשרות Edit (עריכה) > הגדרות פרויקט > Package Manager כדי לפתוח את הגדרות של מנהל החבילות של Unity.
בכרטיסייה Scoped Registries, מוסיפים את OpenUPM כמרשם היקף עם את הפרטים הבאים:
- שם:
OpenUPM
- כתובת אתר:
https://package.openupm.com
- היקפים:
com.google
לאחר מכן עוברים אל חלון > Package Manager כדי לפתוח את Unity Package Manager וגם בוחרים באפשרות My Registries (הרישומים שלי) בתפריט הנפתח.
בוחרים את החבילה Google Mobile Ads Meta Audience Network Mediation לוחצים על התקנה.
חבילת Unity
כדאי להוריד את הגרסה האחרונה של הפלאגין לבחירת רשת (Mediation) של Google Ads לנייד עבור
Meta Audience Network מקישור ההורדה ב-
ה
יומן שינויים
ומחלצים את הקטע
GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage
מהמיקוד
חדש.
בעורך הפרויקט ב-Unity, בוחרים באפשרות Assets (נכסים) > ייבוא חבילה >
Custom Package (חבילה מותאמת אישית) ומוצאים את
GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage
שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על
ייבוא.
בשלב הבא בוחרים באפשרות נכסים > פותר הבעיות של Play Services >
Android resolve > סגירה ידנית. המקודד של Unity Play Services
תבצע רזולוציית תלות מאפס ותעתיק את
יחסי תלות מוצהרים בספרייה Assets/Plugins/Android
של
אפליקציית Unity.
שלב 4: מטמיעים את הגדרות הפרטיות ב-Meta Audience Network SDK
הסכמה באיחוד האירופי ו-GDPR
בכפוף להסכמת משתמשים של Google באיחוד האירופי המדיניות, עליך להבטיח שהודעות גילוי נאות מסוימות יימסרו שמשתמשים באזור הכלכלי האירופי (EEA) הסכימו לשתף בנוגע שימוש במזהי מכשירים ובמידע אישי. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (הדירקטיבה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection (הגנה על מידע כללי) של האיחוד האירופי התקנה (GDPR). כשמבקשים הסכמה, צריך לציין כל רשת מודעות בשרשרת לבחירת רשת שעשויים לאסוף, לקבל או להשתמש במידע אישי מספקים מידע על השימוש בכל רשת. ל-Google אין כרגע אפשרות להעביר את הבחירות של המשתמש בנושא פרטיות לרשתות כאלה באופן אוטומטי.
אפשר לקרוא מידע נוסף על ההנחיות של Meta GDPR ומטא פרסום.
חוקי פרטיות במדינות בארה"ב
ארה"ב חוקי הפרטיות במדינות צריך לתת למשתמשים כדי לבטל את ההצטרפות ל"מבצע" של "המידע האישי" שלהם (כפי שהחוק מגדיר את התנאים האלה), באמצעות ביטול ההסכמה לכך שניתן יהיה ללחוץ על מידע" בדף "מכירה" דף הבית של המסיבה. ארה"ב פרטיות במדינות המדריך לציות לחוקים מאפשר להפעיל עיבוד נתונים מוגבל להצגת מודעות ב-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 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 מתאם רשת כשטעינה של מודעה נכשלה:
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.