Đị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 bạn 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 API Đo lường mở.

Nếu bạn đang sử dụng các định dạng quảng cáo gốc tuỳ chỉnh có thành phần video, thì 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 một quảng cáo sẽ giống nhau cho dù bạn có sử dụng tính năng đo lường mở hay không. Sau đây là một phương thức minh hoạ cách yêu cầu 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());
}

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

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 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ý khung hiển thị 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ý khung hiển thị vùng chứa của bạn bằng tính năng đo lường mở.

Bạn cũng cần phải yêu cầu SDK bắt đầu đo lường quảng cáo của mình một cách rõ ràng. Để thực hiện 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();
  }
}

Kotlin

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

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

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ả thành phần trong hộp giới hạn của khung hiển thị.

Chứng nhận bằng 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.