שילוב עם Facebook Audience Network עם בידינג

מדריך זה מיועד לבעלי תוכן דיגיטלי שמעוניינים להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מרשת הקהלים של Facebook באמצעות בידינג. הוא כולל שילוב של ה-SDK והמתאם של Facebook Audience Network באפליקציית Unity.

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

המתאם של AdMob לתהליך בחירת הרשת (Mediation) ב-Facebook Audience Network כולל את היכולות הבאות:

שילוב
בידינג
Waterfall
פורמטים
כרזה
מעברון
ההטבה הופעלה
מודעת מעברון מתוגמלת

דרישות

  • Unity מגרסה 5.6 ואילך
  • SDK עדכני של Google Mobile Ads
  • הפלאגין של 'Google Ads למודעות לנייד' ב-Facebook 2.11.0 ואילך
  • כדי לפרוס אותו ב-Android
    • Android API ברמה 16 ומעלה
  • כדי לפרוס אותו ב-iOS
    • יעד הפריסה של iOS 10.0 ואילך
    • לרוב, ה-SDK העדכני של Facebook Audience Network מחייב את הגרסה האחרונה של Xcode.
  • פרויקט פעיל ב-Unity שמוגדר באמצעות Google Mobile Ads SDK. לפרטים נוספים, יש לעיין בתחילת העבודה.

שלב 1: הגדרת Facebook Audience Network

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

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

יצירת נכס ב-Facebook

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

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

מציינים אם האפליקציה פעילה ולוחצים על שליחה.

Android

iOS

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

בוחרים באפשרות Banner לכל גודל הבאנר, כולל בגודל 300x250. Facebook לא תומך בפורמט התצוגה Medium Rectangle בבידינג, אבל הוא תומך בבאנר רוחב גמיש עם גובה 50, 90 או 250 כשמשתמשים בפורמט התצוגה Banner.

אם בכוונתך לשלב את פורמט מודעת מעברון המתגמלת, הפורמט התואם ל-Facebook הוא Rewarded Video.

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

שלב 2: קובעים הגדרות של תהליך בחירת הרשת ביחידת המודעות ב-AdMob

צריך להוסיף את Facebook לתצורה של תהליך בחירת הרשת (Mediation) ביחידת המודעות. קודם כל, נכנסים לחשבון AdMob.

Android

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

כדי ליצור קבוצה חדשה לבחירת רשת (Mediation), בוחרים באפשרות יצירה של קבוצה לבחירת רשת.

מזינים את פורמט המודעה ואת הפלטפורמה שלה ולוחצים על המשך.

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

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

הוספת Facebook Audience Network כמקור מודעות

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

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

iOS

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

כדי ליצור קבוצה חדשה לבחירת רשת (Mediation), בוחרים באפשרות יצירה של קבוצה לבחירת רשת.

מזינים את פורמט המודעה ואת הפלטפורמה שלה ולוחצים על המשך.

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

לשייך את הקבוצה הזו לבחירת רשת אל יחידת המודעות הקיימת ב-AdMob. לאחר מכן לוחצים על סיום.

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

הוספת Facebook Audience Network כמקור מודעות

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

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

שימוש במודעות מתגמלות

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

אם לא מגדירים את ההגדרה הזו, מתאם Facebook מוגדר כברירת מחדל כתגמול מסוג "" (מחרוזת ריקה) עם ערך 1. ה-SDK של Facebook לא מספק ערכי תגמולים ספציפיים למודעות המתגמלות.

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

שלב 3: מייבאים את המתאם והמתאם של Facebook Audience Network

אפשר להוריד את הגרסה האחרונה של הפלאגין של Google Mobile Ads ל-Facebook מקישור ההורדה ב-Changelog ולחלץ את GoogleMobileAdsFacebookMediation.unitypackage מקובץ ה-ZIP

בכלי לעריכת פרויקטים ב-Unity, בוחרים באפשרות Assets > Import Package > Custom Package ומוצאים את קובץ ה-GoogleMobileAdsFacebookMediation.unitypackage שהורדתם. מוודאים שכל הקבצים נבחרו ולוחצים על ייבוא.

לאחר מכן, בוחרים באפשרות PROPERTYs > Play Services Resolution > Android מקודד ו-gt; סוגרים לפי הצורך. הספרייה של Unity Play מקודדת יציאה מניהול התלויה מאפס ומעתיקים את התלות המוצהרות לספרייה Assets/Plugins/Android של אפליקציית Unity.

שלב 4: נדרש קוד נוסף

Android

אין צורך בקוד נוסף לשילוב של Facebook.

iOS

