타겟팅

이 가이드에서는 광고 요청에 타겟팅 정보를 제공하는 방법을 설명합니다.

기본 요건

RequestConfiguration

RequestConfigurationSetRequestConfiguration() 전역 함수를 통해 전역으로 적용될 타겟팅 정보를 수집하는 구조체입니다.

요청 구성을 업데이트하려면 먼저 현재 구성을 가져와서 원하는 업데이트를 수행한 후 다음과 같이 설정합니다.

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

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

아동 대상 설정

아동 온라인 개인 정보 보호법(COPPA)의 취지에 따라 '아동 대상 서비스로 취급용 태그'라는 설정을 마련했습니다. 이 태그를 설정하면 이 알림이 정확하며 앱의 소유자를 대행할 권한이 있음을 확인하는 것으로 간주됩니다. 이 설정을 악용하면 Google 계정이 해지될 수 있습니다.

앱 개발자는 광고를 요청할 때 Google에서 콘텐츠를 아동 대상 서비스로 취급하도록 할지를 지정할 수 있습니다. Google에서 콘텐츠를 아동 대상으로 처리하도록 지정하면 해당 광고 요청에 대한 관심 기반 광고 및 리마케팅 광고 사용이 중지됩니다.

RequestConfiguration 구조체의 tag_for_child_directed_treatment 멤버를 다음 열거형 값 중 하나에 할당하여 설정을 구성할 수 있습니다.

  • COPPA에 따라 콘텐츠를 아동 대상으로 처리하도록 지정하려면 RequestConfiguration::kChildDirectedTreatmentTrueRequestConfiguration::tag_for_child_directed_treatment를 할당합니다.
  • COPPA에 따라 콘텐츠를 아동 대상으로 처리하지 않도록 지정하려면 RequestConfiguration::kChildDirectedTreatmentFalseRequestConfiguration::tag_for_child_directed_treatment를 할당합니다.
  • 광고 요청에서 COPPA에 따른 콘텐츠 취급 방법을 지정하지 않으려면 RequestConfiguration::tag_for_child_directed_treatmentRequestConfiguration::kChildDirectedTreatmentUnspecified에 할당합니다.

다음은 COPPA에 따라 콘텐츠를 아동 대상으로 처리하도록 지정하는 방법의 예입니다.

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

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

  firebase::gma::SetRequestConfiguration(request_configuration);

이 태그를 설정하면 이 알림이 정확하며 앱의 소유자를 대행할 권한이 있음을 확인하는 것으로 간주됩니다. 이 설정을 악용하면 Google 계정이 해지될 수 있습니다.

유럽 경제 지역 (EEA)에 거주하는 동의 연령 미만의 사용자를 대상으로 하는 서비스의 경우 광고 요청에 이를 표시할 수 있습니다. 이 기능은 개인 정보 보호법(GDPR) 준수를 지원하기 위해 도입되었습니다. GDPR에 의거한 다른 법적 의무가 있을 수도 있습니다. 유럽연합의 지침을 검토하고 변호사와 상의하시기 바랍니다. Google 도구는 규정 준수를 지원하기 위해 마련되었으며 Google 도구를 사용한다고 해서 게시자의 법적 의무가 면제되지 않으니 유의하시기 바랍니다. GDPR이 게시자에게 미치는 영향에 대해 자세히 알아보기

이 기능을 사용하면 TFUA(유럽 동의 연령 미만 사용자용 태그) 매개변수가 광고 요청에 포함됩니다. 이 매개변수는 모든 광고 요청에 대해 리마케팅을 포함한 개인 맞춤 광고를 사용 중지합니다. 또한 광고 측정 픽셀 및 서드 파티 광고 서버와 같은 서드 파티 광고 공급업체에 대한 요청도 사용 중지됩니다.

아동 대상 설정과 마찬가지로 RequestConfiguration에는 다음과 같은 열거된 값으로 구성할 수 있는 TFUA 매개변수인 tag_for_under_age_of_consent를 구성하는 멤버가 있습니다.

  • 광고 요청이 유럽 경제 지역 (EEA)에 거주하는 동의 연령 미만의 사용자를 대상으로 하는 요청으로 취급되도록 하려면 RequestConfiguration::kUnderAgeOfConsentTrueRequestConfiguration::tag_for_under_age_of_consent를 할당합니다.
  • 광고 요청이 유럽 경제 지역(EEA)에 거주하는 동의 연령 미만의 사용자를 대상으로 하는 서비스로 취급되지 않도록 하려면 RequestConfiguration::kUnderAgeOfConsentFalseRequestConfiguration::tag_for_under_age_of_consent를 할당합니다.
  • 광고 요청이 유럽 경제 지역 (EEA)에 거주하는 동의 연령 미만의 사용자를 대상으로 하는 요청으로 취급되어야 하는지 여부를 지정하지 않았음을 나타내려면 RequestConfiguration::tag_for_under_age_of_consentRequestConfiguration::kUnderAgeOfConsentUnspecified에 할당합니다.

다음은 광고 요청에 TFUA가 포함되도록 지정하는 방법의 예입니다.

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

  request_configuration.tag_for_under_age_of_consent =
    firebase::RequestConfiguration::kUnderAgeOfConsentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

아동 대상 설정을 사용하는 태그와 동의 연령 미만 사용자를 동시에 true로 설정하면 안 됩니다. 이 경우 아동 대상 설정이 우선 적용됩니다.

광고 콘텐츠 필터링

앱에서 RequestConfiguration::max_ad_content_rating field를 통해 광고 요청에 대해 광고 콘텐츠 등급 한도를 설정할 수 있습니다. 광고 콘텐츠 등급 한도가 설정된 경우 콘텐츠 등급이 설정된 한도 이하인 AdMob 광고가 게재됩니다. 가능한 값은 디지털 콘텐츠 라벨 분류를 기반으로 하며 다음 열거 값 중 하나여야 합니다.

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

다음 코드는 반환된 광고 콘텐츠의 디지털 콘텐츠 라벨 지정이 G 이하가 되도록 RequestConfiguration 구조체를 구성합니다.

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

  request_configuration.max_ad_content_rating =
    firebase::RequestConfiguration::kMaxAdContentRatingG;

  firebase::gma::SetRequestConfiguration(request_configuration);

AdRequest

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

콘텐츠 URL

광고를 요청할 때 앱은 게재 중인 콘텐츠의 URL을 전달할 수 있습니다. 이렇게 하면 키워드 타겟팅을 통해 광고와 콘텐츠를 일치시킬 수 있습니다.

예를 들어 https://www.example.com의 콘텐츠를 표시하면서 앱에서 광고를 요청하는 경우 이 URL을 전달하여 관련 키워드를 타겟팅할 수 있습니다.

  // AdRequest with content URL:
  firebase::admob::AdRequest ad_request(/*content_url=*/"https://www.example.com");

  // AdRequest without content URL:
  firebase::admob::AdRequest ad_request();