Targeting

타겟팅을 사용하면 Google Mobile Ads SDK for React Native에 문맥 및 잠재고객 정보를 제공하여 사용자에게 관련성 있는 광고를 게재할 수 있습니다.

다음 수준에서 타겟팅을 구성할 수 있습니다.

  • 전역 요청 구성: 아동 및 청소년 연령에 따른 취급, 광고 콘텐츠 등급 한도, 게시자 개인 정보 보호 취급, 테스트 기기 ID를 포함하여 앱의 모든 광고 요청에 설정을 적용합니다.
  • 요청별 타겟팅: 콘텐츠 URL 및 광고 네트워크 추가를 포함한 광고 요청 객체를 사용하여 개별 광고 요청을 맞춤설정합니다.

이 가이드에서는 Google Mobile Ads SDK for React Native에 타겟팅 정보를 제공하는 방법을 설명합니다.

기본 요건

계속하기 전에 Google Mobile Ads SDK for React Native를 설정합니다.

요청 구성 설정

RequestConfiguration 객체는 모든 광고 요청에 전체적으로 적용되는 타겟팅 정보를 수집합니다.

첫 번째 광고 요청의 타겟팅 설정을 적용하려면 initialize 메서드를 호출할 때 requestConfiguration 속성을 설정합니다.

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

TEST_DEVICE_HASHED_ID를 해싱된 테스트 기기 ID로 바꿉니다. 이 ID는 테스트 광고를 수신해야 하는 기기를 지정합니다.

Google Mobile Ads SDK for React Native를 초기화한 후 타겟팅 설정을 업데이트하려면 setRequestConfiguration 메서드를 호출하세요. setRequestConfiguration 메서드는 기존 구성을 대체하며 이후 광고 요청에 적용됩니다.

다음 예시에서는 업데이트된 타겟팅 설정으로 RequestConfiguration 객체를 수정하고 설정을 광고 요청에 적용합니다.

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

setRequestConfiguration(requestConfiguration);

연령 취급 설정

아동 및 청소년과 관련된 적용 가능한 개인 정보 보호 규정을 준수할 수 있도록 Google Mobile Ads SDK for React Native에서는 연령 취급 설정을 제공합니다. 연령 취급 설정을 통해 Google Mobile Ads SDK for React Native에서 아동, 청소년 또는 연령 미지정 사용자를 위한 특정 광고 게재 보호 정책을 적용할지 여부를 지정할 수 있습니다.

연령 취급은 RequestConfiguration의 ageRestrictedTreatment 속성을 사용하여 설정할 수 있습니다.

다음은 광고 요청이 아동 연령 취급을 받아야 함을 나타내는 예입니다.

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

setRequestConfiguration(requestConfiguration);

청소년 또는 연령 미지정 사용자에 대한 취급 방식을 나타내려면 AgeRestrictedTreatment.CHILD 설정을 다음으로 바꿉니다.

이 설정을 사용하면 Google Mobile Ads SDK for React Native에서는 광고 요청에 tfat 매개변수를 포함합니다. 법적 및 규제 의무에 따라 사용자에게 적용되는 적정 연령 취급 기준을 결정하려면 변호사와 상담하시기 바랍니다. 자세한 내용은 앱이 연령 제한 처리로 취급되도록 광고 요청에 태그 지정하기를 참고하세요.

광고 콘텐츠 필터링

광고 콘텐츠 등급 한도를 사용하면 사용자에게 게재되는 광고의 콘텐츠를 관리할 수 있습니다. 플랫폼 정책을 준수하도록 콘텐츠 등급 한도를 설정할 수 있습니다.

RequestConfiguration 객체의 maxAdContentRating 속성을 사용하여 앱의 광고 요청에 대해 광고 콘텐츠 등급 한도를 설정할 수 있습니다. 이 설정을 구성하면 해당 등급 이하의 광고가 게재됩니다. 이 설정에 대해 가능한 값은 디지털 콘텐츠 라벨 분류에 따라 정해지며, 다음 상수 중 하나여야 합니다.

다음 예는 게재되는 광고 콘텐츠의 디지털 콘텐츠 라벨 지정이 G 상수 이하가 되도록 RequestConfiguration 객체를 구성합니다.

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

setRequestConfiguration(requestConfiguration);

자세한 내용은 다음을 참조하세요.

선택사항: PPT API(베타) 설정

게시자 개인 정보 보호 처리(PPT) API를 사용하면 RequestConfiguration 객체의 publisherPrivacyPersonalizationState 속성을 사용하여 모든 광고 요청에 대해 광고 개인 최적화를 사용 중지할지를 나타낼 수 있습니다. 이 기능을 사용하면 Google Mobile Ads SDK for React Native에서는 세션의 남은 시간 동안 모든 광고 요청에 게시자 개인 정보 보호 처리(PPT) 매개변수를 포함합니다.

기본적으로 Google에 대한 광고 요청에는 개인 맞춤 광고가 게재됩니다. 다음 예에서는 모든 광고 요청에 대해 광고 개인 최적화를 사용 중지합니다.

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

setRequestConfiguration(requestConfiguration);

AdRequest 객체 설정

AdRequest 객체는 광고 요청과 함께 전송되는 타겟팅 정보를 수집합니다.

setRequestConfiguration 메서드로 설정된 전역 구성과 달리 AdRequest 객체는 광고 형식 클래스의 load 메서드에 전달됩니다(예: 전면 광고의 경우 InterstitialAd.load, 배너 광고의 경우 BannerAd.load).

네트워크 세부정보 추가

접을 수 있는 광고의 매개변수와 같은 네트워크별 매개변수를 Google Mobile Ads SDK for React Native에 전달하려면 extras 속성을 사용하세요.

다음 예시에서는 값이 bottom인 추가 매개변수 키 collapsible을 설정합니다.

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

콘텐츠 URL 제공

콘텐츠 타겟팅 광고 및 브랜드 안전성을 위해 콘텐츠 URL을 제공하려면 contentUrl 속성을 추가하세요.

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

콘텐츠 URL은 최대 512자(영문 기준)여야 합니다.