Cauly Android SDK 설치가이드 목차 1. Cauly SDK 설치젂꼭체크해야할 APP정책 2. Android SDK V1.2.5 구성 3. SDK설치가이드 4. 참고 페이지 1
Cauly SDK 설치젂꼭체크해야할 APP 운영정책 APP 등록반려대상 1-1 1. APP 이용자 에게문구, 이모티콘등을이용하여광고클릭을유도하는 APP ( 광고클릭요청, 유도, 대가제공 X) 광고클릭 유도문구 (X) 2. 메뉴실행을위한버튼이 Cauly 광고배너와겹쳐있거나, 0.5cm,14px 이내근접해있는 APP 배너와버튼겹침 (X) 0.5Cm(14px) 간격띄기 페이지 2
3. Cauly 광고배너가 APP 컨텐츠를가리는경우 배너가컨텐츠를 가리는경우 (X) 0.5Cm(14px) 간격띄기 4. Cauly 광고배너광고를읶위적으로편집한경우 ( 사이즈변경등 ) 배너를인위적으로 편집하는경우 (X) 0.5Cm(14px) 간격띄기 ( 자세한내용은카울리 APP 운영정책참조 ) 페이지 3
Cauly SDK 설치젂꼭체크해야할 APP 운영정책 기본광고플랫폼 size 1-2 광고높이는 Device 세로모 드의높이 1/10 으로자동설 정 광고높이는 Device 세로모드의 높이 1/10 으로자동설정 게임 APP 등가로형 APP 내광고배너사이즈자유도부여 세로 size : Device 세로모드의 높이 1/10 으로자동설정 가로사이즈조정시주의사항 - 디바이스마다가로사이즈가다르기때문에측정하는함수등을사용하여조정하는경우승읶처리되지만, 임의강제축소조정은반려처리됩니다. ( 임의강제축소는정상적읶광고노출을저해할수있습니다 ) - 가로사이즈임의조정으로, 광고정보노출이정상적으로되지않을경우적립된수익금을회수조치할수있습니다. 가로사이즈제어 Tip( 측정함수예시 ) - ((WindowManager)this.getSystemService(Context.WINDW_SERVICE)).getDefaultDisplay().getrientation(); // 가로세로판별하는코드 - WindowManager)this.getSystemService(Context.WINDW_SERVICE)).getDefaultDisplay(); //display 가로세로구하는코드 페이지 4
Cauly Android SDK V1.2.5 Release Note 2 1. SDK V1.2.5 구성 - Sample Project - CaulySDK-V1.2.5.jar - Release Note 2. 준비사항 - Eclipse SDK version 3.5(GALILE) - CaulySDK-V1.2.5.jar 3. SDK V1.2.5 기능 광고종류 설명 - 광고 Reload 기능. - 광고높이는 Device 세로높이의 1/10 으로자동설정. CPC( 배너광고 ) - Device 의가로해상도가 320 보다낮으면광고노출안됨. - 광고효과선택가능 반드시하나의 Layout 에광고는 1 개만허용 4. <supports-screens> 사용시주의사항 - android:anydensity=["true false ] // true를권장합니다. 5. 이번버젂에서향상된점 - 버그수정및기능개선 페이지 5
SDK 설치 GUIDE 3 ㄱ. 다운받은파일의압축을푼다 ㄴ. 압축을푼뒤, SDK 를설치할 APP 프로젝트 에 lib 폴더를생성한후, CaulySDK-V1.2.5.jar 파일을복사해붙여넣는다 SDK 설치할 app 프로젝트 lib 폴더생성 SDK 폴더에서 CaulySDK-V1.2.5.jar 파읷을복사해붙여넣는다 ㄷ. CaulySDK-V1.2.0.jar 붙여넣은후 APP 프로젝트 와연결해준다. 1 Properties >>2 javabuild Path >>3 Libraries >>4 Add JARs CaulySDK-V1.2.5.jar 선택후확인 2 3 4 1 5 페이지 6
ㄹ. AndroidManifest.xml 에퍼미션추가. AndroidManifest.xml 파읷 내추가할소스 추가할소스 <uses-permission android:name="android.permission.call_phne"/> <uses-permission android:name="android.permission.internet" /> <uses-permission android:name="android.permission.access_fine_lcatin"/> <uses-permission android:name="android.permission.access_netwrk_state"/> <uses-permission android:name="android.permission.write_external_strage"/> <uses-permission android:name="android.permission.read_external_strage"/> 페이지 7
ㅁ. 프로젝트 /res/values/attrs.xml 파읷을열어다음을추가한다. attrs.xml 파읷내추가할소스 : 파읷이없는경우 attrs.xml 파읷 추가할소스 <declare-styleable name="com.cauly.android.ad.adview"> <attr name="action" format="string" /> <attr name="appcode" format="string" /> <attr name="adtype" format="string" /> <attr name="gender" format="string" /> <attr name="age" format="string" /> <attr name="reloadinterval" format="integer" /> <attr name="gps" format="string" /> <attr name="effect" format="string" /> <attr name="allowcall" format="string" /> </declare-styleable> 페이지 8
ㅂ. 광고를삽입하고싶은 layout 에광고를소스를삽입 ( 두가지방식제공 : XML 방식, JAVA 방식 ) [XML 방식 ] 동일한 Package name 이여함 광고를삽입하고싶은 layout 에소스추가 추가할소스 <com.cauly.android.ad.adview xmlns:app="http://schemas.android.com/apk/res/ 본인 APP의 package name 입력 " android:id="@+id/ad" android:layout_width="fill_parent" android:layout_height="wrap_content" android:layout_alignparentbottom="true" app:appcode="cauly" app:adtype="cpc" app:gender="all" app:age="all" app:gps="off" app:effect="circle" app:allowcall="yes" app:reloadinterval="90"/> 페이지 9
- 설정방법 광고종류 Attrs 설명 Appcode Adtype APP 등록후부여받은 APP CDE[ 발급 ID] ( 테스트시에는 CAULY 사용 ) CPC Gender male( 남성 ) or female( 여성 ) or all( 전체 ) Age 10(10 대 ), 20(20 대 ), 30(30 대 ), 40(40 대 ), 50(50 대 ), all( 전체 ) Gps auto( 자동 ) or off( 사용안함 ) CPC( 띠광고 ) Effect allowcall circle ( 한바퀴롤링 ) half ( 반바퀴롤링 ) bottom_slide ( 아래서위로슬라이드 ) top_slide ( 위에서아래로슬라이드 ) left_slide ( 왼쪽에서오른쪽으로슬라이드 ), default ( 기본 ) yes, no reloadinterval 30, 90, 120 [XML 방식 _ 끝 ] 페이지 10
[JAVA 방식 ] ㄱ. res >> layout >> 광고삽입할부분.xml android: id= @+id/ 사용자지정 ID 입력 추가할소스 <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" android:id="@+id/ 사용자지정ID 입력 " android:orientation="vertical" android:layout_width="fill_parent" android:layout_height="fill_parent"/> 페이지 11
ㄴ. src >> 사용자 package name >> 사용자프로젝트 name.java 2 1 - implements AdListener{ : 광고수신성공 / 실패정보를 SDK로부터제공받기위해 AdListener 인터페이스를구현한다. 광고수신성공은 public void onreceivead() 에서처리하고, 광고수신실패는 public void onfailedtoreceivead(boolean state) 에서처리한다. - private RelativeLayout main_layout; : 광고뷰가삽입될레이아웃 페이지 12
추가할소스 public class CaulySDKTest extends Activity implements AdListener{ /** Called when the activity is first created. */ private RelativeLayout main_layout; @verride public void oncreate(bundle savedinstancestate) { super.oncreate(savedinstancestate); setcontentview(r.layout.main); main_layout = (RelativeLayout)findViewById(R.id.main); AdInfo ads_info = new AdInfo(); ads_info.initdata(appcode, adtype, gender, age, gps, effect, allowcall, reloadinterval); // 설정방법참조 // AdView adview = new AdView(this); adview.setadlistener(this); main_layout.addview(adview); } public void onfailedtoreceivead(boolean arg0) { } // TD Auto-generated method stub } public void onreceivead() { } // TD Auto-generated method stub 페이지 13
- 설정방법 광고종류 Attrs 설명 Appcode Adtype APP 등록후부여받은 APP CDE[ 발급 ID] ( 테스트시에는 CAULY 사용 ) CPC Gender male( 남성 ) or female( 여성 ) or all( 전체 ) Age 10(10 대 ), 20(20 대 ), 30(30 대 ), 40(40 대 ), 50(50 대 ), all( 전체 ) Gps auto( 자동 ) or off( 사용안함 ) CPC( 띠광고 ) Effect allowcall circle ( 한바퀴롤링 ) half ( 반바퀴롤링 ) bottom_slide ( 아래서위로슬라이드 ) top_slide ( 위에서아래로슬라이드 ) left_slide ( 왼쪽에서오른쪽으로슬라이드 ), default ( 기본 ) yes, no reloadinterval 30, 90, 120 [JAVA 방식끝 ] 6. 주의사항 - 광고높이는 Device 세로높이의 1/10으로자동설정. - Device의가로해상도가 320보다낮으면광고노출안됨 - <supports-screens> 사용시주의사항 : android:anydensity=["true false ] // true를권장합니다 Cauly SDK 설치관련하여문의사항은고객센터 1544-8867 또는 Cauly@futurestream.co.kr 로문의주시면빠르게응대해드리도록하겠습니다. 페이지 14
참고 [ Update history ] 읷정 SDK Ver 업데이트내용 2010-09-10 v1.0.0 1 버그개선 2 GPS Manual 모드삭제. 3 Call 광고추가. 4 배너광고추가. 광고 Show, Hidden 기능추가.( 샘플참고 ) 2010-11-10 v1.0.5 1 get_tasks 퍼미션삭제 이미지불러올시 Timeout 추가 2010-11-10 v1.0.6 - Tstore 버전 1 get_tasks 퍼미션삭제 2 이미지불러올시 Timeout 추가 2010-11-15 v1.0.7 1 퍼미션중 Read_phone_State 2010-12-01 v1.0.8 2 버그개선 2011-01-04 v1.1.0 1 버그개선 2 GPS Manual 모드삭제. 3 Call 광고추가. 4 배너광고추가. 광고 Show, Hidden 기능추가.( 샘플참고 ) 2011-01-18 v1.1.1 5 READ_PHNE_STATE 퍼미션제거 2011-01-20 v1.1.2 T store 앱광고 Cauly SDK 최초제공 2011-01-24 v1.1.3 1 READ_PHNE_STATE 퍼미션제거 (ACCESS_WIFI_STATE 퍼미션으로대체 ) 2 에뮬레이터에서 APP 강제종료되는오류개선 2011-02-07 v1.1.4 1 ACCESS_NETWRK_STATE 퍼미션추가 ( 통신상태체크 ) 2 3G 상태에서어플이강제종료되는오류개선 2011-02-11 v1.1.5 접속망 (3G, wifi) 상태가불안정할경우어플이종료되는오류개선 2011-03-15 V1.1.6 광고정보송출시발생하는이미지중첩현상에대한버그개선 2011-04-01 V1.1.7 1 데이터받아오는 Timeout 시간변경. 2 App 광고버그수정 2011-04-06 V1.1.8 티스토어 APP GPS 어트리뷰트삭제 2011-05-30 V1.2.0 1 JAVA 로광고 View 동적생성. 2 GPS( 위치정보 ) 버그수정 3 ACCESS_WIFI_STATE 퍼미션삭제 4 WRITE_EXTERNAL_STRAGE 와 READ_EXTERNAL_STRAGE 퍼미션추가 2011-05-31 V1.2.1 버그개선 2011-06-02 V1.2.2 티스토어 APP GPS 어트리뷰트삭제 2011-06-23 V1.2.3 네트워크속도개선 2011-06-30 V1.2.4 티스토어 APP GPS 어트리뷰트삭제및네트워크속도개선 2011-08-10 v1.2.5 버그수정및기능개선 2011-08-10 v1.2.6 티스토어 APP GPS 어트리뷰트삭제및버그수정및기능개선 페이지 15
[ Cauly S 및 Device별지원광고 ] AD 구분광고 S 단말기지원여부 iphone is ipad APP 광고 Phone Android Tablet PC iphone is ipad Site 광고 Phone Android Tablet PC CPC iphone is ipad 지역광고 Phone X Android Tablet PC X iphone is ipad X 콜광고 Phone Android Tablet PC iphone is ipad X CPM Phone X Android Tablet PC X * Android Tablet PC : 삼성갤럭시Tab 에한함 (2011년 1월기준 ) 페이지 16