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

마지막 업데이트: 2023-05-21

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

파일 콘텐츠 구문

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

<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는 다음과 같을 수 있습니다.

  • 다음에 의해 할당된 고유 사용자 ID Audience Manager ( AUDIENCE MANAGER UUID ).
  • 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는 사용자 인터페이스에 표시된 ID와 동일합니다. API를 사용하여 트레이트 ID를 반환할 수도 있습니다 GET 메서드를 사용합니다. 다음을 참조하십시오 트레이트 API 메서드 .

d_unsid=

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

다음 d_unsid= 접두사는 시스템에 ID가 Audience Manager 트레이트 ID. 이 ID는 사용자 인터페이스에 표시된 ID와 동일합니다. API를 사용하여 트레이트 ID를 반환할 수도 있습니다 GET 메서드를 사용합니다. 다음을 참조하십시오 트레이트 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  d_sid=24,d_sid=26,d_sid=27,d_unsid=28,d_unsid=29

참고:

d_unsid를 사용하는 대신 다음 구문을 사용하여 사용자 프로필에서 트레이트를 제거할 수도 있습니다.

59767559181262060060278870901087098252 28:0, 29:0

59767559181262060060278870901087098252 28:-1, 29:-1

포함 ic==

이러한 트레이트는 를 사용하여 트레이트 규칙에 추가되었습니다. ic 접두사입니다. 따라서 표시된 대로 쉼표로 구분된 데이터 파일에 추가할 수 있습니다. 탭은 UUID와 트레이트 ID를 구분합니다. 다음 ic 파일에 접두사가 필요하지 않습니다.

숫자 ID

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1  30608,50354,50338,50352,30626

문자열 ID

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1  ic=52,ic=55

키-값 쌍 사용

이 파일 데이터는 키-값 쌍을 사용하여 데이터를에 전달합니다. Audience Manager .

59767559181262060060278870901087098252 “gender”=”female”,“luxury_shopper”=”yes”

다운로드 추가 예가 필요한 경우 샘플 데이터 파일입니다. 다운로드 파일에 .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 보내기 trait 자격 정보 Audience Manager UUIDs.

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

예제 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

예제 3

키-값 쌍으로 보내어 추가 trait 자격 정보 Audience Manager UUIDs.

59767559181262060060278870901087098252 <TAB> product = tablet, product = phone

또는

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

예제 4

사용 ic 전송할 접두사 trait 자격 정보 Audience Manager UUIDs.

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

또는

59767559181262060060278870901087098252 <TAB> ic=52,ic=55

예제 5

사용 trait IDs 보내기 trait 자격 정보 Android 디바이스.

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

예제 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

예제 7

키-값 쌍으로 보내어 추가 trait 자격 정보 Android 디바이스.

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

또는

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

예제 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

예제 9

사용 trait IDs 보내기 trait 자격 정보 iOS 디바이스.

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

예 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

예 11

키-값 쌍으로 보내어 추가 trait 자격 정보 iOS 디바이스.

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

또는

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

예 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

예 13

사용 trait IDs 보내기 trait 자격 정보 DPUUIDs.

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

예 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

예 15

키-값 쌍으로 보내어 추가 trait 자격 정보 DPUUIDs.

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone

또는

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

예 16

사용 ic 전송할 접두사 trait 자격 정보 DPUUIDs.

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

또는

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55

이 페이지에서는