시작하기

Android SDK 적용

SDK 적용

Download Link

https://ads-static.v2.dexops.co.kr/sdk/Android_DeXOpsAdsAgent_2.1.0.zip

다운로드 받은 SDK를 프로젝트 라이브러리 폴더에 복사

Gradle 설정

dependencies {
    implementation files ("라이브러리 폴더/DeXOpsAdsAgent.aar") //DeXOps SDK
    
    // 구글 광고 ID
    // https://mvnrepository.com/artifact/com.google.android.gms/play-services-ads-identifier
    implementation("com.google.android.gms:play-services-ads-identifier:18.0.1")    
    // Play Store 설치정보
    // https://mvnrepository.com/artifact/com.android.installreferrer/installreferrer
    implementation("com.android.installreferrer:installreferrer:2.2")
    // Kotlin JSON
    // https://mvnrepository.com/artifact/org.jetbrains.kotlinx/kotlinx-serialization-json
    implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.6.3")
}

프로가드 예외 설정

-keep class com.dexops.dexopsagent.** {*;}
-dontwarn com.dexops.dexopsagent.**

AndroidManifest.xml 권한 설정

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">
    <!-- 권한 : 광고 ID -->
    <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
    <!-- 권한 : ConnectivityManager 목적 : 통신 연결이 Mobile or Wifi 여부 파악 -->
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> 
    <!-- 권한 : NetworkInterface 목적 : IP 주소 -->
    <uses-permission android:name="android.permission.INTERNET"/>
    <!-- 권한 : Telephony Network Type SDK version 23 이하 목적 : Mobile network: 2G, 3G, LET, 5G 등 -->
    <uses-permission android:name="android.permission.READ_BASIC_PHONE_STATE"/> 
    <!-- 권한 : Telephony DataNetworkType Type SDK version 24 이상 목적 : Mobile network: 2G, 3G, LET, 5G 등 -->
    <uses-permission android:name="android.permission.READ_PHONE_STATE"/> 
</manifest>

SDK 초기화

Android Application Class 에서 수행

광고 서버 URL은 담당 메니저를 통해 별도 안내 드립니다.

Sample Code

class MyApplication: Application() {
  override fun onCreate() {
        super.onCreate()
        
        // DeXOps 초기화
        DeXOps.configure(this, "광고서버 URL")
    }
}

public class MyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        
        // DeXOps 초기화
        DeXOps.configure(this, "광고서버 URL");
    }
}

광고 요청

Activity 의 LifeCycle onCreate(), onStart(), onResume() 광고 목적에 맞게 광고 요청을 수행

아래 예시는 onStart() 에서 요청

class MyActivity: AppCompatActivity() {
    override fun onStart() {
        super.onStart()
        
        //FrameLayout (광고가 위치할 Layout)
        val frameLayout = this.window.decorView as FrameLayout
        
        val channel = 0   //채널
        val section = 0   //섹션
        val slot = 0      //슬롯
        
        // 배너 옵션 (상단, 하단, 좌측, 우측 마진 정보)
        val bannerOptions = DeXOps.shared().makeBannerOptionsBuilder()
                                      .topMargin(0)
                                      .bottomMargin(0)
                                      .leftMargin(0)
                                      .rightMargin(0)
                                      .build()
        // 광고 요청
        DeXOps.shared().bannerView(frameLayout, channel, section, slot, bannerOptions) { isSuccess: Boolean, msg: String ->
            println("isSuccess=$isSuccess, message=$msg")
        }
    }
}

public class MyActivity extends AppCompatActivity {
    @Override
    public void onStart() {
        super.onStart();
        
        //FrameLayout (광고가 위치할 Layout)
        FrameLayout frameLayout =  (FrameLayout) MyActivity.this.getWindow().getDecorView();
        
        int channel = 0;    //채널
        int section = 0;    //셕션
        int slot = 0;       //슬롯 
        
        //배너 옵션 (상단, 하단, 좌측, 우측 마진 정보)
        Map<String, Object> bannerOptions = DeXOps.shared().makeBannerOptionsBuilder()
                                      .topMargin(0)
                                      .bottomMargin(0)
                                      .leftMargin(0)
                                      .rightMargin(0)
                                      .build();
        // 광고 요  
        DeXOps.shared().bannerView(frameLayout, channel, section, slot, bannerOptions, (isSuccess, msg) -> {
            Log.d(TAG, "isSuccess=" + isSuccess + ", message=" + msg);
            return null;
        });
    }
}

