‫Google Mobile Ads SDK נמצא במצב תחזוקה. כדי ליהנות מהעדכונים והתכונות האחרונים, כדאי migrate ל-GMA Next-Gen SDK ולהגדיר אותו.

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

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

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

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

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

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

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

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

הקריאה ל-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")
        }
      }
    })

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

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