במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-Meta Audience Network באמצעות גישור, כולל שילובים של בידינג. במאמר מוסבר איך להוסיף את Meta Audience Network להגדרת הגישור של יחידת מודעות, ואיך לשלב את Meta Audience Network ואת המתאם באפליקציית Flutter.
שילובים נתמכים ופורמטים נתמכים של מודעות
המתאם של תהליך בחירת הרשת ב-AdMob עבור Meta Audience Network כולל את היכולות הבאות:
שילוב | |
---|---|
בידינג | |
Waterfall 1 | |
פורמטים | |
מודעת באנר | |
מעברון | |
ההטבה הופעלה | |
מודעות מעברון מתגמלות | |
מותאם |
1 Meta Audience Network הפכה לרשת שמציעה רק בידינג בשנת 2021.
דרישות
- הגרסה העדכנית של Google Mobile Ads SDK
- Flutter 3.7.0 ומעלה
- כדי לפרוס ב-Android
- רמת API 23 ואילך ב-Android
- כדי לפרוס ב-iOS
- יעד הפריסה של iOS הוא 10.0 ומעלה
- בדרך כלל, כדי להשתמש בגרסה האחרונה של Meta Audience Network SDK נדרשת הגרסה האחרונה של Xcode.
- פרויקט Flutter פעיל שמוגדר עם Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה עם Service Management API.
- צריך לקרוא את המדריך לתחילת העבודה עם תהליך בחירת הרשת (Mediation).
שלב 1: הגדרת תצורות בממשק המשתמש של Meta Audience Network
נרשמים ונכנסים אל דף ההתחלה של Business Manager.
לוחצים על תחילת העבודה ואז על יצירת חשבון חדש.
ממלאים את שדות החובה עם פרטי העסק ולוחצים על הבא.
יצירת נכס
אחרי שממלאים את הפרטים הנדרשים, מוצגת בקשה ליצור נכס לאפליקציה. מזינים את השם הרצוי של הנכס לאפליקציה ולוחצים על הבא.
בשלב הבא, בוחרים את הפלטפורמה שרוצים להפעיל בה מונטיזציה.
מוסיפים את פרטי האפליקציה ולוחצים על הבא.
Android

iOS

