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

בחירת פלטפורמה: Android iOS Unity Flutter Android (גרסה קודמת)

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

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

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

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

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

דרישות מוקדמות

לפני שממשיכים, חשוב לוודא את הפרטים הבאים:

  • ‫Android API ברמה 24 ואילך.

שלב 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. בקטע אותות מאובטחים, מחפשים את Facebook ומפעילים את המתג הפעלת שילוב אפליקציות.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

בקובץ Gradle ברמת האפליקציה, מוסיפים את יחסי התלות הבאים להטמעה:

Kotlin

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.google.ads.mediation:facebook:6.22.0.1")
}

Groovy

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:facebook:6.22.0.1'
}

שילוב ידני

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

פרמטרים וערכים של בקשות
FacebookMediationAdapter.KEY_ID מחרוזת. מזהה ייחודי של המודעה המותאמת
FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET מחרוזת. ההקשר החברתי של המודעה

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

דוגמה:

Java 

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

Kotlin 

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

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

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

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

עיבוד מודעות

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

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

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

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

בטבלה הבאה מודגש מתי נרשמות חשיפות של מודעות וקליקים של מודעות מותאמות על ידי Google Mobile Ads SDK (Legacy).

תיעוד חשיפות הקלטת קליקים
פיקסל אחד של נכס מודעה מותאמת של Meta Audience Network על המסך + דרישות רינדור של הנכס קריאה חוזרת (callback) של Meta Audience Network SDK

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

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

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

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

קודי שגיאה

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

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

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

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

יומן השינויים של מתאם תהליך בחירת הרשת של Meta Audience Network ל-Android

גרסה 6.22.0.1

  • מצמידים את התלות של המתאם ב-Kotlin לגרסה 1.9.0 (גרסת Kotlin המינימלית שנתמכת על ידי GMA NextGen SDK).
  • העדכון מאפשר לדווח על חשיפה של מודעה מותאמת כשמערכת Meta מתעדת חשיפה של מודעות מותאמות.

פותח ונבדק עם:

  • גרסה 25.4.0 של Google Mobile Ads SDK.
  • גרסה 1.5.0 של Google Mobile Ads Next-Gen SDK.
  • גרסה 6.22.0 של Meta Audience Network SDK.

גרסה 6.22.0.0

  • תאימות מאומתת ל-Meta Audience Network SDK בגרסה 6.22.0.

פותח ונבדק עם:

  • גרסה 25.4.0 של Google Mobile Ads SDK.
  • גרסה 1.3.0 של Google Mobile Ads Next-Gen SDK.
  • גרסה 6.22.0 של Meta Audience Network SDK.

גרסה 6.21.0.4

  • ממופה ל-AgeRestrictedTreatment בהגדרות הקהל המעורב של Meta Audience Network.
  • תוקנה בעיה של דליפת זיכרון במודעות מעברון.

נבנה ונבדק באמצעות:

  • גרסה 25.4.0 של Google Mobile Ads SDK.
  • גרסה 1.2.1 של Google Mobile Ads Next-Gen SDK.
  • גרסה 6.21.0 של Meta Audience Network SDK.

גרסה 6.21.0.3

  • עדכנו את ההטמעה של המודעות המותאמות כך שתשתמש ב-API המעודכן של NativeAdMapper.
  • צריך להשמיד את NativeAdBase ואת MediaView כשמתבצעת קריאה ל-untrackView כדי לשחרר משאבים.

פותח ונבדק עם:

  • גרסה 25.2.0 של Google Mobile Ads SDK.
  • גרסה 0.25.0-beta01 של Google Mobile Ads Next-Gen SDK.
  • גרסה 6.21.0 של Meta Audience Network SDK.

גרסה 6.21.0.2

  • נוסף מאפיין ליצירת המתאם עם תלות ב-GMA Next-Gen SDK.

