SDK Quảng cáo của Google trên thiết bị di động đang ở chế độ bảo trì. Để sử dụng các tính năng và bản cập nhật mới nhất, hãy migrate và thiết lập GMA Next-Gen SDK.

Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

Nhắm mục tiêu

Chọn nền tảng: Android iOS Unity Flutter Android (Phiên bản cũ)

Hướng dẫn này giải thích cách cung cấp thông tin nhắm mục tiêu cho SDK Quảng cáo của Google trên thiết bị di động.

Để xem ví dụ minh hoạ, hãy tải ứng dụng Android API Demo xuống.

Tải bản minh hoạ API xuống

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

Trước khi tiếp tục, hãy thiết lập Google Mobile Ads SDK (Legacy).

RequestConfiguration

RequestConfiguration thu thập thông tin nhắm mục tiêu được áp dụng trên toàn cầu cho mọi yêu cầu quảng cáo. Để biết các thẻ nhắm mục tiêu hiện có, hãy tham khảo tài liệu về RequestConfiguration.Builder.

Để cập nhật cấu hình yêu cầu, hãy lấy một trình tạo từ cấu hình hiện có, thực hiện mọi nội dung cập nhật đã chọn và đặt cấu hình đó như sau:

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
MobileAds.setRequestConfiguration(requestConfiguration)RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration();
MobileAds.setRequestConfiguration(requestConfiguration);RequestConfigurationSnippets.java

Để đảm bảo rằng tất cả các yêu cầu quảng cáo đều áp dụng các thay đổi về cấu hình yêu cầu, hãy đặt cấu hình yêu cầu trước khi bạn Khởi chạy Google Mobile Ads SDK (Legacy).

Đặt chế độ xử lý theo độ tuổi

Để giúp bạn quản lý việc tuân thủ các quy định hiện hành về quyền riêng tư liên quan đến trẻ em và thanh thiếu niên, Google Mobile Ads SDK (Legacy) cung cấp một chế độ cài đặt xử lý theo độ tuổi. Chế độ cài đặt xử lý theo độ tuổi cho phép bạn cho biết liệu Google Mobile Ads SDK (Legacy) có nên áp dụng các biện pháp bảo vệ cụ thể khi phân phát quảng cáo cho trẻ em, thanh thiếu niên hay độ tuổi không xác định hay không.

Bạn có thể đặt chế độ xử lý theo độ tuổi bằng phương thức setAgeRestrictedTreatment() thông qua API RequestConfiguration.Builder.

Ví dụ sau đây cho biết rằng các yêu cầu quảng cáo phải áp dụng chế độ xử lý theo độ tuổi của trẻ em:

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    // Indicate that ad requests should have child age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        // Indicate that ad requests should have child age treatment.
        .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);RequestConfigurationSnippets.java

Để cho biết chế độ xử lý theo độ tuổi là thanh thiếu niên hoặc không xác định, hãy thay thế chế độ cài đặt CHILD bằng chế độ cài đặt sau:

TEEN
UNSPECIFIED

Khi sử dụng chế độ cài đặt này, Google Mobile Ads SDK (Legacy) sẽ thêm tham số tfat vào các yêu cầu quảng cáo. Hãy tham khảo ý kiến của cố vấn pháp lý để xác định chế độ xử lý theo độ tuổi áp dụng cho người dùng dựa trên các nghĩa vụ pháp lý và quy định. Để biết thêm thông tin, hãy xem bài viết Gắn thẻ yêu cầu quảng cáo để xử lý theo độ tuổi.

Di chuyển sang chế độ xử lý theo độ tuổi từ TFCD và TFUA

Chế độ xử lý theo độ tuổi sẽ thay thế các chế độ cài đặt .setTagForChildDirectedTreatment() (TFCD) và .setTagForUnderAgeOfConsent() (TFUA) không được dùng nữa.

Bảng sau đây cho thấy các chế độ cài đặt TFCD và TFUA cũng như các chế độ xử lý theo độ tuổi tương đương:

