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 ).
  • 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 메서드를 참조하십시오 .

특성 ID 서식 지정

다음 표에서는 인바운드 데이터 파일에서 특성 이름 또는 ID를 식별하는 접두사를 설명합니다. 예는 샘플 파일을 참조하십시오.
접두사 설명
d_sid=
d_sid 접두사는 ID가 Audience Manager 트레이트 ID임을 시스템에 알려줍니다 . 사용자 인터페이스에 표시되는 ID와 동일합니다. API GET 메서드로 트레이트 ID를 반환할 수도 있습니다. 트레이트 API 메서드를 참조하십시오 .
d_unsid=
데이터가 접두사로 추가되면 해당 트레이트에서 사용자가 d_unsid 제거됩니다. 접두사는 d_unsid overwrite 파일에서 무시됩니다.
d_unsid= 접두사는 ID가 Audience Manager 트레이트 ID임을 시스템에 알려줍니다 . 사용자 인터페이스에 표시되는 ID와 동일합니다. API GET 메서드로 트레이트 ID를 반환할 수도 있습니다. 트레이트 API 메서드를 참조하십시오 .
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 은 올바른 형식의 키-값 쌍의 모든 예입니다.

트레이트 ID, 사용자 ID 및 키-값 쌍의 잘못된 문자

특성 ID

트레이트 ID는 숫자 문자로만 구성됩니다. 인바운드 데이터 파일에 온보딩된 특성만 포함시켜 주시기 바랍니다. 인바운드 데이터 전송에서 다른 특성 유형은 처리하지 않습니다.

사용자 ID

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 유형 및 프로필에 트레이트를 추가할 방법에 따라 인바운드 파일의 형식을 올바르게 지정하는 방법의 예를 보여줍니다.
ID 유형/작업 d_sid를 사용하여 사용자 프로필에 트레이트 추가 사용자 프로필에서 트레이트를 제거하려면 d_unsid를 사용합니다. 키-값 쌍으로 전송하여 사용자 프로필에 트레이트 추가 Ic 접두사를 사용하여 사용자 프로필에 트레이트 추가
Audience Manager UUID
Android 장치용 Google 광고 ID
iOS 디바이스용 Apple IDFA
고유한 CRM ID(DPUUID)

Example 1

특성 ID를 사용하여 Audience Manager UUID에 대한 트레이트 자격 정보를 전송합니다.
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27

Example 2

특성 ID를 사용하여 Audience Manager UUID에 대한 트레이트 결격 정보를 전송합니다.
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

키-값 쌍을 전송하여 Audience Manager UUID에 대한 트레이트 자격 정보를 추가합니다.
59767559181262060060278870901087098252 <TAB> product = tablet, product = phone

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

Example 4

Audience Manager UUID에 대한 트레이트 자격 정보를 전송하려면 ic 접두사를 사용합니다.
59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626

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

Example 5

특성 ID를 사용하여 Android 장치에 대한 트레이트 자격 정보를 전송합니다.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26

Example 6

특성 ID를 사용하여 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

키-값 쌍을 전송하여 Android 장치에 대한 트레이트 자격 정보를 추가합니다.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> product = tablet, product = phone

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

Example 8

Android 장치에 대한 트레이트 자격 정보를 전송하려면 ic 접두사를 사용하십시오.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 30608,50354,50338,50352,30626

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

Example 9

특성 ID를 사용하여 iOS 장치에 대한 트레이트 자격 정보를 전송합니다.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26

Example 10

특성 ID를 사용하여 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

키-값 쌍을 전송하여 iOS 장치에 대한 트레이트 자격 정보를 추가합니다.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> product = tablet, product = phone

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

Example 12

iOS 장치에 대한 트레이트 자격 정보를 전송하려면 ic 접두사를 사용하십시오.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 30608,50354,50338,50352,30626

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

Example 13

특성 ID를 사용하여 DPUUID에 대한 트레이트 자격 정보를 전송합니다.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26

Example 14

특성 ID를 사용하여 DPUUID에 대한 트레이트 결격 정보를 전송합니다.
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

키-값 쌍을 전송하여 DPUUID에 대한 트레이트 자격 정보를 추가합니다.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone

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

Example 16

DPUUID에 대한 트레이트 자격 정보를 전송하려면 ic 접두사를 사용합니다.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626

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