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

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

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

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

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

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

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

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

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

Java

RewardedAd.load(this, "/6499/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, "/6499/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")
        }
      }
    })

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

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