Định dạng quảng cáo gốc tuỳ chỉnh loại hiển thị và giải pháp Đo lường mở

Tài liệu hướng dẫn này giải thích cách tích hợp các định dạng quảng cáo gốc tuỳ chỉnh với tính năng đo lường mở.

Điều kiện tiên quyết

Trước khi tiếp tục, hãy làm như sau:

Tích hợp

Nếu dự định sử dụng tính năng đo lường mở với các định dạng quảng cáo gốc tuỳ chỉnh không chứa thành phần video, thì bạn sẽ phải tự gọi các API Đo lường mở.

Nếu đang sử dụng định dạng quảng cáo gốc tuỳ chỉnh có thành phần video, bạn không cần làm theo hướng dẫn này; SDK Quảng cáo trên thiết bị di động sẽ thay bạn theo dõi khả năng xem của thành phần video.

Tải một quảng cáo

Việc tải quảng cáo sẽ giống nhau cho dù bạn có sử dụng tính năng đo lường công khai hay không. Sau đây là một phương thức minh hoạ cách yêu cầu một quảng cáo gốc tuỳ chỉnh:

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

Thay thế AD_UNIT_ID và CUSTOM_TEMPLATE_ID bằng mã đơn vị quảng cáo và mã mẫu tuỳ chỉnh của bạn.

Đăng ký khung hiển thị và bắt đầu đo lường

Để bật tính năng đo lường mở trên một quảng cáo gốc tuỳ chỉnh, trước tiên, hãy hiển thị quảng cáo đó, sau đó đăng ký chế độ xem quảng cáo tuỳ chỉnh bằng đối tượng DisplayOpenMeasurement được liên kết với quảng cáo gốc tuỳ chỉnh. Đối tượng DisplayOpenMeasurement cung cấp phương thức setView() để đăng ký chế độ xem vùng chứa bằng tính năng đo lường nguồn mở.

Bạn cũng cần cho SDK biết một cách rõ ràng để bắt đầu đo lường quảng cáo của bạn. Để làm việc này, hãy gọi phương thức start() trên đối tượng DisplayOpenMeasurement của quảng cáo gốc tuỳ chỉnh. Bạn phải gọi phương thức start() từ luồng chính và các lệnh gọi tiếp theo sẽ không có hiệu lực.

Tab Thanh toán sẽ giống như bên dưới:

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

Xin lưu ý rằng bạn nên hiển thị quảng cáo trước khi đăng ký lượt xem. Việc hiển thị quảng cáo của bạn được đề cập trong phần Định dạng quảng cáo gốc tuỳ chỉnh.

Bố cục customTemplateAdFrame là vùng chứa quảng cáo cho quảng cáo gốc tuỳ chỉnh và phải chứa tất cả các thành phần trong hộp giới hạn của khung hiển thị.

Chứng nhận thông qua IAB

Sau khi phát hành ứng dụng, bạn sẽ bắt đầu nhận được dữ liệu đo lường; tuy nhiên, dữ liệu của bạn sẽ không được chứng nhận cho đến khi bạn hoàn tất quy trình chứng nhận của IAB.