Show Menu
화제×

인바운드 데이터 파일 내용: 구문, 잘못된 문자, 변수 및 예

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

파일 컨텐츠 구문

인바운드 데이터 파일의 필드는 아래에 표시된 순서대로 표시되어야 합니다. 이 예에서는 각 요소를 시각적으로 구분하는 데 도움이 되도록 < > 기호가 추가되었습니다. 데이터 파일에 포함할 필요는 없습니다.
<user ID><TAB><trait ID>,<trait ID>,<trait ID>,...

허용된 기타 파일 컨텐츠 포맷에 대해서는 사용자 지정 파트너 통합을 참조하십시오 .
인바운드 데이터 파일에서 전송된 각 사용자 ID에 대해 처리할 수 있는 줄이 200개로 제한됩니다. 예를 들어 사용자 ID에 대해 300개의 줄을 전송하는 경우 처음 200개의 줄이 유지되고 추가 100개의 줄이 무시됩니다. 아래 예에서, 사용자 ID 1 및 사용자 ID 2에 대해 각각 3개의 줄을 전송하므로 유용합니다. Adobe에서는 한 줄에 포함되는 특성 또는 키-값 쌍의 수에 제한을 두지 않습니다.
<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 ID
사용자 ID는 다음과 같습니다.
  • Audience Manager에 의해 할당된 고유 사용자 ID ( Audience Manager UUID ID의 색인 Audience Manager ).
  • CRM 시스템에 할당된 고유 사용자 ID( Audience Manager의 DPUUID ).
  • 모바일 운영 체제에서 노출되는 대로 원본 수정되지 않은 형식의 모바일 Android 또는 iOS 장치 ID.
모바일 ID의 경우:
  • IDFA 형식: ID는 대문자여야 하며 해시해서는 안 됩니다. 예, 6D92078A-8246-4BA4-AE5B-76104861E7DC
  • Android 형식: ID는 소문자여야 하며 해시해서는 안 됩니다. 예, 97987bca-ae59-4c7d-94ba-ee4f19ab8c21
TAB
단일 탭 구분 기호로 사용자 ID와 특성 ID를 구분합니다.
trait ID
Audience Manager 특성 ID. 인바운드 데이터 파일에 온보딩된 특성만 포함시키십시오. 인바운드 데이터 전송에서 다른 특성 유형은 처리하지 않습니다.
참고: 트레이트 ID는 모든 트레이트에 대한 세부 사항을 반환하는 GET 메서드를 사용하여 찾을 수 있습니다. 자세한 내용은 특성 API 메서드를 참조하십시오 .

서식 Trait IDs

다음 표에서는 인바운드 데이터 파일에서 이름 또는 ID를 식별하는 trait 접두사를 설명합니다. 예제는 샘플 파일을 참조하십시오.
접두사 설명
d_sid=
접두사는 시스템 d_sid 에 ID가 Audience Manager 특성 ID임을 알려줍니다. 사용자 인터페이스에 표시되는 ID와 동일합니다. API 메서드로 특성 ID를 반환할 수도 GET 있습니다. See Trait API Methods .
d_unsid=
데이터가 접두사로 d_unsid 추가되면 해당 트레이트에서 사용자가 제거됩니다. 파일 d_unsid 에서 접두사가 overwrite 무시됩니다.
접두사는 시스템 d_unsid= 에 ID가 Audience Manager 특성 ID임을 알려줍니다. 사용자 인터페이스에 표시되는 ID와 동일합니다. API 메서드로 특성 ID를 반환할 수도 GET 있습니다. See Trait API Methods .
ic=
트레이트 규칙을 사용하여 트레이트 자격에 대한 기준을 설정할 수 있습니다. 특성 규칙의 형식을 지정하는 경우 간단한 쉼표 형식 목록 ic == trait ID 으로 트레이트를 보낼 수 있습니다.
예를 들어 다음과 같은 세 가지 특성 규칙을 만든다고 가정해 봅시다.
  • 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 키-값 쌍

Trait IDs

Trait IDs 숫자 문자로만 구성됩니다. 인바운드 데이터 파일 에만onboarded traits ​포함시켜 주시기 바랍니다. 인바운드 데이터 전송에서 다른trait유형은 처리하지 않습니다.

