שילוב של Meta Audience Network בבידינג

בחירת פלטפורמה: Android (בטא) Android iOS Unity Flutter

במדריך הזה מוסבר איך להשתמש ב-GMA Next-Gen SDK כדי לטעון ולהציג מודעות מ-מטא Audience Network באמצעות תהליך בחירת הרשת (Mediation). המדריך כולל הסברים על שילובים של בידינג. המאמר מסביר איך להוסיף את Meta Audience Network להגדרה של תהליך בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK והמתאם של Meta Audience Network באפליקציית Android.

שילובים ופורמטים נתמכים של מודעות

מתאם תהליך הבחירה של רשת מודעות של Meta Audience Network כולל את היכולות הבאות:

‫¹ ‫Meta Audience Network הפכה לפלטפורמה לבידינג בלבד בשנת 2021.
² ‫Meta Audience Network לא תומכת במודעות באנר מותאמות מוטבעות ומעוגנות.

דרישות

• האחרון GMA Next-Gen SDK.

• ביצוע של תהליך בחירת הרשת מדריך לתחילת העבודה

• רמת API‏ 24 ומעלה ב-Android

• גרסה 5.10.0.0 של Meta Audience Network adapter ואילך (מומלץ להשתמש בגרסה העדכנית)

שלב 1: הגדרת התצורות בממשק המשתמש של Meta Audience Network

נרשמים ומתחברים אל דף ההתחלה של Business Manager.

לוחצים על תחילת העבודה ואז על יצירת חשבון חדש.

ממלאים את שדות החובה עם פרטי העסק ולוחצים על הבא.

יצירת נכס

אחרי שממלאים את הפרטים הנדרשים, מוצגת בקשה ליצור נכס לאפליקציה. מזינים את השם הרצוי של הנכס לאפליקציה ולוחצים על הבא.

בשלב הבא, בוחרים את הפלטפורמה למונטיזציה.

מוסיפים את פרטי האפליקציה ולוחצים על הבא.

לוחצים על הוספת חשבון תשלומים חדש כדי להגדיר את חשבון התשלומים. תועברו לדף חדש שבו תצטרכו להזין את פרטי התשלום. ממלאים את הפרטים הנדרשים ולוחצים על הבא.

בוחרים באפשרות Google Ad Manager בתור הפלטפורמה שבה נערך תהליך בחירת הרשת (Mediation), ואז לוחצים על יצירת מיקום.

בוחרים פורמט, ממלאים את הטופס ולוחצים על יצירה.

חשוב לשמור את מזהה מיקום המודעה.

לוחצים על סיום.

עדכון של הקובץ app-ads.txt

‫ Authorized Sellers for Apps (או app-ads.txt) היא יוזמה של IAB Tech Lab שעוזרת להבטיח שמלאי שטחי הפרסום באפליקציה שלכם יימכר רק דרך ערוצים שציינתם שהם מורשים. כדי למנוע אובדן משמעותי בהכנסות מפרסום, מומלץ להטמיע קובץ app-ads.txt. אם עדיין לא עשיתם זאת, צרו קובץ app-ads.txt עבור Ad Manager.

כדי להטמיע app-ads.txt ב-Meta Audience Network, אפשר לעיין במאמר זיהוי מפיצים מורשים באמצעות קובץ app-ads.txt.

הפעלת מצב בדיקה

במדריך לבדיקת ההטמעה של Audience Network מפורטות הוראות להפעלת מודעות בדיקה של Meta Audience Network.

שלב 2: הגדרת הביקוש של Meta Audience Network בממשק המשתמש של Ad Manager

נכנסים לחשבון Ad Manager.

הפעלת שיתוף אותות מאובטח

עוברים אל Admin > Global settings. עוברים לכרטיסייה הגדרות החשבון ב-Ad Exchange, בודקים את ההגדרה שיתוף אותות מאובטח ומפעילים אותה. לוחצים על שמירה.

שיתוף אותות מאובטחים בבקשות להצעות מחיר

עוברים אל Inventory > Secure Signals. בקטע אותות מאובטחים, מחפשים את פייסבוק ומפעילים את המתג הפעלת שילוב אפליקציות.

לוחצים על שמירה.

איך מאפשרים שיתוף אותות מאובטחים בבידינג מבוסס SDK חיצוני

עוברים אל הצגת מודעות > ההגדרות של ערוץ הביקוש. בכרטיסייה הגדרות ברירת מחדל, מפעילים את האפשרות שיתוף אותות מאובטחים עבור בידינג ב-SDK.

לוחצים על שמירה.

הגדרת בידינג ב-Meta

