Adobe Analytics 및 Adobe Target 선택 opting-into-adobe-analytics-and-adobe-target

AEM에는 Adobe Analytics 및 Adobe Target과 통합하는 데 도움이 되는 옵트인 절차가 있습니다. 관리자 사용자 그룹에 할당된 미리 로드된 작업으로 즉시 사용할 수 있습니다.

관리자로 로그인하면 받은 편지함에서 이 작업(분석 및 타깃팅 구성)을 사용할 수 있습니다. 제공한 자격 증명을 기반으로 이러한 서비스를 구성하고 통합하는 데 도움이 됩니다.

통합을 구성하기 위한 다음과 같은 옵션이 있습니다.

  • 작업을 통해 통합을 구성합니다.

    이 작업은 즉시 또는 나중에 수행할 수 있으며, 일부 작업이 수행될 때까지 작업은 받은 편지함에 유지됩니다. 두 경우 모두 UI에서 직접 구성하거나 사전 정의된 .properties 파일을 사용하여 구성할 수 있습니다.

  • 통합을 옵트아웃합니다.

    수동으로 통합을 구성하려면 이 옵션을 고려하십시오. DTM을 사용하여 AEM과 Adobe Target 및 Adobe Analytics 통합도 참조하세요.

  • 스크립트를 사용하여 설정 및 프로비저닝을 구성합니다.

통합 구성 configuring-the-integration

다음 항목과의 통합을 선택합니다.

  • Analytics를 사용하여 페이지 추적 및 분석 기능을 사용할 수 있습니다.
  • Target을 사용하여 개인화 기능을 사용할 수 있습니다.

두 옵션 모두 사용자 계정 정보를 제공하고 추적되는 페이지를 지정해야 합니다.

NOTE
서버 시작 시 읽히는 속성 파일을 사용하여 Analytics 및 Target 계정 정보를 선택적으로 제공할 수 있습니다. 속성 파일을 사용하여 계정 정보 제공을 참조하세요.

통합을 선택하면 AEM이 다음 작업을 수행합니다.

  • Analytics 및 Target에 연결할 수 있는 클라우드 구성을 만듭니다.
  • 추적되는 데이터를 결정하는 프레임워크를 만듭니다.
  • 이러한 서비스를 사용하도록 웹 페이지를 구성합니다.
NOTE
AT.js는 기본 클라이언트 라이브러리입니다. 대상 클라우드 서비스 구성에 구성되어 있습니다.
Adobe은 AT.js를 클라이언트 라이브러리로 사용할 것을 권장합니다.

사전 로드된 기본 작업에서 옵트인하려면:

  1. 받은 편지함에서 Analytics 및 타깃팅 구성 작업을 선택하고 열기 ​합니다.

    optin-01

  2. Analytics용:

    1. Analytics의 사용자 계정 정보를 입력한 다음 해당 추가 단추를 클릭합니다.
    2. 적절한 자격 증명이 인증됩니다.
    3. Analytics 계정이 인증되면 사용할 Analytics 보고서 세트를 선택합니다. AEM은 해당 Analytics 보고서 세트를 검색합니다. 상태가 추가됨(으)로 업데이트되었습니다.
  3. Target용:

    1. Target에 대한 사용자 계정 정보를 입력한 다음 해당 추가 단추를 클릭합니다.
    2. 적절한 자격 증명이 인증됩니다. 상태가 추가됨(으)로 업데이트되었습니다.
  4. 다음 ​을 선택합니다.

  5. Analytics 및/또는 Target을 사용해야 하는 사이트를 선택합니다.

  6. 완료 ​를 선택하여 완료하십시오.

    note caution
    CAUTION
    구성을 옵트인한 후에는 영향을 받는 사이트/페이지를 게시하여 이러한 변경 사항을 게시 인스턴스에 복제해야 합니다.

통합 옵트아웃 opting-out-of-the-integration

