‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

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

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

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

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

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

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

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

Kotlin

RewardedAd.load(
AdRequest.Builder("AD_UNIT_ID").build(),
object : AdLoadCallback<RewardedAd> {
  override fun onAdLoaded(ad: RewardedAd) {
    ...
    ad.adEventCallback = object : RewardedAdEventCallback {
      override fun onAdMetadataChanged() {
        val metadata = ad.adMetadata
        val adId = metadata.getString("AdId")
      }
    }
  }
})

Java

RewardedAd.load(
  new AdRequest.Builder("AD_UNIT_ID").build(),
  new AdLoadCallback<RewardedAd>() {
    @Override
    public void onAdLoaded(@NonNull RewardedAd rewardedAd) {
      Rewarded.this.rewardedAd = rewardedAd;
        ...
        rewardedAd.setAdEventCallback(new RewardedAdEventCallback() {
            @Override
            public void onAdMetadataChanged() {
                Bundle metadata = rewardedAd.getAdMetadata();
                String adId = metadata.getString("AdId");
            }
        });
      };
    };
  );

החלפת יחידת המודעות AD_UNIT_ID. לדוגמה, /21775744923/example/rewarded למודעות מתגמלות.

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

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