דף זה תורגם על ידי Cloud Translation API.

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

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

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

גרסה 17.0.0 לפחות של Google Mobile Ads SDK
ביצוע השלבים ב מודעות וידאו מתגמלות.

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

ייתכן שאפליקציות מסוימות ירצו לקבל מידע נוסף על המודעות שהוצגו. אפשר להאזין לשינויים במטא-נתונים של מודעות וידאו מתגמלות RewardedVideoAd.setAdMetadataListener() עם הטמעה של AdMetadataListener. ברגע שתתבצע קריאה אל AdMetadataListener.onAdMetadataChanged(), אפשר לבדוק את המטא-נתונים של המודעה ב-RewardedVideo.getAdMetadata().

מתבצעת קריאה אל 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`	מחרוזת	מזהה העסקה הראשון שקיים בשרשרת ה-wrapper של המודעה הנוכחית החל מלמעלה--ריק אם לא זמין.
`AdSystem`	מחרוזת	שרת המודעות המקורי של המודעה, ריק אם הוא לא זמין.
`CreativeId`	מחרוזת	המזהה של הקריאייטיב שנבחר למודעה. הוא ריק אם הוא לא זמין.
`MediaURL`	מחרוזת	כתובת ה-URL של המדיה שנבחרה.
`Wrappers`	מערך	המערך מאוכלס ברכיבים שמתחילים במודעת ה-wrapper הפנימית ביותר (קרוב למודעה המוטבעת) זז החוצה אל מודעת ה-wrapper החיצונית ביותר. כל אחד במערך הוא מילון שמכיל את המפתחות הבאים ערכים. `AdId` מחרוזת. מזהה המודעה שמשמש למודעת wrapper. המזהה ריק אם הוא לא זמין. `AdSystem` מחרוזת. מערכת המודעות שמשמשת למודעת wrapper, היא ריקה אם היא לא זמינה. `CreativeId` מחרוזת. מזהה הקריאייטיב המשמש למודעת wrapper, ריק אם הוא לא זמין.