במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Meta Audience Network באמצעות תהליך בחירת הרשת (Mediation), שכולל שילובים של בידינג. נסביר איך להוסיף את Meta Audience Network להגדרת תהליך בחירת הרשת (Mediation) של יחידת מודעות, ואיך לשלב את Meta Audience Network והמתאם שלהם באפליקציה Flutter .
שילובים נתמכים ופורמטים נתמכים של מודעות
המתאם של AdMob תהליך בחירת הרשת עבור Meta Audience Network כולל את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
מפל 1 | |
פורמטים | |
כרזה | |
פרסומת מרווח ביניים | |
ההטבה הופעלה | |
מודעת מעברון מתגמלת |
1 Meta Audience Network הפכה לבידינג בלבד ב-2021.
דרישות
- ה-SDK העדכני של מודעות Google לנייד
- Flutter 3.7.0 ואילך
- כדי לפרוס ב-Android
- Android API ברמת 21 ואילך
- כדי לפרוס ב-iOS
- יעד פריסת iOS של 10.0 ומעלה
- כדי להשתמש בגרסה העדכנית ביותר של Meta Audience Network SDK, נדרשת בדרך כלל הגרסה האחרונה של Xcode.
- פרויקט Flutter עבודה שמוגדר באמצעות Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה.
- השלמת המדריך לתחילת העבודה של תהליך בחירת הרשת (Mediation)
שלב 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
שילוב דרך pub.dev
מוסיפים את יחסי התלות הבאים עם הגרסאות העדכניות שלMeta Audience Network ה-SDK והמתאם בקובץ pubspec.yaml
של החבילה:
dependencies:
gma_mediation_meta: ^1.0.0
שילוב ידני
הורד את הגרסה האחרונה של פלאגין הגישור של Google Mobile Ads עבור 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) של האיחוד האירופי. כשמבקשים הסכמה, צריך לזהות כל רשת מודעות בשרשרת לבחירת הרשת שעשויה לאסוף מידע אישי, לקבל אותו או להשתמש בו, ולספק מידע על השימוש בכל רשת. בשלב זה Google לא יכולה להעביר את בחירת המשתמש לגבי הסכמה לרשתות כאלה באופן אוטומטי.
כדאי לעיין בהנחיות של Meta למידע על GDPR ועל פרסום מטא-נתונים.
חוקי הפרטיות במדינות בארה"ב
חוקי פרטיות במדינות בארה"ב דורשים למשתמשים את הזכות לא להסכים ל'מכירה' של 'המידע האישי' שלהם (כפי שהחוק מגדיר את המונחים האלה). אפשרות ביטול ההסכמה מוצעת באמצעות קישור בולט בשם 'Do Not Sell My Personal Information' (אל תמכרו את המידע האישי שלי) בדף הבית של הצד המוֹכֵר. במדריך לתאימות לחוקי הפרטיות במדינות ארה"ב אפשר להפעיל עיבוד נתונים מוגבל של הצגת המודעות ב-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 במקרים שבהם טעינת מודעה נכשלת:
Android
קוד שגיאה | הסיבה |
---|---|
101 | פרמטרים לא חוקיים של השרת (למשל, חסר מזהה מיקום). |
102 | גודל המודעה המבוקש אינו תואם לגודל מודעת באנר הנתמך על ידי Meta Audience Network. |
103 | בעל האתר חייב לבקש מודעות עם הקשר Activity . |
104 | ההפעלה של 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 | הבקר של תצוגת הבסיס של מודעת הבאנר הוא nil . |
106 | ההפעלה של Meta Audience Network נכשלה. |
1000-9999 | מערכת Meta Audience Network החזירה שגיאה ספציפית ל-SDK. אפשר לקרוא פרטים נוספים במסמכי התיעוד של Meta Audience Network. |
יומן שינויים של מתאם תהליך בחירת הרשת של Meta Audience Network
1.0.1
- נוספה מחלקת חיצים כדי לאפשר ניתוח תקין של התאימות עם פלטפורמות מארחות
- תאימות מאומתת עם מתאם 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.