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

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

파일 컨텐츠 구문

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

<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

다음 표는 URL을 식별하는 접두사를 설명합니다 trait 인바운드 데이터 파일의 이름 또는 ID입니다. 자세한 내용은 샘플 파일 예.

접두사 설명

d_sid=

다음 d_sid 접두사는 시스템에 ID가 Audience Manager 트레이트 ID입니다. 사용자 인터페이스에 표시된 것과 동일한 ID입니다. API로 트레이트 ID를 반환할 수도 있습니다 GET 메서드를 사용합니다. 자세한 내용은 트레이트 API 메서드 .

d_unsid=

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

다음 d_unsid= 접두사는 시스템에 ID가 Audience Manager 트레이트 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
관련 글

이 페이지에서는