시작하기

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

Was this helpful?