נבנה ונבדק באמצעות:

  • גרסה 25.1.0 של Google Mobile Ads SDK.
  • גרסה 6.21.0 של Meta Audience Network SDK.

גרסה 6.21.0.1

  • הוספנו תמיכה בהעברה של הפרמטר tagForUnderAgeOfConsent Google Mobile Ads SDK אל Meta Audience Network SDK.

נבנה ונבדק באמצעות:

  • גרסה 24.9.0 של Google Mobile Ads SDK.
  • גרסה 6.21.0 של Meta Audience Network SDK.

גרסה 6.21.0.0

  • תאימות מאומתת לגרסה Meta Audience Network SDK v6.21.0.

פותח ונבדק עם:

  • גרסה 24.7.0 של Google Mobile Ads SDK.
  • גרסה 6.21.0 של Meta Audience Network SDK.

גרסה 6.20.0.2

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

נבנה ונבדק באמצעות:

  • גרסה 24.7.0 של Google Mobile Ads SDK.
  • גרסה 6.20.0 של Meta Audience Network SDK.

גרסה 6.20.0.1

  • הוסר הבדיקה שגורמת לכשל באתחול אם אין מזהי מיקום. הסרנו את זה כדי לאפשר ל-RTB לפעול גם אם בעל אפליקציה לא מגדיר מיפויים של יחידות מודעות.
  • תאימות מאומתת ל-Meta Audience Network SDK בגרסה 6.20.0.

פותח ונבדק עם:

  • גרסה 24.6.0 של Google Mobile Ads SDK.
  • גרסה 6.20.0 של Meta Audience Network SDK.

גרסה 6.20.0.0

  • תאימות מאומתת עם Meta Audience Network SDK בגרסה 6.20.0.

נבנה ונבדק באמצעות:

  • גרסה 24.2.0 של Google Mobile Ads SDK.
  • גרסה 6.20.0 של Meta Audience Network SDK.

גרסה 6.19.0.1

  • רמת ה-API המינימלית הנדרשת ב-Android עודכנה ל-23.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-24.0.0.

נבנה ונבדק באמצעות:

  • גרסה 24.0.0 של Google Mobile Ads SDK.
  • גרסה 6.19.0 של Meta Audience Network SDK.

גרסה 6.19.0.0

  • תאימות מאומתת ל-Meta Audience Network SDK בגרסה 6.19.0.

פותח ונבדק עם:

  • גרסה 23.6.0 של Google Mobile Ads SDK.
  • גרסה 6.19.0 של Meta Audience Network SDK.

גרסה 6.18.0.0

  • תאימות מאומתת לגרסה Meta Audience Network SDK v6.18.0.

פותח ונבדק עם:

  • גרסה 23.3.0 של Google Mobile Ads SDK.
  • גרסה 6.18.0 של Meta Audience Network SDK.

גרסה 6.17.0.0

  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-23.0.0.
  • תאימות מאומתת עם Meta Audience Network SDK בגרסה 6.17.0.

פותח ונבדק עם:

  • גרסה 23.0.0 של Google Mobile Ads SDK.
  • גרסה 6.17.0 של Meta Audience Network SDK.

גרסה 6.16.0.0

  • המתאם עודכן כך שיפעיל את MediationInterstitialAdCallback#onAdFailedToShow()‎ כש-Meta SDK מדווח על כשל בהצגת מודעת מעברון.
  • תאימות מאומתת עם Meta Audience Network SDK בגרסה 6.16.0.

פותח ונבדק עם:

  • גרסה 22.3.0 של Google Mobile Ads SDK.
  • גרסה 6.16.0 של Meta Audience Network SDK.

גרסה 6.15.0.0

  • תאימות מאומתת עם Meta Audience Network SDK בגרסה 6.15.0.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-22.2.0.

פותח ונבדק עם:

  • גרסה 22.2.0 של Google Mobile Ads SDK.
  • גרסה 6.15.0 של Meta Audience Network SDK.

