미디에이션 네트워크 준비

Google bidding 및 Google AdMob 앱 ID 추가

1. Integration Manager를 엽니다 (AppLovin > Integration Manager).
2. 최신 Google bidding 및 Google AdMob 어댑터를 설치합니다:
   1. Integration Manager의 Mediated Networks 섹션에서 Google bidding 및 Google AdMob 옆의 Actions 열에 있는 Install을 클릭합니다.
   2. Import Unity Package 대화 상자에서 Import를 클릭합니다.
3. Integration Manager의 Mediated Networks 섹션에 App ID를 입력할 수 있는 두 개의 새로운 필드가 나타납니다. 여기에 해당하는 값을 입력하십시오.

Gradle 오류

Google AdMob은 Android Gradle 플러그인 버전 4.2.0 이상 및 Gradle 버전 6.7.1 이상이 필요합니다. 다음과 같은 오류가 발생하는 경우, Android Gradle 플러그인 및 Gradle 버전을 업데이트하십시오:

AAPT: error: unexpected element <property> found in <manifest><application>.

Android Gradle 플러그인 및 Gradle 버전을 업데이트하려면 다음 단계를 수행하십시오:

1. Unity에서 Project Settings > Player > Android > Publishing Settings > Build를 엽니다.
2. Custom Base Gradle Template을 체크합니다.
3. Assets/Plugins/Android/baseProjectTemplate.gradle 파일을 편집합니다. Gradle 빌드 도구 버전 4.2.0을 사용하도록 종속성을 설정합니다:

   allprojects {
     buildscript {
       dependencies {
         classpath 'com.android.tools.build:gradle:4.2.0'
         «build script dependencies»
       }
     }
   }
   

4. Gradle 버전 6.7.1 이상을 다운로드하여 설치합니다.
5. Unity에서 Unity Preferences > External Tools를 엽니다.
6. 새로 업데이트한 Gradle 설치 경로를 가리키도록 커스텀 Gradle 경로를 설정합니다.

Meta Audience Network SDK 마이그레이션

프로젝트에서 Meta Audience Network Unity SDK를 사용하는 경우, MAX Meta Audience Network 어댑터가 작동하려면 버전 11.0 이상이어야 합니다. 이전 버전의 Meta Audience Network Unity SDK에서 마이그레이션하려면 Assets/FacebookSDK 디렉토리를 삭제한 다음, 여기에서 최신 버전을 다운로드하여 다시 임포트하십시오.

Meta Audience Network 데이터 처리 옵션

Meta Audience Network Unity Plugin을 사용하지 않는 경우, 여기의 “Unity SDK, v5.10+ (not using the Audience Network-supplied Unity wrapper)” 아래에 있는 지침에 따라 관련 메서드에 대한 래퍼를 추가하십시오.

제한된 데이터 사용(LDU) 모드를 활성화하지 않으려면 SetDataProcessingOptions()에 빈 문자열 배열을 전달하십시오:

using AudienceNetwork;
⋮
AdSettings.SetDataProcessingOptions(new string[] { });
⋮
// Initialize MAX SDK

사용자에 대해 LDU를 활성화하고 사용자의 지역을 지정하려면 다음과 같이 SetDataProcessingOptions()를 호출하십시오:

using AudienceNetwork;
⋮
AdSettings.SetDataProcessingOptions(new string[] {"LDU"}, «country», «state»);
⋮
// Initialize MAX SDK

Google UMP 사용하기

Google UMP를 CMP로 사용하는 경우, 사용자가 Meta에 동의했는지 여부를 확인할 수 있습니다. 그렇게 하려면 다음 코드를 사용하십시오:

bool? hasMetaConsent = MaxSdkUtils.GetAdditionalConsentStatus(89);
if ( hasMetaConsent != null )
{
  // Set Meta Data Processing Options accordingly.
}
else
{
  // AC String is not available on disk. Please check for consent status after the user completes the CMP flow.
}

캘리포니아 사용자를 위한 Meta Audience Network 데이터 처리 옵션

캘리포니아에서 Meta Audience Network의 “제한된 데이터 사용(Limited Data Use)” 플래그를 구현하는 방법을 알아보려면 Meta for Developers 문서를 읽어보십시오.

Android manifest 병합 오류

일부 네트워크 SDK는 번들로 제공되는 Android Manifest 파일에 <queries> 요소를 포함합니다. 호환되지 않는 버전의 Android Gradle 플러그인을 사용하는 경우, 이로 인해 다음과 같은 빌드 오류 중 하나가 발생합니다:

이 오류를 해결하려면 다음 버전 중 하나로 Android Gradle 플러그인을 업그레이드하십시오. 이 버전들은 <queries> 요소를 지원합니다:

Gradle 플러그인 버전을 호환 가능한 버전으로 업데이트하려면 커스텀 base Gradle 템플릿을 활성화하십시오:

1. **Edit > Project Settings…**를 선택합니다.
2. Player를 선택하고 Android 아이콘이 표시된 탭을 선택합니다.
3. Publisher Settings를 열고 Custom Base Gradle Template을 체크합니다.

