타겟팅

<ph type="x-smartling-placeholder">

</ph> 지원 중단됨: Google 모바일 광고 C++ SDK는 2024년 6월 17일부터 지원 중단되었으며 를 채택해서는 안 됩니다. 2025년 6월 17일에 유지보수 종료(EoM)가 시작됩니다. 참고로 EoM 날짜 이전에 출시된 SDK는 계속 작동하지만 더 이상 버그는 없습니다. 이러한 수정사항 또는 변경사항은 월말 이후에 출시됩니다.

Google 모바일 광고 C++ SDK 대신 iOS 및 AdMob의 Android SDK. 지원이 필요하면 Google 모바일 광고 SDK 기술 포럼에 문의하세요.

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

기본 요건

• 시작하기를 완료합니다.

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은 IBA 및 리마케팅 광고가 게재됩니다.

이 설정은 RequestConfiguration 구조체의 tag_for_child_directed_treatment 멤버 다음 열거형 값 중 하나:

• RequestConfiguration::tag_for_child_directed_treatment 할당 대상 RequestConfiguration::kChildDirectedTreatmentTrue: COPPA에 따라 아동 대상으로 취급되는 콘텐츠
• RequestConfiguration::tag_for_child_directed_treatment 할당 대상 RequestConfiguration::kChildDirectedTreatmentFalse: 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 계정이 해지될 수 있습니다.

참고: 앱이 가족을 위한 앱 프로그램의 적용을 받고 기본적으로 아동 대상의 앱이며 사용자가 Family Link로 관리하는 Google 계정에 로그인된 상태이면 모든 광고 요청에 대해 모든 콘텐츠가 자동으로 아동 대상으로 처리됩니다.

동의 연령 미만의 사용자

유럽에 거주하는 사용자를 대상으로 하는 서비스로 취급하도록 광고 요청에 표시할 수 있습니다. 동의 연령 미만의 경제 지역 (EEA)에 적용됩니다. 이 기능은 개인 정보 보호법 준수를 촉진합니다. (GDPR)을 참조하세요. GDPR에 의거한 다른 법적 의무가 있을 수도 있습니다. 자세한 내용은 유럽연합의 지침을 따르고 변호사와 상의하시기 바랍니다. 제발 Google 도구는 규정 준수를 지원하기 위해 설계되었으며 특정 게시자의 법적 의무를 경감시킬 수 있습니다. GDPR이 게시자에게 미치는 영향에 대해 자세히 알아보기

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

아동 대상 설정과 마찬가지로 TFUA 매개변수(tag_for_under_age_of_consent)를 구성합니다. 다음 열거된 값으로 구성됩니다.

• 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: 광고 요청이 사용자 대신 처리를 받아야 하는지 여부를 지정하지 않은 경우 유럽 경제 지역 (EEA)의 경우 동의 연령 미만의 사용자에게 적용됩니다.

다음은 광고 요청에 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

다음 코드는 RequestConfiguration 구조체를 구성하여 이 광고를 지정합니다. 반환되는 콘텐츠는 디지털 콘텐츠 라벨 지정 G보다 높음:

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