다음 중 하나를 수행하는 경우 Analytics 및 Target과의 통합을 옵트아웃합니다.

  • 이러한 제품과 통합하지 않으려고 합니다.

  • 통합을 수동으로 구성하기를 선호합니다.

    수동으로 통합을 구성하는 방법에 대한 자세한 내용은 Adobe Analytics과 통합Adobe Target과 통합을 참조하십시오.

옵트아웃하려면 사전 로드된 작업을 완료해야 합니다.

속성 파일을 사용하여 계정 정보 제공 providing-account-information-using-a-properties-file

서버 시작 시 AEM이 읽는 속성 파일을 설치하여 Analytics 및 Target과의 통합을 위한 계정 속성을 구성합니다. 속성 파일을 사용하면 옵트인 마법사가 파일의 속성을 자동으로 사용하고 그에 따라 클라우드 구성이 생성됩니다.

속성 파일은 AEM 프로세스가 사용하는 작업 디렉토리(일반적으로 JAR 파일과 동일한 디렉토리)에 저장하는 marketingcloud.properties라는 텍스트 파일입니다. 파일에는 다음 속성이 포함되어 있습니다.

  • analytics.server: 사용하는 Analytics 데이터 센터의 URL입니다.
  • analytics.company: Analytics 사용자 계정과 연결된 회사입니다.
  • analytics.username: Analytics 사용자 이름입니다.
  • analytics.secret: Analytics 사용자 이름과 연결된 암호입니다.
  • analytics.reportsuite: 사용할 Analytics 보고서 세트의 이름입니다.
  • target.clientcode: Target 계정과 연결된 클라이언트 코드입니다.
  • target.email: Target 계정을 인증하는 데 사용하는 이메일 주소입니다.
  • target.password: 이메일 주소와 연결된 암호입니다.

속성과 값은 등호(=)로 구분됩니다. Analytics 속성에는 접두사가 analytics이고 Target 속성에는 접두사가 target입니다. 서비스를 구성하려면 해당 서비스의 모든 속성에 대한 값을 제공합니다. 서비스를 구성하지 않으려면 해당 서비스에 대한 값을 제공하지 마십시오.

다음 예제 .properties 파일에는 Analytics에 대한 클라우드 구성을 만들기 위한 속성 값이 포함되어 있습니다.

analytics.server=https://test.omniture.com/login/
analytics.company=MyCompany
analytics.username=sbroders
analytics.secret=12345678
analytics.reportsuite=myreportsuite
target.clientcode=
target.email=
target.password=

다음 절차에서는 속성 파일을 사용하여 통합을 옵트인하는 방법을 설명합니다.

  1. AEM 프로세스에서 사용 중인 작업 디렉터리에 marketingcloud.properties 파일을 만듭니다(작성자 인스턴스).

    note note
    NOTE
    작업 디렉터리는 일반적으로 jar 또는 license.properties 파일을 포함하는 디렉터리입니다.
    그러나 시스템 속성에 의해 절대 경로로 정의될 수도 있습니다.
    mac.provisioning.file.container
  2. Analytics 및/또는 Target 계정에 따라 속성 값을 추가합니다.

  3. 서버를 시작하거나 다시 시작한 다음 관리자 계정을 사용하여 로그인합니다.

  4. 통합 구성에 설명된 대로 Analytics & Targeting 구성 작업을 엽니다. 마법사에서는 계정 정보를 요청하는 대신 .properties 파일의 값을 사용합니다.

    적절한 서비스에 대해 추가 ​를 선택한 다음 마법사를 계속합니다.

    optin-02

클라우드 구성 정보 about-the-cloud-configurations

Analytics 및 Target과의 통합을 구성하면 AEM이 필요한 클라우드 구성 및 프레임워크를 자동으로 생성합니다. 예를 들어 Analytics 클라우드 구성을 프로비저닝된 Analytics 계정이라고 합니다.

클라우드 구성을 변경할 필요가 없습니다. 그러나 필요에 따라 프레임워크를 구성할 수 있습니다. (구성 요소 데이터를 Adobe Analytics 속성과 매핑대상 프레임워크 추가를 참조하십시오.)