TFCD

`TFCD`	Xử lý theo độ tuổi
`TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE`	`AgeRestrictedTreatment.CHILD`
`TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE`	`AgeRestrictedTreatment.UNSPECIFIED`
`TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED`	`AgeRestrictedTreatment.UNSPECIFIED`
Không có giá trị được chỉ định `.setTagForChildDirectedTreatment()`	`AgeRestrictedTreatment.UNSPECIFIED`
Không có phiên bản mới	`AgeRestrictedTreatment.TEEN`

TFUA

`TFUA`	Xử lý theo độ tuổi
`TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE`	`AgeRestrictedTreatment.CHILD`
`TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE`	`AgeRestrictedTreatment.UNSPECIFIED`
`TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED`	`AgeRestrictedTreatment.UNSPECIFIED`
Không có giá trị được chỉ định `.setTagForUnderAgeOfConsent()`	`AgeRestrictedTreatment.UNSPECIFIED`
Không có phiên bản mới	`AgeRestrictedTreatment.TEEN`

Tìm hiểu các lượt tương tác xử lý theo độ tuổi với TFCD và TFUA

Nếu bạn đặt chế độ xử lý theo độ tuổi cùng với các chế độ cài đặt TFCD (Gắn thẻ là Được dành cho trẻ em) hoặc TFUA (Thẻ dành cho người dùng dưới độ tuổi hợp pháp), thì Google sẽ áp dụng chế độ xử lý thận trọng nhất.

Chuyển tiếp thông tin xử lý theo độ tuổi bằng tính năng dàn xếp

Nếu bạn đặt chế độ xử lý theo độ tuổi bằng Google Mobile Ads SDK (Legacy), thì các bộ chuyển đổi dàn xếp sẽ chuyển tiếp tín hiệu xử lý theo độ tuổi đến các SDK dàn xếp của bên thứ ba.

Bảng sau đây liệt kê các phiên bản bộ chuyển đổi dàn xếp hỗ trợ việc chuyển tiếp tín hiệu xử lý theo độ tuổi bị hạn chế cho SDK dàn xếp của bên thứ ba:

Tên bộ chuyển đổi dàn xếp	Phiên bản tối thiểu được hỗ trợ
AppLovin	13.6.3.0
BidMachine	3.7.1.1
Bigo	5.9.0.1
Chartboost	9.12.1.1
DTExchange (Fyber)	8.4.5.1
i-mobile	2.3.2.4
InMobi	11.3.0.1
IronSource	9.4.3.0
Liftoff Monetize (Vungle)	7.7.4.2
LY (Line)	3.1.1.1
maio	2.0.9.0
Meta (Facebook)	6.21.0.4
Mintegral	17.1.61.1
Moloco	4.10.0.0
MyTarget	5.47.1.1
Pangle	8.1.0.3.1
PubMatic	5.1.2.2
Verve	3.9.0.0

Chế độ cài đặt hướng đến trẻ em

Nhằm tuân thủ Đạo luật bảo vệ quyền riêng tư của trẻ em trên mạng (COPPA), chúng tôi cung cấp cho bạn một chế độ cài đặt có tên là "gắn thẻ là được dành cho trẻ em". Khi cài đặt thẻ này, bạn xác nhận rằng thông báo này là chính xác và bạn được uỷ quyền để hành động thay mặt chủ sở hữu của ứng dụng. Bạn hiểu rằng nếu bạn sử dụng chế độ cài đặt này sai mục đích, thì Tài khoản Google của bạn có thể sẽ ngừng hoạt động.

Là nhà phát triển ứng dụng, bạn có thể cho biết liệu bạn có muốn Google xem nội dung của bạn là hướng đến trẻ em hay không khi bạn đưa ra yêu cầu quảng cáo. Nếu bạn cho biết rằng bạn muốn Google xem nội dung của bạn là hướng đến trẻ em, chúng tôi sẽ thực hiện các bước để tắt quảng cáo dựa trên mối quan tâm và quảng cáo tái tiếp thị trong yêu cầu quảng cáo đó.

