URL minh bạch về quảng cáo cho phép bạn tuỳ chỉnh biểu tượng AdChoices xuất hiện trong một số quảng cáo. Theo mặc định, biểu tượng này xuất hiện cho người dùng thông qua trải nghiệm Minh bạch và kiểm soát quảng cáo (AT&C) do Google hiển thị, bao gồm thông tin như nhà quảng cáo và chính quảng cáo đó.
Bạn có thể lấy URL minh bạch về quảng cáo bằng cách tạo yêu cầu quảng cáo cho SDK Quảng cáo của Google trên thiết bị di động và nhận được phản hồi có URL minh bạch về quảng cáo. Sau khi nhận được URL trong ứng dụng, bạn có thể tích hợp một biểu tượng được cá nhân hoá có thể tuân thủ thiết kế của quảng cáo và trình bày trải nghiệm AT&C của riêng bạn cho người dùng.
Trang này trình bày cách yêu cầu, phân tích cú pháp và xác thực URL minh bạch về quảng cáo.
Điều kiện tiên quyết
Trước khi tiếp tục, hãy đảm bảo bạn hoàn tất những việc sau:
- Thiết lập quảng cáo gốc trong ứng dụng. Để biết thông tin chi tiết về quảng cáo gốc, hãy xem bài viết Quảng cáo gốc.
- Yêu cầu quyền truy cập vào danh sách cho phép đối với tính năng này. Để yêu cầu quyền truy cập, hãy liên hệ với người quản lý tài khoản của bạn.
- Nếu bạn không có quyền truy cập, thì phản hồi của bạn sẽ không trả về URL minh bạch về quảng cáo và biểu tượng mặc định sẽ hiển thị như dự kiến.
Yêu cầu URL
Để GMA Next-Gen SDK trả về URL minh bạch về quảng cáo, bạn hãy thêm một tham số yêu cầu bổ sung vào các yêu cầu quảng cáo gốc. Tham số này báo hiệu rằng ứng dụng của bạn đã sẵn sàng và được chuẩn bị để xử lý một biểu tượng được cá nhân hoá.
Trong yêu cầu, bạn phải thêm khoá "ad_transparency_url_requested" có giá trị "1" vào thông tin bổ sung của mạng. Để biết thông tin chi tiết về thông tin bổ sung của mạng,
hãy xem
setGoogleExtrasBundle
.
Ví dụ sau đây đặt khoá và giá trị này để yêu cầu URL minh bạch về quảng cáo:
Java
private void loadNativeAd() {
// Create an extra parameter that signals your AT&C implementation.
Bundle extras = new Bundle();
extras.putString("ad_transparency_url_requested", "1");
NativeAdRequest adRequest = new NativeAdRequest.Builder("AD_UNIT_ID", List.of(NativeAdType.NATIVE))
.setGoogleExtrasBundle(extras)
.build();
}
Kotlin
private fun loadNativeAd() {
// Create an extra parameter that signals your AT&C implementation
val extras = Bundle()
extras.putString("ad_transparency_url_requested", "1");
val adRequest = NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
.setGoogleExtrasBundle(extras)
.build()
}
Thay thế AD_UNIT_ID bằng mã đơn vị quảng cáo của bạn. Ví dụ: ca-app-pub-3940256099942544/2247696110 cho quảng cáo gốc.
Phân tích cú pháp URL
Sau khi yêu cầu URL, bạn sẽ nhận được phản hồi quảng cáo có URL minh bạch về quảng cáo trong đối tượng thông tin phản hồi. Để biết thông tin chi tiết về đối tượng thông tin phản hồi, hãy xem bài viết Thông tin phản hồi.
Bạn có thể truy cập vào URL minh bạch về quảng cáo trong khoá "ad_transparency_url"
từ thông tin bổ sung đi kèm phản hồi. Ví dụ sau đây sẽ lấy URL minh bạch về quảng cáo trong đối tượng thông tin phản hồi:
Java
nativeAd.getResponseInfo().getResponseExtras().getString("ad_transparency_url");
Kotlin
nativeAd.getResponseInfo().responseExtras.getString("ad_transparency_url")
Xác thực URL
Để kiểm thử và xác thực URL minh bạch về quảng cáo, hãy xác minh rằng bạn không thấy biểu tượng mặc định do Google cung cấp trong quảng cáo gốc, mà là biểu tượng được cá nhân hoá. Nhấp vào biểu tượng để xem trải nghiệm AT&C.
Ngoài ra, hãy xác minh rằng bạn thấy URL minh bạch về quảng cáo từ thông tin bổ sung đi kèm phản hồi trong đối tượng thông tin phản hồi. Nếu bạn không thấy URL minh bạch về quảng cáo, thì biểu tượng mặc định của Google sẽ hiển thị thay cho biểu tượng được cá nhân hoá. Sau đây là ví dụ về URL minh bạch về quảng cáo:
https://adssettings.google.com/whythisad?source=display&reasons=REASON_ID