עוברים אל הצגת מודעות > מגישי הצעות מחיר ולוחצים על מעבר לבידינג מבוסס SDK חיצוני.

לוחצים על מגיש הצעות מחיר חדש.

בוחרים באפשרות Meta כמגיש הצעות המחיר.

לוחצים על המשך כדי להפעיל בידינג מבוסס SDK חיצוני עבור מגיש הצעות המחיר הזה.

לוחצים על סיום.

הגדרת מיפוי של יחידות מודעות

עוברים אל הצגת מודעות > מגישי הצעות מחיר ולוחצים על מעבר לבידינג מבוסס SDK חיצוני.

בוחרים את החברה ל-Meta Audience Network.

עוברים לכרטיסייה מיפוי יחידות של מודעות ולוחצים על מיפוי חדש של יחידת מודעות.

בוחרים באפשרות יחידת מודעות ספציפית. בוחרים יחידת מודעות ופורמט, אפליקציה לנייד בתור סוג מלאי שטחי הפרסום, ואפליקציה לנייד. לאחר מכן, מזינים את מזהה המיקום שקיבלתם בקטע הקודם.

אם אתם מגדירים מיפוי של יחידות מודעות עבור מודעת מעברון מתגמלת בממשק המשתמש של Ad Manager, בוחרים בפורמט מתגמלת ומשתמשים במזהה המיקום של מודעת המעברון המתגמלת.

לבסוף, לוחצים על שמירה.

הוספת Meta לרשימת שותפי הפרסום שפועלים בהתאם ל-GDPR ולתקנות במדינות בארה"ב

כדי להוסיף בממשק המשתמש של Ad Manager את Meta לרשימת שותפי הפרסום שפועלים בהתאם לתקנות האירופאיות ולתקנות במדינות בארה"ב, צריך לפעול לפי השלבים שמתוארים במאמרים בנושא הגדרות בנושא תקנות אירופאיות והגדרות בנושא תקנות במדינות בארה"ב.

שלב 3: ייבוא של Meta Audience Network SDK ומתאם

שילוב עם Android Studio (מומלץ)

בקובץ gradle ברמת האפליקציה, מוסיפים את יחסי התלות וההגדרות הבאים של implementation:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:facebook:6.21.0.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:facebook:6.21.0.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

שילוב ידני

• מורידים את הגרסה העדכנית של Meta Audience Network SDK for Android. מחפשים את AudienceNetwork.aar בתיקייה AudienceNetwork/bin, מחלצים אותו ומוסיפים אותו לפרויקט.

• עוברים אל הארטיפקטים של המתאם Meta Audience Network במאגר Maven של Google. בוחרים את הגרסה העדכנית, מורידים את קובץ .aar של המתאם של Meta Audience Network ומוסיפים אותו לפרויקט.

שלב 4: הטמעה של הגדרות פרטיות ב-Meta Audience Network SDK

‫GDPR והסכמה בהתאם ולתקנות האירופאיות

כדי לעמוד בדרישות של מדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, עליכם לחשוף מידע מסוים למשתמשים באזור הכלכלי האירופי (EEA), בבריטניה ובשווייץ, ולקבל מהם הסכמה לשימוש בקובצי Cookie או באחסון מקומי אחר במקרים שבהם הדבר נדרש על פי חוק, וכן לאיסוף, לשיתוף ולשימוש במידע אישי לצורך התאמה אישית של מודעות. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (הדירקטיבה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנות הכלליות להגנה על מידע, GDPR) של האיחוד האירופי. באחריותכם לוודא שההסכמה מועברת לכל מקור מודעות בשרשרת לבחירת רשת. ‫Google לא יכולה להעביר את בחירת ההסכמה של המשתמש לרשתות האלה באופן אוטומטי.

‫Meta לא רשומה ברשימת הספקים הגלובלית (GVL) של IAB Europe. במקום זאת, צריך להשתמש במפרט הטכני של הסכמה נוספת. פרטים נוספים זמינים במאמר בנושא הרכיבים של 'הסכמה נוספת'. מפרט ההסכמה הנוספת פועל בשילוב עם גרסה 2 של Transparency & Consent Framework (‏TCF - מסגרת השקיפות וההסכמה) של IAB Europe. ההגדרה הזו מאפשרת לכם, יחד עם פלטפורמות לניהול הסכמה (CMP) ושותפים, לאסוף ולהעביר אותות הסכמה משלימים לחברות שמופיעות ברשימת ספקי טכנולוגיות הפרסום (ATP) של Google, אבל עדיין לא נכללות ב-GVL של IAB Europe.

פועלים לפי ההנחיות שמפורטות במסמכי התיעוד של מטא בנושא GDPR ופרסום במטא.

