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

בחירת פלטפורמה: Android (גרסת בטא) חדש Android iOS

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

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

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

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

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

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

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

Java

RewardedAd.load(this, "/21775744923/example/rewarded", new AdManagerAdRequest.Builder().build(),
    new RewardedAdLoadCallback() {
      @Override
      public void onAdLoaded(@NonNull RewardedAd rewardedAd) {
        mRewardedAd = rewardedAd;
        rewardedAd.setOnAdMetadataChangedListener(new OnAdMetadataChangedListener() {
          @Override
          public void onAdMetadataChanged() {
            Bundle metadata = rewardedAd.getAdMetadata();
            String adId = metadata.getString("AdId");
          }
        });
      }
    });

Kotlin

RewardedAd.load(this, "/21775744923/example/rewarded", AdManagerAdRequest.Builder().build(),
                    object : RewardedAdLoadCallback() {
      override fun onAdLoaded(rewardedAd: RewardedAd) {
        mRewardedAd = rewardedAd
        rewardedAd.onAdMetadataChangedListener = OnAdMetadataChangedListener {
          val metadata = rewardedAd.adMetadata
          val adId = metadata.getString("AdId")
        }
      }
    })

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

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