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 trong 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 sẽ được áp dụng toàn cầu thông qua hàm chung 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 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 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ẻ đượ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 việc sử dụng chế độ cài đặt này sai mục đích 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 mình là dành cho 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 coi nội dung của mình là hướng tới trẻ em, chúng tôi sẽ thực hiện các bước để tắt quảng cáo 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ể đị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:
- 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 nội dung của mình được xem 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 coi nội dung của bạn là hướng tới 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 cho chủ sở hữu ứng dụng. Bạn hiểu rằng việc sử dụng chế độ cài đặt này sai mục đích có thể khiến Tài khoản Google của bạn bị chấm dứt.
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ể phải thực hiện 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ý 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 miễn 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 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. Thông số này vô hiệu hóa hoạt động quảng cáo được cá nhân hóa (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. Thông 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ư chế độ cài đặt hướng tới trẻ em, trong RequestConfiguration có một thành phần để
định cấu hình tham số TFUA: tag_for_under_age_of_consent
. Thông số này có thể
được định cấu hình bằng các giá trị liệt kê sau:
- 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 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
choRequestConfiguration::kUnderAgeOfConsentFalse
để cho biết rằng bạn muốn yêu cầu quảng cáo không á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
choRequestConfiguration::kUnderAgeOfConsentUnspecified
để cho biết rằng bạn chưa chỉ định liệu 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 hướng tới 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
định cấu hình này có mức phân loại nội dung ở mức đó hoặc thấp hơn. Các giá trị có thể có cho trường hợp này được 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 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();