Định dạng quảng cáo gốc tuỳ chỉnh loại Mạng Hiển thị và tiêu chí Đo lường mở

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 đo lường.

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

• SDK Quảng cáo của Google trên thiết bị di động phiên bản 18.1.1 trở lên.
• Đọc bài viết Đo lường mở bằng quảng cáo trên thiết bị di động SDK.
• Tích hợp quảng cáo gốc tuỳ chỉnh định dạng.
• Định cấu hình khả năng xem rồi chỉ định cho mục hàng của bạn.
• Nhập tên đối tác khi tạo nhóm quảng cáo tuỳ chỉnh trong giao diện người dùng Ad Manager.

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, bạn sẽ tự chịu trách nhiệm gọi các API Đo lường mở. Tính năng đo lường mở cho quảng cáo gốc tuỳ chỉnh loại hiển thị chỉ được hỗ trợ trong SDK quảng cáo trên thiết bị di động phiên bản 18.1.1 trở lên.

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

Lưu ý quan trọng: Để nhận được 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 chứng nhận là Nhà cung cấp dịch vụ đo lường có Phòng thí nghiệm công nghệ IAB.

Tải quảng cáo

Việc tải quảng cáo là giống nhau cho dù bạn đang 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 NativeCustomFormatAd:

public void loadAd() {
   AdLoader adLoader = new AdLoader.Builder(context, "YOUR-AD-UNIT-ID")
    .forCustomFormatAd("YOUR-TEMPLATE-ID",
      new NativeCustomFormatAd.OnCustomFormatAdLoadedListener() {
          @Override
          public void onCustomFormatAdLoaded(NativeCustomFormatAd ad) {
              // Register your view and begin open measurement.
              // We will define this method below.
              MyActivity.this.registerOpenMeasurementAndShowAd(ad);
          }
      },
      new NativeCustomFormatAd.OnCustomClickListener() {
          @Override
          public void onCustomClick(NativeCustomFormatAd ad, String s) {
              // Handle the click action
          }
      })
    .withAdListener( ... )
    .withNativeAdOptions( ... )
    .build();
}

Đăng ký lượt xem của bạn và bắt đầu đo lường

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

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

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

public void  registerOpenMeasurementAndShowAd(NativeCustomFormatAd ad) {

...
// Show ad
...
displayCustomFormatAd(ad)
// Begin Open Measurement
// The FrameLayout that will contain your native custom ad
FrameLayout customTemplateAdFrame = (FrameLayout) findViewById(R.id.custom_ad_frame);
ad.getDisplayOpenMeasurement().setView(customTemplateAdFrame);
ad.getDisplayOpenMeasurement().start();

}

Xin lưu ý rằng bạn phải hiển thị quảng cáo của mình trước khi đăng ký lượt xem. Đang hiển thị quảng cáo của bạn thuộc phạm vi Quảng cáo gốc tùy chỉnh Định dạng.

Bố cục customTemplateAdFrame là vùng chứa quảng cáo cho NativeCustomFormatAd và phải chứa tất cả tài sản trong giới hạn hộp của chế độ xem.

Lưu ý quan trọng: Đảm bảo bạn gọi destroy() trên NativeCustomFormatAd khi bạn đã làm xong quảng cáo, ví dụ: sau khi huỷ tham chiếu đối tượng hoặc huỷ bỏ hoạt động. Điều này đảm bảo rằng sự kiện sessionFinish của IAB sẽ đượ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, thì 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.