Hybrid App 광고 요청

Javascript Interface 설정

Sample Code

class MyActivity: AppCompatActivity() {
  override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        
        //Javascript Interface WebView 적용
        val deXOpsJavascriptInterface = DeXOpsJavascriptInterface(webView)
        webView.addJavascriptInterface(deXOpsJavascriptInterface, deXOpsJavascriptInterface.name)
    }
}

public class MyActivity extends AppCompatActivity {
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        
        //Javascript Interface WebView 적용
        DeXOpsJavascriptInterface deXOpsJavascriptInterface = new DeXOpsJavascriptInterface(webView);
        webView.addJavascriptInterface(deXOpsJavascriptInterface, deXOpsJavascriptInterface.getName());
    }
}

Web 광고 요청

등록된 Javascript Interface 를 통해 광고를 요청 하고 Web 화면에 광고를 보여주게 됨
HTML 또는 Javascript 함수 호출 선택

Custom Element 가이드

<html>
<head>
  <!-- DeXOps Web Javascript SDK-->
  <script defer src="https://ads-static.v2.dexops.co.kr/js/dexops_agent_ads.js" data-campaign="광고 서버 URL"></script>
</head>
<body>
  <!-- 모바일 웹과 Hybrid웹을 동일한 페이지에서 사용 하는 경우 분기 처리 필요 -->
  <!-- 하이브리드 웹뷰 페이지인 경우 -->
  <div>
    <dexops-ads-app-view data-channel="0" data-section="0" data-slot="0" data-top-margin="0" data-bottom-margin="0" data-left-margin="0" data-right-margin="0"></dexops-ads-app-view>  
  </div>
  <!-- 광고 응답 콜백 이벤트 필요한 경우 -->
  <script>
      for (let element of document.getElementsByTagName('dexops-ads-app-view') ){
          element.addEventListener('dexopsAdsViewCompletion', function (ev) {
              const status = this.dataset.status; //성공 true, 실패 false
              const message = this.dataset.message; //결과 메세지
              const channel = this.dataset.channel; //채널
              const section = this.dataset.section; //섹션
              const slot = this.dataset.slot; //슬롯
          });
      }
  </script>
</body>
</html>

Javascript 가이드

<html>
<head>
  <!-- DeXOps Web Javascript SDK-->
  <script defer src="https://ads-static.v2.dexops.co.kr/js/dexops_agent_ads.js" data-campaign="광고 서버 URL"></script>
</head>
<body>
  <!-- 모바일 웹과 Hybrid웹을 동일한 페이지에서 사용 하는 경우 분기 처리 필요 -->
  <!-- 하이브리드 웹뷰 페이지인 경우 -->
  <div id="ads">
  </div>
  <script>
    document.addEventListener('DOMContentLoaded', function () {
      if (DeXOpsSDKInterface.availableSDKInterface()) {
        const marginInfo = { top: 0, bottom: 0, left: 0, right: 0 };
        
        DeXOpsSDKInterface.bannerView(document.getElementById('ads'), channel, section, slot, marginInfo)
        .then( function (result) {
            console.log(result);
        }).catch( function (err) {
            console.log(err);
        });
      }
    });
  </script>
</body>
</html>

PreviousANDROID Next주요 함수

Last updated 1 year ago

hashtagSDK 적용

hashtagDownload Link

hashtagGradle 설정

hashtag프로가드 예외 설정

hashtagAndroidManifest.xml 권한 설정

hashtagSDK 초기화

hashtagSample Code

hashtag광고 요청

hashtagHybrid App 광고 요청

hashtagJavascript Interface 설정

hashtagSample Code

hashtagWeb 광고 요청

hashtagCustom Element 가이드

hashtagJavascript 가이드

SDK 적용

Download Link

Gradle 설정

프로가드 예외 설정

AndroidManifest.xml 권한 설정

SDK 초기화

Sample Code

광고 요청

Hybrid App 광고 요청

Javascript Interface 설정

Sample Code

Web 광고 요청

Custom Element 가이드

Javascript 가이드