Analytics용 Experience Cloud ID 서비스 구현 implement-the-experience-cloud-id-service-for-analytics

Last update: Thu Jan 04 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

Developer
User
Admin
Leader

이들 지침은 Experience Cloud ID 서비스를 사용하고 데이터 수집 태그는 사용하지 않으려는 Analytics 고객을 대상으로 합니다. 단, 당사는 태그를 사용하여 ID 서비스를 구현할 것을 권장합니다. 태그를 사용하면 구현 워크플로를 간소화할 수 있으며 올바른 코드 배치 및 순서를 자동으로 확인할 수 있습니다.

IMPORTANT

시작하기 전에 요구 사항을 읽어보십시오.
프로덕션 환경에서 구현하기 전에 개발 환경에서 이 코드를 구성하고 테스트하십시오.

다음 단계에 따라 Adobe Analytics에 대한 ID 서비스를 구현하십시오.

1단계: ID 서비스 코드 다운로드 section-ead9403a6b7e45b887f9ac959ef89f7f

ID 서비스에는 VisitorAPI.js 코드 라이브러리가 필요합니다. 이 코드 라이브러리를 다운로드하려면

관리자 > 코드 관리자 로 이동합니다.
코드 관리자에서 JavaScript (신규) 또는 JavaScript (기존) 을 클릭합니다.

이렇게 하면 압축된 코드 라이브러리가 다운로드됩니다.
코드 파일의 압축을 풀고 VisitorAPI.js 파일을 엽니다.

2단계. ID 서비스 코드에 Visitor.getInstance 함수 추가 section-6053a6b7c16c466a9f9fdbf9cb9db3df

IMPORTANT

이전 버전의 ID 서비스 API는 이 함수를 다른 위치에 배치했으며 다른 구문이 필요합니다. 버전 1.4 이전 버전에서 마이그레이션하는 경우 여기에 설명된 새 배치 및 구문을 참고하십시오.
ALL CAPS의 코드는 실제 값의 자리 표시자입니다. 이 텍스트를 조직 ID, 추적 서버 URL 또는 기타 명명된 값으로 바꿉니다.

1부: 아래 Visitor.getInstance 함수 복사

var visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION-ID-HERE", {
     trackingServer: "INSERT-TRACKING-SERVER-HERE", // same as s.trackingServer
     trackingServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE", // same as s.trackingServerSecure

     // To enable CNAME support, add the following configuration variables
     // If you are not using CNAME, DO NOT include these variables
     marketingCloudServer: "INSERT-TRACKING-SERVER-HERE",
     marketingCloudServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE" // same as s.trackingServerSecure
});

2부: VisitorAPI.js 파일에 함수 코드 추가

Visitor.getInstance 함수를 파일 끝, 코드 블록 뒤에 추가합니다. 편집한 파일은 다음과 같습니다.

/*
========== DO NOT ALTER ANYTHING BELOW THIS LINE ==========
Version and copyright section
*/

// Visitor API code library section

// Put Visitor.getInstance at the end of the file, after the code library

var visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION-ID-HERE", {
     trackingServer: "INSERT-TRACKING-SERVER-HERE", // same as s.trackingServer
     trackingServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE", // same as s.trackingServerSecure

     // To enable CNAME support, add the following configuration variables
     // If you are not using CNAME, DO NOT include these variables
     marketingCloudServer: "INSERT-TRACKING-SERVER-HERE",
     marketingCloudServerSecure: "INSERT-SECURE-TRACKING-SERVER-HERE" // same as s.trackingServerSecure
});

3단계: Visitor.getInstance에 Experience Cloud 조직 ID 추가 section-7b8a6e76dc124d0e9ab1ce96ab2ffb0e

Visitor.getInstance 함수에서 INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE를 Experience Cloud 조직 ID로 바꿉니다. 조직 ID를 모를 경우 Experience Cloud 관리 페이지에서 찾을 수 있습니다. 또한 관리 - 핵심 서비스도 참조하십시오. 편집한 함수는 아래 예제와 비슷합니다.

