Nhắm mục tiêu

Chọn nền tảng: Android iOS Unity Flutter

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 trên thiết bị di động của Google.

Để xem ví dụ về cách thực hiện, bạn 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, thiết lập Google Mobile Ads SDK.

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 trình tạo từ cấu hình hiện có, thực hiện mọi bản cập nhật đã chọn và đặt 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ả 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.

Đặ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 cung cấp chế độ xử lý theo độ tuổi. Chế độ xử lý theo độ tuổi cho phép bạn cho biết liệu Google Mobile Ads SDK có nên áp dụng các biện pháp bảo vệ cụ thể trong hoạt động phân phát quảng cáo cho trẻ em hoặc thanh thiếu niên hay không. Khi bạn sử dụng chế độ cài đặt này, Google Mobile Ads SDK sẽ đưa 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ý độ 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 từ một ứng dụng để áp dụng chế độ xử lý hạn chế theo độ tuổi.

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

Đặt chế độ xử lý theo độ tuổi của trẻ em

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

Java

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

Kotlin

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

Đặt chế độ xử lý theo độ tuổi của thanh thiếu niên

Ví dụ sau cho biết rằng các yêu cầu quảng cáo phải được xử lý theo độ tuổi của thanh thiếu niên:

Java

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

Kotlin

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

Đặt chế độ xử lý theo độ tuổi không cụ thể

Ví dụ sau cho biết rằng các yêu cầu quảng cáo không được xử lý theo độ tuổi cụ thể:

Java

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

Kotlin

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

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òn được dùng nữa.

Bảng sau đây cho thấy các chế độ cài đặt TFCD và TFUA cùng với 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ị nào đượ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ị nào được chỉ định .setTagForUnderAgeOfConsent()	AgeRestrictedTreatment.UNSPECIFIED
Không có phiên bản mới	AgeRestrictedTreatment.TEEN

Tìm hiểu về các 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 hoặc TFUA, thì Google sẽ áp dụng chế độ xử lý thận trọng nhất.

Lưu ý: Đối với các ứng dụng trong Chương trình Thiết kế cho gia đình như Ứng dụng chủ yếu dành cho trẻ em và người dùng đã đăng nhập vào Tài khoản Google do Family Link quản lý, mọi nội dung sẽ tự động được xem là hướng tới trẻ em đối với tất cả yêu cầu quảng cáo.

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

Cảnh báo: Phương thức setTagForChildDirectedTreatment() không còn được dùng nữa. Thay vào đó, đặt phương thức setAgeRestrictedTreatment().

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". Bằng việc đặ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 cho chủ sở hữu ứng dụng. Bạn hiểu rằng hành vi lạm dụng chế độ cài đặt này có thể khiến Tài khoản Google của bạn bị chấm dứt.

Nếu là nhà phát triển ứng dụng thì 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 thực hiện 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, thì chúng tôi sẽ thực hiện các bước để tắt quảng cáo tái tiếp thị và quảng cáo dựa trên mối quan tâm (IBA) cho 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 nội dung của mình được xem là hướng đến trẻ em nhằm tuân thủ COPPA. Thao tác này sẽ ngăn việc truyền mã 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 bị xem là hướng đến trẻ em cho mục đích của COPPA.

• Gọi setTagForChildDirectedTreatment bằng TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED nếu bạn không muốn cho biết cách bạn muốn Google xử lý nội dung của bạn theo COPPA trong các yêu cầu quảng cáo.

Ví dụ sau cho biết rằng bạn muốn nội dung của mình được xem là hướng đến trẻ em nhằm tuân thủ 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

Lưu ý: Đối với các ứng dụng trong Chương trình Thiết kế cho gia đình như Ứng dụng chủ yếu dành cho trẻ em và người dùng đã đăng nhập vào Tài khoản Google do Family Link quản lý, mọi nội dung sẽ tự động được xem là hướng tới trẻ em đối với tất cả yêu cầu quảng cáo.

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

Cảnh báo: Phương thức setTagForUnderAgeOfConsent() không còn được dùng nữa. Thay vào đó, đặt phương thức setAgeRestrictedTreatment().

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). Xin lưu ý rằng 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ủa cố vấn pháp lý riêng. Xin lưu ý rằng 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 đối với nhà xuất bản.

Khi sử dụng tính năng này, tham số Thẻ dành cho người dùng 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 tiếp thị lại) đối với tất cả các yêu cầu quảng cáo. Tham số này cũng vô hiệu hóa 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 bên thứ ba.

Giống như các 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 người dùng ở Khu vực kinh tế Châu Âu (EEA) chưa đủ độ tuổi hợp pháp để tự quản lý tài khoản. Thao tác này cũng sẽ ngăn việc truyền mã 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 áp dụng biện pháp xử lý dành cho 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).

• Gọi setTagForUnderAgeOfConsent() bằng TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED để cho biết rằng bạn chưa chỉ định việc yêu cầu quảng cáo có áp dụng biện pháp xử lý dành cho người dùng ở Khu vực kinh tế Châu Âu (EEA) chưa đủ độ tuổi hợp pháp để tự quản lý tài khoản hay không.

Ví dụ sau cho biết rằng bạn muốn đưa TFUA 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á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 được liên kết trong quảng cáo), tất cả quảng cáo và các ưu đãi được liên kết với quảng cáo 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 các yêu cầu quảng cáo bằng phương thức setMaxAdContentRating. Quảng cáo AdMob được trả về cho các yêu cầu này khi cấu hình có mức phân loại nội dung bằng hoặc thấp hơn mức đó. Các giá trị có thể có cho phần phụ của mạng này dựa trên mức phân loại nhãn nội dung kỹ thuật số, đồng thời các giá trị đó 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

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 thông tin 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ề:

• Đặt mức phân loại nội dung tối đa cho mỗi yêu cầu quảng cáo

• Đặt mức phân loại nội dung quảng cáo tối đa cho một ứng dụng hoặc tài khoản

Lưu ý: Chế độ cài đặt cho bộ lọc phân loại nội dung được chỉ định thông qua Google Mobile Ads SDK sẽ ghi đè mọi chế độ cài đặt được thiết lập thông qua giao diện người dùng AdMob.

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. Công cụ này 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ả yêu cầu quảng cáo hay không bằng phương thức setPublisherPrivacyPersonalizationState() . Khi bạn sử dụng tính năng này, tham số cách nhà xuất bản xử lý quyền riêng tư (PPT) sẽ được đưa vào tất 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 gửi đến Google sẽ được phân phát quảng cáo được cá nhân hoá. Mã sau đây sẽ tắt tính năng cá nhân hoá quảng cáo cho tất 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

Lưu ý: Đối với các yêu cầu quảng cáo có nhiều tín hiệu về quyền riêng tư của người dùng, tín hiệu hạn chế nhất sẽ được ưu tiên. Hãy xem tài liệu về API Cách nhà xuất bản xử lý quyền riêng tư để biết các ví dụ cụ thể.

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

Đối tượng AdRequest thu thập thông tin nhắm mục tiêu sẽ được 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

Thông tin bổ sung của mạng là các 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.

Đoạn mã sau đây đặt khoá tham số phụ 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