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 tất phần 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 rộng rãi thông qua hàm toàn cục SetRequestConfiguration()
.
Để cập nhật cấu hình 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 nội dung 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 dành cho 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 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 coi nội dung của bạn là dành cho trẻ em hay không khi đưa ra 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à hướng tới trẻ em, thì 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 (IBA) và quảng cáo tái tiếp thị cho 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ị liệt kê sau:
- Chỉ định
RequestConfiguration::tag_for_child_directed_treatment
choRequestConfiguration::kChildDirectedTreatmentTrue
để 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ỉ định
RequestConfiguration::tag_for_child_directed_treatment
choRequestConfiguration::kChildDirectedTreatmentFalse
để cho biết rằng bạn không muốn Google xem nội dung của bạn là hướng tới trẻ em theo COPPA. - Chỉ định
RequestConfiguration::tag_for_child_directed_treatment
choRequestConfiguration::kChildDirectedTreatmentUnspecified
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 xem nội dung của bạn là dành cho trẻ em nhằm tuân thủ 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 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.
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). 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 luật sư riêng của bạn. Xin lưu ý rằng các công cụ của Google chỉ giúp nhà xuất bản dễ dàng tuân thủ quy định, chứ không giải 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 bạn sử dụng tính năng này, yêu cầu quảng cáo sẽ bao gồm một thông số Thẻ cho người dùng chưa đủ tuổi thành niên ở Châu Âu (TFUA). Thông số này vô hiệu hoá hoạt động 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 của 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ư các chế độ cài đặt hướng tới trẻ em, trong RequestConfiguration, có một thành viên trong RequestConfiguration để định cấu hình thông số TFUA: tag_for_under_age_of_consent
. Bạn có thể định cấu hình thông số này bằng các giá trị được liệt kê sau đây:
- Chỉ định
RequestConfiguration::tag_for_under_age_of_consent
choRequestConfiguration::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 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. - Chỉ định
RequestConfiguration::tag_for_under_age_of_consent
choRequestConfiguration::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 thành niên ở Khu vực kinh tế Châu Âu (EEA). - Chỉ định
RequestConfiguration::tag_for_under_age_of_consent
choRequestConfiguration::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 nên đặt đồng thời các thẻ để bật chế độ cài đặt Hướng tới trẻ em và Người dùng dưới độ tuổi đồng ý thành true. Nếu bạn đặt như vậy, thì chế độ cài đặt dành cho trẻ em sẽ được ưu tiên áp dụng.
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 cấu hình của quảng cáo này 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 thuộc tính này dựa trên kết quả 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 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 một 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á khớ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
, bạn có thể chuyển URL này thành nhắm mục tiêu các từ khoá có 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();