Adobe Audience Manager의 DIL 버전 8.0 이상으로 업데이트 updating-to-adobe-audience-manager-s-dil-version-or-greater
이 문서에서는 Adobe Audience Manager(AAM) Data Integration Library(DIL) 코드를 버전 8.0 이상으로 업데이트하는 방법에 대한 단계 및 권장 사항을 제공합니다. 이는 Adobe Analytics 데이터의 서버측 전달이 아닌 "클라이언트측" DIL 구현을 의미하며 DTM, Adobe에 의한 Launch 및 Adobe 태그 관리자 솔루션이 없는 구현을 다룹니다.
개요 overview
Audience Manager의 Data Integration Library(DIL) 코드를 사용하면 웹 사이트*에서 AAM을 구현할 수 있습니다. 이전 버전의 DIL을 구현할 때는 Adobe의 ECID(Experience Cloud ID Service)도 구현할 필요가 없었습니다(매우 좋은 생각이었지만). DIL 버전 8.0부터 ECID 버전 3.3 이상에 종속됩니다. ECID 3.3 없이 또는 이전 버전으로 DIL 8.0 이상을 구현하는 경우 오류가 발생하여 작동하지 않습니다. AAM을 구현할 수 있는 방법에는 여러 가지가 있으므로, 몇 가지 권장 사항과 몇 가지 단계를 제공하기 위해 이 페이지를 만들었습니다. 아래에서는 이러한 단계 및 권장 사항이 플랫폼/구현 방법으로 분류되어 있습니다. DIL에 대한 자세한 내용은 설명서를 참조하세요.
- 이 페이지의 설명에 나와 있는 대로, 여기에는 Adobe Analytics이 없는 AAM 고객이 사용하는 "클라이언트측" DIL 구현만 포함됩니다. Adobe Analytics이 있는 경우 AAM을 구현하는 서버측 전달 방법을 사용해야 합니다. 이 메서드는 설명서에 설명되어 있습니다.
중복 및 더 이상 사용되지 않는 요소 및 메서드 duplicate-and-deprecated-elements-and-methods
이전 버전의 DIL 및 ECID에서는 중복 메서드(DIL 및 ECID에서 동일한 기능을 수행하는 메서드)가 있어 사용할 메서드와 관련하여 혼동을 주었습니다. 일반적으로 두 가지를 모두 사용하고 일치시켜야 했으며 해당 메시지는 고객에게 잘 전달되지 않았습니다. DIL 8.0부터 이러한 중복 메서드 및 요소는 DIL에서 더 이상 사용되지 않으며 ECID 버전을 사용하는 것이 좋습니다.
예:
- DIL.create을(를) 사용하는 경우 몇 가지 요소가 더 이상 사용되지 않으므로 대신 ECID 요소를 사용해야 합니다. 이러한 요소는 DIL.create 설명서에서 호출됩니다.
- idSync 인스턴스 수준 메서드도 메서드의 documentation에서 호출되어 더 이상 사용되지 않습니다.
고객 ID와 ID 동기화 id-syncing-with-a-customer-id
AAM에서는 시스템의 UUID(익명 고유 사용자 ID)를 고객 ID와 동기화하여 해당 고객에 대한 오프라인 데이터를 업로드하고 고객의 온라인 동작과 함께 연결하여 고객을 더 잘 이해할 수 있습니다. 과거에는 다음 두 가지 방법 중 하나로 이 작업을 수행했습니다.
- idSync 인스턴스 수준 메서드
- declaredId의 DIL.create 요소
이러한 이전 방법 중 하나를 사용하여 고객 ID와 동기화한 경우 ECID 서비스의 일부인 setCustomerIDs 메서드를 사용하도록 업데이트하는 것이 좋습니다. setCustomerIDs에 대한 자세한 내용은 메서드의 설명서를 참조하세요.
빠른 팁: 이전에 위의 방법 중 하나를 사용할 때 Data Source ID("DPID")가 있는 AAM Data Source을(를) 참조했습니다. setCustomerIDs(으)로 업데이트할 때는 AAM Data Source의 "Integration Code"을(를) 대신 사용해야 합니다. 여전히 동일한 Data Source을(를) 가리키지만 다른 식별자입니다. 아래 비디오에 나와 있습니다.
다음 섹션에는 구현 방법에 따라 DIL 8.0으로 업데이트하는 단계 및 권장 사항이 나와 있습니다.
Adobe Experience Platform 태그에서 DIL 8.0으로 업데이트 updating-to-dil-in-experience-platform-launch
DIL 8.0으로 업데이트하기 위한 기본 단계
-
8.0 이전 버전의 DIL을 사용하는 경우 업그레이드하기 전에 AAM 확장에서 DIL 구성으로 이동하여 사용 중인 고급 옵션(후속 단계에서 사용)을 메모하십시오.
-
AAM 확장을 버전 8.0 이상으로 업데이트합니다.
-
Experience Cloud ID 서비스 확장이 버전 3.3.0 이상인지 확인하십시오.
-
8.0 이전 AAM 확장 또는 DIL용 사용자 지정 코드에 있었던 더 이상 사용되지 않는 메서드/요소(예:
disableIDSyncs
)의 경우 ECID 확장에서 ECID 메서드를 사용하도록 설정합니다.- (DIL)
disableDestinationPublishingIframe
-> (ECID)disableIdSyncs
- (DIL)
disableIDSyncs
-> (ECID)disableIdSyncs
- (DIL)
iframeAkamaiHTTPS
-> (ECID)dSyncSSLUseAkamai
- (DIL)
declaredId
-> (ECID)setCustomerIDs
- (DIL)
-
변경 사항을 게시합니다.
Adobe DTM에서 DIL 8.0으로 업데이트 updating-to-dil-in-adobe-dtm
- AAM 도구를 버전 8.0 이상으로 업데이트합니다. 이 버전 설정은 AAM 도구의 "일반" 섹션에 있습니다.
- 8.0 이전 버전의 DIL용 AAM 도구의 사용자 지정 코드에 있었던 더 이상 사용되지 않는 메서드/요소(예:
disableIDSyncs
)에 대해서는 ECID 도구에 추가할 수 있도록 해당 메서드/요소를 메모한 다음 AAM 도구의 사용자 지정 DIL code에서 제거하십시오. - Experience Cloud ID 서비스 확장을 버전 3.3.0 이상으로 업데이트합니다.
- AAM 도구의 사용자 지정 코드에서 제거한 ECID 도구에 고급 옵션을 추가합니다.
- 변경 사항 게시
Adobe Tag Management 솔루션 없이 DIL 8.0으로 업데이트 additional-resources
페이지에서 바로 코드를 업데이트하는 경우 위에서 설명한 대로 메서드/요소를 DIL에서 ECID로 이동해야 하는 경우를 제외하고 이전 항목을 최신 항목으로 바꿀 수 있습니다. 이 경우 DIL 위치의 이전 메서드/요소를 ECID 위치의 ECID 메서드/요소로 바꾸기만 하면 됩니다.
비 Adobe 태그 관리자도 마찬가지입니다. 해당 태그 관리 솔루션에 이전 버전이 있는 경우 다음 단계에 설명된 대로 새 코드로 바꿉니다.
-
DIL 라이브러리를 최신 버전(8.0 이상)으로 업데이트 - 현재 공개 위치에서 사용할 수 없으므로 Adobe Consulting 또는 Adobe 고객 지원 센터에서 최신 DIL 코드를 받아야 합니다. 그런 다음 이전 DIL 라이브러리 코드를 새 DIL 라이브러리 코드로 바꾸고 다음 단계로 이동하기만 하면 됩니다(지금 중지하지 않으면 문제가 발생합니다. 하).
-
ECID Service을(를) 설치하거나 기존 버전을 3.3.0 이상으로 업데이트하십시오. GitHub 페이지에서 최신 Experience Cloud ID 서비스 릴리스를 다운로드할 수 있습니다. 도움이 필요하면 설명서를 참조하거나 Adobe 컨설턴트에게 문의하십시오.
-
DIL용 사용자 지정 코드에 있는 더 이상 사용되지 않는 모든 메서드 또는 요소가 ECID 메서드로 이동되었는지 확인합니다.