Nhắm mục tiêu

Tính năng nhắm mục tiêu cho phép bạn cung cấp thông tin về bối cảnh và đối tượng cho Google Mobile Ads SDK for React Native để phân phát quảng cáo phù hợp cho người dùng.

Bạn có thể định cấu hình tiêu chí nhắm mục tiêu ở các cấp sau:

  • Cấu hình yêu cầu chung: Áp dụng chế độ cài đặt cho tất cả yêu cầu quảng cáo trong ứng dụng của bạn, bao gồm cả chế độ xử lý theo độ tuổi của trẻ em và thanh thiếu niên, mức phân loại nội dung quảng cáo tối đa, chế độ xử lý quyền riêng tư của nhà xuất bản và mã thiết bị thử nghiệm.
  • Nhắm mục tiêu theo yêu cầu: Tuỳ chỉnh từng yêu cầu quảng cáo riêng lẻ bằng cách sử dụng đối tượng yêu cầu quảng cáo, bao gồm cả URL nội dung và thông tin bổ sung của mạ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 Google Mobile Ads SDK for React Native.

Điều kiện tiên quyết

Trước khi tiếp tục, hãy thiết lập Google Mobile Ads SDK for React Native.

Đặt cấu hình yêu cầu

Đối tượng RequestConfiguration thu thập thông tin nhắm mục tiêu được áp dụng rộng rãi cho mọi yêu cầu quảng cáo.

Để áp dụng chế độ cài đặt tiêu chí nhắm mục tiêu từ yêu cầu quảng cáo đầu tiên, hãy đặt thuộc tính requestConfiguration khi bạn gọi phương thức initialize:

const requestConfiguration: RequestConfiguration = {
  maxAdContentRating: MaxAdContentRating.G,
  ageRestrictedTreatment: AgeRestrictedTreatment.CHILD,
  publisherPrivacyPersonalizationState:
    PublisherPrivacyPersonalizationState.DISABLED,
  testDeviceIds: ["TEST_DEVICE_HASHED_ID"],
};

initialize({requestConfiguration}, (_status: InitializationStatus) => {
  // SDK initialization is complete.
});

Thay thế TEST_DEVICE_HASHED_ID bằng mã thiết bị thử nghiệm đã băm. Mã này chỉ định một thiết bị sẽ nhận quảng cáo thử nghiệm.

Để cập nhật chế độ cài đặt tiêu chí nhắm mục tiêu sau khi bạn khởi động Google Mobile Ads SDK for React Native, hãy gọi phương thức setRequestConfiguration. Phương thức setRequestConfiguration sẽ thay thế cấu hình hiện có và có hiệu lực đối với các yêu cầu quảng cáo tiếp theo.

Ví dụ sau đây sửa đổi đối tượng RequestConfiguration bằng chế độ cài đặt nhắm mục tiêu đã cập nhật và áp dụng chế độ cài đặt đó cho các yêu cầu quảng cáo:

const requestConfiguration: RequestConfiguration = {
  ...getRequestConfiguration(),
  maxAdContentRating: MaxAdContentRating.PG,
  ageRestrictedTreatment: AgeRestrictedTreatment.TEEN,
};

setRequestConfiguration(requestConfiguration);

Đặt chế độ xử lý theo độ tuổi

Để giúp bạn tuân thủ các quy định hiện hành về quyền riêng tư liên quan đến trẻ em và thanh thiếu niên, Google Mobile Ads SDK for React Native cung cấp một chế độ cài đặt về việc xử lý theo độ tuổi. Chế độ cài đặt xử lý theo độ tuổi cho phép bạn cho biết liệu Google Mobile Ads SDK for React Native có nên áp dụng các biện pháp bảo vệ cụ thể trong hoạt động phân phát quảng cáo cho trẻ em, thanh thiếu niên hay độ tuổi không xác định hay không.

Bạn có thể đặt chế độ xử lý theo độ tuổi bằng thuộc tính ageRestrictedTreatment trên RequestConfiguration.

Ví dụ sau đây cho biết rằng các yêu cầu quảng cáo phải áp dụng chế độ xử lý theo độ tuổi của trẻ em:

