Google 광고 및 측정 커뮤니티 서버의 #gma-next-gen-sdk Discord 채널에서 GMA Next-Gen SDK에 대한 의견을 공유하세요.

Targeting

이 가이드에서는 Google 모바일 광고 SDK에 타겟팅 정보를 제공하는 방법을 설명합니다.

기본 요건

RequestConfiguration

RequestConfiguration 은 모든 광고 요청에 전체적으로 적용되는 타겟팅 정보를 수집합니다. 사용 가능한 타겟팅 태그는 문서를 참고하세요.RequestConfiguration.Builder

빌더를 사용하여 필요한 타겟팅 태그로 RequestConfiguration 객체를 만든 다음 MobileAds.setRequestConfiguration()을 호출하여 구성을 설정합니다.

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

첫 번째 광고 요청에서 타겟팅 태그를 적용하려면 SDK 초기화 중에 요청 구성을 제공하세요.

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

CoroutineScope(Dispatchers.IO).launch {
  // Initialize GMA Next-Gen SDK on a background thread.
  MobileAds.initialize(
    this@MainActivity,
    InitializationConfig
      // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
      .Builder("SAMPLE_APP_ID")
      .setRequestConfiguration(requestConfiguration)
      .build()
  ) {
    // Adapter initialization is complete.
  }
  // Other methods on MobileAds can now be called.
}

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
    .Builder()
    // Set your targeting tags.
    .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build();

new Thread(
    () -> {
      // Initialize GMA Next-Gen SDK on a background thread.
      MobileAds.initialize(
          this,
          // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
          new InitializationConfig
              .Builder("SAMPLE_APP_ID")
              .setRequestConfiguration(requestConfiguration)
              .build(),
          initializationStatus -> {
            // Adapter initialization is complete.
          });
      // Other methods on MobileAds can now be called.
    })
    .start();

아동 대상 설정

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

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

setTagForChildDirectedTreatment()를 통해 아동 대상 설정을 적용할 수 있습니다.

콘텐츠를 COPPA의 취지에 따라 아동 대상으로 처리하도록 하려면 TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE로 setTagForChildDirectedTreatment를 호출합니다. 그러면 Android 광고 ID (AAID)가 전송되지 않습니다.
콘텐츠를 COPPA의 취지에 따라 아동 대상으로 처리하지 않도록 하려면 TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE로 setTagForChildDirectedTreatment를 호출합니다.
광고 요청에서 COPPA에 따른 콘텐츠 취급 방법을 지정하지 않으려면 TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED로 setTagForChildDirectedTreatment를 호출합니다.

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

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

동의 연령 미만의 사용자

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

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

아동 대상 설정과 마찬가지로 RequestConfiguration.Builder에는 다음 옵션과 함께 TFUA 매개변수 setTagForUnderAgeOfConsent()를 설정할 수 있는 메서드가 있습니다.

광고 요청이 유럽 경제 지역 (EEA)에 거주하는 동의 연령 미만의 사용자를 대상으로 하는 요청으로 취급되도록 하려는 경우, 이를 나타내기 위해 TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE로 setTagForUnderAgeOfConsent()를 호출합니다. 그러면 Android 광고 식101별자 (AAID)도 전송되지 않습니다.
광고 요청이 유럽 경제 지역 (EEA)에 거주하는 동의 연령 미만의 사용자를 대상으로 하는 요청으로 취급되지 않도록 하려는 경우, 이를 나타내기 위해 TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE로 setTagForUnderAgeOfConsent()를 호출합니다.
광고 요청이 유럽 경제 지역 (EEA)에 거주하는 동의 연령 미만의 사용자를 대상으로 하는 요청으로 취급되어야 하는지 여부를 지정하지 않으려는 경우, 이를 나타내기 위해 TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED로 setTagForUnderAgeOfConsent()를 호출합니다.

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

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  .setTagForUnderAgeOfConsent(RequestConfiguration.TagForUnderAgeOfConsent.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setTagForUnderAgeOfConsent(TagForUnderAgeOfConsent.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

아동 대상 설정과 setTagForUnderAgeOfConsent()를 사용 설정하는 태그를 동시에 true로 설정하면 안 됩니다. 이 경우 아동 대상 설정이 우선 적용됩니다.

광고 콘텐츠 필터링

광고 내 관련 혜택을 포함하는 Google Play의 부적절한 광고 정책을 준수하려면 콘텐츠 자체가 Google Play 정책을 준수하더라도 앱 내에 표시되는 모든 광고 및 관련 혜택이 앱의 콘텐츠 등급에 적합해야 합니다.

광고 콘텐츠 등급 한도와 같은 도구를 사용하면 사용자에게 게재되는 광고의 콘텐츠를 더 세부적으로 관리할 수 있습니다. 플랫폼 정책을 준수하도록 콘텐츠 등급 한도를 설정할 수 있습니다.

앱에서 메서드를 사용하여 광고 요청에 대해 광고 콘텐츠 등급 한도를 설정할 수 있습니다.setMaxAdContentRating 광고 콘텐츠 등급 한도가 설정된 경우 콘텐츠 등급이 설정된 한도 이하인 AdMob 광고가 게재됩니다. 이 네트워크 세부정보에 대해 가능한 값은 디지털 콘텐츠 라벨 분류에 따라 정해지며 다음 중 하나여야 합니다.

MAX_AD_CONTENT_RATING_G
MAX_AD_CONTENT_RATING_PG
MAX_AD_CONTENT_RATING_T
MAX_AD_CONTENT_RATING_MA

다음 코드는 반환되는 광고 콘텐츠가 G보다 높지 않은 디지털 콘텐츠 라벨 지정에 상응하도록 RequestConfiguration 객체를 구성합니다.

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  .setMaxAdContentRating(RequestConfiguration.MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setMaxAdContentRating(MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

다음에 대해 자세히 알아보기

게시자 개인 정보 보호 처리 (베타)

게시자 개인 정보 보호 처리 (PPT) API는 앱이 광고 개인 최적화를 모든 광고 요청에 대해 사용 중지할지를 나타낼 수 있는 도구입니다(선택사항).setPublisherPrivacyPersonalizationState() 이 기능을 사용하면 세션의 남은 시간 동안 모든 광고 요청에 Publisher Privacy Treatment (PPT) 매개변수가 포함됩니다.

기본적으로 Google에 대한 광고 요청에는 개인 맞춤 광고가 게재됩니다. 다음 코드는 모든 광고 요청에 대해 광고 개인 최적화를 사용 중지합니다.

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  .setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

광고 요청

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

네트워크 세부정보 추가

네트워크 세부정보는 광고 요청과 함께 전송되는 추가 세부정보로, 단일 광고 소스에만 해당합니다.

다음 코드 스니펫은 collapsible의 추가 매개변수 키를 bottom 값으로 Google에 설정합니다.

Kotlin

val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest =
  NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build()
NativeAdLoader.load(adRequest, adCallback)

Java

Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
NativeAdRequest adRequest =
  new NativeAdRequest.Builder("AD_UNIT_ID", Arrays.asList(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build();
NativeAdLoader.load(adRequest, adCallback);

Targeting 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

기본 요건

RequestConfiguration

Kotlin

Java

Kotlin

Java

아동 대상 설정

Kotlin

Java

동의 연령 미만의 사용자

Kotlin

Java

광고 콘텐츠 필터링

Kotlin

Java

게시자 개인 정보 보호 처리 (베타)

Kotlin

Java

광고 요청

네트워크 세부정보 추가

Kotlin

Java

Targeting