שילוב SKAdNetwork

Facebook מבקשת ממך להוסיף את מזהי SKAdNetwork לקובץ Info.plist של הפרויקט שלך:

<array>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>v9wttpbfk9.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>n38lu8286q.skadnetwork</string>
    </dict>
</array>

מעקב הפרסום הופעל

אם גרסת האפליקציה היא iOS 14 ואילך, יש לעיין בהוראות של Facebook ל-Set the Advertising Tracking Flag.

שלב 5: בודקים את ההטמעה

עיין במדריך להטמעת רשת בדיקת קהל לקבלת הוראות מפורטות להפעלת מודעות בדיקה של Facebook. לאחר מכן תוכלו להשתמש בכלי לבדיקת ההגדרה של תהליך בחירת הרשת (Mediation) כדי לוודא שההטמעה נכונה.

זהו! כעת יש לך שילוב פעיל של תהליך בחירת הרשת ב-Facebook של Audience Network.

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

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

לקבלת מידע נוסף על GDPR ופרסום ב-Facebook, כדאי לעיין בהנחיות של Facebook.

הוספת Facebook לרשימת שותפי המודעות לפי ה-GDPR

יש לפעול לפי השלבים המפורטים בהגדרות של GDPR כדי להוסיף את Facebook לרשימת שותפי המודעות של GDPR בממשק המשתמש של AdMob.

CCPA

חוק הפרטיות לצרכנים בקליפורניה (California Consumer Privacy Act = CCPA) מחייב את תושבי מדינת קליפורניה לשמור על הזכות לסרב ל&ציטוט; מכירה של &מידע;& מידע; המדריך הכנה ל-CCPA מאפשר להפעיל עיבוד נתונים מוגבל לצורך הצגת מודעות ב-Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת לבחירת רשת. לכן, עליך לזהות כל רשת מודעות בשרשרת לבחירת רשת, שיכולה להשתתף במכירת מידע אישי, ולפעול לפי ההנחיות בכל אחת מהרשתות האלה כדי לוודא עמידה בדרישות ה-CCPA.

למשתמשים בקליפורניה, מומלץ לעיין באפשרויות של עיבוד נתונים ב-Facebook.

הוספת Facebook לרשימת שותפי המודעות בהתאם ל-CCPA

יש לפעול לפי השלבים המפורטים בהגדרות של CCPA כדי להוסיף את Facebook לרשימת שותפי המודעות של CCPA בממשק המשתמש של AdMob.

קודי שגיאה

אם המתאם לא מקבל מודעה מרשת Facebook Audience, בעלי אתרים יכולים לבדוק את השגיאה הבסיסית מתגובת המודעה באמצעות ResponseInfo בכיתות הבאות:

Android

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

iOS

GADMAdapterFacebook
GADMediationAdapterFacebook

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

Android

קוד שגיאה סיבה
101 פרמטרים לא חוקיים של השרת (למשל, 'חסר מזהה מיקום').
102 גודל המודעה המבוקש לא תואם לגודל הבאנר הנתמך ב-Facebook Audience Network.
103 בעל התוכן הדיגיטלי חייב לבקש מודעות בהקשר של Activity.
104 ה-SDK של Facebook Audience Network לא הופעל.
105 בעל האפליקציה לא ביקש מודעות מותאמות מאוחדות.
106 המודעה המותאמת שנטען היא אובייקט שונה מזה הצפוי.
107 האובייקט Context אינו חוקי.
108 במודעה שנטענו חסרים הנכסים הנדרשים של המודעות המותאמות.
109 נכשלה היצירה של מודעה מותאמת מהמטען הייעודי (payload) של הצעת המחיר.
110‎ ה-SDK של Facebook Audience Network לא הצליח להציג את מודעת המעברון/התגמול שלו.
111 הייתה חריגה מהכלל בעת יצירת אובייקט Facebook Audience Network AdView.
1000-9999 Facebook Audience Network החזירה שגיאה ספציפית ל-SDK. פרטים נוספים זמינים בתיעוד של Facebook.

iOS

קוד שגיאה סיבה
101 פרמטרים לא חוקיים של השרת (למשל, 'חסר מזהה מיקום').
102 גודל המודעה המבוקש לא תואם לגודל הבאנר הנתמך ב-Facebook Audience Network.
103 אובייקט המודעה של Facebook Audience Network לא הופעל.
104 ה-SDK של Facebook Audience Network לא הצליח להציג את מודעת המעברון/התגמול שלו.
105 בקר התצוגה של מודעת השורש הוא nil.
106 ה-SDK של Facebook Audience Network לא הופעל.
1000-9999 Facebook Audience Network החזירה שגיאה ספציפית ל-SDK. פרטים נוספים זמינים בתיעוד של Facebook.