var visitor = Visitor.getInstance("1234567ABC@AdobeOrg", { ...

IMPORTANT

조직 ID의 대/소문자를 변경하지 마십시오. ID는 대/소문자를 구분하므로 제공된 그대로 정확히 사용해야 합니다.

4단계: Visitor.getInstance에 추적 서버 추가 section-70ec9ebff47940d8ab520be5ec4728c5

추적 서버는 Analytics 데이터 수집에 사용됩니다.

1부: 추적 서버 URL 찾기

s_code.js 또는 AppMeasurement.js 파일을 확인하여 추적 서버 URL을 찾으십시오. URL을 다음 변수로 지정할 수 있습니다.

s.trackingServer
s.trackingServerSecure

2부: 추적 서버 변수 설정

사용할 추적 서버 변수를 확인하려면:

아래 의사 결정 매트릭스에 나와 있는 질문에 답변합니다. 답변에 해당하는 변수를 사용합니다.
추적 서버 자리 표시자를 추적 서버 URL로 바꿉니다.
사용하지 않은 추적 서버 및 Experience Cloud 서버 변수를 코드에서 제거합니다.

NOTE

Experience Cloud 서버 URL을 사용하는 경우 다음과 같이 해당 추적 서버 URL과 일치시킵니다.

Experience Cloud 서버 URL = 추적 서버 URL
Experience Cloud 서버 보안 URL = 추적 서버 보안 URL

추적 서버를 찾는 방법을 모를 경우 FAQ를 참조하고 올바르게 trackingServer 및 trackingServerSecure 변수를 채웁니다.

5단계: AppMeasurement.js 또는 s_code.js 파일 업데이트 section-b53113aea1bd4de896e0e4e9a7edee19

다음 함수를 AppMeasurement.js 또는 s_code.js 파일에 추가합니다.

s.visitor = Visitor.getInstance("INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE");

linkInternalFilters, charSet, trackDownloads 등과 같은 구성을 포함하는 섹션에 코드를 다음과 같이 추가합니다.

(선택 사항이지만 권장됨) 사용자 정의 Prop 만들기

AppMeasurement.js 또는 s_code.js에 사용자 정의 prop을 설정하여 범위를 측정. 이 사용자 정의 prop을 doPlugins 또는 AppMeasurement.js 파일의 s_code.js 함수에 추가합니다.

// prop1 is used as an example only. Choose any available prop.
s.prop1 = (typeof(Visitor) != "undefined" ? "VisitorAPI Present" : "VisitorAPI Missing");

6단계: 페이지에 방문자 API 코드 추가 section-d46d6aa324c842f2931d901e38d6db1d

각 페이지의 <head> 태그 내에 VisitorAPI.js 파일을 넣습니다. VisitorAPI.js 파일을 페이지에 넣을 경우:

<head> 섹션의 시작 부분에 넣어 다른 솔루션 태그 앞에 나타나게 합니다.
AppMeasurement 및 다른 Experience Cloud 솔루션에 대한 코드 앞에서 실행해야 합니다.

테스트 및 확인 후에 이 코드를 프로덕션으로 이동합니다.

7단계: (선택 사항) 유예 기간 구성 section-7bbb2f72c26e4abeb8881e18366797a3

이러한 사용 사례가 현재 상황에 적용되는 경우 고객 지원 센터에 임시 유예 기간을 설정하도록 요청하십시오. 유예 기간은 최대 180일 동안 실행될 수 있습니다. 필요한 경우 유예 기간을 갱신할 수 있습니다.

부분적인 구현

ID 서비스를 사용하는 페이지도 있고 그렇지 않은 페이지도 있으며 이러한 모든 페이지가 동일한 Analytics 보고서 세트로 보고하는 경우에 유예 기간이 필요합니다. 이는 도메인 간에 보고하는 글로벌 보고서 세트가 있는 경우 일반적입니다.

ID 서비스가 동일한 보고서 세트에 보고하는 모든 웹 페이지에 배포된 후 유예 기간을 중단합니다.

s_vi 쿠키 요구 사항

ID 서비스로 마이그레이션한 후 새 방문자에게 s_vi 쿠키가 있어야 하는 경우에는 유예 기간이 필요합니다. 이는 구현에서 s_vi 쿠키를 읽고 변수에 저장하는 경우에 일반적입니다.

구현에서 s_vi 쿠키를 읽는 대신 MID를 캡처할 수 있게 되면 유예 기간을 중단하십시오.

쿠키 및 Experience Cloud ID 서비스를 참조하십시오.

클릭스트림 데이터 피드에서 내부 시스템으로 데이터를 보내고 해당 프로세스에서 visid_high 및 visid_low 열이 사용되는 경우에 유예 기간이 필요합니다.

데이터 처리 프로세스에서 post_visid_high 및 post_visid_low 열을 사용할 수 있게 되면 유예 기간을 중지하십시오.

클릭스트림 데이터 열 참조를 참조하십시오.

클릭스트림 데이터 처리

8단계: ID 서비스 코드 테스트 및 배포 section-e9c1764ac21a4ec5be1ff338c0e2e01b

다음과 같이 테스트하고 배포할 수 있습니다.

테스트 및 확인

ID 서비스 구현을 테스트하려면 다음을 확인하십시오.

페이지가 호스팅된 도메인의 AMCV 쿠키.
Analytics 이미지 요청이 Adobe 디버거 도구를 통해 수행될 때의 MID 값입니다.

Experience Cloud ID 서비스 테스트 및 확인도 참조하십시오.

코드 배포

테스트를 통과한 후 코드를 배포합니다.

7단계에서 유예 기간을 활성화한 경우:

이미지 요청에 AID(Analytics ID) 및 MID가 있는지 확인합니다.
중단 기준을 충족한 경우 유예 기간을 사용하지 않도록 설정하십시오.

recommendation-more-help

9c9e8ca9-9f7e-42c9-a5d5-a0d82776362a