Görüntülü reklam türü özel yerel reklam biçimleri ve Open Measurement

Bu kılavuzda, özel doğal reklam biçimlerinin açık ölçümle nasıl entegre edileceği açıklanmaktadır.

Ön koşullar

Devam etmeden önce aşağıdakileri yapın:

Entegrasyon

Video öğesi içermeyen özel doğal reklam biçimleriyle açık ölçüm kullanmayı planlıyorsanız Open Measurement API'lerini kendiniz çağırmakla sorumlu olursunuz.

Video öğesi içeren özel doğal reklam biçimleri kullanıyorsanız bu kılavuzu uygulamanız gerekmez. Mobile Ads SDK, video öğesinin görünürlüğünü sizin adınıza izler.

Reklam yükleme

Açık ölçüm kullanıp kullanmadığınıza bakılmaksızın reklam yükleme işlemi aynıdır. Aşağıda, özel bir doğal reklamın nasıl isteneceği gösterilmektedir:

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 ve CUSTOM_TEMPLATE_ID yerine reklam birimi kimliğinizi ve özel şablon kimliğinizi yazın.

Görünümünüzü kaydedin ve ölçüme başlayın

Özel bir yerel reklamda açık ölçümü etkinleştirmek için önce reklamı gösterin, ardından özel reklam görünümünüzü özel yerel reklamla ilişkili DisplayOpenMeasurement nesnesiyle kaydedin. DisplayOpenMeasurement nesnesi, kapsayıcı görünümünüzü açık ölçümle kaydetmek için setView() yöntemini sağlar.

Ayrıca SDK'ya reklamınızı ölçmeye başlamasını açıkça söylemeniz gerekir. Bunu yapmak için özel yerel reklamınızın start() nesnesinde DisplayOpenMeasurement yöntemini çağırın. start() yöntemi ana iş parçacığından çağrılmalıdır ve sonraki çağrıların etkisi yoktur.

Bu sekme aşağıdaki gibi görünür:

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

Görüntülemenizi kaydetmeden önce reklamınızı göstermeniz gerektiğini unutmayın. Reklamınızın gösterilmesi Özel Yerel Reklam Biçimleri bölümünde açıklanmaktadır.

customTemplateAdFrame Düzen, özel doğal reklamın reklam kapsayıcısıdır ve görünümün sınırlayıcı kutusundaki tüm öğeleri içermelidir.

IAB ile sertifika alma

Uygulamanızı yayınladıktan sonra ölçüm verileri almaya başlarsınız ancak IAB sertifika sürecini tamamlayana kadar verileriniz sertifikalandırılmaz.