כדי לדון במוצרים שלנו ולספק משוב, אפשר להצטרף לערוץ הרשמי של 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` ‫ String. מזהה המודעה שמשמשת למודעת wrapper, ריק אם לא זמין. `AdSystem` ‫ String. מערכת המודעות שמשמשת למודעת wrapper, ריק אם לא זמין. `CreativeId` ‫ String. מזהה הקריאייטיב שמשמש למודעה עוטפת. אם המזהה לא זמין, הערך יהיה ריק.