גרסה 6.14.0.0

  • תאימות מאומתת עם Meta Audience Network SDK בגרסה 6.14.0.

פותח ונבדק עם:

  • גרסה 22.0.0 של Google Mobile Ads SDK.
  • גרסה 6.14.0 של Meta Audience Network SDK.

גרסה 6.13.7.1

  • המתאם עודכן כדי להשתמש במחלקה החדשה VersionInfo.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-22.0.0.

נבנה ונבדק באמצעות:

  • גרסה 22.0.0 של Google Mobile Ads SDK.
  • גרסת Meta Audience Network SDK‏ 6.13.7.

גרסה 6.13.7.0

  • תאימות מאומתת עם Meta Audience Network SDK בגרסה 6.13.7.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-21.5.0.

פותח ונבדק עם:

  • גרסה 21.5.0 של Google Mobile Ads SDK.
  • גרסת Meta Audience Network SDK‏ 6.13.7.

גרסה 6.12.0.0

  • תאימות מאומתת עם Meta Audience Network SDK בגרסה 6.12.0.
  • עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-21.2.0.
  • שם המתאם שונה ל-Meta Audience Network.
  • הוסר השילוב של Waterfall.

פותח ונבדק עם:

  • גרסה 21.2.0 של Google Mobile Ads SDK.
  • גרסה 6.12.0 של Meta Audience Network SDK.

גרסה 6.11.0.1

  • העדכון של compileSdkVersion ו-targetSdkVersion ל-API 31.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-21.0.0.
  • עדכנו את רמת ה-API המינימלית הנדרשת ב-Android ל-19.

פותח ונבדק עם:

  • גרסה 21.0.0 של Google Mobile Ads SDK.
  • גרסה 6.11.0 של Facebook SDK.

גרסה 6.11.0.0

  • תאימות מאומתת עם Facebook SDK בגרסה 6.11.0.
  • נוספו הודעות אזהרה לגבי הוצאה משימוש של רשימת רשתות בתהליך בחירת רשת. מידע נוסף זמין בבלוג של Meta.

פותח ונבדק עם:

  • גרסה 20.6.0 של Google Mobile Ads SDK.
  • גרסה 6.11.0 של Facebook SDK.

גרסה 6.10.0.0

  • תאימות מאומתת עם Facebook SDK בגרסה 6.10.0.

פותח ונבדק עם:

  • גרסה 20.6.0 של Google Mobile Ads SDK.
  • ‫Facebook SDK בגרסה 6.10.0.

גרסה 6.8.0.1

  • נוספה תמיכה בהעברת קליקים וקריאות חוזרות (callback) של חשיפות במודעות לבידינג.
  • נוספה תמיכה בהעברת הקריאה החוזרת onAdFailedToShow() כשמודעות מעברון שמוצגות בבידינג לא מוצגות.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-20.6.0.

פותח ונבדק עם:

  • גרסה 20.6.0 של Google Mobile Ads SDK.
  • גרסה 6.8.0 של Facebook SDK.

גרסה 6.8.0.0

  • תאימות מאומתת עם Facebook SDK בגרסה 6.8.0.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-20.4.0.

פותח ונבדק עם:

  • גרסה 20.4.0 של Google Mobile Ads SDK.
  • גרסה 6.8.0 של Facebook SDK.

גרסה 6.7.0.0

  • תאימות מאומתת עם Facebook SDK בגרסה 6.7.0.

פותח ונבדק עם:

  • גרסה 20.3.0 של Google Mobile Ads SDK.
  • גרסת Facebook SDK‏ 6.7.0.

גרסה 6.6.0.0

  • תאימות מאומתת עם Facebook SDK בגרסה 6.6.0.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-20.3.0.

פותח ונבדק עם:

  • גרסה 20.3.0 של Google Mobile Ads SDK.
  • גרסה 6.6.0 של Facebook SDK.

