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

בחירת פלטפורמה: 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
מחרוזת. מזהה המודעה שמשמש למודעת wrapper, ריק אם לא זמין.
AdSystem
מחרוזת. מערכת המודעות שמשמשת למודעת wrapper, ריק אם לא זמין.
CreativeId
מחרוזת. מזהה הקריאייטיב שמשמש למודעת wrapper, ריק אם לא זמין.