Unity 앱에서 Easy Monetization 설정

앱에서의 Easy Monetization 활성화에는 수익화 라이브러리 통합 및 광고 시스템 설정이 포함됩니다.

앱 개발자는 다음과 같은 단계를 수행해야 합니다.

  1. 필수 라이브러리 통합.
  2. 광고 네트워크의 라이브러리 통합.
  3. 앱 매니페스트에 변경 사항 적용.
  4. Info.plist에 변경 사항 적용.
  5. 앱에서 광고 작업 구현(광고 로드 및 표시).
  6. 사용자의 개인 데이터 사용 동의 확보(GDPR 법이 시행되는 국가의 경우).
  7. Firebase에 대한 액세스 권한 제공.
  8. 사이트에 app-ads.txt 파일 게시.

1. Yandex Mobile Ads SDK 라이브러리 통합

다음 지침에 따라 라이브러리를 통합합니다.

2. 광고 네트워크의 라이브러리 통합

Важно

yandex-ads-unity-plugin은 Android 및 iOS 환경에서만 실행됩니다. 현재 Unity 편집기에서는 광고를 로드하거나 표시할 수 없습니다.

yandex-mobileads-mediation 패키지를 사용하여 모든 사용 가능한 어댑터를 자동으로 연결할 수 있습니다.

  1. yandex-ads-unity-plugin 디렉터리를 다운로드하고 패키지 yandex-mobileads-mediation-7.16.0.unitypackage를 추가합니다. 또한 Google 리졸버를 설치하라는 메시지가 표시됩니다. 이미 프로젝트에 Google 리졸버를 추가한 경우, 확인란을 해제합니다.

    패키지 추가 방법

    필요한 플러그인을 선택하고(Assets → Import Package → Custom Package) Import를 클릭합니다.

  2. Google 리졸버를 사용하여 종속성을 설치합니다. auto-resolve를 활성화하거나 메뉴 항목 Assets → External Dependency Manager → Android Resolver → Resolve를 선택하세요.

  3. Mobile Ads Unity 플러그인을 테스트하려면 yandex-ads-unity-plugin 리포지토리의 samples 디렉터리에 있는 데모 스크립트 중 하나를 사용합니다. 스크립트를 프로젝트 디렉터리에 복사하고 메인 카메라에 Component로 추가합니다.

  4. Google AdMob (ex. AdMob) 네트워크에 대한 추가 설정

    • Android의 경우, File → Build Settings → Android → Player Settings → Publishing Settings → Custom Main Manifest(확인란 선택)를 통해 메인 AndroidManifest.xml 파일을 생성합니다.

      생성된 AndroidManifest.xml 애플리케이션 파일에 com.google.android.gms.ads.APPLICATION_ID라는 이름의 <meta-data> 태그를 사용하여 App ID를 추가합니다.

      <manifest>
    <application>
<!--...-->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
<!--...-->
    </application>
</manifest>

    • iOS용으로 생성된 Xcode 프로젝트에서 키 GADApplicationIdentifier를 app ID와 함께 Info.plist 파일에 추가합니다.

      <key>GADApplicationIdentifier</key>
<string>ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy</string>

    Google App ID를 찾을 수 있는 위치에 대해 자세히 알아보세요.

3. 앱 매니페스트에 변경 사항 적용(Android)

앱 매니페스트의 application 객체에 다음 문자열을 추가합니다.

<manifest>
    <application>
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="Google_Application_ID"/>
    </application>
</manifest>

Внимание

Google_Application_ID를 “IDs for setup” 파일의 값으로 교체합니다.

4. Info.plist에 변경 사항 적용(iOS)

앱의 Info.plist에 다음 문자열을 추가합니다.

<key>GADApplicationIdentifier</key>
<string>Google_Application_ID</string>