גרסה 6.5.1.1

  • תוקן באג שהופיע בגרסה 6.5.1.0, שבה מודעות בדיקה מוחזרות במקום מודעות פעילות.
  • המתאם עודכן לשימוש ב-AdError API החדש.

פותח ונבדק עם:

  • גרסה 20.2.0 של Google Mobile Ads SDK.
  • ‫Facebook SDK בגרסה 6.5.1.

גרסה 6.5.1.0 (הוצאה משימוש)

  • זוהתה בעיה בגרסה 6.5.1.0 והיא אושרה. מומלץ לשדרג לגרסה 6.5.1.1.
  • תאימות מאומתת ל-Facebook SDK v6.5.1.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-20.2.0.

פותח ונבדק עם:

  • גרסה 20.2.0 של Google Mobile Ads SDK.
  • ‫Facebook SDK בגרסה 6.5.1.

גרסה 6.5.0.0

  • תאימות מאומתת עם Facebook SDK בגרסה 6.5.0.
  • תוקנה בעיה שבה מודעות מותאמות לא כללו את תמונת השער של פייסבוק.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-20.1.0.

פותח ונבדק עם:

  • גרסה 20.1.0 של Google Mobile Ads SDK.
  • גרסת Facebook SDK‏ 6.5.0.

גרסה 6.4.0.0

  • תאימות מאומתת עם Facebook SDK בגרסה 6.4.0.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-20.0.0.

פותח ונבדק עם:

  • גרסה 20.0.0 של Google Mobile Ads SDK.
  • גרסה 6.4.0 של Facebook SDK.

גרסה 6.3.0.1

  • תוקנה בעיה שבה נזרקת שגיאה מסוג ClassCastException כשמעבדים מודעות מותאמות באפליקציות שלא משתמשות ב-ImageView כדי לעבד נכסי תמונות.

נבנה ונבדק באמצעות:

  • גרסה 19.7.0 של Google Mobile Ads SDK.
  • גרסה 6.3.0 של Facebook SDK.

גרסה 6.3.0.0

  • תאימות מאומתת עם Facebook SDK בגרסה 6.3.0.

נבנה ונבדק באמצעות:

  • גרסה 19.7.0 של Google Mobile Ads SDK.
  • גרסה 6.3.0 של Facebook SDK.

גרסה 6.2.1.0

  • תאימות מאומתת עם Facebook SDK v6.2.1.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-19.7.0.

פותח ונבדק עם:

  • גרסה 19.7.0 של Google Mobile Ads SDK.
  • גרסה 6.2.1 של Facebook SDK.

גרסה 6.2.0.1

  • הוסרה התמיכה בפורמט NativeAppInstallAd שהוצא משימוש. האפליקציות צריכות לשלוח בקשות למודעות מותאמות אחידות.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-19.6.0.

פותח ונבדק עם:

  • גרסה 19.6.0 של Google Mobile Ads SDK.
  • גרסה 6.2.0 של Facebook SDK.

גרסה 6.2.0.0

  • תאימות מאומתת עם Facebook SDK בגרסה 6.2.0.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-19.5.0.

פותח ונבדק עם:

  • גרסה 19.5.0 של Google Mobile Ads SDK.
  • ‫Facebook SDK בגרסה 6.2.0.

גרסה 6.1.0.0

  • תאימות מאומתת עם Facebook SDK בגרסה 6.1.0.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-19.4.0.

פותח ונבדק עם:

  • גרסה 19.4.0 של Google Mobile Ads SDK.
  • גרסה 6.1.0 של Facebook SDK.

גרסה 6.0.0.0

  • תאימות מאומתת עם Facebook SDK בגרסה 6.0.0.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-19.3.0.

פותח ונבדק עם:

  • גרסה 19.3.0 של Google Mobile Ads SDK.
  • גרסה 6.0.0 של Facebook SDK.

