설명서 Audience Manager Audience Manager 사용 안내서

인바운드 데이터 파일 내용: 구문, 잘못된 문자, 변수 및 예 inbound-data-file-contents-syntax-invalid-characters-variables-and-examples

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

주제:

인바운드 트레이트 데이터 파일의 형식을 지정할 때 따라야 하는 필수 필드, 구문 및 규칙입니다.

파일 콘텐츠 구문 file-content-syntax

인바운드 데이터 파일의 필드는 아래에 표시된 순서로 표시되어야 합니다. 이 예제에서는 각 요소를 시각적으로 구분할 수 있도록 < > 기호를 추가했습니다. 데이터 파일에 이러한 매개 변수를 포함할 필요가 없습니다.

<user ID><TAB><trait ID>,<trait ID>,<trait ID>,...

허용되는 다른 파일 콘텐츠 형식은 사용자 지정 파트너 통합을 참조하십시오.

NOTE

인바운드 데이터 파일에서 전송된 각 사용자 ID에 대해 처리할 수 있는 라인은 200개로 제한됩니다. 예를 들어 사용자 ID로 300줄을 전송하는 경우 처음 200줄은 유지되고 추가 100줄은 무시됩니다. 아래 예에서는 사용자 ID 1과 사용자 ID 2에 대해 각각 3줄을 보내므로 문제가 없습니다. 행에 포함하는 트레이트 또는 키-값 쌍의 수에 대한 제한은 적용되지 않습니다.

code language-none

code language-none
`<user ID1><TAB><trait ID>,<trait ID>,<trait ID> <user ID1><TAB><trait ID>,<trait ID>,<trait ID> <user ID1><TAB><trait ID>,<trait ID>,<trait ID> <user ID2><TAB><trait ID>,<trait ID>,<trait ID> <user ID2><TAB><trait ID>,<trait ID>,<trait ID> <user ID2><TAB><trait ID>,<trait ID>,<trait ID>`

<user ID1><TAB><trait ID>,<trait ID>,<trait ID>
<user ID1><TAB><trait ID>,<trait ID>,<trait ID>
<user ID1><TAB><trait ID>,<trait ID>,<trait ID>
<user ID2><TAB><trait ID>,<trait ID>,<trait ID>
<user ID2><TAB><trait ID>,<trait ID>,<trait ID>
<user ID2><TAB><trait ID>,<trait ID>,<trait ID>

정의된 파일 변수 file-variables-defined

이 표에는 올바른 형식의 인바운드 데이터 파일에 사용된 변수가 나열되고 정의됩니다. 기울임꼴 은 변수 자리 표시자를 나타냅니다.

변수

설명

User ID

사용자 ID는 다음과 같을 수 있습니다.

Audience Manager 이(가) 할당한 고유 사용자 ID( Audience Manager UUID).
CRM 시스템에 할당된 고유 사용자 ID( DPUUID, Audience Manager)입니다.
모바일 운영 체제에 의해 노출된 원래의 수정되지 않은 형식의 모바일 Android 또는 iOS 장치 ID입니다.

모바일 ID:

IDFA 형식: ID는 대/소문자여야 하며 해시되지 않아야 합니다. For example, 6D92078A-8246-4BA4-AE5B-76104861E7DC
Android 형식: ID는 소문자여야 하며 해시되지 않아야 합니다. For example, 97987bca-ae59-4c7d-94ba-ee4f19ab8c21

TAB

사용자 ID와 트레이트 ID는 단일 탭 구분 기호로 구분합니다.

trait ID

Audience Manager 트레이트 ID. 인바운드 데이터 파일에 온보딩된 트레이트만 을(를) 포함하도록 요청합니다. 인바운드 데이터 전송에서 다른 트레이트 유형은 처리하지 않습니다.

참고: 트레이트 ID는 모든 트레이트에 대한 세부 사항을 반환하는 GET 메서드를 사용하여 찾을 수 있습니다. 자세한 내용은 트레이트 API 메서드을(를) 참조하십시오.

Trait IDs 서식 지정 formatting-trait-ids

다음 표에서는 인바운드 데이터 파일에서 trait 이름 또는 ID를 식별하는 접두사에 대해 설명합니다. 예제는 샘플 파일을 참조하세요.

접두사

설명

d_sid=

d_sid 접두사는 ID가 Audience Manager 트레이트 ID임을 시스템에 알려줍니다. 이 ID는 사용자 인터페이스에 표시된 ID와 동일합니다. API GET 메서드로 트레이트 ID를 반환할 수도 있습니다. 트레이트 API 메서드을(를) 참조하십시오.

d_unsid=

접두사가 d_unsid 인 데이터는 해당 트레이트에서 사용자를 제거합니다. d_unsid 파일에서 overwrite 접두사가 무시됩니다.