Bạn có thể áp dụng chế độ cài đặt dành cho trẻ em thông qua setTagForChildDirectedTreatment():

Gọi setTagForChildDirectedTreatment bằng TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE để cho biết rằng bạn muốn Google xem nội dung của bạn là hướng tới trẻ em theo COPPA. Chế độ cài đặt này sẽ ngăn việc truyền giá trị nhận dạng cho quảng cáo trên Android (AAID).
Gọi setTagForChildDirectedTreatment bằng TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE để cho biết rằng bạn không muốn nội dung của mình được coi là hướng đến trẻ em theo COPPA.
Gọi setTagForChildDirectedTreatment bằng TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED nếu bạn không muốn chỉ định cách bạn muốn nội dung của mình được xử lý theo COPPA trong các yêu cầu quảng cáo.

Ví dụ sau đây cho biết rằng bạn muốn nội dung của mình được coi là hướng đến trẻ em theo COPPA:

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setTagForChildDirectedTreatment(
            RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);RequestConfigurationSnippets.java

Người dùng chưa đủ độ tuổi hợp pháp để tự quản lý tài khoản

Bạn có thể đánh dấu các yêu cầu quảng cáo của mình để áp dụng biện pháp xử lý dành cho những người dùng chưa đủ độ tuổi hợp pháp để tự quản lý tài khoản ở Khu vực kinh tế Châu Âu (EEA). Tính năng này được thiết kế để giúp bạn dễ dàng tuân thủ Quy định chung về việc bảo vệ dữ liệu (GDPR). Bạn có thể có các nghĩa vụ pháp lý khác theo GDPR. Xem hướng dẫn của Liên minh Châu Âu và tham khảo ý kiến cố vấn pháp lý riêng của bạn. Các công cụ của Google được thiết kế để tạo điều kiện cho việc tuân thủ và không giảm trừ nghĩa vụ theo luật của bất kỳ nhà xuất bản nào. Tìm hiểu thêm về những ảnh hưởng của GDPR đến nhà xuất bản.

Khi sử dụng tính năng này, một tham số Gắn thẻ là Dưới độ tuổi hợp pháp để tự quản lý tài khoản ở Châu Âu (TFUA) sẽ được đưa vào yêu cầu quảng cáo. Tham số này vô hiệu hoá quảng cáo được cá nhân hoá (bao gồm cả hoạt động tái tiếp thị) đối với tất cả các yêu cầu quảng cáo. Thông số này cũng vô hiệu hoá các yêu cầu đối với nhà cung cấp quảng cáo bên thứ ba, chẳng hạn như pixel đo lường quảng cáo và máy chủ quảng cáo của bên thứ ba.

Giống như chế độ cài đặt hướng đến trẻ em, có một phương thức trong RequestConfiguration.Builder để đặt tham số TFUA: setTagForUnderAgeOfConsent(), với các lựa chọn sau.

Gọi setTagForUnderAgeOfConsent() bằng TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE để cho biết rằng bạn muốn yêu cầu quảng cáo áp dụng biện pháp xử lý dành cho những người dùng chưa đủ độ tuổi hợp pháp để tự quản lý tài khoản ở Khu vực kinh tế Châu Âu (EEA). Chế độ cài đặt này cũng ngăn việc truyền giá trị nhận dạng cho quảng cáo trên Android (AAID).
Gọi setTagForUnderAgeOfConsent() bằng TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE để cho biết rằng bạn không muốn yêu cầu quảng cáo nhận được biện pháp xử lý dành cho những người dùng dưới độ tuổi hợp pháp để tự quản lý tài khoản ở Khu vực kinh tế Châu Âu (EEA).
Gọi setTagForUnderAgeOfConsent() bằng TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED để cho biết rằng bạn chưa chỉ định liệu yêu cầu quảng cáo có nên áp dụng biện pháp xử lý dành cho những người dùng ở Khu vực kinh tế Châu Âu (EEA) dưới độ tuổi hợp pháp để tự quản lý tài khoản hay không.

