이 가이드에서는 맞춤 네이티브 광고 형식을 개방형 측정과 통합하는 방법을 설명합니다.
기본 요건
- Google 모바일 광고 SDK 18.1.1 이상
- 모바일 광고 SDK를 활용한 Open Measurement를 읽어보세요.
- 맞춤 네이티브 광고 형식을 통합하세요.
- 조회가능성 제공업체를 구성하고 광고 항목에 할당합니다.
- Ad Manager UI에서 맞춤 형식을 만들 때 파트너 이름을 입력합니다.
통합
동영상 애셋이 포함되지 않은 맞춤 네이티브 광고 형식에 Open Measurement API를 사용하려는 경우 Open Measurement API를 직접 호출해야 합니다. 디스플레이 유형 맞춤 네이티브 광고 형식에 대한 Open Measurement는 모바일 광고 SDK 버전 18.1.1 이상에서만 지원됩니다.
동영상 애셋과 함께 맞춤 네이티브 광고 형식을 사용하는 경우 이 가이드를 따르지 않아도 됩니다. 모바일 광고 SDK가 사용자를 대신하여 동영상 애셋의 조회가능성을 추적합니다.
이제 NativeCustomTemplateAd로 개방형 측정을 사용하는 방법을 살펴보겠습니다. 일반적으로 조회가능성 측정을 시작하고 맞춤 광고 뷰를 등록하려면 모바일 광고 SDK에 알려야 합니다.
광고 로드
공개 측정의 사용 여부와 관계없이 광고를 로드하는 것은 동일합니다. 다음은 NativeCustomTemplateAd를 요청하는 방법을 보여주는 메서드입니다.
public void loadAd() {
AdLoader adLoader = new AdLoader.Builder(context, "YOUR-AD-UNIT-ID")
.forCustomTemplateAd("YOUR-TEMPLATE-ID",
new NativeCustomTemplateAd.OnCustomTemplateAdLoadedListener() {
@Override
public void onCustomTemplateAdLoaded(NativeCustomTemplateAd ad) {
// Register your view and begin open measurement.
// We will define this method below.
MyActivity.this.registerOpenMeasurementAndShowAd(ad);
}
},
new NativeCustomTemplateAd.OnCustomClickListener() {
@Override
public void onCustomClick(NativeCustomTemplateAd ad, String s) {
// Handle the click action
}
})
.withAdListener( ... )
.withNativeAdOptions( ... )
.build();
}
뷰 등록 및 측정 시작
NativeCustomTemplateAd에서 Open Measurement를 사용 설정하려면 NativeCustomTemplateAd와 연결된 DisplayOpenMeasurement 객체로 맞춤 광고 보기를 등록하세요. DisplayOpenMeasurement 객체는 개방형 측정으로 컨테이너 뷰를 등록하는 setView() 메서드를 제공합니다.
또한 광고 측정을 시작하도록 SDK에 명시적으로 알려야 합니다. 이렇게 하려면 NativeCustomTemplateAd의 DisplayOpenMeasurement 객체에서 start() 메서드를 호출합니다. start() 메서드는 기본 스레드에서 호출해야 하며 후속 호출은 영향을 미치지 않습니다.
다음과 같이 표시됩니다.
public void registerOpenMeasurementAndShowAd(NativeCustomTemplateAd ad) {
...
// Show ad
...
displayCustomTemplateAd(ad)
// Begin Open Measurement
// The FrameLayout that will contain your native custom ad
FrameLayout customTemplateAdFrame = (FrameLayout) findViewById(R.id.custom_ad_frame);
ad.getDisplayOpenMeasurement().setView(customTemplateAdFrame);
ad.getDisplayOpenMeasurement().start();
}
보기를 등록하기 전에 광고를 표시해야 합니다. 광고 표시는 맞춤 네이티브 광고 형식에서 다룹니다.
customTemplateAdFrame 레이아웃은 NativeCustomTemplateAd의 광고 컨테이너이며 뷰의 경계 상자 내에 모든 애셋을 포함해야 합니다.
IAB를 통한 인증
앱을 출시하면 측정 데이터를 수신하기 시작하지만 IAB 인증 프로세스를 완료할 때까지 데이터가 인증되지 않습니다.