Đị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ở

Hướng dẫn này giải thích cách tích hợp đị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:

• Đọc bài viết Tiêu chuẩn Đo lường mở với SDK quảng cáo trên thiết bị di động.
• Tích hợp định dạng quảng cáo gốc tuỳ chỉnh formats.
• Định cấu hình nhà cung cấp dịch vụ đo lường khả năng xem và chỉ định nhà cung cấp này cho mục hàng của bạn.
• Nhập tên đối tác khi tạo định dạng tuỳ chỉnh trong giao diện người dùng Ad Manager.

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 đ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.

Điểm quan trọng:Để kết quả đo lường quảng cáo gốc tuỳ chỉnh loại hiển thị được IAB chứng nhận, bạn phải được IAB Tech Lab chứng nhận là Nhà cung cấp dịch vụ đo lường.

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

Việc tải một quảng cáo là 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());
}
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.

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

Bạn cũng cần phải cho SDK biết rõ ràng để bắt đầu đo lường quảng cáo. Để 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();
  }
}
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ý 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ị.

Quan trọng: Hãy nhớ gọi destroy() trên quảng cáo gốc tuỳ chỉnh khi bạn hoàn tất quảng cáo, chẳng hạn như sau khi huỷ tham chiếu đối tượng hoặc huỷ hoạt động. Điều này đảm bảo rằng sự kiện sessionFinish của IAB được kích hoạt.

Chứng nhận với 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.