설명서Audience ManagerAudience Manager 사용 안내서

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

Last update: Mon Jul 22 2024 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 - 오프라인 데이터와 결합된 모든 온라인 활동을 기반으로 하는 Personalization 또는 워크플로 B - 오프라인 전용 데이터를 기반으로 하는 Personalization을 참조하십시오.

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

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

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

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

abc123 def456 ghi789 xyz987

파일 콘텐츠 고려 사항 considerations

인바운드 파일을 만들 때 첫 번째 열에 AAM UUID, GAID, IDFA 등의 장치 ID만 채워져 있는지 확인하십시오. Audience Manager에서 지원하는 ID에 대한 자세한 설명은 Audience Manager의 ID 색인을 참조하세요.

IMPORTANT
첫 번째 열에서 DPUUIDs을(를) 사용하지 마십시오. 이렇게 하면 동기화가 잘못될 수 있습니다.

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

ID 동기화 파일의 목적은 고유한 데이터 소스의 DPUUIDs을(를) Audience Manager개의 UUID와 동기화하는 것입니다. 동기화는 마스터 DPID 및 관련 DPID의 DPUUID을(를) Audience Manager UUID에 매핑합니다. 파일 이름 및 본문에 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 동기화 프로세스가 DPID의 DPUUID을(를) 왼쪽 12345의 Audience Manager UUID과(와) 동기화합니다. 파일 이름의 DPID "0"은(는) Audience Manager UUID을(를) 나타냅니다.

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

DPID12345
DPID67890
XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-TTrj6E4njaMR38
4598060374
XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70
4581274262
XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM
4392434426
XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M
2351382994
XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw
4601584763

2단계: DPID의 DPUUID이(가) 1단계에서 Audience Manager UUID과(와) 동기화되지 12345. 이 ID 동기화를 통해 DPID의 DPUUID을(를) 1단계의 Audience Manager UUID67890과(와) 동기화할 수 있습니다.

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

사용자 ID는

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

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

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