const requestConfiguration: RequestConfiguration = {
  // Indicate that ad requests should have child age treatment.
  ageRestrictedTreatment: AgeRestrictedTreatment.CHILD,
};

setRequestConfiguration(requestConfiguration);

Để cho biết chế độ xử lý dành cho thanh thiếu niên hoặc độ tuổi không xác định, hãy thay thế chế độ cài đặt AgeRestrictedTreatment.CHILD bằng chế độ cài đặt sau:

Khi bạn sử dụng chế độ cài đặt này, Google Mobile Ads SDK for React Native sẽ thêm tham số tfat vào yêu cầu quảng cáo. Hãy tham khảo ý kiến của cố vấn pháp lý để xác định chế độ xử lý theo độ tuổi áp dụng cho người dùng dựa trên các nghĩa vụ pháp lý và quy định. Để biết thêm thông tin, hãy xem bài viết Gắn thẻ yêu cầu quảng cáo từ một ứng dụng để áp dụng cách xử lý bị giới hạn độ tuổi.

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

Mức phân loại nội dung quảng cáo tối đa giúp bạn kiểm soát 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 để giúp tuân thủ các chính sách của nền tảng.

Bạn 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 trong ứng dụng bằng cách sử dụng thuộc tính maxAdContentRating trên đối tượng RequestConfiguration. Sau khi bạn định cấu hình chế độ cài đặt này, quảng cáo được trả về sẽ có mức phân loại nội dung bằng hoặc thấp hơn mức phân loại đó. Các giá trị có thể có cho chế độ cài đặt này dựa trên phân loại nhãn nội dung kỹ thuật số, và phải là một trong các hằng số sau:

Ví dụ 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 chỉ định nhãn nội dung kỹ thuật số không cao hơn hằng số G:

const requestConfiguration: RequestConfiguration = {
  maxAdContentRating: MaxAdContentRating.G,
};

setRequestConfiguration(requestConfiguration);

Để biết thông tin chi tiết, hãy xem phần sau:

Không bắt buộc: Đặt PPT API (Thử nghiệm)

API Cách nhà xuất bản xử lý quyền riêng tư (PPT) cho phép bạn cho biết liệu có tắt tính năng cá nhân hoá quảng cáo cho tất cả yêu cầu quảng cáo hay không bằng cách sử dụng thuộc tính publisherPrivacyPersonalizationState trên đối tượng RequestConfiguration. Khi bạn sử dụng tính năng này, Google Mobile Ads SDK for React Native sẽ thêm một tham số về cách nhà xuất bản xử lý quyền riêng tư (PPT) vào tất cả yêu cầu quảng cáo trong phần còn lại của phiên hoạt động.

Theo mặc định, các yêu cầu quảng cáo đến Google sẽ được phân phát quảng cáo được cá nhân hoá. Ví dụ sau đây tắt tính năng cá nhân hoá quảng cáo cho tất cả yêu cầu quảng cáo:

const requestConfiguration: RequestConfiguration = {
  publisherPrivacyPersonalizationState:
    PublisherPrivacyPersonalizationState.DISABLED,
};

setRequestConfiguration(requestConfiguration);

Đặt đối tượng AdRequest

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

Không giống như cấu hình chung được đặt bằng phương thức setRequestConfiguration, đối tượng AdRequest được truyền đến phương thức load của một lớp định dạng quảng cáo, ví dụ: InterstitialAd.load cho quảng cáo xen kẽ hoặc BannerAd.load cho quảng cáo biểu ngữ.

Thêm thông tin bổ sung của mạng

Để truyền các tham số dành riêng cho mạng tới Google Mobile Ads SDK for React Native, chẳng hạn như tham số cho quảng cáo có thể thu gọn, hãy sử dụng thuộc tính extras.

Ví dụ sau đây đặt khoá tham số bổ sung của collapsible với giá trị là bottom:

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  extras: {
    collapsible: 'bottom',
  },
};

Cung cấp 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à đảm bảo an toàn cho thương hiệu, hãy thêm thuộc tính contentUrl:

const request: AdRequest = {
  adUnitId: AD_UNIT_ID,
  contentUrl: 'https://www.example.com',
};

URL nội dung phải có tối đa 512 ký tự.