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
- SDK quảng cáo trên thiết bị di động của Google phiên bản 18.1.1 trở lên.
- Hãy đọc bài viết Đo lường mở bằng SDK quảng cáo trên thiết bị di động.
- Tích hợp các định dạng quảng cáo gốc tuỳ chỉnh.
- Đị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 đó 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 dự định sử dụng tính năng đo lường mở với những định dạng quảng cáo gốc tuỳ chỉnh không chứa thành phần video, bạn sẽ có trách nhiệm tự gọi API Đo lường mở. Tính năng đo lường mở cho các định dạng quảng cáo gốc tuỳ chỉnh loại hiển thị chỉ được SDK quảng cáo trên thiết bị di động phiên bản 18.1.1 trở lên hỗ trợ.
Nếu đang sử dụng định dạng quảng cáo gốc tuỳ chỉnh với một 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 mặt bạn theo dõi khả năng xem của thành phần video đó.
Bây giờ, hãy xem cách sử dụng tính năng đo lường mở bằng NativeCustomTemplateAd. Nhìn chung, bạn cần thông báo cho SDK quảng cáo trên thiết bị di động khi muốn bắt đầu đo lường khả năng xem và để đăng ký chế độ xem quảng cáo tuỳ chỉnh.
Tải quảng cáo
Bất kể bạn có sử dụng tính năng đo lường mở hay không, việc tải quảng cáo là như nhau. Dưới đây là
phương thức minh hoạ cách yêu cầu NativeCustomTemplateAd:
public void loadAd() {
AdLoader adLoader = new AdLoader.Builder(context, "YOUR-AD-UNIT-ID")
.forCustomTemplateAd("YOUR-TEMPLATE-ID",
new NativeCustomTemplateAd.OnCustomTemplateAdLoadedListener() {
@Override
public void onCustomTemplateAdLoaded(NativeCustomTemplateAd ad) {
// Register your view and begin open measurement.
// We will define this method below.
MyActivity.this.registerOpenMeasurementAndShowAd(ad);
}
},
new NativeCustomTemplateAd.OnCustomClickListener() {
@Override
public void onCustomClick(NativeCustomTemplateAd ad, String s) {
// Handle the click action
}
})
.withAdListener( ... )
.withNativeAdOptions( ... )
.build();
}
Đăng ký chế độ xem của bạn và bắt đầu đo lường
Để bật tính năng đo lường mở trên NativeCustomTemplateAd, hãy đăng ký chế độ xem
quảng cáo tuỳ chỉnh của bạn bằng đối tượng DisplayOpenMeasurement liên kết với
NativeCustomTemplateAd. Đối tượng DisplayOpenMeasurement cung cấp phương thức setView() để đăng ký chế độ đo lường mở cho khung hiển thị vùng chứa của bạn.
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 mình. Để 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 NativeCustomTemplateAd. Phương thức start() phải được gọi từ luồng chính và các lệnh gọi tiếp theo không có hiệu lực.
Tab Thanh toán sẽ giống như bên dưới:
public void registerOpenMeasurementAndShowAd(NativeCustomTemplateAd ad) {
...
// Show ad
...
displayCustomTemplateAd(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();
}
Lưu ý rằng bạn nên hiển thị quảng cáo trước khi đăng ký lượt xem. Bạn nên hiển thị quảng cáo của mình trong Đị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 NativeCustomTemplateAd 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 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.