לוחצים על הוספת חשבון תשלומים חדש כדי להגדיר את חשבון התשלומים. תועברו לדף חדש שבו תתבקשו להזין את פרטי התשלום. ממלאים את הפרטים הנדרשים ולוחצים על הבא.
בוחרים באפשרות Google AdMob בתור פלטפורמת הגישור ולוחצים על יצירת מיקום להצגת מודעות.
בוחרים פורמט, ממלאים את הטופס ולוחצים על יצירה.
חשוב לשמור את מזהה המיקום.
לוחצים על סיום.
עדכון של קובץ app-ads.txt
Authorized Sellers for Apps (או app-ads.txt) היא יוזמה של IAB Tech Lab שעוזרת להבטיח שמלאי שטחי הפרסום באפליקציה שלכם יימכר רק דרך ערוצים שציינתם שהם מורשים. כדי למנוע אובדן משמעותי בהכנסות מפרסום, מומלץ להטמיע קובץ app-ads.txt
.
אם עדיין לא עשיתם זאת, הגדירו קובץ app-ads.txt לאפליקציה.
כדי להטמיע app-ads.txt
ב-Meta Audience Network, אפשר לעיין במאמר זיהוי מפיצים מורשים באמצעות קובץ app-ads.txt.
הפעלת מצב בדיקה
במדריך לבדיקת ההטמעה של Audience Network מפורטות הוראות להפעלת מודעות בדיקה ב-Meta Audience Network.
שלב 2: הגדרת ביקוש מ-Meta Audience Network בממשק המשתמש של AdMob
הגדרת הגדרות הגישור ליחידת המודעות
Android
הוראות מפורטות מופיעות בשלב 2 במדריך ל-Android.
iOS
הוראות מפורטות מופיעות בשלב 2 במדריך ל-iOS.
הוספת Meta לרשימת שותפי הפרסום בהתאם ל-GDPR ולתקנות במדינות בארה"ב
כדי להוסיף את Meta לרשימת שותפי הפרסום שמספקים לכם שירותים שקשורים לתקנות האירופאיות ולתקנות במדינות בארה"ב, אתם צריכים לפעול לפי השלבים שמתוארים במאמרים בנושא הגדרות בנושא תקנות אירופאיות והגדרות בנושא תקנות במדינות בארה"ב בממשק המשתמש של AdMob.
שלב 3: ייבוא ה-SDK והמתאם של Meta Audience Network
שילוב דרך pub.dev
מוסיפים את התלות הבאה עם הגרסאות האחרונות של Meta Audience Network SDK ומתאם בקובץ pubspec.yaml
של החבילה:
dependencies:
gma_mediation_meta: ^
שילוב ידני
מורידים את הגרסה העדכנית של הפלאגין לבחירת רשת של 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), בבריטניה ובשווייץ, ולקבל מהם הסכמה לשימוש בקובצי Cookie או באחסון מקומי אחר במקרים שבהם הדבר נדרש על פי חוק, וכן לאיסוף, לשיתוף ולשימוש במידע אישי לצורך התאמה אישית של מודעות. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (ההנחיה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנה הכללית להגנה על מידע, GDPR) של האיחוד האירופי. באחריותך לוודא שהסכמה מועברת לכל מקור מודעות בשרשרת הגישור. Google לא יכולה להעביר את בחירת ההסכמה של המשתמש לרשתות כאלה באופן אוטומטי.
מידע על GDPR ופרסום ב-Meta זמין בהנחיות של Meta.
חוקי פרטיות במדינות בארה"ב
חוקי הפרטיות במדינות בארה"ב מחייבים אתכם לתת למשתמשים את הזכות לבטל את ההסכמה ל"מכירה" של "המידע האישי" שלהם (בהתאם להגדרה המעוגנת בחוק זה). האפשרות לביטול ההסכמה חייבת להיות מוצעת בקישור בולט בדף הבית של הצד המוֹכֵר. בקישור צריך להיות כתוב "אל תמכרו את המידע האישי שלי". במדריך בנושא עמידה בדרישות של חוקי הפרטיות במדינות בארה"ב יש אפשרות להפעיל עיבוד נתונים מוגבל להצגת מודעות של Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת בחירת הרשת (Mediation). לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת (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 (בידינג).
שלבים אופציונליים
שמירה במטמון ב-Android מגרסה 9
Android
החל מ-Android 9 (רמת 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 | האתחול של Meta Audience Network SDK נכשל. |
105 | בעל התוכן הדיגיטלי לא ביקש מודעות מותאמות אחידות. |
106 | המודעה המותאמת שהוטענה היא אובייקט שונה מהאובייקט שהיה צפוי. |
107 | האובייקט Context שבו נעשה שימוש לא תקין. |
108 | במודעה שנטענה חסרים נכסי המודעה המותאמת הנדרשים. |
109 | יצירת מודעה מותאמת מנתוני הבידינג נכשלה. |
110 | ה-SDK של Meta Audience Network לא הצליח להציג את המודעה הביניים או המודעה עם התגמול. |
111 | חריגה שהופעלה במהלך יצירת אובייקט של Meta Audience Network AdView . |
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 | האתחול של Meta Audience Network SDK נכשל. |
1000-9999 | רשת Meta Audience Network החזירה שגיאה ספציפית ל-SDK. פרטים נוספים זמינים במסמכי התיעוד של Meta Audience Network. |
Meta Audience Network Flutter Mediation Adapter Changelog
גרסה 1.4.1
- תמיכה בגרסה 6.20.0.0 של המתאם ל-Android של Meta Audience Network.
- תמיכה ב-Meta Audience Network iOS adapter version 6.20.1.0.
- התוסף נבנה ונבדק באמצעות Google Mobile Ads Flutter Plugin גרסה 6.0.0.
גרסה 1.4.0
- תמיכה בגרסה 6.20.0.0 של המתאם ל-Android של Meta Audience Network.
- תמיכה ב-Meta Audience Network iOS adapter גרסה 6.20.0.0.
- התוסף נבנה ונבדק באמצעות Google Mobile Ads Flutter Plugin גרסה 6.0.0.
גרסה 1.3.0
- תמיכה בגרסה 6.20.0.0 של המתאם ל-Android של Meta Audience Network.
- תמיכה ב-Meta Audience Network iOS adapter version 6.17.1.0.
- התוסף נבנה ונבדק באמצעות Google Mobile Ads Flutter Plugin גרסה 6.0.0.
גרסה 1.2.0
- תמיכה ב-Meta Audience Network Android adapter version 6.19.0.1.
- תמיכה ב-Meta Audience Network iOS adapter version 6.17.0.0.
- התוסף נבנה ונבדק באמצעות Google Mobile Ads Flutter Plugin גרסה 6.0.0.
גרסה 1.1.0
- פלאגין iOS הוא עכשיו מסגרת סטטית.
- תמיכה בגרסה 6.18.0.0 של מתאם Android של Meta Audience Network.
- תמיכה ב-Meta Audience Network iOS adapter version 6.16.0.0.
- התוסף נוצר ונבדק באמצעות גרסה 5.3.1 של Google Mobile Ads Flutter Plugin.
גרסה 1.0.1
- נוספה מחלקת dart כדי לאפשר ניתוח תאימות נכון עם פלטפורמות מארחות
- תמיכה ב-Meta Audience Network Android adapter version 6.17.0.0.
- תמיכה בגרסה 6.15.0.0 של מתאם Meta Audience Network ל-iOS.
- התוסף נבנה ונבדק באמצעות Google Mobile Ads Flutter Plugin גרסה 5.1.0.
גרסה 1.0.0
- זו הגרסה הראשונה.
- תמיכה ב-Meta Audience Network Android adapter version 6.17.0.0.
- תמיכה בגרסה 6.15.0.0 של מתאם Meta Audience Network ל-iOS.
- התוסף נבנה ונבדק באמצעות Google Mobile Ads Flutter Plugin גרסה 5.0.0.