Android

Hive SDK Android에서 마케팅 어트리뷰션 기능을 사용하기 위한 설정을 안내합니다.

마케팅 어트리뷰션 추가¶

모듈 수준 build.gradle 파일에 Hive SDK 마케팅 어트리뷰션을 사용하기 위한 외부 라이브러리를 추가합니다. 사용할 어트리뷰션만 추가합니다. build.gradle 예시 코드는 아래와 같습니다.

dependencies {
   // Analytics Provider, 사용하는 Provider 만 추가합니다.
   implementation "com.com2us.android.hive:hive-analytics-provider-adjust"
   implementation "com.com2us.android.hive:hive-analytics-provider-appsflyer"
   implementation "com.com2us.android.hive:hive-analytics-provider-firebase"
   implementation "com.com2us.android.hive:hive-analytics-provider-singular"
   implementation "com.com2us.android.hive:hive-analytics-provider-airbridge"
}

마케팅 어트리뷰션별 추가 설정¶

마케팅 어트리뷰션 종류에 따른 추가 설정이 필요합니다.

Airbridge 추가 설정¶

프로젝트 수준 build.gradle 파일을 아래와 같이 설정합니다.

allprojects {
    repositories {
        ...
        // Airbridge
        maven { url 'https://sdk-download.airbridge.io/maven' }
        ...
    }
}

Singular 추가 설정¶

프로젝트 수준 build.gradle 파일을 아래와 같이 설정합니다.

allprojects {
    repositories {
        ...
        // Singular
        maven { url 'https://maven.singular.net/' }
        ...
    }
}

Firebase 필수 파일 추가¶

Firebase 콘솔에 앱을 등록한 후 google-services.json 파일을 다운받습니다. 파일 내용에 따라 Firebase Analytics가 초기화 됩니다. 해당 파일을 다운로드하여 Android Studio 프로젝트에 포함하세요.

그리고, 프로젝트 수준 Gradle 파일인 build.gradle에 아래의 코드를 추가하세요.

buildscript {
   dependencies {
       ...
       classpath 'com.google.gms:google-services:4.3.14'
   }
}

모듈 수준의 build.gradle 파일에 Firebase Analytics 의존성을 추가합니다.

dependencies {
   implementation "com.com2us.android.hive:hive-analytics-provider-firebase"
}

// build.gradle 최 하단에 다음 코드를 추가해주세요.
apply plugin: 'com.google.gms.google-services'

AppsFlyer, Airbridge 함께 사용시 Android Manifest 충돌 해결¶

AppsFlyer, Airbridge를 함께 사용할 경우 android:fullBackupContent 관련하여 자동 백업 규칙 에러가 발생한다면 아래의 방법으로 충돌을 해결하세요.

먼저 res/xml 폴더에 game_custom_backup_rules.xml 파일을 만들고 아래의 코드를 추가하세요. 파일명은 임의로 변경 가능합니다.

<?xml version="1.0" encoding="utf-8"?>
<full-backup-content>
    <exclude domain="sharedpref" path="appsflyer-data"/>
    <exclude domain="sharedpref" path="airbridge-internal" />
    <exclude domain="sharedpref" path="airbridge-install" />
    <exclude domain="sharedpref" path="airbridge-user-info" />
    <exclude domain="sharedpref" path="airbridge-user-alias" />
    <exclude domain="sharedpref" path="airbridge-user-attributes" />
    <exclude domain="sharedpref" path="airbridge-device-alias" />
    <exclude domain="database" path="airbridge.db" />
</full-backup-content>

이후, AndroidManifest.xml파일에 아래의 코드를 추가하세요.

<application
   android:fullBackupContent="@xml/game_custom_backup_rules"
   tools:replace="android:fullBackupContent"

어떠한 경우에도 자동 백업되는 것을 원하지 않을 경우 아래의 코드와 같이 android:fullBackupContent="false" 로 설정하세요.

<application
   android:fullBackupContent="false"
   tools:replace="android:fullBackupContent"