Initialize

0. GDPR (General Data Protection Regulation)

GDPR은 유럽연합(이하 'EU')의 개인정보 보호 법령으로 서비스 제공자는 EU 사용자의 개인정보 또는 그에 준하는 정보에 대한 수집 및 활용에 대해 사용자에게 동의 여부를 확인받아야 합니다. GDPR 규정 준수 및 규정에 따른 광고네트워크 동작에 필요한 절차입니다.

1. Initialize & GDPR Content UI

초기화 시 유럽 경제 지역 (European Economic Area) 사용자의 GDPR 동의 여부를 받아 처리할 수 있는 관련 기능을 제공합니다. 광고 관련 코드를 요청하기 전에 초기화 함수를 호출합니다.

Unity ADX SDK에는 사용자로부터 GDPR 동의를 받을 수 있는 기능이 포함되어 있습니다.

---

2024년 1월 16일부터 IAB 유럽의 인증과 플랫폼 사업자의 인증을 받은 동의 플랫폼(CMP)를 통해 GDPR 동의 관리를 처리해야 됨에 따라, Unity ADX SDK 버전 2.5.0 이상부터, SDK 내부에서 자체적으로 제공되던 GDPR 동의 화면은 더 이상 지원되지 않으니, 애드몹 UMP (User Messaging Platform)를 통하여 GDPR 동의를 처리해야합니다.

---

유럽 경제 지역 (European Economic Area)에서 애플리케이션을 서비스하고 있거나, 또는 서비스할 계획이 있다면 Unity ADX SDK 버전 2.5.0 이상을 설치하고, 이 문서의 UMP (User Messaging Platfom) 이동하여 기술된 내용에 따라 설정하여 주십시오.

• "<ADX_APP_ID>"에 ADX에서 발급받은 ADX App ID를 사용합니다.

• SDK 초기화는 앱 실행 시 한 번만 호출하여 주시고, 광고 요청은 초기화가 완료된 후에 이뤄져야 합니다.

  • OnADXConsentCompleted가 호출 된 후, 광고를 요청해야 합니다.

• GdprType은 아래 항목 중 하나를 선택하여 입력합니다.

GDPR 타입	설명
POPUP_LOCATION	지역에 따라 동의 팝업 호출 (EU 지역)
POPUP_DEBUG	지역 상관없이 동의 팝업 호출 테스트 (DEBUG)
DIRECT_NOT_REQUIRED	동의 여부가 필요없는 지역 (EU 외 지역)
DIRECT_DENIED	사용자가 개인정보 활용 및 수집 거부
DIRECT_CONFIRM	사용자가 개인정보 활용 및 수집 동의

Case 1. EEA 사용자의 GDPR 동의 화면 제공

유럽 경제 지역 (European Economic Area) 사용자에게 동의 여부를 선택할 수 있도록 동의 화면을 제공합니다.

유럽 경제 지역 (European Economic Area) 사용자에게 동의 여부를 선택할 수 있는 기능이 애드몹 UMP (User Messaging Platform)에 의해서 처리되며, 애드몹 UMP 기능은 Unity ADX SDK 버전 2.5.0 이상에 포함되어 있습니다.

• ADXConfiguration에서 GdprType을 POPUP_LOCATION로 설정하시면, 사용자의 접속 국가에 따라 EU 사용자는 GDPR 동의 Consent UI를 통해 동의 여부를 결정할 수 있습니다.

• GdprType을 POPUP_DEBUG로 설정 시 접속 국가와 상관없이 동의 화면을 확인할 수 있습니다.

ADXConfiguration adxConfiguration = new ADXConfiguration.Builder()
                                .SetAppId("<ADX_APP_ID>")
                                .SetTestDevices(new List<string>() {"<TEST_DEVICE_ID>"})
                                .SetGdprType(GdprType.POPUP_LOCATION).Build();

AdxSDK.Initialize(adxConfiguration, adxConsentState => {
       Debug.Log(":::onADXConsentCompleted : " + adxConsentState);
});

애드몹 UMP의 GDPR 동의 화면을 테스트 목적으로 확인하려면, 아래 두 가지 설정이 필요합니다. 1) 애드몹 대쉬보드 (https://apps.admob.com)로 이동한 다음에 아래 GDPR 메시지 작성 가이드 내용을 따라서 메시지 작성과 게시를 완료하십시오. https://support.google.com/admob/answer/10113207?hl=ko

---

• Android 2) 로그 출력에서 아래의 기기 ID를 확인합니다. 이 식별자 문자열을 ADXConfiguration 객체 생성 시 사용하는 SetTestDevices 파라미터에 입력하고, SetGdprType 파라미터에는 POPUP_DEBUG를 입력하여 주십시오. Use new ConsentDebugSettings.Builder().addTestDeviceHashedId("33BE2250B43518CCDA7DE426D04EE231") to set this as a debug device.

---

• iOS 2) iOS 앱을 디바이스에 설치하면 아래와 같은 메시지가 Xcode 콘솔에 출력됩니다. 이 식별자 문자열을 ADXConfiguration 객체 생성 시 사용하는 SetTestDevices 파라미터에 입력하고, SetGdprType 파라미터에는 POPUP_DEBUG를 입력하여 주십시오.

---

<UMP GDPR 동의 화면>

Case 2. 직접 동의 여부 설정