גרסה 5.11.0.0

  • תאימות מאומתת ל-Facebook SDK v5.11.0.

פותח ונבדק עם:

  • גרסה 19.2.0 של Google Mobile Ads SDK.
  • גרסה 5.11.0 של Facebook SDK.

גרסה 5.10.1.0

  • תאימות מאומתת לגרסה Facebook SDK v5.10.1.

פותח ונבדק עם:

  • גרסה 19.2.0 של Google Mobile Ads SDK.
  • גרסה 5.10.1 של Facebook SDK.

גרסה 5.10.0.0

  • תאימות מאומתת עם Facebook SDK בגרסה 5.10.0.

נבנה ונבדק באמצעות:

  • גרסה 19.2.0 של Google Mobile Ads SDK.
  • גרסה 5.10.0 של Facebook SDK.

גרסה 5.9.1.0

  • תאימות מאומתת עם Facebook SDK בגרסה 5.9.1.

נבנה ונבדק באמצעות:

  • גרסה 19.2.0 של Google Mobile Ads SDK.
  • גרסת Facebook SDK‏ 5.9.1.

גרסה 5.9.0.2

  • נוספה תמיכה במודעות מעברון מתגמלות.
  • המתאם עודכן כדי לתמוך בבקשות למודעות באנר מותאמות שמוטמעות באפליקציה.
  • תוקנה בעיה שבה מודעות באנר שמתבצע עליהן בידינג מוצגות תמיד ברוחב מלא.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-19.2.0.

פותח ונבדק עם:

  • גרסה 19.2.0 של Google Mobile Ads SDK.
  • גרסת Facebook SDK‏ 5.9.0.

גרסה 5.9.0.1

  • המתאם מעביר עכשיו שגיאה אם FAN SDK נתקל בשגיאה במהלך הצגה של מודעה מתגמלת או מודעת מעברון.

נבנה ונבדק באמצעות:

  • גרסה 19.1.0 של Google Mobile Ads SDK.
  • גרסת Facebook SDK‏ 5.9.0.

גרסה 5.9.0.0

  • תאימות מאומתת לגרסה Facebook SDK v5.9.0.

נבנה ונבדק באמצעות:

  • גרסה 19.1.0 של Google Mobile Ads SDK.
  • גרסה 5.9.0 של Facebook SDK.

גרסה 5.8.0.2

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

פותח ונבדק עם:

  • גרסה 19.1.0 של Google Mobile Ads SDK.
  • גרסה 5.8.0 של Facebook SDK.

גרסה 5.8.0.1

  • נוספו קודי שגיאה תיאוריים נוספים וסיבות לכשלים בטעינה או בהצגה של המתאם.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-19.1.0.

נבנה ונבדק באמצעות:

  • גרסה 19.1.0 של Google Mobile Ads SDK.
  • גרסה 5.8.0 של Facebook SDK.

גרסה 5.8.0.0

  • תאימות מאומתת לגרסה Facebook SDK v5.8.0.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-19.0.1.

פותח ונבדק עם:

  • גרסה 19.0.1 של Google Mobile Ads SDK.
  • גרסה 5.8.0 של Facebook SDK.

גרסה 5.7.1.1

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

פותח ונבדק עם:

  • גרסה 18.3.0 של Google Mobile Ads SDK.
  • גרסת Facebook SDK‏ 5.7.1.

גרסה 5.7.1.0

  • תאימות מאומתת עם Facebook SDK בגרסה 5.7.1.
  • נוספה תמיכה במודעות באנר מותאמות של פייסבוק כשמשתמשים בבידינג.
  • במודעות מותאמות נעשה עכשיו שימוש ב-Drawable לנכס הסמל.

נבנה ונבדק באמצעות:

  • גרסה 18.3.0 של Google Mobile Ads SDK.
  • גרסת Facebook SDK‏ 5.7.1.

