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

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

파일 내용 구문

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

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

허용되는 다른 파일 내용 포맷은 사용자 지정 파트너 통합을 참조하십시오.

NOTE

인바운드 데이터 파일에서 전송된 각 사용자 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 ( Audience Manager UUID )에 의해 할당된 고유 사용자 ID.
  • CRM 시스템에 할당된 고유 사용자 ID( DPUUID, Audience Manager )입니다.
  • 모바일 운영 체제에서 노출되는 대로 원본 수정되지 않은 형식의 모바일 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서식 지정

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

접두사 설명

d_sid=

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

d_unsid=

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

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 are all examples of correct formatted key-value pair.

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”

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

예제 매트릭스

아래 차트에는 ID의 유형과 프로필에 traits를 추가하고자 하는 방법에 따라 인바운드 파일의 형식을 지정하는 올바른 방법의 예가 나와 있습니다.

ID 유형/작업 d_sid를 사용하여 사용자 프로필에 트레이트 추가 사용자 프로필에서 트레이트를 제거하려면 d_unsid를 사용합니다. 키-값 쌍으로 전송하여 사용자 프로필에 트레이트 추가 사용자 프로필에 트레이트를 추가하려면 ic 접두사를 사용하십시오.

Audience Manager UUID

예제 1

예제 2

예제 3

예제 4

Android 장치용 Google 광고 ID

예제 5

예제 6

예제 7

예제 8

iOS 디바이스용 Apple IDFA

예제 9

예 10

예 11

예 12

자신의 CRM ID(DPUUID)

예 13

예 14

예제 15

예 16

예 1

trait IDs을(를) 사용하여 Audience Manager UUIDs의 자격 정보를 전송합니다.trait

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

예 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

Audience Manager UUIDs에 대한 자격 정보를 추가하려면 키-값 쌍을 전송합니다.trait

59767559181262060060278870901087098252 <TAB> product = tablet, product = phone

또는

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

예 4

ic 접두사를 사용하여 Audience Manager UUIDs의 자격 정보를 전송합니다.trait

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

또는

59767559181262060060278870901087098252 <TAB> ic=52,ic=55

예 5

trait IDs을(를) 사용하여 Android 장치의 자격 정보를 전송합니다.trait

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

예 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

키-값 쌍을 전송하여 Android 장치의 자격 정보를 추가합니다.trait

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

또는

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

예 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

trait IDs을(를) 사용하여 iOS 장치의 자격 정보를 전송합니다.trait

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

예 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

키-값 쌍을 전송하여 iOS 장치의 자격 정보를 추가합니다.trait

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

또는

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

예 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

trait IDs을(를) 사용하여 DPUUIDs의 자격 정보를 전송합니다.trait

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

예 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

DPUUIDs에 대한 자격 정보를 추가하려면 키-값 쌍을 전송합니다.trait

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone

또는

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

예 16

ic 접두사를 사용하여 DPUUIDs의 자격 정보를 전송합니다.trait

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

또는

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55

이 페이지에서는