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

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

파일 내용 구문

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

<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 ( Audience Manager UUID )에 의해 할당된 고유 사용자 ID.
  • 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 서식 지정

다음 표에서는 인바운드 데이터 파일에서 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 으로 지정하는 경우 간단한 쉼표 형식의 목록으로 트레이트를 보낼 수 있습니다.

예를 들어 다음과 같은 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 및 키-값 쌍에 잘못된 문자가 있습니다.

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"

예 5

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

이 페이지에서는

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now