כדי לדון במוצרים שלנו ולספק משוב, אפשר להצטרף לערוץ הרשמי של Ad Manager ב-Discord בשרת קהילת הפרסום והמדידה של Google.

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

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

הפלטפורמה: Android iOS

המדריך הזה מיועד לבעלי תוכן דיגיטלי שמשלבים מטא נתונים של מודעות עם 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")
        }
      }
    })

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

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