# UMP (User Messaging Platform)

## 1. GDPR 메시지 작성

1\) 애드몹 대쉬보드 ([<mark style="color:blue;">https://apps.admob.com</mark>](https://apps.admob.com/))로 이동한 다음에 **아래 GDPR 메시지 작성 가이드 내용을 따라서 메시지 작성과 게시를 완료하십시오**.

{% hint style="info" %}
**GDPR 메시지 작성 가이드**\
[<mark style="color:blue;">https://support.google.com/admob/answer/10113207</mark>](https://support.google.com/admob/answer/10113207?hl=ko)

***

**GDPR 동의 메시지에 관한 상세 설명**\
[<mark style="color:blue;">https://support.google.com/adsense/topic/10924966</mark>](https://support.google.com/adsense/topic/10924966)
{% endhint %}

{% hint style="warning" %}
유럽 경제 지역 (European Economic Area)에서 애플리케이션을 서비스 할 계획이 없다면, "GDPR 메시지 작성" 단계는 무시 하십시오.
{% endhint %}

<figure><img src="/files/X6X0xALCdFbTmRPQwBQ0" alt=""><figcaption><p>&#x3C;애드몹 대쉬보드 - 개인 정보 보호 및 메시지 - GDPR></p></figcaption></figure>

{% hint style="danger" %}
**애드몹 대쉬보드에 등록된 앱이 "준비 중" 상태가 아니라면, GDPR 동의 화면이 나타나지 않을 수 있습니다.**

***

GPPR 동의 화면이 정상적으로 화면에 나타나는지 확인하려면 먼저 애드몹에 등록된 앱이 **"준비됨"** 상태이고, GDPR 메시지 작성 및 게시를 완료한 상태인지 확인 하십시오.

***

발급 받은 애드몹 APP ID를 사용하여 GDPR 화면을 테스트 할 경우, VPN 앱을 활용하여 유럽 경제 지역 (European Economic Area)으로 임시로 변경하면 테스트가 가능합니다.
{% endhint %}

<figure><img src="/files/zQzKRwtwecgY8ra0CIym" alt="" width="323"><figcaption></figcaption></figure>

2\) GDPR 메시지 사용 설정 완료 후, Android/iOS ADX SDK 또는 Unity SDK 초기화 단계에서 자동으로 GDPR 동의 화면이 노출이 필요하다고 판단되는 경우에만 화면에 표시됩니다.

<figure><img src="/files/E2MqMmmpOTmoUua08hO4" alt="" width="293"><figcaption><p>&#x3C;GDPR 동의 요청 화면></p></figcaption></figure>

## 2. IDFA 메시지 작성

{% hint style="danger" %}
IDFA 메시지 작성은 Android 는 해당되는 내용이 아니므로 무시하십시오.

***

**IDFA 메시지 작성은 선택사항이지만,&#x20;**<mark style="color:blue;">**GDPR 메시지 사용 설정을 할 경우, IDFA 메시지 작성도 같이 작성하십시오**</mark>**. 애드몹 UMP의 GDPR 동의 화면이 보이는 상태에서, 프로그래밍 방식으로&#x20;**<mark style="color:red;">**수동으로 ATT (APP Tracking Transparency) 동의 알림을 요청할 경우, 애플 앱 심사에서 거절될 수 있습니다**</mark>**.**

***

**IDFA 메시지 및 ATT 알림에 관한 상세 설명**\
[<mark style="color:blue;">https://support.google.com/admob/topic/10115531</mark>](https://support.google.com/admob/topic/10115531)
{% endhint %}

{% hint style="warning" %}
애드몹 UMP의 IDFA 메시지 설정을 사용하는 것을 권장하나, 만약 수동으로 ATT 동의 요청을 하려면 아래 링크를 참조 하십시오. <mark style="color:red;">**단, GDPR 메시지 사용 시 수동으로 프로그램 코딩을 통하여 ATT 동의 요청을 하지 마십시오.**</mark>

[App Tracking Transparency](/adx/ios/supporting-ios-14/app-tracking-transparency.md#idfa-identifier-for-a-dvertisers)
{% endhint %}

1\) iOS ADX SDK 또는 ADX Unity SDK **V2.5.0 미만 버전을 이미 사용하고 있는 경우, V2.5.0 이상 버전으로 통합 하려면 아래와 같은 관련 코드 제거 작업이 필요합니다. (신규로 도입하는 경우, 이 단계를 무시하고 다음 단계를 진행 하십시오)**

{% hint style="danger" %} <mark style="color:blue;">**프로그래밍 방식으로 "requestTrackingAuthorizationWithCompletionHandler:" 또는 "requestTrackingAuthorization(completionHandler:)" 메소드를 이용하여 ATT 동의를 요청하고 있다면,**</mark> <mark style="color:red;">**기존 코드는 모두 제거하여 주십시오.**</mark>
{% endhint %}

{% tabs %}
{% tab title="Objective-C (iOS)" %}

```objectivec
// 아래와 같은 ATT 동의 요청 코드를 사용하고 있다면, 모두 제거하여 주십시오.
[ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {
    if (status == ATTrackingManagerAuthorizationStatusAuthorized) {
        [FBAdSettings setAdvertiserTrackingEnabled:YES];
    } else {
        [FBAdSettings setAdvertiserTrackingEnabled:NO];
    }
}];
```

{% endtab %}

{% tab title="Swift (iOS)" %}

```swift
// 아래와 같은 ATT 동의 요청 코드를 사용하고 있다면, 모두 제거하여 주십시오. 
ATTrackingManager.requestTrackingAuthorization(completionHandler: { status in
    if (status == .authorized) {
        FBAdSettings.setAdvertiserTrackingEnabled(true)
    } else {
        FBAdSettings.setAdvertiserTrackingEnabled(false)
    }
})
```

{% endtab %}

{% tab title="C# (Unity)" %}

```objectivec
// UnityAppController.mm 파일 (Unity)

#import "UnityAppController.h"
#import <AppTrackingTransparency/AppTrackingTransparency.h>
#import <FBAudienceNetwork/FBAdSettings.h>

@implementation UnityAppController

// 아래와 같은 ATT 동의 요청 코드를 사용하고 있다면, 모두 제거하여 주십시오. 
- (void)requestIDFA {
    if (@available(iOS 14.5, *)) {
        // ATT 알림을 통한 권한 요청
        [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {
            if (status == ATTrackingManagerAuthorizationStatusAuthorized) {
                [FBAdSettings setAdvertiserTrackingEnabled:YES];
            } else {
                [FBAdSettings setAdvertiserTrackingEnabled:NO];
            }
        }];
    }
}

@end
```

{% endtab %}
{% endtabs %}

2\) 애드몹 대쉬보드 ([<mark style="color:blue;">https://apps.admob.com</mark>](https://apps.admob.com/))로 이동한 다음에 **아래 작성 가이드 내용을 따라서 IDFA 메시지를 작성하고 게시를 완료하십시오**.

{% hint style="info" %}
**IDFA 메시지 작성 가이드**\
[<mark style="color:blue;">https://support.google.com/admob/answer/10115331?hl=ko</mark>](https://support.google.com/admob/answer/10115331?hl=ko)

***

**IDFA 메시지에 관한 상세 설명**

[<mark style="color:blue;">https://support.google.com/admob/topic/10115531</mark>](https://support.google.com/admob/topic/10115531)
{% endhint %}

<figure><img src="/files/4sQ1DtxlHYNXvOmNIajv" alt=""><figcaption><p>&#x3C;애드몹 대쉬보드 - 개인 정보 보호 및 메시지 - IDFA></p></figcaption></figure>

3\) ATT (App Tracking Transparency) 동의 요청을 하려면 "**NSUserTrackingUsageDescription**" 키에 왜 사용하는지에 대한 설명을 키 값으로 반드시 추가되어야 합니다. 그렇지 않으면 비정상 종료 (Crash) 또는 ATT 동의 팝업 화면이 노출되지 않을 수 있습니다.

{% hint style="success" %}
Xcode 에서 수동으로 "**NSUserTrackingUsageDescription**" 키 값을 직접 추가할 수 있습니다. Unity를 사용하는 경우 Unity Editor에서 UMP 설정 값을 변경하고 빌드하면 자동으로 Xcode에 해당 키 값이 추가됩니다.
{% endhint %}

* Xcode > 키 값이 추가될 Target 선택 > "Info 탭" > "Privacy - Tracking Usage Description" 키 및 키 값 추가.

<figure><img src="/files/9FMlTqdB7TlStEC81B9r" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
\<key>**NSUserTrackingUsageDescription**\</key>\
\<string>This identifier will be used to deliver personalized ads to you.\</string>
{% endhint %}

* Unity Editor 경우, 상단 Assets 메뉴 > Google Mobile Ads > Settings ... > Inspector > "User Tracking Usage Description"에 설명 메시지 추가

<figure><img src="/files/Uq4nC3aIkAhvbzPIIUGZ" alt="" width="375"><figcaption></figcaption></figure>

4\) 이 단계까지 진행이 되었다면, iOS ADX SDK 또는 Unity SDK 초기화 단계에서 애드몹 UMP에서 자동으로 IDFA 설명 메시지 화면을 유저에게 표시하고, "계속" 버튼을 클릭하면 ATT 동의 알림 요청까지 진행됩니다.

<figure><img src="/files/pPexqcuQreA46Y4u7Oks" alt="" width="375"><figcaption><p>&#x3C;IDFA 설명 메시지 화면></p></figcaption></figure>

<figure><img src="/files/M96YfqdoqEHM4wpdXFgV" alt="" width="375"><figcaption><p>&#x3C;ATT 동의 요청 팝업 화면></p></figcaption></figure>

5\) 사용자의 ATT 동의 여부와 무관하게, 애플에서 공식으로 제공하는 광고 캠페인의 성공을 측정하기 위한 목적으로 [<mark style="color:blue;">SKAdNetwork</mark>](https://developer.apple.com/documentation/storekit/skadnetwork/) 를 도입하였습니다. SKAdNetwork 를 사용하기 위해서는 iOS 앱 프로젝트에 있는 `Info.plist` **파일에 광고 식별자 목록 정보를 추가하여 주십시오**.

{% hint style="info" %}
광고 네트워크에 지원되는 식별자 목록은 이 안내 문서의 [<mark style="color:blue;">SKAdNetwork ID List</mark>](/adx/ios/supporting-ios-14/skadnetwork-id-list.md) 에서 확인할 수 있습니다.
{% endhint %}

#### (예제)

```markup
<key>SKAdNetworkItems</key>
    <array>
        <dict>
            <key>SKAdNetworkIdentifier</key>
            <string>example100.skadnetwork</string>
        </dict>
        <dict>
            <key>SKAdNetworkIdentifier</key>
            <string>example200.skadnetwork</string>
        </dict>
    </array>
```

<figure><img src="/files/psPKPeh9vxdJDDQqPxm5" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://platform-business.gitbook.io/adx/appendix/ump-user-messaging-platform.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.