이 페이지는 Cloud Translation API를 통해 번역되었습니다.

타겟팅

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

기본 요건

시작하기를 모두 읽어보세요.

`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();