커스텀 타입(Android)
본 문서는 비공개 문서이며 Android 환경에서 커스텀 타입 광고용 API 가이드 입니다.
아래 가이드에는 커스텀 타입 광고 타입에 대해 설명 하고 있으며, 기본적인 연동은 애드팝콘 SSP 정식 가이드 사이트에서 확인하시기 바랍니다.
1. 기본 연동
애드팝콘 SSP SDK Android 기본 설정을 참고하시고 아래 사항 SSP SDK 기본 연동 진행이 필요합니다.
SDK 다운로드 및 설치
매니페스트 설정
필수 코드 연동
2. 인스턴스 생성
커스텀 광고를 요청하기 위해 인스턴스 생성 및 추가합니다.
private AdPopcornSSPCustomAd adpopcornSSPCustomAd;
@Override
Protected void onCreate(Bundle savedInstanceState){
adpopcornSSPCustomAd = new AdPopcornSSPCustomAd (context);
}
3. PlacementId 설정
아래 코드를 추가하여 커스텀 광고의 PLACEMENT ID 를 설정합니다. PLACEMENT ID 는 애드팝콘 SSP 콘솔페이지에서 생성이 가능합니다.
@Override
Protected void onCreate(Bundle savedInstanceState){
adpopcornSSPCustomAd = new AdPopcornSSPCustomAd (context);
adpopcornSSPCustomAd.setPlacementId(“발급받은 placementID”);
}
4. 광고 타입 설정
커스텀 placement의 광고 타입을 정의합니다.
CustomAdType.BANNER_320x50
배너 320x50 사이즈
CustomAdType.BANNER_300x250
배너 300x250 사이즈
CustomAdType.BANNER_320x100
배너 320x100 사이즈
CustomAdType.INTERSTITIAL
전면 광고
CustomAdType.NATIVE_AD
네이티브 광고
@Override
Protected void onCreate(Bundle savedInstanceState){
adpopcornSSPCustomAd = new AdPopcornSSPCustomAd (context);
adpopcornSSPCustomAd.setPlacementId(“발급받은 placementID”);
adpopcornSSPCustomAd.setAdType(CustomAdType.NATIVE_AD);
}
5. 이벤트 리스너 설정
광고 요청에 대한 결과를 전달 받을 이벤트 리스너를 등록합니다.
OnCustomAdReceiveSuccess
광고 요청에 성공한 경우. adData에 광고 정보가 넘어옵니다.
OnCustomAdReceiveFailed
광고 요청에 실패한 경우
private AdPopcornSSPCustomAd adpopcornSSPCustomAd;
@Override
Protected void onCreate(Bundle savedInstanceState){
adpopcornSSPCustomAd = new AdPopcornSSPCustomAd (context);
adpopcornSSPCustomAd.setPlacementId(“발급받은 placementID”);
adpopcornSSPCustomAd.setAdType(CustomAdType.NATIVE_AD);
adpopcornSSPCustomAd.setCustomAdEventCallbackListener (new ICustomAdListener(){
@Override
public void OnCustomAdReceiveSuccess (String placementId, , String adData) {
}
@Override
public void OnCustomAdReceiveFailed (String placementId, SSPErrorCode code) {
}
});
}
각 광고 타입별 성공 시 adData 예시는 아래와 같습니다.
<html><head><style>html,body{overflow:hidden;position:relative;width:100%;heigh
t:100%;margin:0;padding:0}</style></head>><body>
<a href="https://partners.igaworks.com/"target="_blank">
<img src="https://adpopcorn-ssp/test_campaign/300x250.JPG" width="300"
height="250" /></a></body></html><style>
html,body{overflow:hidden;position:relative;width:100%;height:100%;margin:0;paddin
g:0}</style>
6. 광고 요청
광고 요청 시점에 load API 호출하여 서버에 광고를 요청합니다.
private AdPopcornSSPCustomAd adpopcornSSPCustomAd;
@Override
Protected void onCreate(Bundle savedInstanceState){
adpopcornSSPCustomAd = new AdPopcornSSPCustomAd (context);
adpopcornSSPCustomAd.setPlacementId(“발급받은 placementID”);
adpopcornSSPCustomAd.setAdType(CustomAdType.NATIVE_AD);
adpopcornSSPCustomAd.setCustomAdEventCallbackListener (new ICustomAdListener(){
@Override
public void OnCustomAdReceiveSuccess (String placementId, , String adData) {
}
@Override
public void OnCustomAdReceiveFailed (String placementId, SSPErrorCode code) {
}
});
adpopcornSSPCustomAd.loadAd();
}
7. 광고 노출, 클릭 리포트 수집
커스텀 광고 타입의 경우 매체가 직접 광고물을 노출시키고, 클릭 처리를 해주어야 하기에 반드시 아래 두 API를 적절한 시점해 호출해 주는 연동을 진행해 주어야 정확한 데이터 수집이 가능합니다.
// 광고 노출 시점에 호출
adpopcornSSPCustomAd.reportImpression();
// 광고 클릭 시점에 호출
adpopcornSSPCustomAd.reportClick();
위 연동 중 궁금하신 사항이나 수정이 필요한 부분이 있으면 애드팝콘 사업팀(pm@adpopcorn.com)으로 메일 주시기 바랍니다.
Last updated
Was this helpful?