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

타겟팅

이 가이드에서는 광고 요청에 타겟팅 정보를 제공하는 방법을 설명합니다. Android API 데모 앱을 다운로드하세요

API 데모 다운로드

기본 요건

시작 가이드를 끝까지 읽어보세요.

RequestConfiguration

RequestConfiguration 드림 는 MobileAds 정적 메서드를 제공합니다.

요청 구성을 업데이트하려면 기존 원하는 대로 업데이트하고 다음과 같이 설정합니다.

자바

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

아동 대상 설정

아동 온라인 개인 정보 보호법의 목적상 (COPPA), '아동 대상 서비스로 취급용 태그'라는 설정이 있습니다. 이 태그를 설정하면 이 알림이 정확함을 확인하는 것으로 간주됩니다. 앱의 소유자를 대행할 권한이 있어야 합니다. 이 설정을 악용하면 계정이 해지될 수 있음을 이해합니다. 로그인이 필요합니다.

앱 개발자인 경우 Google에서 내 콘텐츠를 아동 대상으로 제공할 수 있습니다. 귀하가 Google이 콘텐츠를 아동 대상 서비스로 취급하기를 원하는 경우 Google은 해당 광고 요청에 대한 관심 기반 광고 및 리마케팅 광고 비활성화

이 설정은 모든 버전의 Google Play 서비스 SDK에서 사용할 수 있습니다. RequestConfiguration.Builder.setTagForChildDirectedTreatment(int)까지:

setTagForChildDirectedTreatment에 전화 걸기: TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE: COPPA에 따라 아동 대상으로 취급되는 콘텐츠 이렇게 하면 Android 광고 ID의 전송은 (AAID)
setTagForChildDirectedTreatment에 전화 걸기: TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE: COPPA에 따라 아동 대상으로 취급되는 콘텐츠
setTagForChildDirectedTreatment에 전화 걸기: 표시하지 않으려면 TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED 광고 요청에서 COPPA에 따라 콘텐츠를 어떻게 처리할지 선택할 수 있습니다.

다음 예는 콘텐츠를 아동 온라인 개인 정보 보호법(COPPA)에 의거하여

자바

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

동의 연령 미만의 사용자

유럽 경제 지역 (EEA)의 경우 동의 연령 미만의 사용자에게 적용됩니다. 이 기능은 개인 정보 보호법 (GDPR). 의무를 이행합니다. 유럽 연합의 지침을 검토하고 변호사와 상담하시기 바랍니다. Google 도구는 Google에서 특정 게시자의 의무가 면제되지 않으며, 법을 준수해야 합니다. GDPR이 게시자에게 미치는 영향에 대해 자세히 알아보기

