인바운드 데이터 파일 내용: 구문, 잘못된 문자, 변수 및 예 inbound-data-file-contents-syntax-invalid-characters-variables-and-examples
인바운드 트레이트 데이터 파일의 형식을 지정할 때 따라야 하는 필수 필드, 구문 및 규칙입니다.
파일 콘텐츠 구문 file-content-syntax
인바운드 데이터 파일의 필드는 아래에 표시된 순서로 표시되어야 합니다. 이 예제에서는 각 요소를 시각적으로 구분할 수 있도록 <
>
기호를 추가했습니다. 데이터 파일에 이러한 매개 변수를 포함할 필요가 없습니다.
<user ID><TAB><trait ID>,<trait ID>,<trait ID>,...
허용되는 다른 파일 콘텐츠 형식은 사용자 지정 파트너 통합을 참조하십시오.
code language-none |
---|
|
정의된 파일 변수 file-variables-defined
이 표에는 올바른 형식의 인바운드 데이터 파일에 사용된 변수가 나열되고 정의됩니다. 기울임꼴 은 변수 자리 표시자를 나타냅니다.
User ID
사용자 ID는 다음과 같을 수 있습니다.
- Audience Manager 이(가) 할당한 고유 사용자 ID( Audience Manager UUID).
- CRM 시스템에 할당된 고유한 사용자 ID입니다( Audience Manager의 DPUUID). - 모바일 운영 체제에 의해 노출된 원래의 수정되지 않은 형식의 모바일 Android 또는 iOS 장치 ID입니다.
TAB
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
인 데이터는 해당 트레이트에서 사용자를 제거합니다. overwrite
파일에서 d_unsid
접두사가 무시됩니다.
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
%3A
) 또는 인코딩되지 않은 콜론( :) 기호를 사용하지 마십시오.모바일 장치 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을(를) 추가할 방법에 따라 인바운드 파일의 형식을 지정하는 올바른 방법의 예를 보여 줍니다.
예제 1 example-1
trait IDs을(를) 사용하여 Audience Manager UUIDs에 대한 trait 자격 정보를 보냅니다.
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27
예제 2 example-2
trait IDs을(를) 사용하여 Audience Manager UUIDs에 대한 trait 자격 박탈 정보를 보냅니다.
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
키-값 쌍을 전송하여 Audience Manager UUIDs에 대한 trait 자격 정보를 추가하십시오.
59767559181262060060278870901087098252 <TAB> product = tablet, product = phone
또는
59767559181262060060278870901087098252 <TAB> "product" = "tablet", "product" = "phone"
예제 4 example-4
ic
접두사를 사용하여 Audience Manager UUIDs에 대한 trait 자격 정보를 보냅니다.
59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626
또는
59767559181262060060278870901087098252 <TAB> ic=52,ic=55
예제 5 example-5
trait IDs을(를) 사용하여 Android개 장치에 대한 trait 자격 정보를 보냅니다.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26
예제 6 example-6
trait IDs을(를) 사용하여 Android개의 장치에 대한 trait개의 자격 박탈 정보를 보냅니다.
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
Android 장치에 대한 trait 자격 정보를 추가하려면 키-값 쌍을 보냅니다.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> product = tablet, product = phone
또는
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> "product" = "tablet", "product" = "phone"
예제 8 example-8
ic
접두사를 사용하여 Android개 장치에 대한 trait 자격 정보를 보냅니다.
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을(를) 사용하여 iOS개 장치에 대한 trait 자격 정보를 보냅니다.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26
예 10 example-10
trait IDs을(를) 사용하여 iOS개의 장치에 대한 trait개의 자격 박탈 정보를 보냅니다.
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
iOS 장치에 대한 trait 자격 정보를 추가하려면 키-값 쌍을 보냅니다.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> product = tablet, product = phone
또는
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> "product" = "tablet", "product" = "phone"
예 12 example-12
ic
접두사를 사용하여 iOS개 장치에 대한 trait 자격 정보를 보냅니다.
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을(를) 사용하여 DPUUIDs에 대한 trait 자격 정보를 보냅니다.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26
예 14 example-14
trait IDs을(를) 사용하여 DPUUIDs에 대한 trait개의 결격 정보를 보냅니다.
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
키-값 쌍을 보내 DPUUIDs에 대한 trait 자격 정보를 추가하십시오.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone
또는
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> "product" = "tablet", "product" = "phone"
예 16 example-16
ic
접두사를 사용하여 DPUUIDs에 대한 trait 자격 정보를 보냅니다.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626
또는
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55