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ều kiện tiên quyết

• Hoàn thành các bước Bắt đầu.

RequestConfiguration

RequestConfiguration là một cấu trúc thu thập thông tin nhắm mục tiêu để áp dụng trên toàn hệ thống thông qua hàm toàn cục SetRequestConfiguration().

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

  firebase::gma::RequestConfiguration retrieved_configuration =
    firebase::gma::GetRequestConfiguration();

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

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 (COPPA), chúng tôi cung cấp cho bạn một chế độ cài đặt có tên là "thẻ dành cho trẻ em". Khi đặ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ể khiến Tài khoản Google của bạn bị chấm dứt.

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à dành cho 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 coi nội dung của bạn là dành cho trẻ em, thì chúng tôi sẽ thực hiện các bước để vô hiệu hoá quảng cáo IBA và quảng cáo tái tiếp thị đối với yêu cầu quảng cáo đó.

Bạn có thể định cấu hình chế độ cài đặt này bằng cách chỉ định thành phần tag_for_child_directed_treatment của cấu trúc RequestConfiguration cho một trong các giá trị được liệt kê sau đây:

• Chỉ định RequestConfiguration::tag_for_child_directed_treatment cho RequestConfiguration::kChildDirectedTreatmentTrue để cho biết rằng bạn muốn Google xem nội dung của bạn là dành cho trẻ em theo COPPA.
• Chỉ định RequestConfiguration::tag_for_child_directed_treatment cho RequestConfiguration::kChildDirectedTreatmentFalse để cho biết rằng bạn không muốn nội dung của mình được coi là dành cho trẻ em theo COPPA.
• Chỉ định RequestConfiguration::tag_for_child_directed_treatment cho RequestConfiguration::kChildDirectedTreatmentUnspecifiednế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 coi nội dung của bạn là dành cho trẻ em theo COPPA:

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.tag_for_child_directed_treatment =
    firebase::RequestConfiguration::kChildDirectedTreatmentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

Khi đặ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ể khiến Tài khoản Google của bạn bị chấm dứt.

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

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 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. Vui lòng xem lại 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. Vui lòng 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ải trừ nghĩa vụ cho bất kỳ nhà xuất bản cụ thể nào theo luật. 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, thông số Thẻ cho người dùng chưa đủ 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. Thông số này vô hiệu hoá hoạt động quảng cáo được cá nhân hoá (kể 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 bên thứ ba.

Giống như các chế độ cài đặt hướng tới trẻ em, trong RequestConfiguration có một thành phần để định cấu hình thông số TFUA: tag_for_under_age_of_consent. Thông số này có thể được định cấu hình với các giá trị được liệt kê sau đây:

• Chỉ định RequestConfiguration::tag_for_under_age_of_consent cho RequestConfiguration::kUnderAgeOfConsentTrue để 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 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ỉ định RequestConfiguration::tag_for_under_age_of_consent cho RequestConfiguration::kUnderAgeOfConsentFalse để 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).
• Chỉ định RequestConfiguration::tag_for_under_age_of_consent cho RequestConfiguration::kUnderAgeOfConsentUnspecified để 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 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) 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:

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.tag_for_under_age_of_consent =
    firebase::RequestConfiguration::kUnderAgeOfConsentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

Bạn không được đặt đồng thời các thẻ để bật chế độ cài đặt Dành cho trẻ em và Người dùng dưới độ tuổi hợp pháp để tự quản lý tài khoản thành true. Nếu có, chế độ cài đặt hướng tới trẻ em sẽ được ưu tiên.

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

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 thông qua RequestConfiguration::max_ad_content_rating field. Quảng cáo AdMob được trả về khi giá trị này được định cấu hình có mức phân loại nội dung ở mức đó hoặc thấp hơn mức đó. Các giá trị có thể sử dụng cho thuộc tính này dựa trên cách phân loại nhãn nội dung kỹ thuật số và phải là một trong các giá trị được liệt kê sau:

• RequestConfiguration::kMaxAdContentRatingG
• RequestConfiguration::kMaxAdContentRatingPG
• RequestConfiguration::kMaxAdContentRatingT
• RequestConfiguration::kMaxAdContentRatingMA

Mã sau đây định cấu hình một cấu trúc 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:

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.max_ad_content_rating =
    firebase::RequestConfiguration::kMaxAdContentRatingG;

  firebase::gma::SetRequestConfiguration(request_configuration);

AdRequest

Đố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.

URL nội dung

Khi yêu cầu quảng cáo, các ứng dụng có thể chuyển URL của nội dung mà ứng dụng đang phân phát. Điều này cho phép tính năng nhắm mục tiêu theo từ khoá kết hợp quảng cáo với nội dung.

Ví dụ: nếu ứng dụng của bạn yêu cầu một quảng cáo trong khi hiển thị nội dung từ https://www.example.com, thì bạn có thể chuyển URL này để nhắm mục tiêu theo các từ khoá liên quan:

  // AdRequest with content URL:
  firebase::admob::AdRequest ad_request(/*content_url=*/"https://www.example.com");

  // AdRequest without content URL:
  firebase::admob::AdRequest ad_request();