פורמטים מותאמים אישית של מודעות מותאמות מסוג רשת המדיה ומדידה פתוחה

במדריך הזה מוסבר איך לשלב פורמטים מותאמים אישית של מודעות מותאמות עם מדידה פתוחה.

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

שילוב

אם אתם מתכוונים להשתמש במדידה פתוחה בפורמטים מותאמים אישית של מודעות מותאמות שלא מכילים נכס וידאו, באחריותכם לקרוא לממשקי ה-API של המדידה בכל אפליקציה בעצמכם. מדידה פתוחה של פורמטים מותאמים אישית של מודעות מותאמות לרשת המדיה נתמכת רק ב-Mobile Ads SDK בגרסה 18.1.1 ואילך.

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

עכשיו נראה איך להשתמש במדידה של מודעות פתוחות באמצעות NativeCustomTemplateAd. באופן כללי, אם רוצים להתחיל למדוד את הניראות ולרשום צפייה במודעה בהתאמה אישית, צריך לשלוח התראה ל-Mobile Ads SDK.

טעינת מודעה

בין אם משתמשים במדידה של מודעות פתוחות או לא, טעינת המודעה זהה. לפניכם שיטה שמדגימה איך לבקש NativeCustomTemplateAd:

public void loadAd() {
   AdLoader adLoader = new AdLoader.Builder(context, "YOUR-AD-UNIT-ID")
    .forCustomTemplateAd("YOUR-TEMPLATE-ID",
      new NativeCustomTemplateAd.OnCustomTemplateAdLoadedListener() {
          @Override
          public void onCustomTemplateAdLoaded(NativeCustomTemplateAd ad) {
              // Register your view and begin open measurement.
              // We will define this method below.
              MyActivity.this.registerOpenMeasurementAndShowAd(ad);
          }
      },
      new NativeCustomTemplateAd.OnCustomClickListener() {
          @Override
          public void onCustomClick(NativeCustomTemplateAd ad, String s) {
              // Handle the click action
          }
      })
    .withAdListener( ... )
    .withNativeAdOptions( ... )
    .build();
}

צריך לרשום את התצוגה ולהתחיל למדוד

כדי להפעיל מדידה פתוחה ב-NativeCustomTemplateAd, צריך לרשום את תצוגת המודעה המותאמת אישית עם האובייקט DisplayOpenMeasurement המשויך ל-NativeCustomTemplateAd. האובייקט DisplayOpenMeasurement מספק את השיטה setView() לרישום תצוגת הקונטיינר כמדידה פתוחה.

בנוסף, צריך להורות ל-SDK באופן מפורש להתחיל למדוד את המודעה. כדי לעשות את זה, קוראים ל-method start() באובייקט DisplayOpenMeasurement של השדה NativeCustomTemplateAd. צריך לקרוא ל-method start() מה-thread הראשי, ולקריאות הבאות אין השפעה.

היא נראית כך:

public void  registerOpenMeasurementAndShowAd(NativeCustomTemplateAd ad) {

...
// Show ad
...
displayCustomTemplateAd(ad)
// Begin Open Measurement
// The FrameLayout that will contain your native custom ad
FrameLayout customTemplateAdFrame = (FrameLayout) findViewById(R.id.custom_ad_frame);
ad.getDisplayOpenMeasurement().setView(customTemplateAdFrame);
ad.getDisplayOpenMeasurement().start();

}

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

הפריסה customTemplateAdFrame היא מאגר המודעות של NativeCustomTemplateAd, והיא חייבת להכיל את כל הנכסים שבתיבה התוחמת של התצוגה.

אישור תאימות ל-IAB

לאחר השקת האפליקציה תתחילו לקבל נתוני מדידה. עם זאת, הנתונים לא יאושרו עד שתשלימו את תהליך האישור של IAB.