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

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

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

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

שילוב

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

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

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

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

צריך גם להנחות את ערכת ה-SDK באופן מפורש להתחיל למדוד את המודעה. כדי לעשות את זה, קוראים לשיטה start() באובייקט DisplayOpenMeasurement של המודעה המותאמת האישית. צריך לקרוא לשיטה 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.