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

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

파일 컨텐츠 구문

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

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

수락된 다른 파일 콘텐츠 형식에 대해서는 사용자 지정 파트너 통합을 참조하십시오.

노트

인바운드 데이터 파일에서 전송된 각 사용자 ID에 대해 처리할 수 있는 라인의 제한은 200개입니다. 예를 들어, 사용자 ID에 대해 300줄을 전송하는 경우 처음 200개 줄이 유지되고 추가 100개 줄이 삭제됩니다. 아래 예에는 사용자 ID 1 및 사용자 ID 2에 대해 각각 3행을 보내기 때문에 잘 있습니다. 행에 포함하는 트레이트 또는 키-값 쌍의 개수에 제한을 적용하지 않습니다.

<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 IDsAudience 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

Audience Manager UUIDs에 대한 trait 자격 정보를 보내려면 ic 접두사를 사용하십시오.

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

DPUUIDs에 대한 trait 자격 정보를 보내려면 trait IDs을 사용하십시오.

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

DPUUIDs에 대한 trait 자격 정보를 보내려면 ic 접두사를 사용하십시오.

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

또는

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55

이 페이지에서는