이 섹션의 문서

디파이너리(애드브릭스) Android 연동하기 [Unity]

Avatar
DFINERY
  • 업데이트 시간
팔로우

 

V2 에서의 변경점

2022년 9월 29일 Unity SDK V2 버전이 출시되었습니다. V2 버전이 출시됨에 따라 아래의 기존 "AdBrixRemasterUnityPlugin-a1.1.2110-i1.6.5102" Unity 패키지를 사용하시는 분은 아래 내용을 참고하여 Unity 패키지를 업데이트 해주시길 부탁드립니다.

  1. 라이브러리 변경
    • Android / iOS 네이티브 라이브러리가 변경되었습니다. 기존에 사용하셨던 아래 라이브러리는 삭제를 부탁드립니다.
      • Android
        • abx-common-rm-release-v1.1.2110.aar
        • abx-unity.aar
        • installreferrer-1.0.aar
      • iOS
        • AdBrixRM.framework
    • 이외 SDK 업데이트 시 기존 파일과 동일한 이름의 파일은 모두 신규 버전으로 업데이트를 부탁드립니다.
  2. SDK init 변경
    • SDK init 연동 방식이 Android / iOS 별 네이티브 상에서 연동하는 것으로 변경되었습니다. 그러므로 아래의 API 는 삭제를 부탁드립니다.
      • Android : AdBrixRm.InitPlugin(); 
      • iOS : AdBrixRm.initAdBrix("your_app_key", "your_secret_key");
  3. SDK LogLevel API 삭제
  4. 딥링크 / 디퍼드 딥링크 연동 방식이 변경됨에 따라 setAdBrixDeeplinkDelegate / setAdBrixDeferredDeeplinkDelegate API 가 삭제되었습니다.
  5. 딥링크 / 디퍼드 딥링크 연동방식이 변경됨에 따라 didReceiveDeeplink / didReceiveDeferredDeeplink API 가 삭제되었습니다.
  6. SetCallbackHandler API 가 삭제되었습니다.
  7. 커스텀 이벤트 명이 변경되었습니다. ("events" -> "eventWithName" or "eventWithEventNameAndValue")
  8. 사용자의 나이를 설정하는 API 명이 변경되었습니다. ("setAgeInt" -> "setAge")
  9. 사용자의 성별을 설정하는 API 명이 변경되었습니다. ("setGenderWithAdBrixGenderType" -> "setGender")
  10. 사용자의 정보를 설정하는 API 명이 변경되었습니다. ("setUserPropertiesWithDictionary" -> "saveUserProperties")
  11. 이벤트 추가 정보 설정시 기존 Dictionary <string, object> 에서 Dictionary<string,string> 로 통일되었습니다.

 

Quick Start

 

Unity 지원 버전

 

디파이너리(애드브릭스) Unity SDK 는 Untiy 2021 LTS 버전에서 최적화 되었습니다. 해당 버전 사용을 권장합니다.

 

SDK 다운로드

 

