Trang này được dịch bởi Cloud Translation API.

Nhắm mục tiêu

KHÔNG DÙNG NỮA: SDK C++ của quảng cáo trên thiết bị di động của Google sẽ ngừng hoạt động kể từ ngày 17 tháng 6 năm 2024 và không nên được áp dụng trong các dự án chưa sử dụng tính năng này. Nút này sẽ nhập Kết thúc bảo trì (EoM) vào ngày 17 tháng 6 năm 2025. Xin lưu ý rằng các phiên bản của SDK được phát hành trước ngày EoM sẽ tiếp tục hoạt động mà không có lỗi nào khác các bản sửa lỗi hoặc thay đổi sẽ được phát hành sau ngày EoM.

Thay vì dùng SDK C++ của quảng cáo trên thiết bị di động của Google, hãy cân nhắc sử dụng iOS và SDK Android từ AdMob. Để được hỗ trợ, hãy liên hệ với Diễn đàn kỹ thuật về SDK Quảng cáo của Google trên thiết bị di động.

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 để được áp dụng trên toàn cầu 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 cập nhật mong muốn và thiết lập 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 (Đạ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 chế độ cài đặt 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 phép 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 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 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 coi 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 hoá IBA và quảng cáo tái tiếp thị trên yêu cầu quảng cáo đó.

Có thể định cấu hình 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 đến 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 nội dung của bạn được coi là hướng tới 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 Google coi nội dung của bạn là hướng tới 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 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:

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

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

  firebase::gma::SetRequestConfiguration(request_configuration);

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 hành vi sai trái đối với chế độ cài đặt này, Tài khoản Google của bạn có thể 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âu Âu Khu vực kinh tế (EEA) chưa đủ độ 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 hỗ trợ việc 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 tham khảo 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. Năn nỉ hãy nhớ 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ụ của bất kỳ nhà xuất bản cụ thể nào theo luật này. 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) sẽ được đưa vào 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ó một thành viên trong RequestConfiguration cho định cấu hình thông số TFUA: tag_for_under_age_of_consent, có thể là được định cấu hình bằng các giá trị được liệt kê sau:

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 ở 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 cho RequestConfiguration::kUnderAgeOfConsentFalse để cho biết rằng bạn muốn yêu cầu quảng cáo không đượ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 (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 cho RequestConfiguration::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 hay khô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.

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);

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 không được đặt đồng thời cả hai thành true. Nếu có, quảng cáo 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 cấu hình này sẽ có mức phân loại nội dung bằng hoặc thấp hơn mức đó. Khả năng các giá trị 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 một trong các giá trị được liệt kê sau đây:

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

Đoạn mã sau đây định cấu hình một cấu trúc RequestConfiguration để chỉ định quảng cáo đó nội dung 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 quảng cáo của bạn.

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 để nhắm mục tiêu các từ khóa 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();