d_unsid= 접두사는 ID가 Audience Manager 트레이트 ID임을 시스템에 알려줍니다. 이 ID는 사용자 인터페이스에 표시된 ID와 동일합니다. API GET 메서드로 트레이트 ID를 반환할 수도 있습니다. 트레이트 API 메서드을(를) 참조하십시오.

ic=

트레이트 규칙을(를) 사용하면 트레이트 자격에 대한 기준을 설정할 수 있습니다. 트레이트 규칙의 서식을 ic == trait ID (으)로 지정하면 간단한 쉼표로 서식 지정된 목록으로 트레이트를 보낼 수 있습니다.

예를 들어 다음 3가지 트레이트 규칙을 만든다고 가정합니다.

ic == "123"
ic == "456"
ic == "789"

이러한 트레이트는 ic 키와 연결되어 있습니다. 이렇게 하면 데이터 파일에서 더 간단한 트레이트 목록을 만들 수 있습니다. ic 접두사를 포함할 필요가 없습니다. 따라서 데이터 파일의 내용은 다음과 같습니다.

user ID <TAB> 123,456,789

키-값 쌍

특성 데이터는 영숫자 문자열을 사용하여 키-값 쌍으로 형식을 지정할 수 있습니다. 아래와 같이 키-값 쌍의 서식을 지정하는 방법에는 여러 가지가 있습니다.

key = value
"key" = value
key = "value"
"key" = "value"

"age"="32" , "gender"=m , model = "pickup truck" , product = tablet 은(는) 모두 올바른 형식의 키-값 쌍의 예입니다.

Trait IDs, User IDs 및 키-값 쌍에 잘못된 문자가 있습니다. invalid-chars

Trait IDs

Trait IDs은(는) 숫자 문자로만 구성됩니다. 인바운드 데이터 파일에 만onboarded traits 을(를) 포함하도록 요청합니다. 인바운드 데이터 전송에서 다른 trait 유형은 처리하지 않습니다.

User IDs

ID 유형

요구 사항

DPUUID

DPUUID에 인코딩된 콜론() 또는 인코딩되지 않은 콜론( :) 기호를 사용하지 마십시오 %3A .

Mobile iOS(IDFA) 또는 Android 장치 ID

모바일 장치 ID는 다음과 같이 엄격하게 형식화해야 합니다.

IDFA 형식: ID는 대/소문자여야 하며 해시되지 않아야 합니다. For example, 6D92078A-8246-4BA4-AE5B-76104861E7DC
Android 형식: ID는 소문자여야 하며 해시되지 않아야 합니다. For example, 97987bca-ae59-4c7d-94ba-ee4f19ab8c21

키-값 쌍

키-값 쌍에서 값 이름의 형식이 잘못되어도 문제가 발생합니다. 키-값 쌍에서 값을 만들거나 이름을 지정할 때 다음 규칙을 따르십시오.

문자

요구 사항