템플릿 파일은 Unity 2019.2 이하의 경우 Assets/Plugins/Android/mainTemplate.gradle이고, Unity 2019.3 이상의 경우 Assets/Plugins/Android/baseProjectTemplate.gradle입니다. 해당 템플릿에서 아래 줄을 적절한 Gradle 버전으로 업데이트하십시오:

classpath com.android.tools.build:gradle:«x».«x».«x»

compileSdkVersion

Google Mobile Ads SDK 버전 23.1.0 이상은 최소 34의 compileSdkVersion이 필요합니다.

앱의 build.gradle에서 compileSdkVersion을 34 이상으로 설정하십시오.

최신 compileSdkVersion 요구 사항은 Google Mobile Ads SDK 릴리스 노트를 참조하십시오.

Google bidding 및 Google AdMob 앱 ID 추가

Integration Manager를 열고 (AppLovin > Integration Manager) 최신 Google bidding 및 Google AdMob 어댑터를 설치합니다:

1. Integration Manager의 Mediated Networks 섹션에서 Google bidding 및 Google AdMob 옆의 Actions column에 있는 Install을 클릭합니다.
2. Import Unity Package 대화 상자에서 Import를 클릭합니다.
3. Integration Manager의 Mediated Networks 섹션에 App ID를 입력할 수 있는 두 개의 새로운 필드가 나타납니다. 여기에 해당하는 값을 입력하십시오.

Meta Audience Network SDK 마이그레이션

프로젝트에서 Meta Audience Network Unity SDK를 사용하는 경우, MAX Meta Audience Network 어댑터가 작동하려면 버전 11.0 이상이어야 합니다. 이전 버전의 Meta Audience Network Unity SDK에서 마이그레이션하려면 Assets/FacebookSDK 디렉토리를 삭제한 다음, 여기에서 최신 버전을 다운로드하여 다시 임포트하십시오.

Meta Audience Network 데이터 처리 옵션

Meta Audience Network Unity Plugin을 사용하지 않는 경우, 여기의 “Unity SDK, v5.10+ (not using the Audience Network-supplied Unity wrapper)” 아래에 있는 지침에 따라 관련 메서드에 대한 래퍼를 추가할 수 있습니다.

제한된 데이터 사용(LDU) 모드를 활성화하지 않으려면 SetDataProcessingOptions()에 빈 문자열 배열을 전달하십시오:

using AudienceNetwork;
⋮
AdSettings.SetDataProcessingOptions(new string[] { });
⋮
// Initialize MAX SDK

사용자에 대해 LDU를 활성화하고 사용자의 지역을 지정하려면 다음과 같이 SetDataProcessingOptions()를 호출하십시오:

using AudienceNetwork;
⋮
AdSettings.SetDataProcessingOptions(new string[] {"LDU"}, «country», «state»);
⋮
// Initialize MAX SDK

Google UMP 사용하기

Google UMP를 CMP로 사용하는 경우, 사용자가 Meta에 동의했는지 여부를 확인할 수 있습니다. 그렇게 하려면 다음 코드를 사용하십시오:

bool? hasMetaConsent = MaxSdkUtils.GetAdditionalConsentStatus(89);
if ( hasMetaConsent != null )
{
  // Set Meta Data Processing Options accordingly.
}
else
{
  // AC String is not available on disk. Please check for consent status after the user completes the CMP flow.
}

캘리포니아 사용자를 위한 Meta Audience Network 데이터 처리 옵션

캘리포니아에서 Meta Audience Network의 “제한된 데이터 사용(Limited Data Use)” 플래그를 구현하는 방법을 알아보려면 Meta for Developers 문서를 읽어보십시오.

iOS 14.5 이상을 위한 Meta의 준비 사항

Audience Network SDK 버전 6.2.1부터 다음 요구 사항이 도입되었습니다:

• mediation 사용 여부와 관계없이 setAdvertiserTrackingEnabled 플래그를 구현해야 합니다. 이는 개인 맞춤형 광고를 제공하기 위해 데이터를 사용할지 여부를 Meta에 알립니다.

MaxSdkCallbacks.OnSdkInitializedEvent += (MaxSdk.SdkConfiguration sdkConfiguration) => {

#if UNITY_IOS || UNITY_IPHONE || UNITY_EDITOR
  if (MaxSdkUtils.CompareVersions(UnityEngine.iOS.Device.systemVersion, "14.5") != MaxSdkUtils.VersionComparisonResult.Lesser)
  {
    // App transparency tracking 권한은 Unity Editor 및 iOS 타겟의 경우 `sdkConfiguration.AppTrackingStatus`를 통해 확인할 수 있습니다.
    // 1. 여기에 Meta ATE 플래그를 설정한 다음,
  }
#endif

  // 2. 광고 로드
};

SKAdNetwork

Integration Manager는 귀하를 대신하여 연동된 네트워크의 SKAdNetwork ID를 자동으로 연동합니다.