במדריך הזה נסביר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Meta Audience Network באמצעות תהליך בחירת הרשת, כולל שילובי בידינג. במאמר מוסבר איך להוסיף את Meta Audience Network להגדרות בחירת הרשת של יחידת מודעות, ואיך לשלב את Meta Audience Network ואת המתאם שלה באפליקציה Flutter .
השילובים והפורמטים של המודעות הנתמכים
למתאם בחירת הרשת (Mediation) של Meta Audience Network יש את היכולות הבאות: AdMob
שילוב | |
---|---|
בידינג | |
Waterfall 1 | |
פורמטים | |
מודעת באנר | |
מעברון | |
ההטבה הופעלה | |
מודעות מעברון מתגמלות |
1 בשנת 2021, הפלטפורמה Meta Audience Network הפכה לפלטפורמה לבידינג בלבד.
דרישות
- הגרסה העדכנית ביותר של Google Mobile Ads SDK
- Flutter מגרסה 3.7.0 ואילך
- לפריסה ב-Android
- Android API ברמה 21 ואילך
- לפריסה ב-iOS
- יעד הפריסה של iOS בגרסה 10.0 ואילך
- בדרך כלל, כדי להשתמש ב-SDK העדכני ביותר של Meta Audience Network צריך את הגרסה העדכנית ביותר של Xcode.
- פרויקט Flutter פעיל שהוגדרה בו Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה.
- קוראים את המדריך לתחילת העבודה בנושא תהליך בחירת הרשת (Mediation)
שלב 1: הגדרת ההגדרות בממשק המשתמש של Meta Audience Network
נרשמים ונכנסים לדף ההתחלה של Business Manager.
לוחצים על תחילת העבודה ואז על יצירת חשבון חדש.
ממלאים את שדות החובה בפרטי העסק ולוחצים על הבא.
יצירת נכס
אחרי שממלאים את הפרטים הנדרשים, מופיעה בקשה ליצור נכס לאפליקציה. מזינים את השם הרצוי לנכס של האפליקציה ולוחצים על הבא.
בשלב הבא, בוחרים את הפלטפורמה שבה רוצים לייצר הכנסות.
מוסיפים את פרטי האפליקציה ולוחצים על הבא.
Android
iOS
כדי להגדיר את חשבון התשלומים, לוחצים על Add a new payment account (הוספת חשבון תשלומים חדש). תועברו לדף חדש שבו תצטרכו להזין את פרטי התשלום. ממלאים את הפרטים הנדרשים ולוחצים על הבא.
בוחרים ב-Google AdMob בתור פלטפורמת בחירת הרשת ולוחצים על Create placement.
בוחרים פורמט, ממלאים את הטופס ולוחצים על Create.
שימו לב למזהה מיקום המודעה.
לוחצים על סיום.
הפעלת מצב בדיקה
הוראות מפורטות להפעלת מודעות בדיקה ב-Meta Audience Network מפורטות במדריך לבדיקת ההטמעה של Audience Network.
שלב 2: מגדירים את הביקוש מ-Meta Audience Network בממשק המשתמש AdMob
הגדרת הגדרות בחירת הרשת ליחידת המודעות
הוספה של Facebook לרשימת שותפי הפרסום בהתאם ל-GDPR ולתקנות במדינות בארה"ב
פועלים לפי השלבים המפורטים בקטע הגדרות GDPR ובקטע הגדרות בנושא תקנות במדינות בארה"ב כדי להוסיף את Meta לרשימת שותפי הפרסום בהתאם ל-GDPR ולתקנות במדינות בארה"ב בממשק המשתמש של AdMob.
שלב 3: מייבאים את ה-SDK ואת המתאם של Meta Audience Network
שילוב דרך pub.dev
מוסיפים את התלות הבאה עם הגרסאות האחרונות של ה-SDK ושל המתאם שלMeta Audience Network בקובץ 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 Regulation (התקנות הכלליות להגנה על מידע, GDPR) של האיחוד האירופי. כשמבקשים הסכמה, צריך לזהות כל רשת פרסום בשרשרת בחירת הרשת (Mediation) שעשויה לאסוף, לקבל או להשתמש במידע אישי, ולספק מידע על השימוש של כל רשת. בשלב זה, Google לא יכולה להעביר באופן אוטומטי את הבחירה של המשתמש לגבי הסכמה לרשתות כאלה.
ההנחיות של Meta מספקות מידע על GDPR ועל הפרסום ב-Meta.
חוקי פרטיות במדינות בארה"ב
חוקי הפרטיות במדינות ארה"ב מחייבים אתכם לתת למשתמשים את הזכות לבטל את ההסכמה למכירת המידע האישי שלהם (בהתאם להגדרה המעוגנת בחוק). האפשרות לבטל את ההסכמה חייבת להיות מוצגת בקישור בולט עם הכיתוב 'אל תמכרו את המידע האישי שלי' בדף הבית של הצד המוֹכֵר. במדריך התאימות לחוקי הפרטיות במדינות ארה"ב מוסבר איך מפעילים עיבוד נתונים מוגבל להצגת מודעות של Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת בחירת הרשת. לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת (Mediation) שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא תאימות.
למשתמשים בקליפורניה, כדאי לעיין באפשרויות של 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
החל מגרסה 9 של Android (רמת API 28), התמיכה בטקסט ללא הצפנה מושבתת כברירת מחדל. הדבר ישפיע על הפונקציונליות של שמירת מדיה במטמון ב-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 | יצירת מודעה מותאמת מתוכן העומס של הצעת המחיר נכשלה. |
110 | ה-SDK של 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 | ה-SDK של Meta Audience Network נכשל בהצגת המודעה המעברית או המודעה עם התמריץ. |
105 | ה-root view controller של מודעת הבאנר הוא nil . |
106 | לא ניתן היה לאתחל את ה-SDK של Meta Audience Network. |
1000-9999 | רשת Meta Audience Network החזירה שגיאה ספציפית ל-SDK. פרטים נוספים זמינים במסמכי התיעוד של Meta Audience Network. |
יומן השינויים של מתאם בחירת הרשת ב-Flutter של Meta Audience Network
הגרסה הבאה
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.2.0.
1.1.0
- תאימות מאומתת עם מתאם Meta Android בגרסה 6.17.0.0
- תאימות מאומתת עם מתאם Meta ל-iOS מגרסה 6.15.2.0
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.1.0.
1.0.1
- נוספה כיתה של Dart כדי לאפשר ניתוח תקין של תאימות לפלטפורמות המארחות
- תאימות מאומתת עם מתאם Meta Android בגרסה 6.17.0.0
- תאימות מאומתת עם מתאם Meta ל-iOS בגרסה 6.15.0.0
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.1.0.
1.0.0
- הגרסה הראשונית.
- תאימות מאומתת עם מתאם Meta Android בגרסה 6.17.0.0
- תאימות מאומתת עם מתאם Meta ל-iOS בגרסה 6.15.0.0
- ה-plugin נוצר ונבדק באמצעות Google Mobile Ads Flutter Plugin בגרסה 5.0.0.