설명서Audience ManagerAudience Manager 튜토리얼

전역 장치 ID 유효성 검사 global-device-id-validation

Last update: Mon Aug 18 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 경험
  • 개발자

장치 Advertising 식별자(즉, iDFA, GAID, Roku ID)에는 디지털 광고 생태계에서 사용하기 위해 충족해야 하는 형식 표준이 있습니다. 현재 고객 및 파트너는 ID의 형식이 제대로 지정되었는지 여부에 대한 알림을 받지 않고도 모든 형식으로 글로벌 데이터 소스에 ID를 업로드할 수 있습니다. 이 기능을 사용하면 적절한 형식을 지정하기 위해 전역 데이터 소스로 전송된 장치 ID의 유효성을 검사하고 ID의 형식이 잘못되었을 때 오류 메시지를 제공합니다. 시작 시 iDFA, Google Advertising 및 Roku IDs에 대한 유효성 검사를 지원합니다.

형식 표준 개요 overview-of-format-standards

다음은 현재 AAM에서 인식하고 지원하는 글로벌 장치 Advertising ID 풀입니다. 이러한 데이터는 이러한 플랫폼의 사용자에 연결된 데이터로 작동하는 모든 고객 또는 데이터 파트너가 사용할 수 있는 공유 Data Sources​(으)로 구현됩니다.

플랫폼
AAM 데이터 Source ID
ID 형식
AAM PID
참고
Google Android (GAID)
20914
일반적으로 8-4-4-4-12 로 표시된 16진수 32개 예, 97987bca-ae59-4c7d-94ba-ee4f19ab8c21
1352
이 ID는 원시/해시되지 않은/변경되지 않은 양식 참조에서 수집해야 합니다. - https://play.google.com/about/monetization-ads/ads/ad-id/
Apple iOS (IDFA)
20915
일반적으로 8-4-4-4-12 로 표시되는 16진수 32개 예, 6D92078A-8246-4BA4-AE5B-76104861E7DC
3560
이 ID는 원시/해시되지 않은/변경되지 않은 양식 참조에서 수집해야 합니다. - https://support.apple.com/en-us/HT205223
Roku(RIDA)
121963
일반적으로 8-4-4-4-12 예, fcb2a29c-315a-5e6b-bcfd-d889ba19aada 로 표시되는 32개의 16진수
11536
이 ID는 원시/해시되지 않은/변경되지 않은 양식 참조에서 수집해야 합니다. - https://sdkdocs.roku.com/display/sdkdoc/Roku+Advertising+Framework
Microsoft Advertising ID (MAID)
389146
Alpha 숫자 문자열
14593
이 ID는 원시/해시되지 않은/변경되지 않은 양식 참조에서 수집해야 합니다. - https://docs.microsoft.com/en-us/uwp/api/windows.system.userprofile.advertisingmanager.advertisingid
https://msdn.microsoft.com/en-us/library/windows/apps/windows.system.userprofile.advertisingmanager.advertisingid.aspx
삼성 DUID
404660
Alpha 숫자 문자열 예, 7XCBNROQJQPYW
15950
이 ID는 원시/해시되지 않은/변경되지 않은 양식 참조에서 수집해야 합니다. - https://developer.samsung.com/tv/develop/api-references/samsung-product-api-references/productinfo-api

앱에서 Advertising 식별자 설정 setting-an-advertising-identifier-in-the-app

앱에서 광고주 ID를 설정하는 프로세스는 두 단계로, 먼저 광고주 ID를 검색한 다음 Experience Cloud으로 전송합니다. 이러한 단계를 수행하기 위한 링크는 아래에 있습니다.

  1. ID 검색

    1. Apple에 대한 advertising ID 정보를 여기에서 찾을 수 있습니다.
    2. advertiser ID 개발자를 위한 Android 설정에 대한 일부 정보는 여기에서 찾을 수 있습니다.

  2. SDK에서 setAdvertisingIdentifier 메서드를 사용하여 Experience Cloud으로 보냅니다.

    1. setAdvertisingIdentifier 사용에 대한 정보는 과(와)의 iOS설명서Android에 있습니다.

// iOS (Swift) example for using setAdvertisingIdentifier:
ACPCore.setAdvertisingIdentifier([AdvertisingId]) // ...where [AdvertisingId] is replaced by the actual advertising ID

잘못된 ID에 대한 DCS 오류 메시지 dcs-error-messaging-for-incorrect-ids

잘못된 글로벌 장치 ID(IDFA, GAID 등)가 실시간으로 Audience Manager에 제출되면 히트에서 오류 코드가 반환됩니다. 다음은 ID가 대문자만 포함해야 하는 Apple IDFA​(으)로 전송되었지만 ID에 소문자가 'x'인 경우 반환되는 오류의 예입니다.

오류 이미지

오류 코드 목록은 설명서를 참조하세요.

온보딩 글로벌 장치 ID onboarding-global-device-ids

전역 장치 ID를 실시간으로 제출하는 것 외에도 ID에 대해 "onboard"(업로드) 데이터를 사용할 수 있습니다. 이 프로세스는 고객 ID(일반적으로 키/값 쌍을 통해)에 대해 데이터를 온보딩할 때와 동일하지만 데이터가 글로벌 장치 ID에 할당되도록 적절한 데이터 Source ID를 사용하기만 하면 됩니다. 온보딩 프로세스에 대한 설명서는 설명서에서 찾을 수 있습니다. 사용 중인 플랫폼에 따라 글로벌 데이터 소스 ID를 사용해야 합니다.

온보딩 프로세스를 통해 잘못된 전역 장치 ID가 제출되면 Onboarding Status Report에 오류가 표시됩니다.

다음은 해당 보고서를 통해 발생할 수 있는 오류 샘플입니다.

오류 이미지

recommendation-more-help
468cbaa0-07ce-4354-9a38-4f23b645a466