인바운드 데이터 파일 내용: 구문, 잘못된 문자, 변수 및 예 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는 다음과 같을 수 있습니다.
- 다음에 의해 할당된 고유 사용자 ID Audience Manager ( AUDIENCE MANAGER UUID).
- CRM 시스템에 할당된 고유 사용자 ID( DPUUID, Audience Manager).
- 모바일 운영 체제에 의해 노출된 원래의 수정되지 않은 형식의 모바일 Android 또는 iOS 장치 ID입니다.
모바일 ID:
- IDFA 형식: ID는 대/소문자여야 하며 해시되지 않아야 합니다. 예,
6D92078A-8246-4BA4-AE5B-76104861E7DC
- Android 포맷: ID는 소문자여야 하며 해시되지 않아야 합니다. 예,
97987bca-ae59-4c7d-94ba-ee4f19ab8c21
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를 사용하여 트레이트 ID를 반환할 수도 있습니다 GET
메서드를 사용합니다. 다음을 참조하십시오 트레이트 API 메서드.d_unsid=
접두사가 있는 데이터 d_unsid
는 해당 트레이트에서 사용자를 제거합니다. 다음 d_unsid
접두사가 다음에서 무시됩니다. overwrite
파일.
다음 d_unsid=
접두사는 시스템에 ID가 Audience Manager 트레이트 ID. 이 ID는 사용자 인터페이스에 표시된 ID와 동일합니다. API를 사용하여 트레이트 ID를 반환할 수도 있습니다 GET
메서드를 사용합니다. 다음을 참조하십시오 트레이트 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
) 또는 DPUUID의 인코딩되지 않은 콜론( : ) 기호.모바일 장치 ID는 다음과 같이 엄격하게 형식화해야 합니다.
- IDFA 형식: ID는 대/소문자여야 하며 해시되지 않아야 합니다. 예,
6D92078A-8246-4BA4-AE5B-76104861E7DC
- Android 포맷: ID는 소문자여야 하며 해시되지 않아야 합니다. 예,
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 보내기 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