פורמטים מותאמים אישית של מודעות מותאמות לרשת המדיה ו-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()
  }
}
OpenMeasurementSnippets.kt

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();
  }
}
OpenMeasurementSnippets.java

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

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

אישור על ידי IAB

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