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

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

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

למתאם בחירת הרשת (Mediation) של Meta Audience Network יש את היכולות הבאות:

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

1 בשנת 2021 התחלנו להשתמש ב-Meta Audience Network בבידינג בלבד.

דרישות

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

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

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

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

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

יצירת נכס

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

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

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

Android

iOS

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

בוחרים ב-Google AdMob בתור פלטפורמת בחירת הרשת ולוחצים על Create placement.

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

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

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

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

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

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

קביעת הגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות

Android

לקבלת הוראות, עיינו בשלב 2 במדריך עבור Android.

iOS

לקבלת הוראות, עיינו בשלב 2 במדריך iOS.

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

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

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

OpenUPM-CLI

אם התקנתם את OpenUPM-CLI, תוכלו להתקין את הפלאגין של Google Mobile Ads לבחירת רשת (Mediation) ב-Meta Audience Network ל-Unity בפרויקט שלכם. לשם כך, מריצים את הפקודה הבאה מהספרייה ברמה הבסיסית (root) של הפרויקט:

openupm add com.google.ads.mobile.mediation.metaaudiencenetwork

OpenUPM

בעורך הפרויקט ב-Unity, בוחרים באפשרות Edit (עריכה) > Project Settings (הגדרות הפרויקט) > Package Manager (מנהל החבילות) כדי לפתוח את הגדרות מנהל החבילות של Unity.

בכרטיסייה Scoped Registries, מוסיפים את OpenUPM כמאגר ברמת ההיקף עם הפרטים הבאים:

  • שם: OpenUPM
  • כתובת אתר: https://package.openupm.com
  • היקפים: com.google

פרטי OpenUPM

לאחר מכן, עוברים אל Window‏ > Package Manager כדי לפתוח את Unity Package Manager ובוחרים באפשרות My Registries בתפריט הנפתח.

Unity Registries

בוחרים בחבילה Google Mobile Ads Meta Audience Network Mediation ולוחצים על Install.

התקנה מ-OpenUPM

חבילת Unity

מורידים את הגרסה העדכנית של הפלאגין לבחירת רשת (Mediation) של Google Mobile Ads עבור Meta Audience Network מקישור ההורדה ביומן שינויים ומחלצים את GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage מקובץ ה-ZIP.

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

ייבוא מ-Unity

לאחר מכן בוחרים באפשרות Assets‏ > External Dependency Manager‏ > Android Resolver‏ > Force Resolve. ספריית 'מנהל התלות החיצונית' תבצע את רזולוציית התלות מאפס ותעתיק את יחסי התלות המוצהרים לספרייה Assets/Plugins/Android באפליקציה Unity.

אילוץ פתרון

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

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

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

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

חוקי הפרטיות במדינות ארה"ב מחייבים אתכם לתת למשתמשים את הזכות לבטל את ההסכמה למכירת המידע האישי שלהם (בהתאם להגדרה המעוגנת בחוק). האפשרות לבטל את ההסכמה חייבת להיות מוצגת בקישור בולט עם הכיתוב 'אל תמכרו את המידע האישי שלי' בדף הבית של הצד המוֹכֵר. במדריך התאימות לחוקי הפרטיות במדינות ארה"ב מוסבר איך מפעילים עיבוד נתונים מוגבל להצגת מודעות של Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת המודעות בשרשרת בחירת הרשת. לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת (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 (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 מודעת המעברון/המתגמלת של 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) של מודעת הבאנר הוא nil.
106 לא ניתן היה לאתחל את ה-SDK של Meta Audience Network.
1000-9999 רשת Meta Audience Network החזירה שגיאה ספציפית ל-SDK. פרטים נוספים זמינים במסמכי העזרה של Meta Audience Network.

יומן השינויים של הפלאגין של Meta Audience Network לבחירת רשת ב-Unity

גרסה 3.14.0

גרסה 3.13.1

גרסה 3.13.0

גרסה 3.12.2

גרסה 3.12.1

גרסה 3.12.0

גרסה 3.11.0

גרסה 3.10.0

גרסה 3.9.1

גרסה 3.9.0

גרסה 3.8.0

גרסה 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

  • תמיכה במתאם Facebook ל-Android בגרסה 5.5.0.0.
  • יש תמיכה בגרסה 5.5.1.0 של מתאם ל-iOS של Facebook.

גרסה 2.5.0

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

גרסה 2.4.1

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

גרסה

  • תמיכה במתאם Facebook ל-Android בגרסה 5.4.0.0.
  • תמיכה במתאם Facebook ל-iOS בגרסה 5.4.0.0.

גרסה 2.3.2

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

גרסה 2.3.1

  • תמיכה במתאם Facebook ל-Android בגרסה 5.3.1.0.
  • תמיכה במתאם Facebook ל-iOS בגרסה 5.3.2.0.

גרסה 2.3.0

  • תמיכה במתאם Facebook ל-Android בגרסה 5.3.0.0.
  • תמיכה במתאם Facebook ל-iOS בגרסה 5.3.0.0.

גרסה

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

גרסה 2.1.1

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

גרסה

  • תמיכה במתאם Facebook ל-Android בגרסה 5.1.0.0.
  • תמיכה במתאם Facebook ל-iOS בגרסה 5.1.0.0.

גרסה 2.0.0

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

גרסה 1.2.1

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

גרסה 1.2.0

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

גרסה 1.1.3

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

גרסה 1.1.2

  • תוקנה התנגשות פוטנציאלית עם הפלאגין של Unity Ads לבחירת רשת (Mediation).

גרסה 1.1.1

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

גרסה 1.1.0

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

גרסה 1.0.0

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