במדריך הזה נסביר איך משתמשים ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Meta Audience Network באמצעות תהליך בחירת הרשת, כולל שילובים של בידינג. במאמר מוסבר איך להוסיף את Meta Audience Network להגדרות בחירת הרשת של יחידת מודעות, ואיך לשלב את Meta Audience Network ואת המתאם שלה באפליקציה Flutter .
השילובים והפורמטים של המודעות הנתמכים
למתאם בחירת הרשת (Mediation) של Meta Audience Network יש את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
Waterfall 1 | |
פורמטים | |
מודעת באנר | |
מעברון | |
ההטבה הופעלה | |
מודעות מעברון מתגמלות |
1 בשנת 2021, הפלטפורמה Meta Audience Network הפכה לפלטפורמה לבידינג בלבד.
דרישות
- ה-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. פרטים נוספים זמינים במאמר תחילת העבודה.
- קוראים את המדריך לתחילת העבודה בנושא תהליך בחירת הרשת (Mediation)
שלב 1: הגדרת ההגדרות בממשק המשתמש של Meta Audience Network
נרשמים ונכנסים לדף ההתחלה של Business Manager.
לוחצים על תחילת העבודה ואז על יצירת חשבון חדש.
ממלאים את פרטי העסק בשדות החובה ולוחצים על הבא.
יצירת נכס
אחרי שממלאים את הפרטים הנדרשים, מופיעה בקשה ליצור נכס לאפליקציה. לשם כך, מזינים את השם הרצוי של הנכס לאפליקציה ולוחצים על Next.
בשלב הבא, בוחרים את הפלטפורמה שבה רוצים לייצר הכנסות.
מוסיפים את פרטי האפליקציה ולוחצים על הבא.
Android
iOS
כדי להגדיר את חשבון התשלומים, לוחצים על הוספת חשבון תשלומים חדש. תופנו לדף חדש שבו תזינו את פרטי התשלום. ממלאים את הפרטים הנדרשים ולוחצים על הבא.
בוחרים ב-Google AdMob בתור פלטפורמת בחירת הרשת ולוחצים על Create placement.
בוחרים פורמט, ממלאים את הטופס ולוחצים על Create.
שימו לב למזהה מיקום המודעה.
לוחצים על סיום.
הפעלת מצב בדיקה
הוראות מפורטות להפעלת מודעות בדיקה ב-Meta Audience Network מפורטות במדריך לבדיקת ההטמעה של Audience Network.
שלב 2: הגדרת ביקוש ב-Meta Audience Network AdMob בממשק המשתמש
קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות
הוספה של 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 לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת לבחירת רשת. לכן צריך לזהות כל רשת מודעות בשרשרת לבחירת רשת שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי להבטיח תאימות.
למשתמשים בקליפורניה, כדאי לעיין באפשרויות של 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
הגרסה הבאה
- נוצר ונבדק באמצעות גרסה 5.2.0 של הפלאגין של Google Mobile Ads Flutter.
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
- הקוד נוצר ונבדק באמצעות הפלאגין של Google Mobile Ads ל-Flutter בגרסה 5.0.0.