BuzzAd Unity Android์ฉ SDK ์ฐ๋ ๊ฐ์ด๋
๋ชฉ์ฐจ
๊ฐ์
์ด ์ฐ๋ ๊ฐ์ด๋๋ BuzzAd SDK(BuzzAd-Benefit
)๋ฅผ Unity Android ํ๋ก์ ํธ์ ์ฐ๋ํ๋ ๋ฐฉ๋ฒ์ ์๋ดํฉ๋๋ค.
BuzzAd Unity Android์ฉ SDK๋ ์คํผ์์ฒ๋ผ ๋ค์์ ๊ด๊ณ ๋ฅผ ๋ชฉ๋ก ํ์์ผ๋ก ์ ๊ณตํ๋ ํผ๋(Feed) ์ง๋ฉด๊ณผ ์ฌ์ฉ์๋ฅผ ์ฑ ์ธ๋ถ์์ ํผ๋ ์ง๋ฉด์ผ๋ก ์ ๋ํ๋ ํ(Pop) ์ง๋ฉด์ ์ ๊ณตํฉ๋๋ค. ๋ํ ๊ตญ๋ด ์ต๋ค ๊ด๊ณ ๋ฌผ๋์ ๊ณต๊ธํ๋ ๋ฒ์ฆ๋น์ ๋น๋ณด์ํ ๊ด๊ณ , ๋ฆฌ์๋ ๊ธฐ์ ์ ์ ์ฉํ ๋ณด์ํ ๊ด๊ณ ๋ฅผ ๊ฒ์ฌํ์ฌ Unity Android ์ฑ์ ์์ตํ๋ฅผ ํจ๊ณผ์ ์ผ๋ก ์ง์ํฉ๋๋ค.
๋ณ๋์ ์ปค์คํฐ๋ง์ด์ง์ด ํ์์๋ SDK ๊ธฐ๋ณธ UI๋ก ์ฐ๋์ด ๊ฐ๋ฅํ BuzzAd Unity Android์ฉ SDK๋ฅผ ํ์ฌํด ํ ๋จ๊ณ ์งํ๋ ์ฑ ์์ต ์ฐฝ์ถ์ ์์ํ์ธ์.
์์ํ๊ธฐ
SDK ์ค์น์ ์ด๊ธฐํ, ์ฌ์ฉ์ ์ ๋ณด ๋ฑ๋ก ๋ฑ ๋ฒ์ฆ๋น์ SDK๋ก ๊ด๊ณ ์ง๋ฉด์ ์ฐ๋ํ๊ธฐ ์ ์๋ฃํด์ผ ํ๋ ์ค์ ์ ๋ํด ์์๋ณด์ธ์.
์๊ตฌ ์ฌ์
Android 4.1 Jellybean (API ๋ ๋ฒจ 16) ์ด์
compileSdkVersion, targetSdkVersion 31 ์ด์
AndroidX
JDK 1.11
์ฐ๋์ฉ ID ๋ฐ๊ธ๋ฐ๊ธฐ
๋ฒ์ฆ๋น์ SDK๋ฅผ ์ฐ๋ํ๋ ค๋ฉด ๋ฐ๋์ ์ฐ๋ํ๋ ค๋ ์ฑ์ ๊ณ ์ ์๋ณ์(App ID)์ ๊ด๊ณ ์ง๋ฉด์ ๊ณ ์ ์๋ณ์(Unit ID)๊ฐ ํ์ํฉ๋๋ค. ๋ฒ์ฆ๋น BD ๋งค๋์ ๋๋ย help@buzzvil.com์ ํตํด ID๋ฅผ ๋ฐ๊ธ๋ฐ์ผ์ธ์.
App ID: ๋ฒ์ฆ๋น์ SDK๋ฅผ ์ฐ๋ํ๋ ์ฑ๋ณ๋ก ๋ถ์ฌํ๋ ๊ณ ์ ์๋ณ์์ ๋๋ค.
Unit ID: ๋ฒ์ฆ๋น์ SDK๋ฅผ ํตํด ์์ฑํ๋ ์ง๋ฉด๋ณ๋ก ๋ถ์ฌํ๋ ๊ณ ์ ์๋ณ์์ ๋๋ค.
Unity ํ๋ก์ ํธ ์์ SDK ์ค์นํ๊ธฐ
Unity์์ ์ํ๋ ํ๋ก์ ํธ์ BuzzAd SDK๋ฅผ ์ค์นํ์ธ์.
Android Target API ๋ ๋ฒจ ์ค์ ํ๊ธฐ
Unity ํ๋ก์ ํธ์์ ๋ค์์ ์ ์ฐจ๋ฅผ ๋ฐ๋ผ Android Target API ๋ ๋ฒจ์ ์ค์ ํ์ธ์.
โBuild Settingsโ ์ฐฝ์ Platform ์์ญ์์ Android๋ฅผ ์ ํํ์ธ์.
โBuild Settingsโ ์ฐฝ์ ํ๋จ์ ์๋ Player Settings๋ฅผ ํด๋ฆญํ์ธ์.
โProject Settingsโ ์ฐฝ์ Player ํ๋ฉด > Other Settings ํญ > Identification ์์ญ์ Target API Level์ API Level 31๋ก ์ค์ ํ์ธ์.
Android Gradle๋ก SDK ์ฐ๋ํ๊ธฐ
Unity ํ๋ก์ ํธ์์ ๋ค์์ ์ ์ฐจ๋ฅผ ๋ฐ๋ผ Android Gradle์ ์ฌ์ฉํ์ฌ SDK๋ฅผ ์ฐ๋ํ์ธ์.
1. Unity์ โBuild Settingsโ ์ฐฝ์ ํ๋จ์ ์๋ Player Settings๋ฅผ ํด๋ฆญํ์ธ์.
2. โProject Settingsโ ์ฐฝ์ Player ํ๋ฉด > Publisher Settings ํญ์์ ์๋์ ํ์ธ๋์ ์ ํํ์ธ์.
Custom Main Gradle Template
Custom Launcher Gradle Template
Custom Base Gradle Template
Gradle Properties Template
3. Unity ํ๋ก์ ํธ ์๋ํฐ์ Project ํญ์์ Assets > Plugins๋ฅผ ํด๋ฆญํ์ธ์.
4. Android ๋๋ ํ ๋ฆฌ์ ์๋์ ํ์ผ์ด ์์ฑ๋์๋์ง ํ์ธํ์ธ์.
baseProjectTemplate.gradle
mainTemplate.gradle
gradleTemplate.properties
5. baseProjectTemplate.gradle
ํ์ผ์ ๋ฒ์ฆ๋น์ maven ์ ์ฅ์๋ฅผ ์ค์ ํ์ธ์.
// baseProjectTemplate.gradle
allprojects {
buildscript {
repositories {**ARTIFACTORYREPOSITORY**
google()
jcenter()
}
dependencies {
// If you are changing the Android Gradle Plugin version, make sure it is compatible with the Gradle version preinstalled with Unity
// See which Gradle version is preinstalled with Unity here https://docs.unity3d.com/Manual/android-gradle-overview.html
// See official Gradle and Android Gradle Plugin compatibility table here https://developer.android.com/studio/releases/gradle-plugin#updating-gradle
// To specify a custom Gradle version in Unity, go do "Preferences > External Tools", uncheck "Gradle Installed with Unity (recommended)" and specify a path to a custom Gradle version
classpath 'com.android.tools.build:gradle:4.0.2'
**BUILD_SCRIPT_DEPS**
}
}
repositories {**ARTIFACTORYREPOSITORY**
google()
jcenter()
maven { // ๋ฒ์ฆ๋น ์ ์ฅ์
url "https://dl.buzzvil.com/public/maven"
}
flatDir {
dirs "${project(':unityLibrary').projectDir}/libs"
}
}
}
task clean(type: Delete) {
delete rootProject.buildDir
}
ย
6. mainTemplate.gradle
ํ์ผ์ BuzzAd SDK(buzzad-benefit
) ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ์ค์ ํ์ธ์.
// mainTemplate.gradle
apply plugin: 'com.android.library'
**APPLY_PLUGINS**
dependencies {
implementation ("com.buzzvil:buzzad-benefit:3.11.+") // ๋ฒ์ฆ๋น ๋ผ์ด๋ธ๋ฌ๋ฆฌ
implementation fileTree(dir: 'libs', include: ['*.jar'])
**DEPS**}
android {
compileSdkVersion **APIVERSION**
buildToolsVersion '**BUILDTOOLS**'
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
defaultConfig {
minSdkVersion **MINSDKVERSION**
targetSdkVersion **TARGETSDKVERSION**
ndk {
abiFilters **ABIFILTERS**
}
versionCode **VERSIONCODE**
versionName '**VERSIONNAME**'
consumerProguardFiles 'proguard-unity.txt'**USER_PROGUARD**
}
lintOptions {
abortOnError false
}
aaptOptions {
noCompress = **BUILTIN_NOCOMPRESS** + unityStreamingAssets.tokenize(', ')
ignoreAssetsPattern = "!.svn:!.git:!.ds_store:!*.scc:.*:!CVS:!thumbs.db:!picasa.ini:!*~"
}**PACKAGING_OPTIONS**
}**REPOSITORIES**
**IL_CPP_BUILD_SETUP**
**SOURCE_BUILD_SETUP**
**EXTERNAL_SOURCES**
ย
7. gradleTemplate.properties
ํ์ผ์ AndroidX ๋ง์ด๊ทธ๋ ์ด์
์ ์ํ ์ค์ ์ ์ถ๊ฐํ์ธ์.
org.gradle.jvmargs=-Xmx**JVM_HEAP_SIZE**M
org.gradle.parallel=true
android.enableR8=**MINIFY_WITH_R_EIGHT**
unityStreamingAssets=**STREAMING_ASSETS**
**ADDITIONAL_PROPERTIES**
android.useAndroidX=true // AndroidX ๋์
android.enableJetifier=true // AndroidX ๋์
SDK ์ด๊ธฐํํ๊ธฐ
BuzzAd Unity Android์ฉ SDK ์ค์นํ ํ C# ํ์ผ์ ์๋ ์ฝ๋๋ฅผ ์ถ๊ฐํ์ธ์. App ID, ์ฌ์ฉ์ ํ๋กํ ๋ฑ ํ์ํ ์ ๋ณด๋ฅผ ์ถ๊ฐํ๊ณ ์ด๊ธฐํ ๋ฉ์๋๋ฅผ ํธ์ถํด SDK๋ฅผ ์ด๊ธฐํํ ์ ์์ต๋๋ค.
์ฑ์ด ์์๋ ๋ ์ด๊ธฐํ ๋ฉ์๋๋ฅผ ํธ์ถํ๋ ๊ฒ์ ๊ถ์ฅํฉ๋๋ค.
SDK ์ด๊ธฐํ ๋ฉ์๋ ํธ์ถ ํ ๋ฑ๋กํด์ผ ํ๋ ID์ ์ฌ์ฉ์ ํ๋กํ ์ ๋ณด์ ๋ํด์๋ ์๋ ํ๋ฅผ ์ฐธ๊ณ ํ์ธ์.
ํ์/๊ถ์ฅ | ํญ๋ชฉ | ์ค๋ช |
---|---|---|
ํ์ |
| ๋ฒ์ฆ๋น์ SDK๋ฅผ ์ฐ๋ํ๋ ์ฑ๋ณ๋ก ๋ถ์ฌํ๋ ๊ณ ์ ์๋ณ์์ ๋๋ค. |
ํ์ |
| ์ฌ์ฉ์ ๊ณ ์ ์๋ณ์์ ๋๋ค. ์๋น์ค ๋์ค ๋ณํ์ง ์๋ ๊ณ ์ ๊ฐ์ ๋๋ค. ์ฑ์ ์ญ์ ํ ์ฌ์ค์นํ์ฌ ์ฌ์ฉ์์ ID ๊ฐ์ด ๋ณ๊ฒฝ๋๊ฑฐ๋ ๋ค๋ฅธ ์ฌ์ ๋ก ์ธํด ๊ณ ์ ID๋ฅผ ์ฌ์ฉํ์ง ๋ชปํ๋ ๊ฒฝ์ฐ ๋ฒ์ฆ๋น BD ๋งค๋์ ๋๋ย help@buzzvil.com์ ๋ฌธ์ํ์ธ์. |
๊ถ์ฅ |
| ์ฌ์ฉ์์ ์ฑ๋ณ์ ๋๋ค.
|
๊ถ์ฅ |
| ์ฌ์ฉ์์ ์ถ์์ฐ๋์ ๋๋ค. |
ย
ํผ๋ ์ง๋ฉด
ํผ๋๋ ๋ชฉ๋ก ํํ์ ๊ด๊ณ ์ง๋ฉด์ ๋๋ค. ์คํผ์์ฒ๋ผ ๋๋ ๊ด๊ณ ๊ฒ์ฌ๊ฐ ๊ฐ๋ฅํ๊ณ ๋ค์ดํฐ๋ธ ์ง๋ฉด์ฒ๋ผ ์ฑ UI์ ์ด์ธ๋ฆฌ๋ ๋์์ธ์ ๊ตฌํํ ์ ์๋ค๋ ์ฅ์ ์ด ์์ต๋๋ค.
ํผ๋ ์ง๋ฉด์ ํ์ํ๊ณ ๊ด๊ณ ๋ฅผ ํ ๋นํ๋ ๋ฐฉ๋ฒ, ๊ทธ๋ฆฌ๊ณ ๊ด๊ณ ๋ ธ์ถ๊ณผ ์ฌ์ฉ์ ๊ฒฝํ ์ต์ ํ๋ฅผ ์ง์ํ๋ ๊ธฐ๋ฅ๋ค์ ํ์ธํด ๋ณด์ธ์.
์ค๋น ์ฌํญ
์์ํ๊ธฐ ์ ์ฉ ์๋ฃ
ํผ๋ ์ง๋ฉด์ ์ฌ์ฉํ Unit ID(์ดํ
feedUnitId
)
ํผ๋ ์ง๋ฉด ์ด๊ธฐํํ๊ธฐ
๋ค์์ ์ ์ฐจ๋ฅผ ๋ฐ๋ผ ํผ๋ ์ง๋ฉด์ ์ด๊ธฐํํ์ธ์.
1. Unity ์กํฐ๋นํฐ์์ ์ปจํ ์คํธ๋ฅผ ๊ฐ์ ธ์ค์ธ์.
2. Unity ํผ๋ ์ง๋ฉด ์ด๊ธฐํ ๋ฉ์๋์ feedConfig
๋ฅผ ์ค์ ํ ํ feedUnitId
๋ฅผ ์ถ๊ฐํ์ธ์.
3. BuzzAdBenefit.init()
์ ํธ์ถํ์ธ์.
4. ๊ด๊ณ ํ ๋น์ ์์ฒญํ๊ธฐ ์ํด ์ฌ์ฉ์ ํ๋กํ์ ์ค์ ํ์ธ์.
ํผ๋ ์ง๋ฉด ํ์ํ๊ธฐ
show()
๋ฅผ ํธ์ถํ๋ฉด ํผ๋ ์กํฐ๋นํฐ๊ฐ ์คํ๋๊ณ ๊ด๊ณ ๊ฐ ๋ก๋๋ฉ๋๋ค. ๋
ธ์ถํ ์ ์๋ ๊ด๊ณ ๊ฐ ์์ผ๋ฉด ๋น ํ๋ฉด์ด ํ์๋ฉ๋๋ค.
show()
๋ฅผ ๋ฐ๋ณตํด์ ํธ์ถํ๋๋ผ๋ ๊ด๊ณ ๋ ๊ฐฑ์ ๋์ง ์์ผ๋ฉฐ ๋์ผํ ๊ด๊ณ ๊ฐ ํธ์ถ๋ฉ๋๋ค.
๊ฐ์ธ ์ ๋ณด ์์ง ๋์ UI
๊ฐ์ธ ์ ๋ณด ๋ณดํธ๋ฒ๊ณผ ๊ตฌ๊ธ ์ ์ฑ ์ ๋ฐ๋ผ, ๊ฐ์ธ ์ ๋ณด ์์ง ๋ฐ ์ฌ์ฉ์ ๋ํ ์ฌ์ฉ์์ ๋์๊ฐ ํ์ํฉ๋๋ค. BuzzAd Unity Android์ฉ SDK๋ ๋์๋ฅผ ์ป๊ธฐ ์ํ UI๋ฅผ ์ ๊ณตํ๋ฉฐ, ์ฌ์ฉ์๊ฐ ๊ฐ์ธ ์ ๋ณด ์์ง์ ๋์ํ์ง ์์ผ๋ฉด, ํผ๋ ์ง๋ฉด์ ๊ด๊ณ ๊ฐ ํ ๋น๋์ง ์์ต๋๋ค. ํผ๋ ์ง๋ฉด์ ์ฒ์ ์ง์ ํ ์ฌ์ฉ์์๊ฒ๋ ์๋์ ๊ฐ์ UI๊ฐ ํ์๋ฉ๋๋ค.
๋ฌดํ ์คํฌ๋กค ๊ธฐ๋ฅ
ํผ๋ ๋ฌดํ ์คํฌ๋กค ๊ธฐ๋ฅ์ ์ฌ์ฉ์๊ฐ ํผ๋์ ์ง์ ํด ํ ๋น๋ ๊ด๊ณ ๋ชฉ๋ก์ ๋๊น์ง ์คํฌ๋กค ํด ๋ ์ด์ ๋ณผ ์ ์๋ ๊ด๊ณ ๊ฐ ์์ผ๋ฉด ์๋์ผ๋ก ์ถ๊ฐ ๊ด๊ณ ๋ฅผ ํ ๋นํด ๊ธฐ๋ฅ์ ๋๋ค. ์ด ๊ธฐ๋ฅ์ ๊ธฐ๋ณธ์ ์ผ๋ก ํ์ฑํ๋์ด ์์ผ๋ฉฐ, ์ฑ์์ ์ฝ๋๋ฅผ ์์ ํ๊ฑฐ๋ ์ฌ๋ฐฐํฌ๋ฅผ ํ์ง ์๊ณ ๋ฌดํ ์คํฌ๋กค ๊ธฐ๋ฅ์ ํ์ฑํ ์ฌ๋ถ๋ฅผ ์ค์ ํ ์ ์์ต๋๋ค. ์ค์ ์ ๋ณ๊ฒฝํ๋ ค๋ฉด ๋ฒ์ฆ๋น BD ๋งค๋์ ๋๋ย help@buzzvil.com์ ์ฐ๋ฝํ์ธ์.
๊ด๊ณ ๋ถ๋ฅ ๊ธฐ๋ฅ
ํผ๋ ๊ด๊ณ ๋ถ๋ฅ ๊ธฐ๋ฅ์ ํญ๊ณผ ํํฐ UI๋ฅผ ์ฌ์ฉํ์ฌ ์ ํ ๋ณ๋ก ๋ถ๋ฅ๋ ๊ด๊ณ ๋ฅผ ์ฌ์ฉ์์๊ฒ ๋ณด์ฌ์ฃผ๋ ๊ธฐ๋ฅ์ ๋๋ค. ํญ๊ณผ ํํฐ ๊ธฐ๋ฅ์ ์ฌ์ฉํ๋ฉด ์ฌ์ฉ์๊ฐ ์ฐธ์ฌํ๊ณ ์ถ์ ์ ํ์ ๊ด๊ณ ๋ง ๋ณผ ์ ์์ด ์ฌ์ฉ์์ ๊ด๊ณ ์ฐธ์ฌ ๊ฒฝํ๊ณผ ๊ด๊ณ ํจ์จ์ ๋์ผ ์ ์์ต๋๋ค.
๊ด๊ณ ๋ถ๋ฅ ๊ธฐ๋ฅ์ ๋ํ ์ค์ ์ ์ฑ์์ ์ฝ๋๋ฅผ ์์ ํ๊ฑฐ๋ ์ฌ๋ฐฐํฌํ์ง ์๊ณ ๋ณ๊ฒฝํ ์ ์์ต๋๋ค. ์ค์ ์ ๋ณ๊ฒฝํ๋ ค๋ฉด ๋ฒ์ฆ๋น BD ๋งค๋์ ๋๋ย help@buzzvil.com์ ์ฐ๋ฝํ์ธ์.
๊ด๊ณ ๋ถ๋ฅ ํญ๊ณผ ํํฐโ
ํญ์ ๊ฐฏ์, ํญ์ ์ด๋ฆ, ํญ์ผ๋ก ๋ชจ์์ ๊ฒ์ฌํ ๊ด๊ณ ์ ํ์ ์ค์ ํ ์ ์์ต๋๋ค. ํญ์ ์ต๋ 3๊ฐ๊น์ง ์ค์ ํ ์ ์์ผ๋ฉฐ, ์ด๊ธฐ์๋ย ๊ด๊ณ ์ ๋ฆฝ,ย ์ผํ ์ ๋ฆฝย ํญ์ด ์ค์ ๋ฉ๋๋ค. ์ด ์ค์์ ๊ด๊ณ ์ ๋ฆฝ ํญ์๋ ์ผํ ๊ด๊ณ ๋ฅผ ์ ์ธํ ๋๋จธ์ง ์ ํ์ ๊ด๊ณ ๊ฐ ๋ ธ์ถ๋๋ฉฐ, ์ผํ ์ ๋ฆฝ ํญ์๋ ์ผํ ๊ด๊ณ ๊ฐ ๋ ธ์ถ๋ฉ๋๋ค.
ํญ์ผ๋ก ๋ถ๋ฅํ ์ ์๋ ๊ด๊ณ ์ ์ ํ์ ๋ ธ์ถํ ๊ด๊ณ , ์ฐธ์ฌํ ๊ด๊ณ , ๋น๋์ค ๊ด๊ณ , ์์ ๋ฏธ๋์ด ๊ด๊ณ , ์ผํ ๊ด๊ณ ์ ๋๋ค. ๊ฐ ํญ์ ํ ๊ฐ ์ด์์ ๊ด๊ณ ์ ํ์ผ๋ก ๊ตฌ์ฑํ ์ ์์ต๋๋ค. ๋จ, ์ผํ ๊ด๊ณ ์ ๊ฒฝ์ฐ ๋ค๋ฅธ ๊ด๊ณ ์ ํ๊ณผ ํจ๊ป ํญ์ผ๋ก ๊ตฌ์ฑํ ์ ์์ต๋๋ค.
ํญ์ด ์ฌ๋ฌ ๊ฐ์ ๊ด๊ณ ์ ํ์ผ๋ก ๊ตฌ์ฑ๋๋ฉด โํด๋ฆญํ๊ธฐโ, โ์ฐธ์ฌํ๊ธฐโ ๋ฑ ๊ด๊ณ ์ ํ์ ์ธ๋ถํํ๋ ํํฐ UI๊ฐ ๋ ธ์ถ๋ฉ๋๋ค.