דיני פרטיות במדינות בארה"ב

דיני הפרטיות במדינות בארה"ב מחייבים אתכם לתת למשתמשים את הזכות לבטל את ההסכמה ל"מכירה" של "המידע האישי" שלהם (כפי שהמונחים האלה מוגדרים בחוק). האפשרות לביטול ההסכמה חייבת להיות מוצעת בקישור בולט בדף הבית של הצד המוֹכֵר. בקישור צריך להיות כתוב "אין למכור את המידע האישי שלי". במדריך בנושא עמידה בדרישות של דיני הפרטיות במדינות בארה"ב יש אפשרות להפעיל עיבוד נתונים מוגבל בהצגת מודעות של Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת בחירת הרשת. לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא שאתם עומדים בדרישות.

פועלים לפי ההנחיות שמפורטות במסמכי התיעוד של Meta בנוגע לאפשרויות עיבוד הנתונים של משתמשים בקליפורניה.

שלב 5: מוסיפים את הקוד הנדרש

לא נדרש קוד נוסף לשילוב של Meta Audience Network.

שלב 6: בדיקת ההטמעה

הפעלת מודעות בדיקה

חשוב לוודא שרשמתם את מכשיר הבדיקה ב-Ad Manager והפעלתם את מצב הבדיקה בממשק המשתמש של Meta Audience Network.

אימות מודעות בדיקה

כדי לוודא שאתם מקבלים מודעות לבדיקה מ-Meta Audience Network, צריך להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות מקורות המודעות Meta Audience Network (בידינג).

שלבים אופציונליים

מודעות מותאמות

חלק מהנכסים של מודעות מותאמות ברשת הקהלים של Meta לא ממופים אחד לאחד לנכסים של מודעות מותאמות ב-Google. נכסים כאלה מועברים בחזרה לבעל האפליקציה בחבילה באמצעות המתודה getExtras() ב-NativeAd. המתאם תומך בהעברת הנכסים הבאים:

הנה קוד לדוגמה שמראה איך לחלץ את הנכסים האלה:

דוגמה:

val extras = nativeAd.getExtras()
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
  var socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)
  // ...
}

Bundle extras = nativeAd.getExtras();
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
    String socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET);
    // ...
}

שימוש במודעות מותאמות של Meta Audience Network ללא MediaView

פורמט המודעות המותאמות של מטא Audience Network מחייב רינדור של נכס MediaView. אם אתם מתכננים להציג מודעות מותאמות בלי הנכס הזה, הקפידו להשתמש בפורמט המודעה native banner של Meta Audience Network.

כדי להשתמש במודעות באנר מותאמות של Meta Audience Network, צריך לבחור בפורמט Native Banner כשמגדירים את Meta Audience Network. המתאם יטען באופן אוטומטי את פורמט המודעה המותאמת המתאים.

רינדור מודעות

המתאם של Audience Network מחזיר את המודעות המותאמות שלו כאובייקטים של NativeAd. הוא מאכלס את השדות הבאים של NativeAd.

‫¹ המתאם של Meta Audience Network לא מספק גישה ישירה לנכס התמונה הראשי של המודעות המותאמות שלו. במקום זאת, המתאם מאכלס את MediaView בסרטון או בתמונה.

מעקב אחר חשיפות וקליקים

בטבלה הבאה מודגש מתי נרשמות חשיפות וקליקים של מודעות מותאמות על ידי GMA Next-Gen SDK.

ל-Meta Audience Network יש דרישות ספציפיות לעיבוד נכסים כדי שהצגת מודעה תיחשב תקפה, בהתאם לפורמט שבחרתם מודעה מותאמת או באנר מותאם כשהגדרתם את Meta Audience Network.

שמירה במטמון ב-Android מגרסה 9

החל מ-Android 9 (רמת API ‏28), התמיכה בטקסט גלוי מושבתת כברירת מחדל, מה שישפיע על הפונקציונליות של שמירת מדיה במטמון ב-SDK של Meta Audience Network, ועלול להשפיע על חוויית המשתמש ועל ההכנסות מפרסום. כדי לעדכן את הגדרות אבטחת הרשת באפליקציה, צריך לפעול לפי ההוראות במאמרי העזרה של Meta.

קודי שגיאה

אם המתאם לא מצליח לקבל מודעה מ-Audience Network, אפשר לבדוק את השגיאה הבסיסית בתגובה לבקשה להצגת מודעה באמצעות ResponseInfo.getAdSourceResponses() במחלקות הבאות:

com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter

אלה הקודים וההודעות הנלוות שמוחזרים על ידי המתאם של Audience Network כשהטעינה של מודעה נכשלת: