Nhắm mục tiêu

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 một yêu cầu quảng cáo. Đối với ví dụ hiệu quả, 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

• Xem hết Hướng dẫn bắt đầu sử dụng.

RequestConfiguration

RequestConfiguration là một đối tượng thu thập thông tin nhắm mục tiêu sẽ được áp dụng trên toàn cầu thông qua MobileAds phương thức tĩnh.

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

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Chế độ cài đặt hướng tới 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 (Đạo luật bảo vệ quyền riêng tư của trẻ em trên mạng), có một chế độ cài đặt tên là "thẻ được dành cho trẻ em". Bằng cách đặ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 việc lạm dụng chế độ cài đặt này có thể dẫn đến việc bị chấm dứt của Tài khoản Google.

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

Bạn có thể dùng chế độ cài đặt này cho mọi phiên bản của SDK Dịch vụ Google Play đến RequestConfiguration.Builder.setTagForChildDirectedTreatment(int):

• Gọi setTagForChildDirectedTreatment bằng TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE để cho biết rằng bạn muốn nội dung được coi là hướng tới trẻ em theo COPPA. Điều này giúp ngăn chặn việc truyền mã nhận dạng cho quảng cáo của 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 coi là hướng tới trẻ em theo 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 Google xử lý nội dung của bạn là hướng tới trẻ em theo COPPA:

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

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Người dùng dưới độ 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 người dùng trong 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. Tính năng này được thiết kế để giúp tạo điều kiện tuân thủ Điều khoản chung Quy định 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ụ theo GDPR. Xem xét 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 của bạn. Xin lưu ý rằng các công cụ của Google được thiết kế để hỗ trợ không tuân thủ và không giảm trừ nghĩa vụ cho bất kỳ nhà xuất bản cụ thể nào theo luật pháp. Tìm hiểu thêm về những ảnh hưởng của GDPR đối với nhà xuất bản.

Khi bạn sử dụng tính năng này, một Thẻ cho người dùng dưới độ tuổi hợp pháp để tự quản lý tài khoản ở Châu Âu Thông số (TFUA) được bao gồm trong yêu cầu quảng cáo. Thông 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ị) cho tất cả các yêu cầu quảng cáo. Điều 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 của bên thứ ba.

Giống như chế độ cài đặt hướng tới trẻ em, cũng có một phương pháp RequestConfiguration.Builder để đặt thông số TFUA: setTagForUnderAgeOfConsent() thân mến! với các tuỳ chọn sau đây.

• 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) dưới độ tuổi hợp pháp để tự quản lý tài khoản. Việc này cũng ngăn việc truyền mã nhận dạng cho quảng cáo của 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 ở 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.

• Gọi setTagForUnderAgeOfConsent() bằng TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED để cho biết rằng bạn chưa chỉ định xem yêu cầu quảng cáo có nên áp dụng biện pháp xử lý dành cho người dùng trong 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.

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

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

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

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

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

Để tuân thủ Chính sách quảng cáo không phù hợp của Google Play bao gồm các ưu đãi được liên kết trong một quảng cáo, tất cả quảng cáo và các ưu đãi được liên kết ưu đãi xuất hiện trong ứng dụng của bạn phải phù hợp với nội dung xếp hạng của ứng dụng của bạn, ngay cả khi bản thân nội dung đó đã tuân thủ các quy định của Google Chính sách của 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 tốt hơn nội dung của quảng cáo hiển thị cho người dùng. Bạn có thể đặt mức phân loại nội dung tối đa thành giúp tuân thủ các chính sách 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 cách sử dụng setMaxAdContentRating . Quảng cáo AdMob được trả về khi cấu hình này có mức phân loại nội dung bằng hoặc dưới mức đó. Các giá trị có thể có cho phần phụ mạng này được dựa trên phân loại nhãn nội dung kỹ thuật số, đồng thời phải là một trong các tiêu chí sau: chuỗi:

• 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:

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

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Tìm hiểu thêm về:

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

• Đặ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

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

