03. Unity-Plugin Guide

ONE AdMax for Unity-Plugin Guide

개발 버전

Unity

2022.3.11f1

Java SDK (Java 11)

ONE AdMax SDK v1.2.1

전제조건 (Requirements)

• Unity 2022.3.11f1 이상 사용 (Use Unity 2022.3.11f1 or higher.)

• Android SDK version

  • Minimum API Level 16 이상 사용 (Minimum API Level 16 or higher.)

  • Target API Level 33 이상 사용 (Target API Level 33 or higher.)

Android API 레벨은 Project Settings > Player > Other Settings 에서 설정할 수 있습니다. (Android API level can be set in Project Settings > Player > Other Settings.)

ONE AdMax for Unity 플러그인 다운로드(ONE AdMax for Unity Plugin Download)

ONE AdMax for Unity 플러그인을 사용하면 Unity 개발자가 원스토어 광고를 제공할 수 있습니다. (The ONE AdMax for Unity plugin allows Unity developers to serve ONE store advertising.)

Java 코드를 작성할 필요 없이 Android 앱에서 사용할 수 있습니다. (You can use it in your Android app without having to write Java code.)

이 플러그인은 Unity에서 광고를 요청하기 위한 C# 인터페이스를 제공합니다. (It provides a C# interface for requesting ads in Unity.)

플러그인용 Unity 패키지는 (링크)에서 확인하실 수 있습니다. (The Unity package for the plugin can be found at link.)

ONE AdMax for Unity 플러그인 가져오기(Importing ONE AdMax for Unity Plugin)

Unity 메뉴 바에서 Assets > Import Package > Custom Package를 클릭합니다. (From the Unity menu bar, navigate to Assets > Import Package > Custom Package.)

Assets/OneStoreCorpPlugins/com.oneadmax.global 폴더가 생성됩니다. (This creates the Assets/OneStoreCorpPlugins/com.oneadmax.global folder.)

