Show Menu
TOPICS×

Analytics용 Experience Cloud Identity 서비스 구현

이러한 지침은 Experience Cloud Identity 서비스를 사용하고 DTM(Dynamic Tag Management)은 사용하지 않으려는 Analytics 고객을 대상으로 합니다. 그러나 DTM을 사용하여 ID 서비스를 구현하는 것이 매우 좋습니다. DTM을 사용하면 구현 워크플로우를 간소화할 수 있고, 올바른 코드 배치 및 순서를 자동으로 확인할 수 있습니다.
다음 단계에 따라 Adobe Analytics에 대한 ID 서비스를 구현하십시오.

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

ID 서비스에는
VisitorAPI.js
코드 라이브러리가 필요합니다. 이 코드 라이브러리를 다운로드하려면
  1. 관리자
    >
    코드 관리자
    ​로 이동합니다.
  2. 코드 관리자에서
    JavaScript (신규)
    또는
    JavaScript (기존)
    ​을 클릭합니다.
    이렇게 하면 압축된 코드 라이브러리가 다운로드됩니다.
  3. 코드 파일의 압축을 풀고
    VisitorAPI.js
    파일을 엽니다.

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

  • 이전 버전의 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 추가

Visitor.getInstance
함수에서
INSERT-MARKETING-CLOUD-ORGANIZATION ID-HERE
를 Experience Cloud 조직 ID로 바꿉니다. 조직 ID를 모를 경우 Experience Cloud 관리 페이지에서 찾을 수 있습니다. 또한, 관리 - 핵심 서비스 도 참조하십시오. 편집한 함수는 아래 예제와 비슷합니다.
var visitor = Visitor.getInstance("1234567ABC@AdobeOrg", { ...
조직 ID의 대/소문자를 변경하지
마십시오
. ID는 대/소문자를 구분하므로 제공된 그대로 정확히 사용해야 합니다.

4단계: Visitor.getInstance에 추적 서버 추가

추적 서버는 Analytics 데이터 수집에 사용됩니다.
1부: 추적 서버 URL 찾기
s_code.js
또는
AppMeasurement.js
파일을 확인하여 추적 서버 URL을 찾으십시오. URL을 다음 변수로 지정할 수 있습니다.
  • s.trackingServer
  • s.trackingServerSecure
2부: 추적 서버 변수 설정
사용할 추적 서버 변수를 확인하려면:
  1. 아래 의사 결정 매트릭스에 나와 있는 질문에 답변합니다. 답변에 해당하는 변수를 사용합니다.
  2. 추적 서버 자리 표시자를 추적 서버 URL로 바꿉니다.
  3. 사용하지 않은 추적 서버 및 Experience Cloud 서버 변수를 코드에서 제거합니다.
Experience Cloud 서버 URL을 사용하는 경우 다음과 같이 해당 추적 서버 URL과 일치시킵니다. >
  • Experience Cloud 서버 URL = 추적 서버 URL
  • Experience Cloud 서버 보안 URL = 추적 서버 보안 URL
추적 서버를 찾는 방법을 모를 경우 FAQ 를 참조하고 올바르게 trackingServer 및 trackingServerSecure 변수를 채웁니다 .

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

다음 함수를
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 코드 추가

각 페이지의
<head>
태그 내에
VisitorAPI.js
파일을 넣습니다.
VisitorAPI.js
파일을 페이지에 넣을 경우:
  • <head>
    섹션의 시작 부분에 넣어 다른 솔루션 태그 앞에 나타나게 합니다.
  • AppMeasurement 및 다른 Experience Cloud 솔루션에 대한 코드 앞에서 실행해야 합니다.
테스트 및 확인 후에 이 코드를 프로덕션으로 이동합니다.

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

이러한 사용 사례가 현재 상황에 적용되는 경우 고객 지원 센터 에 임시 유예 기간 을 설정하도록 요청하십시오. 유예 기간은 최대 180일 동안 실행될 수 있습니다. 필요한 경우 유예 기간을 갱신할 수 있습니다.
부분적인 구현
ID 서비스를 사용하는 페이지도 있고 그렇지 않은 페이지도 있으며 이러한 모든 페이지가 동일한 Analytics 보고서 세트로 보고하는 경우에 유예 기간이 필요합니다. 이는 도메인 간에 보고하는 글로벌 보고서 세트가 있는 경우 일반적입니다.
ID 서비스가 동일한 보고서 세트에 보고하는 모든 웹 페이지에 배포된 후 유예 기간을 중단합니다.
s_vi 쿠키 요구 사항
ID 서비스로 마이그레이션한 후 새 방문자에게 s_vi 쿠키가 있어야 하는 경우에는 유예 기간이 필요합니다. 이는 구현에서 s_vi 쿠키를 읽고 변수에 저장하는 경우에 일반적입니다.
구현에서 s_vi 쿠키를 읽는 대신 MID를 캡처할 수 있게 되면 유예 기간을 중단하십시오.
클릭스트림 데이터 피드에서 내부 시스템으로 데이터를 보내고 해당 프로세스에서
visid_high
visid_low
열이 사용되는 경우에 유예 기간이 필요합니다.
데이터 처리 프로세스에서
post_visid_high
post_visid_low
열을 사용할 수 있게 되면 유예 기간을 중지하십시오.
클릭스트림 데이터 처리

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

다음과 같이 테스트하고 배포할 수 있습니다.
테스트 및 확인
ID 서비스 구현을 테스트하려면 다음을 확인하십시오.
코드 배포
테스트를 통과한 후 코드를 배포합니다.
7단계 에서 유예 기간을 활성화한 경우:
  • 이미지 요청에 AID(Analytics ID) 및 MID가 있는지 확인합니다.
  • 중단 기준을 충족한 경우 유예 기간을 사용하지 않도록 설정하십시오.