<key>SKAdNetworkItems</key>
<array>
    <dict>
        <!-- Yandex Ads -->
        <key>SKAdNetworkIdentifier</key>
        <string>zq492l623r.skadnetwork</string>
    </dict>
    <dict>
        <!-- Google AdMob (ex. AdMob) -->
        <key>SKAdNetworkIdentifier</key>
        <string>cstr6suwn9.skadnetwork</string>
    </dict>
    <dict>
        <!-- VK Ads (ex. myTarget) -->
        <key>SKAdNetworkIdentifier</key>
        <string>n9x2a789qt.skadnetwork</string>
    </dict>
    <dict>
        <!-- VK Ads (ex. myTarget) -->
        <key>SKAdNetworkIdentifier</key>
        <string>r26jy69rpl.skadnetwork</string>
    </dict>
    <dict>
        <!-- Start.io -->
        <key>SKAdNetworkIdentifier</key>
        <string>5l3tpt7t6e.skadnetwork</string>
    </dict>
    <dict>
        <!-- UnityAds -->
        <key>SKAdNetworkIdentifier</key>
        <string>4dzt52r2t5.skadnetwork</string>
    </dict>
    <dict>
        <!-- IronSource -->
        <key>SKAdNetworkIdentifier</key>
        <string>su67r6k2v3.skadnetwork</string>
    </dict>
    <dict>
        <!-- Applovin -->
        <key>SKAdNetworkIdentifier</key>
        <string>ludvb6z3bs.skadnetwork</string>
    </dict>
    <dict>
        <!-- Mintegral -->
        <key>SKAdNetworkIdentifier</key>
        <string>KBD757YWX3.skadnetwork</string>
    </dict>
</array>

Внимание

Google_Application_ID 값을 “IDs for setup” 파일의 값으로 교체합니다.

5. 광고 작업의 로직 구현

다음 문서를 기반으로 광고 로딩 및 표시를 구현하세요.

로직 구현 시 “IDs for setup” 파일의 adUnitId 값을 사용하세요.

  • 전면 광고의 경우 Interstitial_ad_unit.
  • 보상형 광고의 경우 Rewarded_ad_unit.
  • 배너 광고의 경우 Banner_ad_unit.

6. 사용자의 개인 데이터 수집에 대한 동의 확보 구현

GDPR이 시행되는 EEA 회원국의 사용자에게는 개인 데이터 수집 동의 대화 상자를 표시해야 합니다. 사용자의 동의를 얻으면 광고 SDK에 반드시 전송하세요.

지침을 참조하세요.

7. Firebase 설정

Google Admob에서 수익을 늘리려면 지침에 따라 Firebase Analytics를 통합하세요.

활성화되면 firebase.admin 권한으로 int-ad@yandex-team.com 이메일에 액세스 권한을 제공하여 Google AdMob (ex. AdMob) 계정에 Firebase 앱을 연결합니다.

지침에 따라 편집자 역할로 Google Analytics 액세스 권한을 부여합니다.

설정이 완료되면 부여된 역할을 취소할 수 있습니다.

8. app-ads.txt 파일 게시

app-ads.txt 파일(앱용 인증된 판매자)은 IAB에서 개발한 광고 사기 방지 메커니즘입니다. 파일은 선택 사항이지만, 사용하면 앱에 표시할 수 있는 광고주의 수와 광고 수익이 증가합니다.

Google Play 또는 App Store 개발자 페이지에 나열된 사이트의 루트 폴더에 app-ads.txt를 업로드하세요.

“IDs for setup” 파일의 App_ads_txt 문자열에 제공된 링크의 정확한 app-ads.txt 파일을 업로드하세요.

app-ads.txt 파일에 대한 자세한 내용은 수익화를 참조하세요.

9. ILRD 활성화(선택 사항)

필요한 경우 상세한 수익 데이터를 받을 수 있습니다. 수행하는 방법을 알아보려면 ILRD(노출 수준 수익 데이터) 활성화를 참조하세요.

지원 문의