디파이너리(애드브릭스) Unity 통합 패키지 : [다운로드(update : 2022/09/28]

 

Unity 패키지 설치

1. 기존 유니티 프로젝트를 오픈합니다.

___________2018-08-08______12.07.06.png

   [기존 유니티 프로젝트 오픈]

 

2. 기존 유니티 프로젝트의 Assets 창으로 ~~.package 파일을 드래그&드롭합니다.

___________2018-08-08______12.09.53.png

[AdBrix SDK package 파일 Drag & Drop]

 

3. iOS와 동시에 개발하는 프로젝트가 아니라면 Android 디렉토리만 선택(iOS 디렉토리는 체크 박스를 해제)하여 Import 합니다.

_____2022-09-28____4.46.46.png

 

디파이너리(애드브릭스) SDK Scripts 설정

Unity 로 구현될 앱이 iOS / Android 모두 사용될 앱이라면 아래와 같이 스크립트 추가하여 각각의 OS 에 대응하도록 합니다.

using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using System.Runtime.InteropServices;
using System;

#if UNITY_IOS
using UnityEngine.iOS;
using AdBrixRmIOS;

#elif UNITY_ANDROID
using AdBrixRmAOS;

#endif
public class AdBrixSDKController : MonoBehaviour {

}

[[인용:위험:작게]] ※ 주의 : 아래부터는 안드로이드만 사용했을 경우를 가정하여 작성되었습니다.

 

Script 생성 후 해당 스크립트를 호출할 Component 에 이를 등록합니다.

_____2022-09-27____3.34.55.png

 

디파이너리(애드브릭스) SDK init 설정

 

[[인용:위험:작게]] ※ 아래의 내용은 Android Studio 로 프로젝트를 Export 후 진행하셔야 합니다.

 

1. SDK 자체 Application 클래스를 사용할 경우

디파이너리(애드브릭스) Unty SDK 에서 제공하는 자체 Application 클래스 (com.igaworks.v2.unity.BaseApplication) 을 사용할 경우 아래와 같이 [AndroidManifest.xml > application] 항목에 해당 클래스를 추가합니다.

   <application
    android:name="com.igaworks.v2.unity.BaseApplication"
    android:usesCleartextTraffic="true"
    android:label="@string/app_name"
    android:icon="@drawable/app_icon">

 

2. 자체 Application 클래스를 사용할 경우

앱 내에서 자체적으로 사용하는 Application 클래스를 사용할 경우 아래와 같이 AbxUnityApplication 클래스를 상속받아 사용합니다.

package com.igaworks.v2.unity;

public class MyApplication extends AbxUnityApplication{

    @Override
    public void registerListener() {

    }
}

 

이후 해당 클래스를 AndroidManfiest.xml 에 추가합니다.

   <application
    android:name="com.your.packagename.MyApplication"
    android:usesCleartextTraffic="true"
    android:label="@string/app_name"
    android:icon="@drawable/app_icon">

 

 

안드로이드 권한 설정

디파이너리(애드브릭스) SDK 아래 권한을 사용합니다. 

[AndroidManifest.xml > manifest]에 아래 권한을 추가합니다.

<manifest>
...
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="com.google.android.gms.permission.AD_ID" />
...
</manifest>

 

Appkey / SecretKey 설정

디파이너리(애드브릭스) SDK 를 사용하기 위해서는 아래와 같이 Appkey 와 SecretKey 를 Androidmanifest.xml 에 명시해야 합니다.

<meta-data android:name="AdBrixRmAppKey"
  android:value="inputYourAppKey"/>
<meta-data android:name="AdBrixRmSecretKey"
  android:value="inputYourSecretKey"/>

 

Android 진입점 액티비티 구성

디파이너리(애드브릭스)에서는 기본 UnityPlayerActivity 를 대체하는 맞춤 진입점 액티비티를 제공합니다. 그러므로 SDK 연동시 기존 UnityPlayerAcitvity 를 아래와 같이"com.igaworks.v2.unity.AbxUnityActivity" 로 변경하여 사용해 주시길 부탁드립니다.

<activity android:name="com.igaworks.v2.unity.AbxUnityActivity" 
    android:label="@string/app_name"
    android:launchMode="singleTask"
    android:screenOrientation="fullUser"
    android:exported="true"
    android:configChanges="fontScale|keyboard|keyboardHidden|locale|mnc|mcc|navigation|orientation|screenLayout|screenSize|smallestScreenSize|uiMode|touchscreen">
  <intent-filter android:label="@string/app_name">
    <action android:name="android.intent.action.MAIN" />
    <category android:name="android.intent.category.LAUNCHER" />
  </intent-filter>
  <meta-data android:name="unityplayer.UnityActivity" android:value="true" />
</activity>

 

build.gradle 수정

SDK 연동에 사용할 필수 라이브러리 추가를 위해 unityLibrary 내 build.gradle 파일에서 dependencies 부분에 아래 라이브러리를 추가합니다.

dependencies {
    implementation 'androidx.core:core:1.0.0'
    implementation 'com.google.android.gms:play-services-ads-identifier:18.0.1'
    implementation 'com.android.installreferrer:installreferrer:2.2'
}

 

gradle.properties 수정

Android 프로젝트 내 gradle.properties 에 다음 사항을 추가합니다.

android.useAndroidX=true
android.enableJetifier=true

 

 

  

SDK 추가 설정

 

이벤트 업로드 주기 설정

디파이너리(애드브릭스) SDK 에 전달된 이벤트를 AdBrix 서버로 업로드하는 기준을 설정할 수 있습니다.

이벤트 업로드 주기는 누적 이벤트 개수와 시간으로 설정할 수 있습니다.

* 두 가지 기준 중 먼저 충족되는 기준에 따라 이벤트가 업로드 됩니다.

 

누적 이벤트 개수 기준

설정된 개수만큼 이벤트가 누적되었을 때에 디파이너리(애드브릭스) 서버로 이벤트를 업로드하도록 설정합니다.

디파이너리(애드브릭스) SDK에 사전 정의된 아래의 값을 이용하여 설정합니다.

  • AdBrixRm.AdBrixEventUploadCountInterval.MIN : 10건
  • AdBrixRm.AdBrixEventUploadCountInterval.NORMAL : 30건
  • AdBrixRm.AdBrixEventUploadCountInterval.MAX : 60건
using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using System.Runtime.InteropServices;
using System;
using AdBrixRmAOS;

public class AdBrixSDKController: MonoBehaviour {

     void Start () {     
           AdBrixRm.setEventUploadCountInterval(AdBrixRm.AdBrixEventUploadCountInterval.NORMAL);           
     }
}

 

시간 기준

설정된 시간이 지나면 디파이너리(애드브릭스) 서버로 이벤트를 업로드하도록 설정합니다.

디파이너리(애드브릭스) SDK에 사전 정의된 아래의 값을 이용하여 설정합니다.

  • AdBrixRm.AdBrixEventUploadTimeInteval.MIN : 30초
  • AdBrixRm.AdBrixEventUploadTimeInteval.NORMAL :60초
  • AdBrixRm.AdBrixEventUploadTimeInteval.MAX :120초
using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using System.Runtime.InteropServices;
using System;
using AdBrixRmAOS;

public class AdBrixSDKController: MonoBehaviour {

     void Start () {     
           AdBrixRm.setEventUploadTimeInterval(AdBrixRm.AdBrixEventUploadTimeInterval.NORMAL);           
     }
}

   

GDPR 설정

GDPR 요청 이벤트를 이용하여 사용자 요청에 대해 데이터 주체와 연관된 모든 개인 데이터를 삭제할 수 있습니다.

본 이벤트 호출시, SDK 동작은 정지되며 모든 이벤트 저장, 전송 등이 불가합니다.

본 기능은 사용자가 앱을 삭제 후, 재설치하기 전에는 되돌릴 수 없습니다.

void gdprForgetMeEvent() {
   AdBrixRm.gdprForgetMe ();
}

 

 

 

 

딥링크 / 디퍼드 딥링크 설정

  

딥링크 설정

 

Unity 프로젝트에서 디파이너리(애드브릭스) SDK를 관리하는 스크립트에 아래와 같이 딥링크 핸들러를 추가합니다.

public class AdBrixSdkController: MonoBehaviour {
  
 public void HandleDidReceiveDeeplink (string deepLinkValue){
 
    Debug.Log("HandleDidReceiveDeeplink : "+ deepLinkValue);
 
 }
 
}

위 코드의 HandleDidReceiveDeeplink 의 deepLinkValue 값을 통해 아래와 같이 딥링크 정보가 전달 됩니다. 전달되는 딥링크 정보를 활용하여 원하시는 화면으로 이동시켜 주시면 되겠습니다.

[[인용:위험:작게]] ※ 예시 : 트래킹 링크에 adbrixrm://deeplinkpath 란 값을 딥링크 정보로 전달할 경우
예시 : HandleDidReceiveDeeplink : adbrixrm://deeplinkpath+추가 파라미터

 

Android Studio 로 프로젝트를 export 하여 AndroidManifest.xml의 진입점 액티비티에 아래와 같이 딥링크 스키마와 호스트를 추가 합니다.

<activity android:name="com.igaworks.v2.unity.AbxUnityActivity" 
    android:label="@string/app_name"
    android:launchMode="singleTask"
    android:screenOrientation="fullUser"
    android:exported="true"
    android:configChanges="fontScale|keyboard|keyboardHidden|locale|mnc|mcc|navigation|orientation|screenLayout|screenSize|smallestScreenSize|uiMode|touchscreen">
  <intent-filter android:label="@string/app_name">
    <action android:name="android.intent.action.MAIN" />
    <category android:name="android.intent.category.LAUNCHER" />
  </intent-filter>
  <intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="your_deeplink_scheme" android:host="your_deeplink_host" />
  </intent-filter>
  <meta-data android:name="unityplayer.UnityActivity" android:value="true" />
</activity>

 

설정하신 Application  클래스 내  아래와 같이 게임 내 Object 명과 리스너를 등록합니다.

public class BaseApplication extends AbxUnityApplication{
   
   public static String GAME_OBJECT_NAME = "AbxObject"; // Game Object 이름 등록

    @Override
    public void registerListener() {
        registerAllListeners();
        setGameObjectNameReceiveListener(new GameObjectNameReceiveListener() {
            @Override
            public void onReceive(String gameObjectName) {
                BaseApplication.GAME_OBJECT_NAME = gameObjectName;
                unregisterListenersForChangingGameObjectName();
                registerAllListeners();
            }
        });
    }
    public void registerAllListeners(){
        setDeeplinkListener(GAME_OBJECT_NAME, "HandleDidReceiveDeeplink");   // 딥링크 리스너 추가

    }
}

[[인용:위험:작게]] ※ GAME_OBJECT_NAME 은 Unity 내 딥링크 핸들러를 호출할 스크립트가 포함된 OBJECT 명과 일치해야 합니다.

 

 

디퍼드 딥링크 설정

디퍼드 딥링크는 트래킹 링크를 클릭하여 앱을 설치하고 실행했을 때 특정 화면으로 랜딩 시켜주는 기능입니다.

 

Unity 프로젝트에서 디파이너리(애드브릭스) SDK를 관리하는 스크립트에 아래와 같이 디퍼드딥링크 핸들러를 추가합니다.

public class AdBrixSdkController: MonoBehaviour {
  
 public void HandleDidReceiveDeferredDeeplink (string deferredDeeplinkValue){
 
    Debug.Log("HandleDidReceiveDeferredDeeplink : "+ deferredDeeplinkValue);
 
 }
 
}

디파이너리(애드브릭스) 서버에서 위 코드의 HandleDidReceiveDeferredDeeplink 의 deferredDeepLinkValue 값을 통해 아래와 같이 딥링크 정보가 전달 됩니다. 전달되는 딥링크 정보를 활용하여 원하시는 화면으로 이동시켜 주시면 되겠습니다.

[[인용:위험:작게]] ※ 예시 : 트래킹 링크에 adbrixrm://deeplinkpath 란 값을 디퍼드 딥링크 딥링크 정보로 전달할 경우
예시 : HandleDidReceiveDeferredDeeplink : adbrixrm://deeplinkpath

 

Android Studio로 export 후 Android 내 설정하신 Application 클래스에 디퍼드 딥링크 리스너를 추가합니다.

public class BaseApplication extends AbxUnityApplication{
   
   public static String GAME_OBJECT_NAME = "AbxObject"; // Game Object 이름 등록

    @Override
    public void registerListener() {
        registerAllListeners();
        setGameObjectNameReceiveListener(new GameObjectNameReceiveListener() {
            @Override
            public void onReceive(String gameObjectName) {
                BaseApplication.GAME_OBJECT_NAME = gameObjectName;
                unregisterListenersForChangingGameObjectName();
                registerAllListeners();
            }
        });
    }
    public void registerAllListeners(){
        setDeferredDeeplinkListener(GAME_OBJECT_NAME, "HandleDidReceiveDeferredDeeplink");   // 디퍼드 딥링크 리스너 추가

    }
}

[[인용:위험:작게]] ※ GAME_OBJECT_NAME 은 Unity 내 디퍼드 딥링크 핸들러를 호출할 스크립트가 포함된 OBJECT 명과 일치해야 합니다.

[[인용:위험:작게]] - HandleDidReceiveDeferredDeeplink 는 디퍼드 딥링크 정보가 없을 경우 호출하지 않습니다.
- 구글 플레이에서 다운로드 받은 앱은 구글 플레이에서도 디퍼드 딥링크 정보를 전달합니다. 디파이너리(애드브릭스) 서버와 구글 플레이에서 동시 디퍼드 딥링크 정보가 전달되는 만큼 중복으로 화면이 오픈되지 않도록 설정을 부탁드립니다.

  [[인용:위험:작게]] Facebook SDK의 fetchDeferredAppLinkData API 를 사용할 수 없습니다 .
Facebook 광고시 사용하는 fetchDeferredApplinkData 의 역할을 저희 DeferredDeeplink API 가 대신하므로 이를 중복해서 사용할 수 없습니다. 사용하고 계시다면 삭제를 부탁드립니다.

  

 

유저 분석

 

로그인/로그아웃 이벤트

사용자의 로그인/로그아웃 이벤트를 분석합니다.

로그인이 성공하였을 때, 유저를 구분하는 식별 값(user id)을 다음과 같이 전달합니다.

로그아웃이 성공하였을 때, @"" 와 같이 빈 문자열을 전달하여 유저 로그인 데이터를 초기화합니다.

 [[인용:경고:보통]] 로그인 유의 사항
user id에 개인정보가 포함되지 않도록 주의해주세요. 만약 user id에 이메일, 전화번호 등의 개인정보가 포함되는 경우에는 암호화처리를 하시는 것을 권장합니다.

void sampleFunction() {

    if(isLoginSuccess) {
        // 로그인이 성공했을 떄, "user_1234"와 같은 유저아이디를 전달
        AdBrixRm.login ("user_1234");
    } else {
        // 로그아웃이 성공했을 때, ""의 빈 문자열을 전달
        AdBrixRm.login ("");
    }
}

 

유저 정보

유저의 나이, 성별, 기타 정보에 대해 분석할 수 있습니다.

void sampleFunction() {

    //유저 나이
    AdBrixRm.setAge (20);
    
    //유저 성별
    AdBrixRm.setGender(AdBrixRm.Gender.FEMALE);
    
    //기타 유저 정보
    Dictionary<string, string> dict = new Dictionary<string, string>();
    dict.Add("key1", "value1");
    AdBrixRm.saveUserProperties (dict);
}

[[인용:위험:보통]] Dictionary 데이터 설정 시 유의 사항
1.100 개 이상의 정보는 처리되지 않습니다.
2. Key 값의 데이터 타입은 string 이며 256자를 넘을 수 없고, 영문 소문자, 숫자를 제외한 나머지 문자는 사용할 수 없습니다.
3. Value 값의 데이터 길이는 byte 기준으로 1024byte를 넘을 수 없습니다. 

 

 

공통(일반)이벤트 분석

앱에서 발생하는 이벤트 중, 공통적으로 발생하는 이벤트를 분석합니다.

디파이너리(애드브릭스) 에서 제공하는 공통 이벤트 종류는 다음과 같습니다.

  • 회원가입
  • 앱 업데이트
  • 사용자 초대
  • 크레딧 사용
  • 결제하기

* 디파이너리(애드브릭스)에서 광고채널 별 매출을 보고자 할 때에는 '결제하기' 연동을 반드시 진행해야 합니다.

 

회원가입

앱에서 발생한 회원가입 이벤트를 분석합니다.

void userSignup() {

  // 유저 정보를 Adbrix 로 전달할 경우 설정합니다.
  Dictionary<string, string> dict = new Dictionary<string, string>();
  dict.Add("key1", "value1");

  AdBrixRm.commonSignUp(AdBrixRm.SignUpChannel.Google, dict);
}

   

앱 업데이트

앱에서 발생한 앱 업데이트 이벤트를 분석합니다.

void appUpdate() {

    // 유저 정보
    Dictionary<string, string> dict = new Dictionary<string, string>();
    dict.Add("key1", "value1");
    
    AdBrixRm.commonAppUpdate("1.2.2a","1.3.0",dict);
}

   

사용자 초대

앱에서 발생한 앱 초대 이벤트를 분석합니다.

void userInvite() {

    // 유저 정보
    Dictionary<string, string> dict = new Dictionary<string, string>();
    dict.Add("key1", "value1");
    
    AdBrixRm.commonInvite(AdBrixRm.InviteChannel.Facebook, dict);
}

 

크레딧 사용

앱내 현금성 화폐 사용에 대한 이벤트를 분석합니다.

void useCredit() {

    // 크레딧 사용 정보
    Dictionary<string, string> credit_info= new Dictionary<string, string>();
    credit_info.Add("credit", "20000");
    
    AdBrixRm.commonUseCredit(credit_info);
}

  

결제하기

앱에서 발생한 결제(구매) 이벤트를 분석합니다.

다음과 같은 상품 맟 주문에 대한 정보를 array 형태로 구성하여 전달합니다.

  • order id : (필수) 주문 번호
  • product id : (필수) 상품 번호
  • product name : (필수) 상품 이름
  • price : (필수) 상품 단가
  • quantity : (필수) 구매 수량
  • discount : (옵션) 할인 금액
  • currency string : (옵션) 구매 화폐 단위
  • category : (옵션) 카테고리 정보
  • product attr map : (옵션) 상품 상세 옵션
  • delivery charge : (옵션) 배송비
  • payment method : (옵션) 결제 방법
void sampleFunction() {

    //상품을 담을 배열
    List<AdBrixRm.AdBrixRmCommerceProductModel> items = new List <AdBrixRm.AdBrixRmCommerceProductModel>();
    
    //상품 상세 옵션 Dictionary
    Dictionary<string, string>productAttrs = new Dictionary<string, string>();
    productAttrs.Add ("Att1", "Value1");
    productAttrs.Add ("Att2", "Value2");
    productAttrs.Add ("Att3", "Value3");
    
    //상품 생성
    AdBrixRm.AdBrixRmCommerceProductModel productModel = AdBrixRm.AdBrixRmCommerceProductModel.create (
                "productId01",
                "productName01",
                10000.00,
                1,
                5000.00,
                AdBrixRm.Currency.KR_KRW,
                AdBrixRm.AdBrixRmCommerceProductCategoryModel.create ("Cate1", "Cate2", "Cate3"),
                AdBrixRm.AdBrixRmCommerceProductAttrModel.create (productAttrs)
            );
    
    //상품 생성
    AdBrixRm.AdBrixRmCommerceProductModel productModel2 = AdBrixRm.AdBrixRmCommerceProductModel.create (
                "productId02",
                "productName02",
                10000.00,
                1,
                5000.00,
                AdBrixRm.Currency.KR_KRW,
                AdBrixRm.AdBrixRmCommerceProductCategoryModel.create ("Cate1", "Cate2", "Cate3"),
                AdBrixRm.AdBrixRmCommerceProductAttrModel.create (productAttrs)
    );

    items.Add (productModel);
    items.Add (productModel2);
    
    //상품 결제하기 이벤트
    AdBrixRm.commonPurchase ("30290121", items, 1000.00, 3500.00, AdBrixRm.PaymentMethod.CreditCard);

}

 

 

 

 

커스텀 분석

앱 내 사용자의 일반적인 모든 이벤트를 분석합니다. (구매 이벤트 제외)

앱 내에서 이벤트(string)를 통해 액션을 자유롭게 분석할 수 있습니다.

void sampleFunction() {

  //Custom event with just Event Name
  
  AdBrixRm.eventWithName ("your_event_name");
  
  // Custom event with Event Name + event properties
  
  Dictionary<string, string> eventDic = new Dictionary<string, string>();
  eventDic.Add("event_parameter1", "value1");
  eventDic.Add("event_parameter2", "value2");
  
  AdBrixRm.eventWithEventNameAndValue("your_event_name" , eventDic);

}

 

 

 

커머스 분석

앱에서 발생하는 구매 관련(상품상세보기, 장바구니 담기 등) 이벤트를 분석합니다.

디파이너리(애드브릭스)에서 제공하는 커머스 이벤트 종류는 다음과 같습니다.

  • 홈(메인) 화면 진입
  • 카테고리(기획전) 진입
  • 상품 상세 보기
  • 장바구니 담기
  • 위시리스트(관심 상품) 추가
  • 주문 확인하기
  • 주문 취소하기
  • 상품 검색하기
  • 상품 목록 조회하기
  • 상품 공유하기
  • 장바구니 조회하기
  • 구매 정보 입력하기

 

홈(메인) 화면 진입

사용자가 앱의 홈(메인) 화면으로 진입한 이벤트를 분석합니다.

void sampleFunction() {
  AdBrixRm.commerceViewHome ();
}

 

카테고리(기획전) 진입

사용자가 카테고리(기획전) 화면으로 진입한 이벤트를 분석합니다.

카테고리 정보는 최대 5단계까지 분석할 수 있습니다.

void sampleFunction() {

    //상품을 담을 배열
    List<AdBrixRm.AdBrixRmCommerceProductModel> items = new List <AdBrixRm.AdBrixRmCommerceProductModel>();
    
    //상품 상세 옵션 Dictionary
    Dictionary<string, string>productAttrs = new Dictionary<string, string>();
    productAttrs.Add ("Att1", "Value1");
    productAttrs.Add ("Att2", "Value2");
    productAttrs.Add ("Att3", "Value3");
    
    //카테고리에 포함된 상품 생성
    AdBrixRm.CommerceProductModel productModel =
    AdBrixRm.AdBrixRmCommerceProductModel.create (
                "productId01",
                "productName01",
                10000.00,
                1,
                5000.00,
                AdBrixRm.Currency.KR_KRW,
                AdBrixRm.AdBrixRmCommerceProductCategoryModel.create ("하의기획전"),
                AdBrixRm.AdBrixRmCommerceProductAttrModel.create (productAttrs)
    );

    items.Add (productModel);
    
    //카테고리 진입 이벤트
    AdBrixRm.commerceCategoryView (AdBrixRm.AdBrixRmCommerceProductCategoryModel.create("기획전"), items);

}

 

상품 상세 보기

사용자의 상품을 상세하기 본 이벤트를 분석합니다.

다음과 같은 상품에 대한 정보를 전달합니다.

  • product id : (필수) 상품 번호
  • product name : (필수) 상품 이름
  • price : (필수) 상품 단가
  • quantity : (필수) 구매 수량
  • discount : (옵션) 할인 금액
  • currency string : (옵션) 카테고리 정보
  • category : (옵션) 구매 화폐 단위
  • product attr map : (옵션) 상품 상세 옵션
void sampleFunction() {

    //상품 상세 옵션 Dictionary 생성
    Dictionary<string, string> productAttrs = new Dictionary<string, string>();
    productAttrs.Add ("Att1", "Value1");
    productAttrs.Add ("Att2", "Value2");
    productAttrs.Add ("Att3", "Value3");
    
    //상품 생성
    AdBrixRm.AdBrixRmCommerceProductModel productModel = AdBrixRm.AdBrixRmCommerceProductModel.create (
                "productId01",
                "productName01",
                10000.00,
                1,
                5000,
                AdBrixRm.Currency.KR_KRW,
                AdBrixRm.AdBrixRmCommerceProductCategoryModel.create ("Cate1", "Cate2", "Cate3"),
                AdBrixRm.AdBrixRmCommerceProductAttrModel.create (productAttrs)
    );
    //상품 상세보기
    AdBrixRm.commerceProductView (productModel);

}

 

장바구니 담기

사용자가 상품을 장바구니에 담은 이벤트를 분석합니다.

다음과 같은 상품 정보를 전달합니다.

  • product id : (필수) 상품 번호
  • product name : (필수) 상품 이름
  • price : (필수) 상품 단가
  • quantity : (필수) 구매 수량
  • discount : (옵션) 할인 금액
  • currency string : (옵션) 카테고리 정보
  • category : (옵션) 구매 화폐 단위
  • product attr map : (옵션) 상품 상세 옵션
void sampleFunction() {

    //상품을 담을 배열
    List<AdBrixRm.AdBrixRmCommerceProductModel> items = new List <AdBrixRm.AdBrixRmCommerceProductModel>();
    
    //상품 상세 옵션 Dictionary 생성
    Dictionary<string, string>productAttrs = new Dictionary<string, string>();
    productAttrs.Add ("Att1", "Value1");
    productAttrs.Add ("Att2", "Value2");
    productAttrs.Add ("Att3", "Value3");
    
    //상품 생성
    AdBrixRmCommerceProductModel productModel =
    AdBrixRmCommerceProductModel.create (
                "productId01",
                "productName01",
                10000.00,
                1,
                5000.00,
                AdBrixRm.Currency.KR_KRW,
                AdBrixRm.AdBrixRmCommerceProductCategoryModel.create ("Cate1", "Cate2", "Cate3"),
                AdBrixRm.AdBrixRmCommerceProductAttrModel.create (productAttrs)
    );

    items.Add (productModel);
    
    //장바구니 이벤트
    AdBrixRm.commerceAddToCart(items);

}

 

관심 상품(위시리스트) 추가

사용자가 상품을 관심 상품(위시리스트)에 추가한 이벤트를 분석합니다.

다음과 같은 상품 정보를 전달합니다.

  • product id : (필수) 상품 번호
  • product name : (필수) 상품 이름
  • price : (필수) 상품 단가
  • quantity : (필수) 구매 수량
  • discount : (옵션) 할인 금액
  • currency string : (옵션) 카테고리 정보
  • category : (옵션) 구매 화폐 단위
  • product attr map : (옵션) 상품 상세 옵션
void sampleFunction() {

    //상품 상세 옵션 Dictionary 생성
    Dictionary<string, string>productAttrs = new Dictionary<string, string>();
    productAttrs.Add ("Att1", "Value1");
    productAttrs.Add ("Att2", "Value2");
    productAttrs.Add ("Att3", "Value3");
    
    //상품 생성
    AdBrixRm.AdBrixRmCommerceProductModel productModel =
    AdBrixRm.AdBrixRmCommerceProductModel.create (
                "productId01",
                "productName01",
                10000.00,
                1,
                5000.00,
                AdBrixRm.Currency.KR_KRW,
                AdBrixRm.AdBrixRmCommerceProductCategoryModel.create ("Cate1", "Cate2", "Cate3"),
                AdBrixRm.AdBrixRmCommerceProductAttrModel.create (productAttrs)
    );
    
    
    //관심 상품 이벤트
    AdBrixRm.commerceAddToWishList (productModel);

}

 

주문 확인하기

사용자가 상품을 결제하기 전 최종 확인하는 이벤트를 분석합니다.

다음과 같은 주문 및 상품 정보를 전달합니다.

  • order id : (필수) 주문 번호
  • product id : (필수) 상품 번호
  • product name : (필수) 상품 이름
  • price : (필수) 상품 단가
  • quantity : (필수) 구매 수량
  • discount : (옵션) 할인 금액
  • currency string : (옵션) 카테고리 정보
  • category : (옵션) 구매 화폐 단위
  • product attr map : (옵션) 상품 상세 옵션
  • delivery charge : (옵션) 배송비
void sampleFunction() {

    //상품을 담을 배열
    List<AdBrixRm.AdBrixRmCommerceProductModel>items = new List <AdBrixRm.AdBrixRmCommerceProductModel>();
    
    //상품 상세 옵션 Dictionary 생성
    Dictionary<string, string>productAttrs = new Dictionary<string, string>();
    productAttrs.Add ("Att1", "Value1");
    productAttrs.Add ("Att2", "Value2");
    productAttrs.Add ("Att3", "Value3");
    
    //상품 생성
    AdBrixRm.AdBrixRmCommerceProductModel productModel =
    AdBrixRm.AdBrixRmCommerceProductModel.create (
                "productId01",
                "productName01",
                10000.00,
                1,
                5000.00,
                AdBrixRm.Currency.KR_KRW,
                AdBrixRm.AdBrixRmCommerceProductCategoryModel.create ("Cate1", "Cate2", "Cate3"),
                AdBrixRm.AdBrixRmCommerceProductAttrModel.create (productAttrs)
    );

    items.Add (productModel);
    
    //주문확인 이벤트
    AdBrixRm.commerceReviewOrder ("30290121", items, 1000.00, 3500.00);

}

 

주문 취소하기 (환불하기)

사용자가 주문을 취소하거나 환불 처리한 이벤트를 분석합니다.

다음과 같은 상품 및 주문 정보를 전달합니다.

  • order id : (필수) 주문 번호
  • product id : (필수) 상품 번호
  • product name : (필수) 상품 이름
  • price : (필수) 상품 단가
  • quantity : (필수) 구매 수량
  • discount : (옵션) 할인 금액
  • currency string : (옵션) 카테고리 정보
  • category : (옵션) 구매 화폐 단위
  • product attr map : (옵션) 상품 상세 옵션
  • penalty charge : (옵션) 취소(환불) 수수료
void sampleFunction() {

    //상품을 담을 배열
    List<AdBrixRm.AdBrixRmCommerceProductModel> items = new List <AdBrixRm.AdBrixRmCommerceProductModel>();
    
    //상품 상세 옵션 Dictionary 생성
    Dictionary<string, string>productAttrs = new Dictionary<string, string>();
    productAttrs.Add ("Att1", "Value1");
    productAttrs.Add ("Att2", "Value2");
    productAttrs.Add ("Att3", "Value3");
    
    //상품 생성
    AdBrixRm.AdBrixRmCommerceProductModel productModel =
    AdBrixRm.AdBrixRmCommerceProductModel.create (
                "productId01",
                "productName01",
                10000.00,
                1,
                5000.00,
                AdBrixRm.Currency.KR_KRW,
                AdBrixRm.AdBrixRmCommerceProductCategoryModel.create ("Cate1", "Cate2", "Cate3"),
                AdBrixRm.AdBrixRmCommerceProductAttrModel.create (productAttrs)
    );

    items.Add (productModel);
    
    //주문 취소 이벤트
    AdBrixRm.commerceRefund ("30290121", items, 3500.00);

}

 

상품 검색하기

사용자가 상품을 검색한 이벤트를 분석합니다.

다음과 같은 검색 결과에 포함된 상품 정보를 전달합니다.

  • keyword : (필수) 검색에 사용한 단어
  • product id : (필수) 상품 번호
  • product name : (필수) 상품 이름
  • price : (필수) 상품 단가
  • quantity : (필수) 구매 수량
  • discount : (옵션) 할인 금액
  • currency string : (옵션) 카테고리 정보
  • category : (옵션) 구매 화폐 단위
void sampleFunction() {

    //상품을 담을 배열
    List<AdBrixRm.AdBrixRmCommerceProductModel> items = new List <AdBrixRm.AdBrixRmCommerceProductModel>();
    
    //상품 상세 옵션 Dictionary 생성
    Dictionary<string, string>productAttrs = new Dictionary<string, string>();
    productAttrs.Add ("Att1", "Value1");
    productAttrs.Add ("Att2", "Value2");
    productAttrs.Add ("Att3", "Value3");
    
    //상품 생성
    AdBrixRm.AdBrixRmCommerceProductModel productModel =
    AdBrixRm.AdBrixRmCommerceProductModel.create (
                "productId01",
                "productName01",
                10000.00,
                1,
                5000.00,
                AdBrixRm.Currency.KR_KRW,
                AdBrixRm.AdBrixRmCommerceProductCategoryModel.create ("Cate1", "Cate2", "Cate3"),
                AdBrixRm.AdBrixRmCommerceProductAttrModel.create (productAttrs)
            );
    
            items.Add (productModel);
    
    //상품 검색 이벤트
    AdBrixRm.commerceSearch("나이키", items);

}

 

상품 공유하기

사용자가 상품 정보를 공유한 이벤트를 분석합니다.

다음과 같은 공유된 상품 정보를 전달합니다.

  • product id : (필수) 상품 번호
  • product name : (필수) 상품 이름
  • price : (필수) 상품 단가
  • quantity : (필수) 구매 수량
  • discount : (옵션) 할인 금액
  • currency string : (옵션) 카테고리 정보
  • category : (옵션) 구매 화폐 단위
  • product attr map : (옵션) 상품 상세 옵션
void sampleFunction() {

    //상품 상세 옵션 Dictionary 생성
    Dictionary<string, string>productAttrs = new Dictionary<string, string>();
    productAttrs.Add ("Att1", "Value1");
    productAttrs.Add ("Att2", "Value2");
    productAttrs.Add ("Att3", "Value3");
    
    //상품 생성
    AdBrixRm.AdBrixRmCommerceProductModel productModel =
    AdBrixRm.AdBrixRmCommerceProductModel.create (
                "productId01",
                "productName01",
                10000.00,
                1,
                5000.00,
                AdBrixRm.Currency.KR_KRW,
                AdBrixRm.AdBrixRmCommerceProductCategoryModel.create ("Cate1", "Cate2", "Cate3"),
                AdBrixRm.AdBrixRmCommerceProductAttrModel.create (productAttrs)
    );
    
    
    //상품 공유하기 이벤트
    AdBrixRm.commerceShare (AdBrixRm.SharingChannel.KAKAOTALK, productModel);

}

 

상품 목록 조회하기

사용자가 상품 목록을 조회한 이벤트를 분석합니다.

다음과 같이 조회한 상품 정보를 전달합니다.

  • product id : (필수) 상품 번호
  • product name : (필수) 상품 이름
  • price : (필수) 상품 단가
  • quantity : (필수) 구매 수량
  • discount : (옵션) 할인 금액
  • currency string : (옵션) 카테고리 정보
  • category : (옵션) 구매 화폐 단위
  • product attr map : (옵션) 상품 상세 옵션
void sampleFunction() {

    //상품을 담을 배열
    List<AdBrixRm.AdBrixRmCommerceProductModel> items = new List <AdBrixRm.AdBrixRmCommerceProductModel>();
    
    //상품 상세 옵션 Dictionary 생성
    Dictionary<string, string>productAttrs = new Dictionary<string, string>();
    productAttrs.Add ("Att1", "Value1");
    productAttrs.Add ("Att2", "Value2");
    productAttrs.Add ("Att3", "Value3");
    
    //상품 생성
    AdBrixRm.AdBrixRmCommerceProductModel productModel =
    AdBrixRm.AdBrixRmCommerceProductModel.create (
                "productId01",
                "productName01",
                10000.00,
                1,
                5000.00,
                AdBrixRm.Currency.KR_KRW,
                AdBrixRm.AdBrixRmCommerceProductCategoryModel.create ("Cate1", "Cate2", "Cate3"),
                AdBrixRm.AdBrixRmCommerceProductAttrModel.create (productAttrs)
    );

    items.Add (productModel);
    
    //상품 목록 조회 이벤트
    AdBrixRm.commerceListView (items);

}

 

장바구니 조회하기

사용자가 장바구니를 조회한 이벤트를 분석합니다.

다음과 같이 조회한 상품 정보를 전달합니다.

  • product id : (필수) 상품 번호
  • product name : (필수) 상품 이름
  • price : (필수) 상품 단가
  • quantity : (필수) 구매 수량
  • discount : (옵션) 할인 금액
  • currency string : (옵션) 카테고리 정보
  • category : (옵션) 구매 화폐 단위
  • product attr map : (옵션) 상품 상세 옵션
void sampleFunction() {

    //상품을 담을 배열
    List<AdBrixRm.AdBrixRmCommerceProductModel> items = new List <AdBrixRm.AdBrixRmCommerceProductModel>();
    
    //상품 상세 옵션 Dictionary 생성
    Dictionary<string, string>productAttrs = new Dictionary<string, string>();
    productAttrs.Add ("Att1", "Value1");
    productAttrs.Add ("Att2", "Value2");
    productAttrs.Add ("Att3", "Value3");
    
    //상품 생성
    AdBrixRm.AdBrixRmCommerceProductModel productModel =
    AdBrixRm.AdBrixRmCommerceProductModel.create (
                "productId01",
                "productName01",
                10000.00,
                1,
                5000.00,
                AdBrixRm.Currency.KR_KRW,
                AdBrixRm.AdBrixRmCommerceProductCategoryModel.create ("Cate1", "Cate2", "Cate3"),
                AdBrixRm.AdBrixRmCommerceProductAttrModel.create (productAttrs)
    );
    
    items.Add (productModel);

    //장바구니 조회하기 이벤트
    AdBrixRm.commerceCartView (items);

}

 

구매 정보 입력하기

사용자가 구매 정보를 입력한 이벤트를 분석합니다.

void sampleFunction() {

    //구매 정보 상세 옵션 Dictionary
    Dictionary<string, string> paymentAttrs = new Dictionary<string, string>();
    paymentAttrs.Add ("creditcard", "oocard");
    
    
    AdBrixRm.commercePaymentInfoAdded (paymentAttrs, 100);

}

 

 

게임 이벤트 분석

앱에서 발생하는 게임과 관련된 이벤트(튜토리얼, 스테이지 등)를 분석합니다.

디파이너리(애드브릭스)에서 제공하는 게임 이벤트 종류는 다음과 같습니다.

  • 튜토리얼 완료
  • 캐릭터 생성
  • 스테이지 완료
  • 레벨 달성

 

튜토리얼 완료

앱에서 발생한 튜토리얼 완료 이벤트를 분석합니다.

다음과 같은 튜토리얼 완료 정보를 구성하여 전달합니다.

  • (필수) 건너뛰기(skip)를 통한 완료인지 여부 
void sampleFunction() {

    AdBrixRm.gameTutorialCompleted (false);

}

 

캐릭터 생성

앱에서 발생한 캐릭터 생성 이벤트를 분석합니다.

void sampleFunction() {

    AdBrixRm.gameCharacterCreated();

}

 

스테이지 완료

앱에서 발생한 스테이지 완료 이벤트를 분석합니다.

다음과 같은 스테이지 완료 정보를 구성하여 전달합니다.

  • (필수) 완료한 스테이지 이름 
void sampleFunction() {

    AdBrixRm.gameStageCleared("1-1");

}

 

레벨 달성

앱에서 발생한 레벨 달성 이벤트를 분석합니다.

다음과 같은 레벨 달성 정보를 구성하여 전달합니다.

  • (필수) 달성한 레벨 (1~10000) 
void sampleFunction() {

    AdBrixRm.gameLevelAchieved (15);

}

관련 문서

클릭하여 고객지원팀에게 문의하기

답을 찾지 못하였나요? 걱정하지 마시고, 고객지원팀에게 문의주세요!

INDEX