NOTE
Adobe Target 구성 마법사에 옵트인하면 정확한 타겟팅은 기본적으로 활성화되어 있습니다.
정확한 타겟팅은 클라우드 서비스 구성이 콘텐츠를 로드하기 전에 컨텍스트가 로드될 때까지 대기함을 의미합니다. 결과적으로 성능 측면에서 정확한 타겟팅을 사용하면 콘텐츠를 로드하기 전에 몇 밀리초의 지연이 발생할 수 있습니다.
작성자 인스턴스에서는 정확한 타겟팅이 항상 활성화되어 있습니다. 그러나 게시 인스턴스에서는 클라우드 서비스 구성에서 정확한 타겟팅 옆에 있는 확인 표시를 지움으로써 정확한 타겟팅을 전역적으로 끌 수도 있습니다(http://localhost:4502/etc/cloudservices.html). 또한 클라우드 서비스 구성의 설정에 관계없이 개별 구성 요소에 대해 정확한 타겟팅을 켜거나 끌 수 있습니다.
타겟팅된 구성 요소를 이미 만든 다음 이 설정을 변경하는 경우, 해당 변경 내용은 이들 구성 요소에 영향을 미치지 않습니다. 해당 구성 요소를 직접 변경합니다.
CAUTION
Analytics 구성을 선택하고 특정 reportsuite을(를) 선택하면 프레임워크가 게시 실행 모드로 제한됩니다. 즉, 추적은 게시 인스턴스에서만 작동합니다.
작성 인스턴스뿐만 아니라 추적도 필요한 경우 값을 all(으)로 변경해야 합니다.

스크립트를 통해 설정 및 프로비저닝 구성 configuring-the-setup-and-provisioning-via-script

관리자는 수동으로 마법사를 실행하는 대신 스크립트로 설정 및 프로비저닝을 트리거할 수 있습니다. 다음을 통해 작업을 수행할 수 있습니다.

  • 필수 매개 변수를 사용하여 /libs/cq/cloudservicesprovisioning/content/autoprovisioning.json(으)로 POST 요청을 보내는 중입니다.

보낼 매개 변수는 다음에 따라 다릅니다.

  • 필요한 모든 자격 증명으로 채워진 marketingcloud.properties 파일을 사용하려면 다음 매개 변수를 전송해야 합니다.

    • automaticProvisioning= true
    • servicename= analytics|target
    • path=생성된 클라우드 서비스 구성을 첨부할 AEM 페이지 경로

    예를 들어 Analytics와 Target 구성을 모두 만들고 we.retail 페이지에 첨부하는 curl 요청은 다음과 같습니다.

    code language-shell
    curl -v -u admin:admin -X POST -d"automaticProvisioning=true&servicename=target&servicename=analytics&path=/content/we-retail" http://localhost:4502/libs/cq/cloudservicesprovisioning/content/autoprovisioning.json
    
  • marketingcloud.properties 파일을 사용하지 않으려면 자격 증명과 매개 변수를 보내야 합니다. 예:

    • automaticProvisioning= true
    • servicename= analytics|target
    • path=생성된 클라우드 서비스 구성을 첨부할 AEM 페이지에 대한 경로. 여러 경로를 정의할 수 있습니다.
    • analytics.server= https://servername
    • analytics.company= Name of company
    • analytics.username= me
    • analytics.secret= secret
    • analytics.reportsuite= we-retail
    • target.clientcode= mycompany
    • target.email= me@adobe.com
    • target.password= password

    이 경우 Analytics와 Target 구성을 모두 만들고 we-retail 페이지에 첨부하는 curl 요청은 다음과 같습니다.

    code language-shell
    curl -v -u admin:admin -X POST -d"automaticProvisioning=false&servicename=target&servicename=analytics&path=/content/we-retail&analytics.server=https://servername/&analytics.company=Name of company&analytics.username=me&analytics.secret=secret&analytics.reportsuite=weretail&target.clientcode=mycompany&target.email=me@adobe.com&target.password=password" http://localhost:4502/libs/cq/cloudservicesprovisioning/content/autoprovisioning.json
    
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2