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

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

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

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

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

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

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

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

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

  • רמת API ב-Android‏ 24 ואילך.

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

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

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

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

יצירת נכס

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

צריך להוסיף את Meta Audience Network להגדרת הגישור של יחידת המודעות.

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

כדי ליצור קבוצה חדשה לבחירת רשת, לוחצים על יצירת קבוצה לבחירת רשת.

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

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

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

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

הוספה של Meta Audience Network כמקור מודעות


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

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



לוחצים על אישור והסכמה ואז על המשך.



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



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

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

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

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

בקובץ 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 for Android. מחפשים את AudienceNetwork.aar בתיקייה AudienceNetwork/bin, מחלצים אותו ומוסיפים אותו לפרויקט.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

חלק מהנכסים של מודעות מותאמות ברשת המדיה של Meta לא ממופים אחד לאחד לנכסים של מודעות מותאמות ב-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
גוף
סמל האפליקציה
קריאה לפעולה
שם המפרסם
Star rating
חנות
מחיר

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

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

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

תיעוד חשיפות הקלטת קליקים
‫1px של נכס שמצורף למודעה מותאמת ב-מטא 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 v6.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

  • ‫Maps 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

  • עדכנו את ההטמעה של מודעות מותאמות כדי להשתמש ב-NativeAdMapper API המעודכן.
  • הפונקציות 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 v6.20.0.

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

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

גרסה 6.20.0.0

  • תאימות מאומתת לגרסה Meta Audience Network SDK v6.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 v6.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 v6.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 v6.16.0.

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

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

גרסה 6.15.0.0

  • תאימות מאומתת לגרסה Meta Audience Network SDK v6.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 v6.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 v6.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 v6.12.0.
  • עדכנו את הגרסה המינימלית הנדרשת של Google Mobile Ads SDK ל-21.2.0.
  • שינינו את שם המתאם ל-Meta Audience Network.
  • הסרנו את השילוב של שיטת המפל.

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

  • גרסה 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 v6.11.0.
  • נוספו הודעות אזהרה לגבי הוצאה משימוש של תהליך בחירת הרשת (Mediation) ב-Waterfall. מידע נוסף זמין בבלוג של Meta.

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

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

גרסה 6.10.0.0

  • תאימות מאומתת לגרסה Facebook SDK v6.10.0.

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

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

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

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

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

גרסה 6.6.0.0

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

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

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

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

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

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

גרסה 6.3.0.1

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

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

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

גרסה 6.3.0.0

  • תאימות מאומתת לגרסה Facebook SDK v6.3.0.

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

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

גרסה 6.2.1.0

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

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

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

גרסה 6.2.0.1

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

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

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

גרסה 6.2.0.0

  • תאימות מאומתת לגרסה Facebook SDK v6.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 v6.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 v6.0.0.
  • הגרסה המינימלית הנדרשת של Google Mobile Ads SDK עודכנה ל-19.3.0.

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

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

גרסה 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.
  • גרסת Facebook SDK‏ 5.10.1.

גרסה 5.10.0.0

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

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

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

גרסה 5.9.1.0

  • תאימות מאומתת לגרסה Facebook SDK v5.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.
  • גרסה 5.9.0 של Facebook SDK.

גרסה 5.9.0.1

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

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

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

גרסה 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 v5.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.
  • גרסה 5.6.0 של Facebook SDK.

גרסה 5.5.0.0

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

גרסה 5.4.1.1

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

גרסה 5.4.1.0

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

גרסה 5.4.0.0

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

גרסה 5.3.1.2

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

גרסה 5.3.1.1

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

גרסה 5.3.1.0

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

גרסה 5.3.0.0

  • השם של שירות הגישור עודכן ב-Google Mobile Ads.
  • הוספנו את גרסת המתאם לקריאת האתחול.
  • תאימות מאומתת ל-Facebook SDK v5.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 v5.2.0.

גרסה 5.1.1.1

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

גרסה 5.1.1.0

  • החלפנו את התצוגה של AdChoices בתצוגה של AdOptions.
  • תאימות מאומתת ל-Facebook SDK v5.1.1

גרסה 5.1.0.1

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

גרסה 5.1.0.0

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

גרסה 5.0.1.0

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

גרסה 5.0.0.1

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

גרסה 5.0.0.0

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

גרסה 4.99.3.0

  • תאימות מאומתת לגרסה Facebook SDK v4.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

  • תוקנה בעיה שבה קליקים לא נרשמו במודעות מותאמות מסוג Unified Native Ads.

גרסה 4.28.1.0

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

גרסה 4.28.0.0

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

גרסה 4.27.1.0

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

גרסה 4.27.0.0

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

גרסה 4.26.1.0

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

גרסה 4.26.0.0

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

גרסה 4.25.0.0

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

גרסה 4.24.0.0

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

גרסה 4.23.0.0

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

גרסה 4.22.1.0

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

גרסה 4.22.0.0

  • עדכנו את המתאם כדי שיהיה תואם לגרסה Facebook SDK v4.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 v4.20.0.

גרסה 4.19.0.0

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

גרסה 4.18.0.0

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

גרסה 4.17.0.0

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

גרסה 4.15.0.0

  • שינינו את מערכת השמות של הגרסאות ל-[גרסת FAN SDK].[גרסת תיקון המתאם].
  • עדכנו את גרסת ה-SDK המינימלית הנדרשת של FAN לגרסה 4.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

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