Ví dụ sau đây cho biết rằng bạn muốn TFUA được đưa vào yêu cầu quảng cáo:

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);RequestConfigurationSnippets.java

Bạn không nên đặt đồng thời cả thẻ để bật chế độ cài đặt hướng đến trẻ em và setTagForUnderAgeOfConsent() thành true. Nếu bạn cài đặt như vậy, thì chế độ cài đặt hướng đến trẻ em sẽ được ưu tiên áp dụng.

Lọc nội dung quảng cáo

Để tuân thủ Chính sách về quảng cáo không phù hợp của Google Play (bao gồm cả các ưu đãi liên quan trong quảng cáo), tất cả quảng cáo và các ưu đãi liên quan xuất hiện trong ứng dụng của bạn phải phù hợp với mức phân loại nội dung của ứng dụng, ngay cả khi bản thân nội dung đó tuân thủ các chính sách của Google Play.

Các công cụ như mức phân loại nội dung quảng cáo tối đa có thể giúp bạn kiểm soát nội dung của quảng cáo hiển thị cho người dùng hiệu quả hơn. Bạn có thể đặt mức phân loại nội dung tối đa để giúp tuân thủ các chính sách của nền tảng.

Các ứng dụng có thể đặt mức phân loại nội dung quảng cáo tối đa cho yêu cầu quảng cáo bằng cách sử dụng phương thức setMaxAdContentRating. Quảng cáo AdMob được trả về khi bạn định cấu hình chế độ này có mức phân loại nội dung bằng hoặc thấp hơn cấp độ đó. Các giá trị có thể có cho thông tin bổ sung về mạng này dựa trên phân loại nhãn nội dung kỹ thuật số và phải là một trong các chuỗi sau:

MAX_AD_CONTENT_RATING_G
MAX_AD_CONTENT_RATING_PG
MAX_AD_CONTENT_RATING_T
MAX_AD_CONTENT_RATING_MA

Đoạn mã sau đây định cấu hình một đối tượng RequestConfiguration để chỉ định rằng nội dung quảng cáo được trả về phải tương ứng với chỉ định nhãn nội dung kỹ thuật số không cao hơn G:

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);RequestConfigurationSnippets.java

Tìm hiểu thêm về cách đặt mức phân loại nội dung tối đa cho từng yêu cầu quảng cáo.

Cách nhà xuất bản xử lý quyền riêng tư (Thử nghiệm)

API Cách nhà xuất bản xử lý quyền riêng tư (PPT) là một công cụ không bắt buộc cho phép các ứng dụng cho biết liệu có tắt tính năng cá nhân hoá quảng cáo cho tất cả các yêu cầu quảng cáo bằng phương thức setPublisherPrivacyPersonalizationState() hay không. Khi sử dụng tính năng này, một thông số cách nhà xuất bản xử lý quyền riêng tư (PPT) sẽ được đưa vào tất cả các yêu cầu quảng cáo trong tương lai đối với phần còn lại của phiên hoạt động.

Theo mặc định, các yêu cầu quảng cáo đến Google sẽ phân phát quảng cáo được cá nhân hoá. Đoạn mã sau sẽ tắt tính năng cá nhân hoá quảng cáo cho tất cả các yêu cầu quảng cáo:

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setPublisherPrivacyPersonalizationState(
      RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED
    )
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setPublisherPrivacyPersonalizationState(
            RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);RequestConfigurationSnippets.java

Yêu cầu quảng cáo

Đối tượng AdManagerAdRequest thu thập thông tin nhắm mục tiêu để gửi cùng với yêu cầu quảng cáo.

Thêm thông tin bổ sung của mạng truyền hình

Thông số bổ sung của mạng là thông tin chi tiết bổ sung được gửi cùng với yêu cầu quảng cáo và dành riêng cho một nguồn quảng cáo duy nhất.

Đoạn mã sau đây đặt một khoá tham số bổ sung là collapsible với giá trị bottom cho Google:

