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

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

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

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

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

1 בשנת 2021, הפלטפורמה Meta Audience Network הפכה לפלטפורמה לבידינג בלבד.

דרישות

  • הגרסה העדכנית ביותר של Google Mobile Ads SDK
  • 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

כדי להגדיר את חשבון התשלומים, לוחצים על Add a new payment account (הוספת חשבון תשלומים חדש). תועברו לדף חדש שבו תצטרכו להזין את פרטי התשלום. ממלאים את הפרטים הנדרשים ולוחצים על הבא.

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

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

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

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

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

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

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

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

Android

להוראות, אפשר לעיין בשלב 2 במדריך ל-Android.

iOS

להוראות, אפשר לעיין בשלב 2 במדריך ל-iOS.

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

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

שלב 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

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

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

ייבוא מ-Unity

לאחר מכן בוחרים באפשרות נכסים > מנהל יחסי התלות החיצוניים > Android Resolver > Force Resolve. הספרייה של External Dependency Manager תפתור את יחסי התלות מהתחלה ותעתיק את יחסי התלות המוצגים לתיקייה 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). לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת (Mediation) שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי להבטיח תאימות.

למשתמשים בקליפורניה, כדאי לעיין באפשרויות של Meta לעיבוד נתונים.

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

Android

אין צורך בקוד נוסף לשילוב עם Meta Audience Network.

iOS

שילוב עם SKAdNetwork

פועלים לפי המסמכים של Meta Audience Network כדי להוסיף את המזהים של SKAdNetwork לקובץ Info.plist של הפרויקט.

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

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

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

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

חשוב לרשום את מכשיר הבדיקה ב-Ad Manager ולהפעיל את מצב הבדיקה בממשק המשתמש של 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 ה-SDK של 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 view controller של מודעת הבאנר הוא 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.
  • תמיכה במתאם Facebook ל-iOS בגרסה 5.5.1.0.

גרסה 2.5.0

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

גרסה 2.4.1

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

גרסה 2.4.0

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

גרסה 2.3.2

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

גרסה 2.3.1

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

גרסה

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

גרסה 2.2.0

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

גרסה 2.1.1

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

גרסה

  • תמיכה במתאם 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

  • תמיכה במתאם Facebook ל-Android בגרסה 4.99.3.0.
  • התמיכה במתאם של 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.
  • תמיכה ב-Facebook iOS SDK בגרסה 4.28.1.

גרסה 1.0.0

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