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

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

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

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

שילוב

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

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

טעינת מודעה

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

Java

private void loadCustomNativeAd(Context context, ViewGroup nativeCustomFormatAdContainer) {

  AdLoader adLoader =
      new AdLoader.Builder(context, "AD_UNIT_ID")
          .forCustomFormatAd(
              "CUSTOM_TEMPLATE_ID",
              new NativeCustomFormatAd.OnCustomFormatAdLoadedListener() {
                @Override
                public void onCustomFormatAdLoaded(@NonNull NativeCustomFormatAd ad) {
                  // Show the ad first and then register your view and begin open measurement.
                  // Make sure to do this on the main thread.

                  // ...
                  // Show ad
                  // ...

                  startOpenMeasurement(ad, nativeCustomFormatAdContainer);
                }
              },
              new NativeCustomFormatAd.OnCustomClickListener() {
                @Override
                public void onCustomClick(NativeCustomFormatAd ad, String assetName) {
                  // Handle the click action
                }
              })
          .build();
  adLoader.loadAd(new AdRequest.Builder().build());
}

CustomNativeOMIDSnippets.java

Kotlin

private fun loadCustomNativeAd(context: Context, nativeCustomFormatAdContainer: ViewGroup) {
  val adLoader =
    AdLoader.Builder(context, "AD_UNIT_ID")
      .forCustomFormatAd(
        "CUSTOM_TEMPLATE_ID",
        NativeCustomFormatAd.OnCustomFormatAdLoadedListener { ad ->
          // Show the ad first and then register your view and begin open measurement. Make sure
          // to do this on the main thread.

          // ...
          // Show ad
          // ...

          startOpenMeasurement(ad, nativeCustomFormatAdContainer)
        },
        NativeCustomFormatAd.OnCustomClickListener { ad, assetName ->
          // Handle the click action.
        },
      )
      .build()

  adLoader.loadAd(AdRequest.Builder().build())
}

CustomNativeOMIDSnippets.kt

מחליפים את AD_UNIT_ID ואת CUSTOM_TEMPLATE_ID במזהה של יחידת המודעות ובמזהה של התבנית המותאמת אישית.

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

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

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

היא נראית כך:

Java

private void startOpenMeasurement(
    NativeCustomFormatAd ad, ViewGroup nativeCustomFormatAdContainer) {
  DisplayOpenMeasurement displayOpenMeasurement = ad.getDisplayOpenMeasurement();
  if (displayOpenMeasurement != null) {
    displayOpenMeasurement.setView(nativeCustomFormatAdContainer);
    displayOpenMeasurement.start();
  }
}
CustomNativeOMIDSnippets.java

Kotlin

private fun startOpenMeasurement(
  ad: NativeCustomFormatAd,
  nativeCustomFormatAdContainer: ViewGroup,
) {
  ad.getDisplayOpenMeasurement()?.let { displayOpenMeasurement ->
    displayOpenMeasurement.setView(nativeCustomFormatAdContainer)
    displayOpenMeasurement.start()
  }
}

CustomNativeOMIDSnippets.kt

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

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

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

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