Kotlin

val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest =
  AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()
adView.loadAd(adRequest)AdRequestSnippets.kt

Java

Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
AdRequest adRequest =
    new AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();
adView.loadAd(adRequest);AdRequestSnippets.java

Nhắm mục tiêu tuỳ chỉnh

Bạn có thể truyền các cặp khoá-giá trị tuỳ chỉnh để nhắm đến các chiến dịch (mục hàng) trên Google Ad Manager. Ví dụ sau đây truyền một cặp khoá-giá trị tuỳ chỉnh trong yêu cầu quảng cáo:

Kotlin

// Example: Pass custom targeting "age=25".
val newRequest = AdManagerAdRequest.Builder().addCustomTargeting("age", "25").build()AdRequestSnippets.kt

Java

// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest =
    new AdManagerAdRequest.Builder().addCustomTargeting("age", "25").build();AdRequestSnippets.java

Bạn có thể truyền nhiều giá trị cho một khoá dưới dạng danh sách các chuỗi. Ví dụ: để nhắm đến những cá nhân ở độ tuổi từ 23 đến 27 thay vì chỉ nhắm đến những người 25 tuổi.

Kotlin

.addCustomTargeting("age", listOf("24", "25", "26"))AdRequestSnippets.kt

Java

.addCustomTargeting("age", Arrays.asList("24", "25", "26"))AdRequestSnippets.java

Hãy xem ví dụ về nhắm mục tiêu tùy chỉnh của Ad Manager để biết cách triển khai nhắm mục tiêu tùy chỉnh trong ứng dụng minh họa Android API.

Loại trừ danh mục

Bạn có thể thêm cấp loại trừ danh mục ở cấp vị trí vào một yêu cầu bằng cách sử dụng phương thức addCategoryExclusion():

Kotlin

// Example: Exclude "automobile" and "boat" categories.
val newRequest =
  AdManagerAdRequest.Builder()
    .addCategoryExclusion("automobile")
    .addCategoryExclusion("boat")
    .build()AdRequestSnippets.kt

Java

// Example: Exclude "automobile" and "boat" categories.
AdManagerAdRequest newRequest =
    new AdManagerAdRequest.Builder()
        .addCategoryExclusion("automobile")
        .addCategoryExclusion("boat")
        .build();AdRequestSnippets.java

Hãy xem ví dụ về Tiêu chí loại trừ danh mục của Ad Manager để biết cách triển khai tiêu chí loại trừ danh mục trong ứng dụng Android API Demo.

Giá trị nhận dạng do nhà xuất bản cung cấp

Bạn có thể đặt giá trị nhận dạng do nhà xuất bản cung cấp (PPID) để sử dụng trong tính năng giới hạn tần suất, nhắm mục tiêu và phân khúc đối tượng, xoay vòng quảng cáo tuần tự và các chế độ kiểm soát phân phối quảng cáo dựa trên đối tượng khác trên các thiết bị.

Dưới đây là ví dụ về cách đặt PPID:

Kotlin

val adRequest = AdManagerAdRequest.Builder().setPublisherProvidedId("AB123456789").build()AdRequestSnippets.kt

Java

AdManagerAdRequest adRequest =
    new AdManagerAdRequest.Builder().setPublisherProvidedId("AB123456789").build();AdRequestSnippets.java

Hãy xem ví dụ về PPID của Ad Manager để biết cách triển khai giá trị nhận dạng do nhà xuất bản cung cấp (PPID) trong ứng dụng Android API Demo.

Tín hiệu do nhà xuất bản cung cấp

