이 가이드에서는 광고 요청에 타겟팅 정보를 제공하는 방법을 설명합니다.
기본 요건
- 시작하기를 모두 읽어보세요.
RequestConfiguration
RequestConfiguration
는 SetRequestConfiguration()
전역 함수를 통해 전역으로 적용할 타겟팅 정보를 수집하는 구조체입니다.
요청 구성을 업데이트하려면 먼저 현재 구성을 가져오고 원하는 업데이트를 수행한 후 다음과 같이 설정합니다.
firebase::gma::RequestConfiguration retrieved_configuration = firebase::gma::GetRequestConfiguration(); // .. apply your changes, then: firebase::gma::SetRequestConfiguration(request_configuration);
아동 대상 설정
아동 온라인 개인 정보 보호법(COPPA)의 취지에 따라 '아동 대상 서비스로 취급용 태그'라는 설정을 마련했습니다. 이 태그를 설정하면 이 알림이 정확하며 앱의 소유자를 대행할 권한이 있음을 확인하게 됩니다. 이 설정을 악용하면 Google 계정이 해지될 수 있습니다.
앱 개발자는 광고를 요청할 때 Google에서 콘텐츠를 아동용으로 처리할지 여부를 지정할 수 있습니다. Google에서 콘텐츠를 아동 대상으로 처리하도록 지정하는 경우 Google에서는 해당 광고 요청에 대한 관심 기반 광고 및 리마케팅 광고 사용이 중지되도록 조치합니다.
설정은 RequestConfiguration
구조체의 tag_for_child_directed_treatment
멤버를 다음 열거형 값 중 하나에 할당하여 구성할 수 있습니다.
RequestConfiguration::kChildDirectedTreatmentTrue
에RequestConfiguration::tag_for_child_directed_treatment
를 할당하여 COPPA에 따라 콘텐츠를 아동 대상으로 처리하도록 지정합니다.RequestConfiguration::kChildDirectedTreatmentFalse
에RequestConfiguration::tag_for_child_directed_treatment
를 할당하여 COPPA에 따라 콘텐츠를 아동 대상으로 처리하지 않도록 지정합니다.- 광고 요청에서 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::kUnderAgeOfConsentUnspecified
에RequestConfiguration::tag_for_under_age_of_consent
를 할당합니다.
다음은 광고 요청에 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();