יומן שינויים בפלאגין של Facebook לתהליך בחירת הרשת (Mediation)

גרסה 3.7.0

גרסה 3.6.1

גרסה 3.6.0

גרסה 3.5.0

גרסה 3.4.0

גרסה 3.3.2

גרסה 3.3.1

גרסה 3.3.0

גרסה 3.2.0

גרסה 3.1.0

גרסה 3.0.0

גרסה 2.12.0

גרסה 2.11.1

גרסה 2.11.0

גרסה 2.10.0

גרסה 2.9.2

גרסה 2.9.1

גרסה 2.9.0

גרסה 2.8.1

גרסה 2.8.0

גרסה 2.7.1 (הוצא משימוש, יש להשתמש בגרסה 2.8.0 ואילך)

גרסה 2.7.0 (הוצאה משימוש, שימוש בגרסה 2.8.0 ואילך)

גרסה 2.6.1 (הוצאה משימוש, שימוש ב-2.8.0 ואילך)

גרסה 2.6.0

גרסה 2.5.1

  • תומך במתאם 5.5.0.0 של Facebook ל-Android.
  • תומך במתאם 5.5.1.0 של Facebook ל-iOS.

גרסה 2.5.0

  • תומך במתאם 5.5.0.0 של Facebook ל-Android.
  • תומך במתאם ל-Facebook של iOS בגרסה 5.5.0.0.

גרסה 2.4.1

  • תומך במתאם ל-Android בגרסה 5.4.1.1.
  • תומך במתאם 5.4.0.0 של Facebook ל-iOS.

גרסה 2.4.0

  • תומך במתאם ל-Android בגרסה 5.4.0.0.
  • תומך במתאם 5.4.0.0 של Facebook ל-iOS.

גרסה 2.3.2

  • תומך במתאם ל-Android בגרסה 5.3.1.2.
  • תומך במתאם ל-iOS 5.3.2.0 של Facebook.

גרסה 2.3.1

  • תומך במתאם ל-Android בגרסה 5.3.1.0.
  • תומך במתאם ל-iOS 5.3.2.0 של Facebook.

גרסה 2.3.0

  • תומך במתאם ל-Android בגרסה 5.3.0.0.
  • תומך בגרסה 5.3.0.0 של מתאם ל-Facebook של Facebook.

גרסה 2.2.0

  • הפלאגין עודכן והוספנו לו תמיכה ב-API בגרסת בטא פתוחה לגרסת בטא.
  • תומך במתאם ל-Android בגרסה 5.2.0.1.
  • תומך במתאם 5.2.0.1 של Facebook ל-Facebook.

גרסה 2.1.1

  • תומך במתאם ל-Android בגרסה 5.1.0.1.
  • תומך במתאם 5.1.0.0 של Facebook ל-iOS.

גרסה 2.1.0

  • תומך במתאם ל-Android בגרסה 5.1.0.0.
  • תומך במתאם 5.1.0.0 של Facebook ל-iOS.

גרסה 2.0.0

  • תמיכה במתאם ל-Android בגרסה 5.0.1.0 של Facebook.
  • תומך במתאם 5.0.1.0 של Facebook ל-iOS.

גרסה 1.2.1

  • תומך במתאם ל-Android בגרסה 4.99.3.0.
  • תומך במתאם ל-Facebook של iOS בגרסה 4.99.3.0.

גרסה 1.2.0

  • תומך במתאם ל-Android בגרסה 4.99.1.1.
  • תומך במתאם ל-Facebook של iOS בגרסה 4.99.2.0.

גרסה 1.1.3

  • תומך במתאם ל-Android בגרסה 4.28.2.1.
  • תומך במתאם ל-Facebook של iOS בגרסה 4.28.1.2.

גרסה 1.1.2

  • תוקן ההתנגשות הפוטנציאלית באמצעות הפלאגין Unity Ads לגישור.

גרסה 1.1.1

  • תומך במתאם ל-Android בגרסה 4.28.2.0.
  • תומך במתאם ל-Facebook של iOS בגרסה 4.28.1.1.

גרסה 1.1.0

  • תמיכה ב-Facebook Android Android SDK בגרסה 4.28.1.
  • תמיכה ב-Facebook iOS SDK בגרסה 4.28.1.

גרסה 1.0.0

  • השקה ראשונה!
  • תמיכה ב-Facebook Android Android SDK בגרסה 4.27.0.
  • תמיכה ב-Facebook iOS SDK בגרסה 4.27.1.