Bạn có thể gửi dữ liệu đối tượng và dữ liệu bối cảnh dưới dạng tín hiệu do nhà xuất bản cung cấp (PPS) trong các yêu cầu quảng cáo. Với PPS, bạn có thể sử dụng dữ liệu người dùng để cải thiện hoạt động kiếm tiền có lập trình bằng cách truyền đạt đặc điểm đối tượng của bạn cho các bên đặt giá thầu trong tất cả các loại giao dịch, sử dụng các hệ thống phân loại tiêu chuẩn mà không cần chia sẻ giá trị nhận dạng người dùng. Đặc điểm đối tượng của bạn có thể bao gồm dữ liệu hành vi và dữ liệu dựa trên mối quan tâm (Hệ thống phân loại đối tượng 1.1 của IAB) và dữ liệu theo bối cảnh (Hệ thống phân loại nội dung 2.2 của IAB).

Kotlin

val extras = Bundle()
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6, 284))
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4, 5, 6))

val request =
  AdManagerAdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()AdRequestSnippets.kt

Java

Bundle extras = new Bundle();
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", new ArrayList<>(Arrays.asList(6, 284)));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", new ArrayList<>(Arrays.asList(4, 5, 6)));

AdManagerAdRequest request =
    new AdManagerAdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();AdRequestSnippets.java

URL nội dung

Để cung cấp URL nội dung cho quảng cáo nhắm đến nội dung và đảm bảo an toàn cho thương hiệu, hãy thêm những thông tin sau:

Kotlin

val builder = AdManagerAdRequest.Builder()
builder.setContentUrl("https://www.example.com")
val request = builder.build()AdRequestSnippets.kt

Java

AdManagerAdRequest.Builder builder = new AdManagerAdRequest.Builder();
builder.setContentUrl("https://www.example.com");
AdManagerAdRequest request = builder.build();AdRequestSnippets.java

An toàn thương hiệu (Thử nghiệm)

Những ứng dụng hiển thị nội dung động dành cho nhiều đối tượng đều có thể cung cấp một danh sách ngắn gồm các URL:

Kotlin

val urls =
  mutableListOf(
    "https://www.mycontenturl1.com",
    "https://www.mycontenturl2.com",
    "https://www.mycontenturl3.com",
    "https://www.mycontenturl4.com",
  )

val requestWithContent = AdManagerAdRequest.Builder().setNeighboringContentUrls(urls).build()AdRequestSnippets.kt

Java

List<String> urls =
    Arrays.asList(
        "https://www.mycontenturl1.com",
        "https://www.mycontenturl2.com",
        "https://www.mycontenturl3.com",
        "https://www.mycontenturl4.com");

AdManagerAdRequest requestWithContent =
    new AdManagerAdRequest.Builder().setNeighboringContentUrls(urls).build();AdRequestSnippets.java

.setNeighboringContentUrls() khác với .setContentUrl() ở chỗ chỉ được dùng cho mục đích an toàn thương hiệu.

Nhắm mục tiêu Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

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

RequestConfiguration

Kotlin

Java

Đặt chế độ xử lý theo độ tuổi

Kotlin

Java

Di chuyển sang chế độ xử lý theo độ tuổi từ TFCD và TFUA

TFCD

TFUA

Tìm hiểu các lượt tương tác xử lý theo độ tuổi với TFCD và TFUA

Chuyển tiếp thông tin xử lý theo độ tuổi bằng tính năng dàn xếp

Chế độ cài đặt hướng đến trẻ em

Kotlin

Java

Người dùng chưa đủ độ tuổi hợp pháp để tự quản lý tài khoản

Kotlin

Java

Lọc nội dung quảng cáo

Kotlin

Java

Cách nhà xuất bản xử lý quyền riêng tư (Thử nghiệm)

Kotlin

Java

Yêu cầu quảng cáo

Thêm thông tin bổ sung của mạng truyền hình

Kotlin

Java

Nhắm mục tiêu tuỳ chỉnh

Kotlin

Java

Kotlin

Java

Loại trừ danh mục

Kotlin

Java

Giá trị nhận dạng do nhà xuất bản cung cấp

Kotlin

Java

Tín hiệu do nhà xuất bản cung cấp

Kotlin

Java

URL nội dung

Kotlin

Java

An toàn thương hiệu (Thử nghiệm)

Kotlin

Java

Nhắm mục tiêu