EDM4U(External Dependency Manager for Unity)가 필수로 같이 배포됩니다. 만약, 이미 사용하고 있다면 Import Package 단계에서 ExternalDependencyManager 를 체크해지 하고 적용하면 됩니다. (EDM4U (External Dependency Manager for Unity is distributed during this process. If already in use, deselect ExternalDependencyManager during the Import Package step.)

외부 종속성 포함(Including External Dependencies)

프로젝트에 레파지토리 및 종속성이 포함되도록 하려면 다음 단계를 따릅니다. (To include the repository and dependencies in your project, follow these steps:)

Project Settings > Player > Publishing Settings > Build

아래의 두 가지를 체크합니다. (Check the two items below:)

• Custom Main Manifest

• Custom Main Gradle Template

• Custom Gradle Settings Template

Assets > External Dependency Manager > Android Resolver > Force Resolve 를 선택합니다. (Select Assets > External Dependency Manager > Android Resolver > Force Resolve.)

settingsTemple.gradle 파일에 Maven Repository 주소가 적용됩니다.

mainTemplete.gradle 파일에 Maven Module 이 적용됩니다.

ONEAdMax for Unity 플러그인 종속성은 다음에 나열되어 있습니다. (Dependencies for the ONE AdMax for Unity plugin are listed in)

Assets/OneStoreCorpPlugins/com.oneadmax.global/Editor/ONEAdMaxDependencies.xml

매체 키발급 및 적용하기(Issuing and Applying a Media Key)

매체 키 발급 받는 방법(How to Issue a Media Key)

매체키를 발급 받았다면 AndroidManifest.xml에 <meta-data />를 설정해야 합니다. (Once you have received your media key, you must configure it within your AndroidManifest.xml using the tag.)

<manifest>
    ...
    <application>
        ...
        <activity android:name="com.unity3d.player.UnityPlayerActivity">
            ...
        </activity>

        <meta-data android:name="com.oneadmax.global.appkey" android:value="your app key"/>
    </application>
</manifest>

(!) 아래 내용 확인해 주세요. (Important: Please check the information below:)

• 매체키를 AndroidManifest.xml 에 넣었는지 확인해주세요. (Ensure the media key is correctly placed within the AndroidManifest.xml.)

• 매체키는 Unity Plugin 과 상관없이 Java SDK 에서 읽는 값이기 때문에 해당 meta-data 의 위치가 application element 내부에 있어야 합니다. (Since the media key is read by the Java SDK regardless of the Unity Plugin, it must be located inside the application element.)

SDK에 적용된 사항들(Matters applied to SDK)

Permission

<manifest>
    ...
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    ...
</manifest>

SDK 초기화(SDK Initialize)

광고를 로드하기 전에 앱이 ONEAdMax를 초기화해야 합니다. ONEAdMaxClient.Initialize() 초기화는 최초 한 번만 수행해야 합니다. (The app must Initialize ONE AdMax before loading ads. Reset with ONEAdMaxClient.Initialize() should occur only once.)

다음은 ONEAdMaxClient 를 초기화하는 방법입니다. (Here’s how to reset ONE AdMaxClient.)

...
using ONEAdMax;
...
public class ONEAdMaxDemo : MonoBehaviour
{
    private static bool _isInitialized = false;
    
    void Start()
    {
        if (!_isInitialized)
        {
            // Initialize the ONEAdMax SDK.
            ONEAdMaxClient.Initialize(() =>
            {
                // This callback is called once the ONEAdMax SDK is initialized.
                _isInitialized = true
            });
        }
    }
}

Log Settings

개발을 위해 ONEAdMax의 자세한 로그를 노출할 수 있습니다. (기본값: false) (For development, you can expose detailed logs from ONE AdMax (default: false).)

ONEAdMaxClient.SetLogEnable(true);

GDPR Settings

EU의 GDPR (General Data protection Regulation) 법안에 대응하기 위해 아래 API를 추가합니다. GDPR 동의가 필요한 유저에 한 해 아래 API를 호출하시기 바랍니다. (기본값: true) (To comply with the EU’s GDPR (General Data Protection Regulation), add the following API. Call this API only for users who require GDPR consent.(default: true))

ONEAdMaxClient.GdprConsentAvailable(true);

COPPA Settings

COPPA(Children's Online Privacy Protection Rule)법안에 대응하기 위해 아래 API를 추가 합니다. 해당 디바이스에서는 모든 광고 타입의 광고 요청에 대해 No ad 처리 됩니다. (기본값: false) (To comply with the Children's Online Privacy Protection Rule (COPPA), we've added the following API. This API will ensure that no ads are served on devices where this setting is enabled. (Default: false))

ONEAdMaxClient.tagForChildDirectedTreatment(true);

애플리케이션 종료(Closing Application)

애플리케이션이 종료될 때 메모리에 할당된 리소스(View, Memory)를 해제합니다. (Delete allocated resources (View, Memory) when the application closes.)

void OnApplicationQuit()
{
    ONEAdMaxClient.Destroy();
}

미디에이션 설정(링크) (Mediation Settings)

광고 형식 선택하기(Choosing an Ad Format)

이제 광고를 구현할 준비가 되었습니다. ONE AdMax 는 다양한 광고 형식을 제공하므로 만들 수 있는 광고 형식을 선택할 수 있습니다. (Now you are ready to implement ads. ONE AdMax provides various ad types that you can choose from.)

보상형 비디오 광고(Reward Video Ads)

보상을 제공하는 비디오 광고입니다. 비디오 광고 종료 시 Complete event callback으로 광고 참여 완료 정보를 전달합니다. (These are reward video ads. When the video ad closes, information about the completion of ad participation is sent through Complete event callback.)

3-1. Reward Video ADs for Unity(Implementing Reward Video Ads)

전면 광고(Interstitial Ads)

전면 광고는 앱의 화면 전체를 덮는 광고입니다. 완료되었거나 유저에 의해 중단 되었을 경우 앱의 화면으로 전환됩니다. (Interstitial ads are a form of advertising that covers the entire screen. When advertisement is completed or stopped by the user, the screen will return to the app.)

3-2. Interstitial ADs for Unity(Implementing Interstitial Ads)

배너 광고(Banner Ads)

배너 광고는 앱의 일부를 차지하는 직사각형 광고를 표시합니다. 위치를 설정하고 시간을 설정하여 자동으로 새로고침할 수 있습니다. (Banner ads expose rectangular ads that take up a portion of your app. You can set your location and set the time to automatically refresh.)

3-3. Banner ADs for Unity(Implementing Banner Ads)

전면 비디오 광고(Interstitial Video Ads)

전면 광고와 동일하지만 이미지가 아닌 영상이 노출됩니다. 영상을 로드하는 과정이 전면 광고 보다 오래 소요될 수 있습니다. (It is the same as an interstitial ad, but a video is exposed instead of an image. The video loading process may take longer than an interstitial ad.)

3-4. Interstitial Video ADs (Non Reward)(Implementing Interstitial Video Ads)