במדריך הזה מוסבר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Meta Audience Network באמצעות תהליך בחירת הרשת (Mediation), שכולל את תכונת הבידינג של Google. הוא מסביר איך להוסיף את Meta Audience Network הגדרת תהליך בחירת הרשת, ואיך לשלב את Meta Audience Network את המתאם לאפליקציה Flutter .
השילובים והפורמטים של המודעות שנתמכים
מתאם הגישור של AdMob ל-Meta Audience לרשת יש את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל 1 | |
פורמטים | |
כרזה | |
מעברון | |
ההטבה הופעלה | |
מודעות מעברון מתגמלות |
1 Meta Audience Network (רשת קהלים של Meta) הפך בידינג בלבד בשנת 2021.
דרישות
- ה-SDK העדכני של Google Mobile Ads
- Flutter 3.7.0 ואילך
- לפריסה ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS מגרסה 10.0 ואילך
- בדרך כלל, ה-SDK העדכני ביותר של Meta Audience Network מחייב את הגרסה העדכנית ביותר של Xcode.
- פרויקט Flutter עבודה שהוגדר באמצעות Google Mobile Ads SDK. צפייה פרטים נוספים זמינים כאן.
- מבצעים את ההוראות שבמדריך לתחילת העבודה.
שלב 1: הגדרת ההגדרות בממשק המשתמש של Meta Audience Network
שלב 2: הגדרת ביקוש ב-Meta Audience Network AdMob בממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
הוספה Facebook לרשימת שותפי הפרסום בנושא תקנות GDPR ומדינות בארה"ב
שלב 3: מייבאים את ה-SDK והמתאם של Meta Audience Network
שילוב באמצעות pub.dev
צריך להוסיף את התלות הבאה בגרסאות האחרונות של
Meta Audience Network ה-SDK והמתאם בחבילה שלך
קובץ pubspec.yaml
:
dependencies:
gma_mediation_meta: ^1.0.0
שילוב ידני
מורידים את הגרסה האחרונה של הפלאגין של Google Mobile Ads לבחירת רשת (Mediation) עבור Meta Audience Network, מנתקים את הקובץ שהורדתם ומוסיפים את תיקיית הפלאגין שחולצה (ואת התוכן שלה) לפרויקט Flutter. לאחר מכן, מוסיפים את הפלאגין לקובץ pubspec.yaml
באמצעות יחסי התלות הבאים:
dependencies:
gma_mediation_meta:
path: path/to/local/package
שלב 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 אפשר לקבל פרטים נוספים. |
יומן שינויים של מתאם תהליך בחירת הרשת (Mediation) ב-Meta Audience Network
1.0.1
- נוספה מחלקת Dart כדי לאפשר ניתוח תאימות נכון עם פלטפורמות מארחות
- תאימות מאומתת למתאם Meta Android בגרסה 6.17.0.0
- תאימות מאומתת למתאם Meta iOS בגרסה 6.15.0.0
- נוצר ונבדק באמצעות גרסה 5.1.0 של פלאגין Google Mobile Ads Flutter.
1.0.0
- גרסה ראשונית.
- תאימות מאומתת למתאם Meta Android בגרסה 6.17.0.0
- תאימות מאומתת למתאם Meta iOS בגרסה 6.15.0.0
- נוצר ונבדק באמצעות גרסה 5.0.0 של הפלאגין של Google Mobile Ads Flutter.