פורמטים מותאמים אישית של מודעות מותאמות לרשת המדיה ו-Open Measurement

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

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

לפני שממשיכים, צריך:

שילוב

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

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

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

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

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

היא נראית כך:

Kotlin

@MainThread
private fun displayCustomNativeAd(
  customNativeAd: CustomNativeAd,
  nativeAdViewContainer: FrameLayout,
) {
  // TODO: Render the custom native ad inside the nativeAdViewContainer.

  // ...

  // Start measuring the ad view.
  val displayOpenMeasurement = customNativeAd.getDisplayOpenMeasurement()
  if (displayOpenMeasurement != null) {
    displayOpenMeasurement.setView(nativeAdViewContainer)
    displayOpenMeasurement.start()
  }
}

Java

@MainThread
private void displayCustomNativeAd(
    CustomNativeAd customNativeAd, FrameLayout nativeAdViewContainer) {
  // TODO: Render the custom native ad inside the nativeAdViewContainer.

  // ...

  // Start measuring the ad view.
  DisplayOpenMeasurement displayOpenMeasurement = customNativeAd.getDisplayOpenMeasurement();
  if (displayOpenMeasurement != null) {
    displayOpenMeasurement.setView(nativeAdViewContainer);
    displayOpenMeasurement.start();
  }
}

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

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

אישור בהתאם לתקנים של IAB

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