이 기능을 사용하면 유럽의 동의 연령 미만 사용자를 위한 태그 (TFUA) 매개변수가 광고 요청에 포함됩니다. 이 매개변수는 모든 광고 요청에 대해 리마케팅을 포함한 개인 맞춤 광고를 게재할 수 있음 또한 서드 파티 광고 업체에 대한 요청(예: 광고 측정 픽셀 및 외부 광고 서버를 사용하는 것이 좋습니다

아동 대상 설정과 마찬가지로 RequestConfiguration.Builder: TFUA 매개변수 설정 setTagForUnderAgeOfConsent(), 다음 옵션을 사용하세요.

TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE번으로 setTagForUnderAgeOfConsent()에 전화 걸기 해당 광고 요청이 해당 유형의 사용자에 대해 처리되는 것을 유럽 경제 지역 (EEA)의 경우 동의 연령 미만의 사용자에게 적용됩니다. 또한 Android 광고 ID의 전송을 (AAID)
TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE번으로 setTagForUnderAgeOfConsent()에 전화 걸기 광고 요청이 특정 사용자를 대상으로 하는 요청으로 취급되지 않도록 유럽 경제 지역 (EEA)의 경우 동의 연령 미만의 사용자에게 적용됩니다.
setTagForUnderAgeOfConsent()에 전화 걸기: TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED: 는 광고 요청이 유럽 경제 지역 (EEA)의 경우 동의 연령 미만의 사용자에게 적용됩니다.

다음 예는 광고 요청에 TFUA를 포함하도록 지정합니다.

자바

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForUnderAgeOfConsent(RequestConfiguration.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

다음 코드는 RequestConfiguration 객체를 구성하여 반환되는 광고 콘텐츠는 디지털 콘텐츠 라벨 지정 G보다 높은 경우:

자바

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

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

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

이 게시자의 개인 정보 보호 처리 (PPT) API는 앱에서 광고 사용 중지 여부를 나타낼 수 있는 선택적 도구입니다 모든 광고 요청에 대한 맞춤설정을 setPublisherPrivacyPersonalizationState() 메서드를 사용합니다. 이 기능을 사용하면 게시자 개인 정보 보호 처리 (PPT) 매개변수는 모든 향후 광고 요청에 포함됩니다.

기본적으로 Google로 전송되는 광고 요청에는 개인 맞춤 광고가 게재됩니다. 다음 모든 광고 요청에 대해 광고 개인 최적화를 끄는 코드:

자바

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

광고 요청

AdManagerAdRequest 객체가 타겟팅 수집 광고 요청과 함께 전송할 정보

맞춤 타겟팅

맞춤 키-값 쌍을 전달하여 Google Ad Manager 캠페인 (줄 항목)에서 AdManagerAdRequest.Builder.addCustomTargeting()까지:

자바

// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest = new AdManagerAdRequest.Builder()
    .addCustomTargeting("age", "25")
    .build();

Kotlin

// Example: Pass custom targeting "age=25".
var newRequest = AdManagerAdRequest.Builder()
  .addCustomTargeting("age", "25")
  .build()

키의 여러 값을 문자열 목록으로 전달할 수 있습니다. 예를 들어 만 25세가 아닌 20대 중반의 개인을 타겟팅합니다.

.addCustomTargeting("age", Arrays.asList("24", "25", "26"))

Ad Manager 맞춤 타겟팅 예 확인하기 을 참조하세요.

카테고리 제외

다음과 같은 방법으로 요청에 슬롯 수준 카테고리 제외 수준을 추가할 수 있습니다. addCategoryExclusion() 드림 AdManagerAdRequest.Builder에서 제공하는 메서드:

자바

// Example: Exclude "automobile" and "boat" categories.
AdManagerAdRequest newRequest = new AdManagerAdRequest.Builder()
    .addCategoryExclusion("automobile")
    .addCategoryExclusion("boat")
    .build();

Kotlin

// Example: Exclude "automobile" and "boat" categories.
var newRequest = AdManagerAdRequest.Builder()
  .addCategoryExclusion("automobile")
  .addCategoryExclusion("boat")
  .build()

Ad Manager 카테고리 제외의 예를 확인해 보세요. 을 참조하세요.

게시자 제공 식별자

PPID (게시자 제공 식별자)를 설정하여 최대 게재빈도 설정, 잠재고객 분류 및 타겟팅, 순차 광고 로테이션, 기타 잠재고객 기반 광고 게재 관리 기능을 제공합니다.

다음은 PPID 설정의 예입니다.

자바

AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder()
    .setPublisherProvidedId("AB123456789")
    .build();

Kotlin

var adRequest = AdManagerAdRequest.Builder()
  .setPublisherProvidedId("AB123456789")
  .build()

Ad Manager PPID 예 확인하기 게시자 제공 식별자 (PPID) 구현에 관한 API 데모 앱

게시자 제공 신호

잠재고객 및 문맥 데이터를 게시자 제공 신호와 (PPS)를 광고 요청에 사용할 수 있습니다. PPS를 사용하면 사용자 데이터를 사용하여 프로그래매틱 수익 창출 전략을 수립할 수 있도록 입찰한 모든 거래 유형이 있는 경우 사용자 식별자를 공유할 필요 없이 표준 분류를 사용합니다. 내 시청자 특성에는 행동 및 관심 기반 데이터 (IAB 잠재고객)가 포함될 수 있습니다. 분류 1.1) 및 문맥 데이터 (IAB 콘텐츠 분류 2.2)

자바

Bundle extras = new Bundle();
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6));

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
  .addNetworkExtrasBundle(AdMobAdapter.class, extras)
  .build()

Kotlin

val extras = Bundle()
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284))
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6))

val request = AdRequest.Builder()
  .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
  .build()

콘텐츠 URL

콘텐츠 타겟팅 광고 및 브랜드 안전을 위해 콘텐츠 URL을 제공하려면 setContentUrl() 드림 AdManagerAdRequest:

자바

AdManagerAdRequest.Builder builder = new AdManagerAdRequest.Builder();
builder.setContentUrl("https://www.example.com");
AdManagerAdRequest request = builder.build();

Kotlin

val builder = AdManagerAdRequest.Builder()
builder.setContentUrl("https://www.example.com")
val request = builder.build()

브랜드 안전성 (베타)

다양한 잠재고객을 대상으로 동적 콘텐츠를 표시하는 애플리케이션은 API를 사용하여 간단한 URL 목록을 setNeighboringContentUrls() 드림 메서드를 사용하여 AdManagerAdRequest:

자바

ArrayList<String> urls = new ArrayList<String>();
urls.add("https://www.mycontenturl1.com");
urls.add("https://www.mycontenturl2.com");
urls.add("https://www.mycontenturl3.com");
urls.add("https://www.mycontenturl4.com");
AdManagerAdRequest requestWithContent = new AdManagerAdRequest.Builder()
    .setNeighboringContentUrls(urls)
    .build();

Kotlin

var urls = mutableListOf("https://www.mycontenturl1.com", "https://www.mycontenturl2.com",
                         "https://www.mycontenturl3.com", "https://www.mycontenturl4.com")
var requestWithContent = AdManagerAdRequest.Builder()
  .setNeighboringContentUrls(urls)
  .build()

.setNeighboringContentUrls()은(는) .setContentUrl()과는 달리 브랜드 안전성에 사용됩니다.