아래 가이드에는 커스텀 타입 광고 타입에 대해 설명 하고 있으며, 기본적인 연동은 애드팝콘 SSP 정식 가이드 사이트에서 확인하시기 바랍니다.
커스텀 광고?
SDK를 통해 자동으로 광고를 노출하지 않고 광고 노출에 필요한 정보를 받아 직접 광고를 노출 시켜주는 수동 광고 타입
1. 기본 연동
을 참고하시고 아래 사항 SSP SDK 기본 연동 진행이 필요합니다.
2. 인스턴스 생성
커스텀 광고를 요청하기 위해 인스턴스 생성 및 추가합니다.
private AdPopcornSSPCustomAd adpopcornSSPCustomAd;
@Override
Protected void onCreate(Bundle savedInstanceState){
adpopcornSSPCustomAd = new AdPopcornSSPCustomAd (context);
}
3. PlacementId 설정
@Override
Protected void onCreate(Bundle savedInstanceState){
adpopcornSSPCustomAd = new AdPopcornSSPCustomAd (context);
adpopcornSSPCustomAd.setPlacementId(“발급받은 placementID”);
}
4. 광고 타입 설정
커스텀 placement의 광고 타입을 정의합니다.
CustomAdType.BANNER_320x50
CustomAdType.BANNER_300x250
CustomAdType.BANNER_320x100
CustomAdType.INTERSTITIAL
@Override
Protected void onCreate(Bundle savedInstanceState){
adpopcornSSPCustomAd = new AdPopcornSSPCustomAd (context);
adpopcornSSPCustomAd.setPlacementId(“발급받은 placementID”);
adpopcornSSPCustomAd.setAdType(CustomAdType.NATIVE_AD);
}
5. 이벤트 리스너 설정
광고 요청에 대한 결과를 전달 받을 이벤트 리스너를 등록합니다.
광고 요청에 성공한 경우. adData에 광고 정보가 넘어옵니다.
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>
{
CtaText = “Click";
Desc = “Adpopcorn SSP description sample”;
IconImageURL = “https://static.adbrix.igaworks.com/adpopcornssp/test_campaign/80x80_icon.jpg”;
MainImageURL = “https://static.adbrix.igaworks.com/adpopcornssp/test_campaign/1200x627.jpg”;
PrivacyPolicyImageURL = “https://static.adbrix.igaworks.com/adpopcornssp/default_image/warning.png”;
PrivacyPolicyURL = “https://www.igaworks.com/ko/rule_user.html”;
Title = “Title sample”;
LandingURL = “https://www.igaworks.com”;
}
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)으로 메일 주시기 바랍니다.