Chiến lược phát hành đĩa đơn Cách xử lý quyền riêng tư của nhà xuất bản (PPT) API là một công cụ không bắt buộc, cho phép các ứng dụng cho biết có nên tắt quảng cáo hay không cá nhân hóa cho tất cả các yêu cầu quảng cáo bằng cách sử dụng setPublisherPrivacyPersonalizationState(). Khi bạn sử dụng tính năng này, thông số xử lý quyền riêng tư của nhà xuất bản (PPT) được đượ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, yêu cầu quảng cáo đến Google được phân phát quảng cáo được cá nhân hóa. Nội dung sau đây mã sẽ tắt cá nhân hóa quảng cáo cho tất cả các yêu cầu quảng cáo:

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

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

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

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

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

Bạn có thể chuyển các cặp khoá-giá trị tuỳ chỉnh để nhắm mục tiêu các chiến dịch Google Ad Manager (dòng mặt hàng) thông qua AdManagerAdRequest.Builder.addCustomTargeting():

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

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

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

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

Hãy xem ví dụ về tính năng Nhắm mục tiêu tùy chỉnh của Ad Manager để triển khai tính năng nhắm mục tiêu tuỳ chỉnh trong ứng dụng Android API Demo.

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 yêu cầu bằng cách sử dụng addCategoryExclusion() phương thức do AdManagerAdRequest.Builder cung cấp:

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

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

Hãy xem ví dụ về tính năng Loại trừ danh mục của Ad Manager để triển khai tính năng 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 giới hạn tần suất, phân khúc đối tượng và nhắm mục tiêu, xoay vòng quảng cáo tuần tự và các các chế độ kiểm soát phân phối quảng cáo dựa trên đối tượng trên các thiết bị.

Sau đây là ví dụ về cách đặt PPID:

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

var adRequest = AdManagerAdRequest.Builder()
  .setPublisherProvidedId("AB123456789")
  .build()

Hãy xem ví dụ về PPID của Ad Manager đối với hoạt động triển khai giá trị nhận dạng do nhà xuất bản cung cấp (PPID) trong Android Ứng dụng minh hoạ API.

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

Bạn có thể gửi dữ liệu về đối tượng và ngữ cảnh dưới dạng tín hiệu do nhà xuất bản cung cấp (PPS) trong yêu cầu quảng cáo. Nhờ có PPS, bạn có thể sử dụng dữ liệu người dùng của mình để cải thiện 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 đến bên đặt giá thầu trong tất cả loại giao dịch bằng cách sử dụng dữ liệu phân loại chuẩn mà không cần chia sẻ giá trị nhận dạng người dùng. Khán giả 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 (Đối tượng IAB Phân loại 1.1) và bối cảnh (Hệ thống phân loại nội dung 2.2 của IAB).

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", arrayListOf(6,284));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6));

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

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 = AdRequest.Builder()
  .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
  .build()

URL nội dung

Để cung cấp URL nội dung cho quảng cáo được nhắm mục tiêu theo nội dung và an toàn thương hiệu, bạn có thể gọi setContentUrl() khi tạo AdManagerAdRequest:

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

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

Sự an toàn cho thương hiệu (Thử nghiệm)

Các ứng dụng hiển thị nội dung động dành cho các đối tượng khác nhau có thể cung cấp một danh sách ngắn gồm các URL sử dụng setNeighboringContentUrls() khi tạo AdManagerAdRequest:

ArrayList<String> urls = new ArrayList<String>();
urls.add("https://www.mycontenturl1.com");
urls.add("https://www.mycontenturl2.com");
urls.add("https://www.mycontenturl3.com");
urls.add("https://www.mycontenturl4.com");
AdManagerAdRequest requestWithContent = new AdManagerAdRequest.Builder()
    .setNeighboringContentUrls(urls)
    .build();

var urls = mutableListOf("https://www.mycontenturl1.com", "https://www.mycontenturl2.com",
                         "https://www.mycontenturl3.com", "https://www.mycontenturl4.com")
var requestWithContent = AdManagerAdRequest.Builder()
  .setNeighboringContentUrls(urls)
  .build()

.setNeighboringContentUrls() khác với .setContentUrl() ở chỗ nó chỉ được dùng để đảm bảo an toàn thương hiệu.