유럽 경제 지역 (European Economic Area) 사용자가 없거나 앱 내에 회원가입이나 GDPR에서 정하는 개인정보에 준하는 정보를 수집하고 있으시다면 한국에서 푸시알림 동의, 개인정보처리방침에 대해 동의절차를 진행하는 것과 같이 따로 직접 동의 절차를 진행 및 처리해주셔야합니다.

• 유럽 경제 지역 (European Economic Area) 외 지역으로 동의 여부가 필요 없는 경우, ADXConfiguration에서 GdprType을 DIRECT_NOT_REQUIRED로 설정 하십시오.

iOS 경우,UMP에서 GDPR과 IDFA (Identifier for Advertisers)접근 권한에 관한 제어를 같이 처리하기 때문에,DIRECT_NOT_REQUIRED값으로 설정할 경우 IDFA 접근 권한까지 같이 획득할 수 없습니다. 이 경우 ATT (App Tracking Transparency) 동의 요청은, 프로그래밍 코드를 사용하여수동으로 ATT 동의 알림을 요청하십시오.

ADXConfiguration adxConfiguration = new ADXConfiguration.Builder()
                                .SetAppId("<ADX_APP_ID>")
                                .SetTestDevices(new List<string>() {"<TEST_DEVICE_ID>"})
                                .SetGdprType(GdprType.DIRECT_NOT_REQUIRED).Build();

AdxSDK.Initialize(adxConfiguration, adxConsentState => {
       Debug.Log(":::onADXConsentCompleted : " + adxConsentState);
});

2. ConsentState

GDPR 동의 여부에 대해 4개의 상태값을 가집니다.

상태	설명
0	동의 여부가 존재하지 않는 사용자로 호출 상태로 개인화 광고가 노출되지 않습니다.
1	동의 여부가 필요없는 지역 (EU 외 지역) 개인화 광고가 노출됩니다.
2	사용자가 개인정보 활용 및 수집을 거부한 상태 개인화 광고가 노출되지 않습니다.
3	사용자가 개인정보 활용 및 수집을 동의한 상태 개인화 광고가 노출됩니다.

동의 여부를 확인/변경 하시는 경우 ADXGDPRManager의 아래 함수를 사용하여 주시기 바랍니다.

// ADXGDPR에 설정된 사용자의 동의 정보를 확인하실 수 있습니다.
ADXGDPRManager.GetConsentState();

// 직접 동의 여부를 변경합니다.
ADXGDPRManager.SetConsentState(consentState);

3. GDPR 동의화면 재노출

GDPR 동의 화면을 사용자에게 재노출하여 동의 여부에 대한 상태 값을 변경할 수 있습니다.

AdxSDK.ShowGDPRForm((bool result) => {
    // GDPR 동의화면 재노출 결과 확인
});

• 버튼 클릭과 같은 사용자 입력 이벤트에 의해서만 위의 메소드를 호출 하십시오. 사용자 입력 이벤트 없이 호출할 경우 정상적으로 동작하지 않을 수 있습니다.

• 유럽 경제 지역 (European Economic Area) 지역이 아닐 경우, GDPR 동의 화면이 재노출 안 될 수도 있습니다.

• GDPR 동의 여부에 대한 정보가 이미 존재할 경우, 유럽 경제 지역 (European Economic Area) 지역이 아니더라도 GDPR 동의 화면이 노출될 수 있습니다.

• ADX Unity SDK 2.6.0 버전부터 지원됩니다.

4. Privacy Policy

AD(x)의 Privacy Policy 문서 URL은 ADXGDPRManager의 GetPrivacyPolicyURL()를 호출하여 사용하실 수 있습니다.

ADXGDPRManager.GetPrivacyPolicyURL();

5. 디버깅 로그 활성화

QA 진행 시 연동 및 미디에이션 정상 동작 확인을 위해 초기화 함수를 호출하기 전에 아래와 같이 추가되어야 합니다.

AdxSDK.SetLogEnable(true);

6. iOS App 일시정지 기능 (풀스크린 광고)

전면, 리워드 등 전체 화면에서 광고가 노출될 때 iOS 앱의 일시중지가 필요하다면 아래와 같이 추가해야 합니다.

해당 기능은 ADX Unity SDK 2.3.4 이상에서 사용 가능합니다.

AdxSDK.SetiOSAppPauseForFullScreenAd(true);

7. Android Main Thread 대응

안드로이드 단말에서 광고 콜백을 통해 리소스 접근시 메인쓰레드 관련 에러가 발생합니다.

can only be called from the main thread

이를 해결하기 위해서는 Update() 또는 AdxSDK.ExecuteMainThread() 를 사용하여 메인쓰레드 내에서 해당 로직을 처리해야 합니다.

해당 기능은 ADX Unity SDK 2.3.4 이상에서 사용 가능합니다.

AdxSDK.ExecuteMainThread(() => {
    // 메인쓰레드에서 처리 가능
});

8. 아동 대상 설정

COPPA에 따라 콘텐츠를 아동 대상으로 처리하도록 지정해야 하거나 유럽 경제 지역 (EEA)에 거주하는 동의 연령 미만의 사용자를 대상으로 하는 서비스의 경우 초기화 함수 호출하기 전에 애드몹의 타겟팅 설정을 해야 합니다. 자세한 내용은 애드몹 타겟팅(https://developers.google.com/admob/unity/targeting?hl=ko) 통해 확인 하실 수 있습니다.