User IDs

ID 유형 요구 사항
DPUUID
인코딩된 콜론() 또는 인코딩되지 않은 콜론( %3A :)을 사용하지 마십시오. ) 기호를 DPUUID에 넣습니다.
모바일 iOS(IDFA) 또는 Android 장치 ID
모바일 장치 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 )를 사용하지 마십시오.

데이터 파일 예제

데이터 파일 형식 설명 및 예
사용 d_sid 또는 d_unsid
이 데이터 파일은 트레이트 24, 26, 27에 자격이 있는 사용자를 보여주며 트레이트 28 및 29에서 제거되었습니다.
59767559181262060060278870901087098252&nbsp;&nbsp;d_sid=24,d_sid=26,d_sid=27,d_unsid=28,d_unsid=29
참고:
d_unsid를 사용하는 대신 다음 구문을 사용하여 사용자 프로필에서 트레이트를 제거할 수도 있습니다.
59767559181262060060278870901087098252&nbsp;28:0,&nbsp;29:0
59767559181262060060278870901087098252&nbsp;28:-1,&nbsp;29:-1
포함 ic==
이러한 트레이트는 접두사가 있는 트레이트 규칙에 ic 추가되었습니다. 이와 같이 쉼표로 구분하여 데이터 파일에 추가할 수 있습니다. 탭은 UUID와 특성 ID를 구분합니다. 파일에 ic 접두사가 필요하지 않습니다.
숫자 ID
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1&nbsp;&nbsp;30608,50354,50338,50352,30626
문자열 ID
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1&nbsp;&nbsp;ic=52,ic=55
키-값 쌍 사용
이 파일 데이터는 키-값 쌍을 사용하여 데이터를 Audience Manager에 전달합니다 .
59767559181262060060278870901087098252&nbsp;“gender”=”female”,“luxury_shopper”=”yes”
추가 예제가 필요한 경우 샘플 데이터 파일을 다운로드합니다 . 다운로드 파일의 확장자는 .overwrite 파일입니다. 간단한 텍스트 편집기로 열 수 있습니다.

예제 매트릭스

아래 차트에는 ID 유형 및 프로필에 추가하고자 하는 방법에 따라 인바운드 파일의 형식을 지정하는 올바른 방법에 대한 예 traits 가 나와 있습니다.
ID 유형/작업 d_sid를 사용하여 사용자 프로필에 트레이트 추가 사용자 프로필에서 트레이트를 제거하려면 d_unsid를 사용합니다. 키-값 쌍으로 전송하여 사용자 프로필에 트레이트 추가 사용자 프로필에 트레이트를 추가하려면 ic 접두사를 사용하십시오.
Audience Manager UUID
Android 장치용 Google 광고 ID
iOS 디바이스용 Apple IDFA
자신의 CRM ID(DPUUID)

Example 1

을 trait IDs 사용하여 자격 trait 정보를 Audience Manager UUIDs전송합니다.
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27

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

Example 3

키-값 쌍으로 보내 trait 자격 정보를 추가합니다 UUIDs.
59767559181262060060278870901087098252 <TAB> product = tablet, product = phone

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

Example 4

접두사를 ic 사용하여 자격 trait 정보를 Audience Manager UUIDs전송합니다.
59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626

또는
59767559181262060060278870901087098252 <TAB> ic=52,ic=55

Example 5

장치 trait IDs 에 대한 trait 자격 정보를 보내는 데 Android 사용합니다.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26

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

Example 7

키-값 쌍으로 전송하여 장치의 trait 자격 정보를 Android 추가합니다.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> product = tablet, product = phone

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

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

Example 9

장치 trait IDs 에 대한 trait 자격 정보를 보내는 데 iOS 사용합니다.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26

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

Example 11

키-값 쌍으로 전송하여 장치의 trait 자격 정보를 iOS 추가합니다.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> product = tablet, product = phone

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

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

Example 13

를 trait IDs 사용하여 자격 trait 정보를 보낼 수 DPUUIDs있습니다.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26

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

Example 15

키-값 쌍으로 보내 trait 자격 정보를 추가합니다 DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone

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

Example 16

접두사를 ic 사용하여 자격 trait 정보를 보낼 수 DPUUIDs있습니다.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626

또는
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55