אתם מוזמנים לשתף את המשוב שלכם על GMA Next-Gen SDK בערוץ #gma-next-gen-sdk בשרת של קהילת הפרסום והמדידה של Google ב-Discord.

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

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

בחירת פלטפורמה: Android iOS Android (Legacy)

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