גרסה 5.7.0.0

  • תאימות מאומתת לגרסה Facebook SDK v5.7.0.

נבנה ונבדק באמצעות:

  • גרסה 18.3.0 של Google Mobile Ads SDK.
  • גרסת Facebook SDK‏ 5.7.0.

גרסה 5.6.1.0

  • תאימות מאומתת עם Facebook SDK v5.6.1.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-18.3.0.

פותח ונבדק עם:

  • גרסה 18.3.0 של Google Mobile Ads SDK.
  • גרסת Facebook SDK‏ 5.6.1.

גרסה 5.6.0.0

  • תאימות מאומתת לגרסה Facebook SDK v5.6.0.
  • המתאם של פייסבוק עודכן לשימוש ב-AdChoicesView.

נבנה ונבדק באמצעות:

  • גרסה 18.2.0 של Google Mobile Ads SDK.
  • גרסת Facebook SDK‏ 5.6.0.

גרסה 5.5.0.0

  • תאימות מאומתת ל-Facebook SDK v5.5.0.

גרסה 5.4.1.1

  • תוקנה בעיה שגרמה לקריסה כשהמודעות מותאמות הוסרו.

גרסה 5.4.1.0

  • תאימות מאומתת עם Facebook SDK בגרסה 5.4.1.
  • נוספה תמיכה במודעות באנר מותאמות של פייסבוק בתהליך בחירת הרשת (Mediation) ב-Waterfall.
    • כדי לבקש מודעות באנר מותאמות, משתמשים ב-setNativeBanner() מהמחלקה FacebookExtras.
  • תוקנה בעיה שגרמה לכשל בבקשות להצגת מודעות באנר חכמות.
  • תוקנה בעיה שבה מודעות וידאו מתגמלות לא העבירו את האירוע onAdClosed() במקרים מסוימים שבהם האפליקציה הועברה לרקע בזמן שהסרטון פעל.
  • המתאם הועבר אל AndroidX.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-18.1.1.

גרסה 5.4.0.0

  • תאימות מאומתת עם Facebook SDK בגרסה 5.4.0.

גרסה 5.3.1.2

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

גרסה 5.3.1.1

  • עדכנו את המעקב אחר חשיפות של מודעות RTB מותאמות.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-17.2.1.

גרסה 5.3.1.0

  • נוספה לאדפטר יכולת בידינג למודעות באנר, למודעות מעברון, למודעות מתגמלות ולמודעות מותאמות.
  • תאימות מאומתת עם Facebook SDK בגרסה 5.3.1.

גרסה 5.3.0.0

  • שם מעודכן של שירות לבחירת רשת (Mediation) ב-Google Mobile Ads.
  • נוספה גרסת מתאם לקריאת האתחול.
  • תאימות מאומתת עם Facebook SDK בגרסה 5.3.0.

גרסה 5.2.0.2

  • נוספה תמיכה בגדלים גמישים של מודעות באנר.

גרסה 5.2.0.1

  • המתאם עודכן כדי לתמוך ב-Rewarded API החדש בגרסת בטא פתוחה.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-17.2.0.

גרסה 5.2.0.0

  • תאימות מאומתת עם Facebook SDK בגרסה 5.2.0.

גרסה 5.1.1.1

  • המתאם עודכן כדי לאכלס את שם המפרסם במודעות מותאמות מסוג Native מאוחד.

גרסה 5.1.1.0

  • החלפנו את AdChoices View ב-AdOptions View.
  • תאימות מאומתת עם Facebook SDK בגרסה 5.1.1

גרסה 5.1.0.1

  • תוקנה בעיית ANR שנגרמה על ידי getGMSVersionCode()‎.

גרסה 5.1.0.0

  • מפעילים את Facebook SDK לכל פורמט מודעה.

גרסה 5.0.1.0

  • תאימות מאומתת עם Facebook SDK בגרסה 5.0.1.

גרסה 5.0.0.1

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

