설명서Audience ManagerAudience Manager 사용 안내서

ID 동기화 파일 이름 및 컨텐츠 요구 사항 name-and-content-requirements-for-id-synchronization-files

Last update: Sun May 21 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

파일 기반 ID 동기화에 사용되는 필수 필드, 구문 및 이름 지정 규칙에 대해 설명합니다. 이러한 사양에 따라 파일 내용의 이름을 지정하고 구성합니다.

NOTE
텍스트 스타일(monospaced text, 기울임체, 괄호 [ ] ( ) 등)은 이 문서에서는 코드 요소 및 옵션을 나타냅니다. 자세한 내용은 코드 및 텍스트 요소에 대한 스타일 규칙을 참조하십시오.

파일 이름 구문 및 예 file-name-syntax

ID 파일 이름에는 다음과 같은 필수 요소와 선택적 요소가 포함되어 있습니다.

[adobe_id_] [c2c_id_]MASTERDPID_DPID[_DPID]_TIMESTAMP.sync[.SPLIT_NUMBER][.gz]

매개 변수
설명
adobe_id
파일을 ID 동기화 파일로 식별하는 정적 접두사입니다. 장치 ID를 다른 장치 ID 또는 고객 ID(DPUUID)와 일치시킬 때 이 접두사를 사용합니다.
c2c_id
파일을 사용자 기반 대상에 대한 ID 동기화 파일로 식별하는 정적 접두사입니다. 사용자 기반 대상의 해시된 이메일 주소에 고객 ID(DPUUID)를 일치시킬 때 이 접두사를 사용합니다.
MASTERDPID

마스터 데이터 공급자 ID는 파일 이름에 있는 DPID의 상위 ID입니다. 또한 데이터 파일의 첫 번째 사용자 ID는 마스터 ID에 해당합니다. 후속 DPID는 마스터에 속하는 다른 식별자입니다. 동기화는 파일 이름의 DPID를 파일의 UUID에 매핑합니다.

이 DPID에는 AAM UUID, GAID, IDFA 등과 같은 장치 ID만 포함되어야 합니다. DPUUID를 포함할 수 없습니다. 이렇게 하면 동기화가 잘못될 수 있습니다.

DPID

데이터 공급자 ID. 이러한 ID는 마스터 DPID와 연결된 엔티티 또는 데이터 소스를 나타냅니다. 동기화는 파일 이름의 DPID를 파일의 UUID에 매핑합니다.

파일 이름의 DPID 수는 데이터 파일의 UUID 수와 일치해야 합니다. 예를 들어 파일 이름에 마스터 DPID와 3개의 DPID가 포함되어 있다고 가정합니다. 데이터 파일에는 아래 파일 콘텐츠 섹션에 설명된 대로 형식이 지정된 4개의 해당 UUID 열이 포함되어야 합니다.

timestamp
10자리 UNIX 타임스탬프(초). 타임스탬프는 각 파일 이름을 고유하게 만드는 데 도움이 됩니다.
.sync
일반 전체 동기화를 나타냅니다.
[.SPLIT_NUMBER]
정수. 큰 파일을 여러 개의 작은 파일로 분할할 때 사용됩니다. 이는 처리 시간을 개선하는 데 도움이 됩니다. 번호는 보내는 원본 파일의 일부를 나타냅니다. 아래의 파일 이름 예를 참조하십시오.
[.gz]
파일이 선택적 gzip 압축으로 압축되도록 지정합니다.

파일 이름 예

다음 예제에서는 올바른 형식의 파일 이름을 보여 줍니다. 파일 이름이 비슷해 보일 수 있습니다.

  • adobe_id_111_222_333_444_1454442149.sync
  • adobe_id_123_898_456_1454442149.sync.1.gz
  • adobe_id_123_898_456_1454442149.sync.2.gz
  • c2c_id_123_898_1454442149.sync.gz
NOTE
사용자 기반 대상에 대한 ID 동기화 파일 이름 지정(c2c 접두사)에 대해서는 다음을 참조하십시오. 워크플로우 A - 오프라인 데이터와 결합된 모든 온라인 활동을 기반으로 한 개인화 또는 워크플로우 B - 오프라인 전용 데이터를 기반으로 개인화.

파일 콘텐츠 구문 및 예 file-content-syntax

ID 파일의 컨텐츠에는 다음 요소가 포함됩니다.

UUID <tab>UUID<tab>UUID<tab>UUID

파일에 사용자 ID(UUID). 각 행에서 탭으로 ID를 구분합니다. 다음 예제에서는 올바른 형식의 ID 파일을 보여 줍니다. 콘텐츠가 비슷해 보일 수 있습니다.

abc123 def456 ghi789 xyz987

파일 콘텐츠 고려 사항 considerations

인바운드 파일을 생성할 때 첫 번째 열에 다음과 같은 장치 ID만 채워야 합니다. AAM UUID, GAID, IDFA등. 다음을 참조하십시오 Audience Manager 내 ID 색인 Audience Manager에서 지원하는 ID에 대한 자세한 설명.

IMPORTANT
사용하지 않음 DPUUIDs 첫 번째 열에서 이렇게 하면 동기화가 잘못될 수 있습니다.

동기화는 DPUUID를 UUID에 일치시킵니다. sync-matches-dpuuids-uuids

ID 동기화 파일의 목적은 DPUUIDs 을 사용하여 고유한 데이터 소스에서 Audience Manager UUID. 동기화는 다음을 매핑합니다. DPUUID마스터의 DPID 및 관련 항목 DPID에 대한 Audience Manager UUIDs. 파일 이름 및 본문에 ID를 넣는 위치에 따라 이러한 식별자가 서로 매핑되는 방식이 결정됩니다. 예를 들어 여기에 표시된 두 개의 샘플 파일을 사용합니다.

  • 파일 1: adobe_id_0_12345_1476312152.sync

  • 파일 2: adobe_id_12345_67890_1476312876.sync

샘플 이름과 콘텐츠가 주어지면 ID는 다음과 같이 함께 매핑됩니다.

파일 1 ( 샘플 파일 다운로드)

DPID 0 = Adobe Audience Manager UUIDs
DPID 12345
68079982765673198504052656074456196039
XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-TTrj6E4njaMR38
67412682083411995725538770443620307584
XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70
89159024796760343733111707646026765593
XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM
66552757407517449462805881945288602094
XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M
66184778222667870903738139438735041506
XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw

1단계: ID 동기화 프로세스가 DPUUIDs from DPID 12345 포함 Audience Manager UUID왼쪽 열에 s가 있습니다. 다음 사항에 주의하십시오. DPID 파일 이름의 "0"은(는) Audience Manager UUIDs.

파일 2 ( 샘플 파일 다운로드)

DPID 12345
DPID 67890
XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-TTrj6E4njaMR38
4598060374
XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70
4581274262
XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM
4392434426
XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M
2351382994
XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw
4601584763

2단계: DPUUIDs from DPID 12345 1단계에서 Audience Manager과 동기화됨 UUIDs. 이 ID 동기화로 수행할 작업은 DPUUIDs from DPID Audience Manager 67890 UUID1단계의 .

기타 형식 요구 사항 other-format-reqs

사용자 ID는

  • ID 자체에 탭이 있습니다. 탭은 데이터 파일에서 개별 ID를 구분하는 데만 사용됩니다.
  • 개인 식별 정보 포함(PII).
  • 사용 URL 인코딩. 인코딩되지 않은 ID만 전달합니다.

탭이나 공백으로 끝나는 행은 처리되거나 실현되지 않습니다. 행 끝을 명확하게 유지해야 합니다.

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695