מטא נתונים של מודעות

המדריך הזה מיועד לבעלי תוכן דיגיטלי שמשלבים מטא-נתונים של מודעות עם Google Mobile Ads SDK ל-Android.

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

  • גרסה 17.0.0 של Google Mobile Ads SDK או גרסה מאוחרת יותר.
  • משלימים את השלבים במאמר בנושא סרטונים מתגמלים.

אחזור מטא-נתונים של מודעות

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

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

בדוגמה הבאה אפשר לראות איך לאחזר את המטא-נתונים של המודעה:

Kotlin 

RewardedAd.load(
AdRequest.Builder("AD_UNIT_ID").build(),
object : AdLoadCallback<RewardedAd> {
  override fun onAdLoaded(ad: RewardedAd) {
    ...
    ad.adEventCallback = object : RewardedAdEventCallback {
      override fun onAdMetadataChanged() {
        val metadata = ad.adMetadata
        val adId = metadata.getString("AdId")
      }
    }
  }
})

Java 

RewardedAd.load(
  new AdRequest.Builder("AD_UNIT_ID").build(),
  new AdLoadCallback<RewardedAd>() {
    @Override
    public void onAdLoaded(@NonNull RewardedAd rewardedAd) {
      Rewarded.this.rewardedAd = rewardedAd;
        ...
        rewardedAd.setAdEventCallback(new RewardedAdEventCallback() {
            @Override
            public void onAdMetadataChanged() {
                Bundle metadata = rewardedAd.getAdMetadata();
                String adId = metadata.getString("AdId");
            }
        });
      };
    };
  );

מחליפים את AD_UNIT_ID ביחידת המודעות. לדוגמה, /21775744923/example/rewarded למודעות מתגמלות.

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

Key סוג תיאור
AdId מחרוזת המזהה של המודעה, אם קיים.
AdTitle מחרוזת השם, ריק אם לא צוין.
CreativeDurationMs מספר שלם משך הקריאייטיב שנבחר באלפיות השנייה, -1 אם הקריאייטיב לא ליניארי.
TraffickingParameters מחרוזת פרמטרים של ניהול תנועה, ריקים אם לא זמינים.
DealId מחרוזת מזהה העסקה הראשון שמופיע בשרשרת העטיפה של המודעה הנוכחית, החל מהחלק העליון – ריק אם לא זמין.
AdSystem מחרוזת שרת המודעות של המקור, ריק אם לא זמין.
CreativeId מחרוזת המזהה של הקריאייטיב שנבחר למודעה. אם המזהה לא זמין, הערך יהיה ריק.
MediaURL מחרוזת כתובת ה-URL של המדיה שנבחרה.
Wrappers מערך המערך מתמלא ברכיבים שמתחילים במודעת ה-Wrapper הפנימית ביותר (קרוב למודעה בתוך הטקסט) ומתקדמים החוצה למודעת ה-Wrapper החיצונית ביותר. כל רכיב במערך הוא מילון שמכיל את המפתחות והערכים הבאים.
AdId
מחרוזת. מזהה המודעה שמשמש למודעת wrapper, ריק אם לא זמין.
AdSystem
מחרוזת. מערכת המודעות שמשמשת למודעת wrapper, ריק אם לא זמין.
CreativeId
מחרוזת. מזהה הקריאייטיב שמשמש למודעת wrapper, ריק אם לא זמין.