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üntülenebilirliğini sizin adınıza izler.

Reklam yükleme

Reklam yükleme işlemi, açık ölçüm kullanıp kullanmadığınıza bakılmaksızın aynıdır. Aşağıda, özel doğal reklam isteğinde bulunma yöntemini gösteren bir örnek verilmiştir:

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 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 doğal reklamda açık ölçümü etkinleştirmek için önce reklamı gösterin, ardından özel reklam görüntülemenizi özel doğal 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 doğal reklamınızın DisplayOpenMeasurement nesnesinde start() 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();
  }
}

Kotlin

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

Görüntülemenizi kaydetmeden önce reklamınızı göstermeniz gerektiğini unutmayın. Reklamınızın gösterilmesi Özel Doğal Reklam Biçimleri bölümünde ele alınmıştı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.