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

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())
}

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

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

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

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

היא נראית כך:

Java

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

Kotlin

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

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

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

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

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