따옴표 문자(")

키와 키-값 쌍의 값 부분에서 다음과 같이 따옴표 문자를 사용할 수 있습니다.

d_city = "New York", d_city = "San Francisco"
"d_city" = "New York", "d_city" = "San Francisco"

대시 문자(-)

우리는 키의 시작 부분에서 대시 기호는 무시한다. 예를 들어 -product = camera 은(는) product = camera (으)로 해석됩니다.

TAB

키-값 쌍에 빈 값 대신 을(를) 사용하지 마십시오 TAB . TAB 만 사용하여 인바운드 데이터 파일에서 변수를 구분하십시오.

\n, \t

키 또는 값에 새 줄 또는 탭 문자( \n, \t )를 사용하지 마십시오.

데이터 파일 예 data-file-examples

데이터 파일 형식

설명 및 예제

d_sid 또는 d_unsid 사용

이 데이터 파일은 트레이트 24, 26, 27에 대한 자격이 있는 사용자를 나타내며 트레이트 28 및 29에서 제거되었습니다.

59767559181262060060278870901087098252 d_sid=24,d_sid=26,d_sid=27,d_unsid=28,d_unsid=29

참고:

d_unsid를 사용하는 대신 다음 구문을 사용하여 사용자 프로필에서 트레이트를 제거할 수도 있습니다.

59767559181262060060278870901087098252 28:0, 29:0

59767559181262060060278870901087098252 28:-1, 29:-1

ic== 사용

이러한 트레이트는 ic 접두사가 있는 트레이트 규칙에 추가되었습니다. 따라서 표시된 대로 쉼표로 구분된 데이터 파일에 추가할 수 있습니다. 탭은 UUID와 트레이트 ID를 구분합니다. ic 접두사는 파일에 필요하지 않습니다.

숫자 ID

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 30608,50354,50338,50352,30626

문자열 ID

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 ic=52,ic=55

키-값 쌍 사용

이 파일 데이터는 키-값 쌍을 사용하여 Audience Manager 에 데이터를 전달합니다.

59767559181262060060278870901087098252 “gender”=”female”,“luxury_shopper”=”yes”

추가 예제가 필요한 경우 샘플 데이터 파일을 다운로드합니다. 다운로드 파일의 파일 확장명은 .overwrite입니다. 간단한 텍스트 편집기로 열 수 있습니다.

예제 매트릭스 examples-matrix

아래 차트는 ID 유형 및 프로필에 traits을(를) 추가할 방법에 따라 인바운드 파일의 형식을 지정하는 올바른 방법의 예를 보여 줍니다.

ID 유형/작업

d_sid를 사용하여 사용자 프로필에 트레이트를 추가합니다.

d_unsid를 사용하여 사용자 프로필에서 트레이트를 제거합니다.

키-값 쌍을 전송하여 사용자 프로필에 트레이트를 추가합니다.

ic 접두사를 사용하여 사용자 프로필에 트레이트 추가

AUDIENCE MANAGER UUID

Android 장치용 Google Advertising ID

iOS 디바이스용 Apple IDFA

고유한 CRM ID(DPUUID)

예제 1 example-1

trait IDs을(를) 사용하여 trait Audience Manager에 대한 UUIDs 자격 정보를 보냅니다.

59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27

예제 2 example-2

trait IDs을(를) 사용하여 trait Audience Manager에 대한 UUIDs 자격 박탈 정보를 보냅니다.

59767559181262060060278870901087098252 <TAB> d_unsid=24, d_unsid=26, d_unsid=27

또는

59767559181262060060278870901087098252 <TAB> 24:0, 26:0, 27:0

또는

59767559181262060060278870901087098252 <TAB> 24:-1, 26:-1, 27:-1

예제 3 example-3

키-값 쌍을 전송하여 trait Audience Manager에 대한 UUIDs 자격 정보를 추가하십시오.

59767559181262060060278870901087098252 <TAB> product = tablet, product = phone

또는

59767559181262060060278870901087098252 <TAB> "product" = "tablet", "product" = "phone"

예제 4 example-4

ic 접두사를 사용하여 trait Audience Manager에 대한 UUIDs 자격 정보를 보냅니다.

59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626

또는

59767559181262060060278870901087098252 <TAB> ic=52,ic=55

예제 5 example-5

trait IDs을(를) 사용하여 trait개 장치에 대한 Android 자격 정보를 보냅니다.

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26

예제 6 example-6

trait IDs을(를) 사용하여 trait개의 장치에 대한 Android개의 자격 박탈 정보를 보냅니다.

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_unsid=24, d_unsid=25, d_unsid=26

또는

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 24:0, 26:0, 27:0

또는

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 24:-1, 26:-1, 27:-1

예제 7 example-7

trait 장치에 대한 Android 자격 정보를 추가하려면 키-값 쌍을 보냅니다.

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> product = tablet, product = phone

또는

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> "product" = "tablet", "product" = "phone"

예제 8 example-8

ic 접두사를 사용하여 trait개 장치에 대한 Android 자격 정보를 보냅니다.

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 30608,50354,50338,50352,30626

또는

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> ic=52,ic=55

예제 9 example-9

trait IDs을(를) 사용하여 trait개 장치에 대한 iOS 자격 정보를 보냅니다.

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26

예 10 example-10

trait IDs을(를) 사용하여 trait개의 장치에 대한 iOS개의 자격 박탈 정보를 보냅니다.

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_unsid=24, d_unsid=25, d_unsid=26

또는

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 24:0, 26:0, 27:0

또는

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 24:-1, 26:-1, 27:-1

예 11 example-11

trait 장치에 대한 iOS 자격 정보를 추가하려면 키-값 쌍을 보냅니다.

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> product = tablet, product = phone

또는

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> "product" = "tablet", "product" = "phone"

예 12 example-12

ic 접두사를 사용하여 trait개 장치에 대한 iOS 자격 정보를 보냅니다.

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 30608,50354,50338,50352,30626

또는

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> ic=52,ic=55

예 13 example-13

trait IDs을(를) 사용하여 trait에 대한 DPUUIDs 자격 정보를 보냅니다.

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26

예 14 example-14

trait IDs을(를) 사용하여 trait에 대한 DPUUIDs개의 결격 정보를 보냅니다.

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_unsid=24, d_unsid=25, d_unsid=26

또는

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 24:0, 26:0, 27:0

또는

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 24:-1, 26:-1, 27:-1

예 15 example-15

키-값 쌍을 보내 trait에 대한 DPUUIDs 자격 정보를 추가하십시오.

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone

또는

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> "product" = "tablet", "product" = "phone"

예 16 example-16

ic 접두사를 사용하여 trait에 대한 DPUUIDs 자격 정보를 보냅니다.

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626

또는

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55

recommendation-more-help

de293fbf-b489-49b0-8daa-51ed303af695