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

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

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