גרסה 5.0.0.0

  • תאימות מאומתת ל-Facebook SDK v5.0.0.

גרסה 4.99.3.0

  • תאימות מאומתת עם Facebook SDK בגרסה 4.99.3.

גרסה 4.99.1.1

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

גרסה 4.99.1.0

  • תאימות מאומתת לגרסה Facebook SDK v4.99.1.

גרסה 4.28.2.1

  • המתאם עודכן כדי להפעיל את אירוע המודעה onRewardedVideoComplete().

גרסה 4.28.2.0

  • תאימות מאומתת ל-Facebook SDK v4.28.2.

גרסה 4.28.1.1

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

גרסה 4.28.1.0

  • תאימות מאומתת עם Facebook SDK בגרסה 4.28.1.

גרסה 4.28.0.0

  • תאימות מאומתת לגרסה Facebook SDK v4.28.0.

גרסה 4.27.1.0

  • תאימות מאומתת עם Facebook SDK בגרסה 4.27.1.

גרסה 4.27.0.0

  • תאימות מאומתת עם Facebook SDK בגרסה 4.27.0.

גרסה 4.26.1.0

  • תאימות מאומתת עם Facebook SDK בגרסה 4.26.1.
  • עדכון פרויקט המתאם ל-Android Studio 3.0

גרסה 4.26.0.0

  • נוספה תמיכה במודעות וידאו מתגמלות.
  • נוספה תמיכה במודעות וידאו מותאמות.
  • תאימות מאומתת עם Facebook SDK בגרסה 4.26.0.

גרסה 4.25.0.0

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

גרסה 4.24.0.0

  • תאימות מאומתת עם Facebook SDK בגרסה 4.24.0.

גרסה 4.23.0.0

  • תאימות מאומתת לגרסה Facebook SDK v4.23.0.

גרסה 4.22.1.0

  • תאימות מאומתת עם Facebook SDK בגרסה 4.22.1.

גרסה 4.22.0.0

  • המתאם עודכן כדי שיהיה תואם ל-Facebook SDK בגרסה 4.22.0.

גרסה 4.21.1.0

  • תאימות מאומתת עם Facebook SDK v4.21.1.

גרסה 4.21.0.0

  • תאימות מאומתת לגרסה Facebook SDK v4.21.0.

גרסה 4.20.0.0

  • רמת ה-API המינימלית הנתמכת ב-Android עודכנה ל-14 ומעלה.
  • תאימות מאומתת עם Facebook SDK בגרסה 4.20.0.

גרסה 4.19.0.0

  • תאימות מאומתת עם Facebook SDK בגרסה 4.19.0.

גרסה 4.18.0.0

  • תאימות מאומתת עם Facebook SDK בגרסה 4.18.0.

גרסה 4.17.0.0

  • נוספה תמיכה במודעות מותאמות.

גרסה 4.15.0.0

  • שינינו את מערכת השמות של הגרסאות ל-[גרסת FAN SDK].[גרסת תיקון המתאם].
  • גרסת ה-SDK המינימלית הנדרשת של FAN עודכנה ל-v4.15.0.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה לגרסה 9.2.0.
  • תוקן באג שגרם לכך שקריאות חוזרות (callback) של פייסבוק לקליקים על מודעות מעברון לא הועברו בצורה תקינה.
  • המתאם מעביר עכשיו גם את onAdLeftApplication כשמשתמש לוחץ על מודעה.

גרסה 1.2.0

  • תוקן באג כך ש-AdSize.SMART_BANNER הוא עכשיו גודל חוקי.

גרסה 1.1.0

  • הוספנו תמיכה בפורמט של רוחב מלא x‏ 250 כשהבקשה היא ל-AdSize.MEDIUM_RECTANGLE

גרסה 1.0.1

  • הוספנו תמיכה ב-AdSize.SMART_BANNER

גרסה 1.0.0

  • גרסה ראשונית