選擇使用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. 從您的收件匣,選取並​ 開啟 ​設定分析和定位工作。

    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的整合:

若要選擇退出,您必須完成預先載入的工作:

使用屬性檔案提供帳戶資訊 providing-account-information-using-a-properties-file

安裝AEM在伺服器啟動時讀取的屬性檔案,以設定帳戶屬性以便與Analytics和Target整合。 當您使用屬性檔案時,選擇加入精靈會自動使用檔案中的屬性,並據此建立雲端設定。

屬性檔案是名為marketingcloud.properties的文字檔,儲存在AEM處理序正在使用的工作目錄中(通常與JAR檔案相同的目錄)。 檔案包含下列屬性:

  • 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. 開啟設定分析和目標工作,如設定整合中所述。 精靈不會要求您的帳戶資訊,而是使用.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

透過Script設定設定和布建 configuring-the-setup-and-provisioning-via-script

身為管理員,您可能想要使用指令碼觸發設定和布建,而不是手動逐步執行精靈。 您可以透過以下方式達成此目的:

  • 使用必要的引數將POST要求傳送至​ /libs/cq/cloudservicesprovisioning/content/autoprovisioning.json

您傳送的引數取決於下列專案:

  • 如果您想要使用填入所有必要認證的​ 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=path to an AEM page to attach the created cloud services configurations;可以定義多個路徑
    • 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