Targeting

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

기본 요건

시작하기 단계를 완료하세요.

`RequestConfiguration`

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

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

  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::tag_for_child_directed_treatment를 RequestConfiguration::kChildDirectedTreatmentTrue에 할당합니다.
COPPA의 취지에 따라 콘텐츠를 아동 대상 서비스로 취급하지 않도록 하려면 RequestConfiguration::tag_for_child_directed_treatment를 RequestConfiguration::kChildDirectedTreatmentFalse에 할당합니다.
광고 요청에서 COPPA에 따른 콘텐츠 취급 방법을 지정하지 않으려면 RequestConfiguration::tag_for_child_directed_treatment를 RequestConfiguration::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 도구는 규정 준수를 지원하기 위해 설계되었으며 특정 게시자의 법적 의무를 면제하지 않습니다. 자세히 알아보기 GDPR이 게시자에게 미치는 영향에 대해.

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

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

광고 요청이 유럽 경제 지역 (EEA)에 거주하는 동의 연령 미만의 사용자를 대상으로 하는 요청으로 취급되도록 하려는 경우, 이를 나타내기 위해 RequestConfiguration::tag_for_under_age_of_consent를 RequestConfiguration::kUnderAgeOfConsentTrue에 할당합니다.
광고 요청이 유럽 경제 지역(EEA)에 거주하는 동의 연령 미만의 사용자를 대상으로 하는 요청으로 취급되지 않도록 하려는 경우, 이를 나타내기 위해 RequestConfiguration::tag_for_under_age_of_consent를 RequestConfiguration::kUnderAgeOfConsentFalse에 할당합니다.
광고 요청이 유럽 경제 지역 (EEA)에 거주하는 동의 연령 미만의 사용자를 대상으로 하는 요청으로 취급되어야 하는지 여부를 지정하지 않으려는 경우, 이를 나타내기 위해 RequestConfiguration::tag_for_under_age_of_consent를 RequestConfiguration::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();