整合Dynamic Media檢視器與Adobe Analytics和Experience Platform Launch

什麼是Dynamic Media檢視器與Adobe Analytics和Experience Platform Launch整合？

適用於Platform launch和Dynamic Media檢視器5.13的全新​Dynamic Media檢視器​擴充功能可讓Adobe Analytics和Platform launch的客戶在其Platform launch設定中使用檢視器專用的事件和資料。

這項整合表示您可以透過Adobe Analytics追蹤Dynamic Media檢視器在您網站上的使用情況。 同時，您可以將檢視器公開的事件和資料與來自Adobe或協力廠商的任何其他Experience Platform Launch擴充功能搭配使用。

若要深入了解擴充功能，請參閱Experience Platform Launch使用手冊中的Adobe擴充功能。

本主題旨在下列用途： 網站管理員、Experience Manager平台的開發人員，以及營運中的人員。

整合的限制

  • Dynamic Media檢視器的Experience Platform Launch整合無法在Experience Manager製作節點中運作。 在WCM頁面發佈前，您無法看到任何追蹤。
  • Dynamic Media檢視器的Experience Platform Launch整合不支援「快顯」操作模式，即使用「資產詳細資料」頁面上的「URL」按鈕取得檢視器URL。
  • Experience Platform Launch整合無法與舊版檢視器Analytics整合同時使用（透過config2=參數）。
  • 視訊追蹤的支援僅限於「核心播放」追蹤，如追蹤概述所述。 尤其是不支援QoS、廣告、章節/區段或錯誤追蹤。
  • 使用​Dynamic Media Viewers​擴充功能的資料元素不支援資料元素的儲存期間設定。 儲存持續時間必須設定為​無。

整合的使用案例

與Experience Platform Launch整合的主要使用案例為同時使用Adobe Experience Manager Assets和Adobe Experience Manager Sites的客戶。 在這類情況下，您可以在Experience Manager製作節點和Experience Platform Launch之間設定標準整合，然後將您的Sites例項與Experience Platform Launch屬性建立關聯。 之後，任何新增至Sites頁面的Dynamic Media WCM元件都會追蹤檢視器的資料和事件。

請參閱在Experience Manager網站🔗中追蹤Dynamic Media檢視器。

整合支援的次要使用案例為僅使用Experience Manager資產或Dynamic Media Classic的客戶。 在這種情況下，您會取得檢視器的內嵌程式碼，並將其新增至網站頁面。 然後，從Experience Platform Launch取得Experience Platform Launch程式庫生產URL，並手動將其新增至網頁代碼。

請參閱使用內嵌程式碼🔗追蹤Dynamic Media檢視器。

資料和事件追蹤在整合中如何運作

此整合利用兩種不同且獨立的Dynamic Media檢視器追蹤類型：Adobe Analytics​和​Adobe Analytics for Audio and Video。

關於使用Adobe Analytics進行追蹤

Adobe Analytics可讓您追蹤使用者在您網站上與Dynamic Media檢視器互動時所執行的動作。 Adobe Analytics也可讓您追蹤檢視器專屬的資料。 例如，您可以追蹤並記錄檢視載入事件以及資產名稱、發生的任何縮放動作，以及視訊播放動作。

在Experience Platform Launch中，資料元素​和​規則​的概念可共同運作，以啟用Adobe Analytics追蹤。

關於Experience Platform Launch中的資料元素

Experience Platform Launch中的資料元素是已命名的屬性，其值會靜態定義，或根據網頁或Dynamic Media檢視器資料的狀態動態計算。

資料元素定義可用的選項取決於Experience Platform Launch屬性中安裝的擴充功能清單。 「核心」擴充功能已預先安裝，且可在任何設定中立即使用。 此「核心」擴充功能可定義資料元素，其值來自Cookie、JavaScript程式碼、查詢字串和許多其他來源。

針對Adobe Analytics追蹤，必須依照擴充功能的安裝與設定所述，安裝多個擴充功能。 Dynamic Media檢視器擴充功能新增了定義資料元素的功能，該值是動態檢視器事件的引數。 例如，可參考檢視器類型或檢視器在載入時報告的資產名稱、使用者縮放時報告的縮放等級等等。

Dynamic Media檢視器擴充功能會自動保留其資料元素的值為最新。

定義資料元素後，您就可以使用資料元素選擇器Widget，在Experience Platform LaunchUI的其他位置使用資料元素。 尤其是為Dynamic Media檢視器追蹤目的而定義的資料元素，是由規則中Adobe Analytics擴充功能的「設定變數動作」參照（請參閱下方）。

請參閱資料元素。

關於Experience Platform Launch中的規則

Experience Platform Launch中的規則是一種多種結構的配置，它定義了構成規則的三個區域：事件、條件​和​操作:

  • 事件 (if)告知Experience Platform Launch何時觸發規則。
  • 條件 (if)告知Experience Platform Launch觸發規則時要允許或不允許的其他限制。
  • 動作 (then)告訴Experience Platform Launch觸發規則時該做什麼。

「事件」、「條件」和「動作」區段中可用的選項，取決於「Experience Platform Launch屬性」中安裝的擴充功能。 核心​擴充功能已預先安裝，且可在任何設定中立即使用。 擴充功能提供事件的數個選項，例如基本瀏覽器層級動作。 這些動作包括焦點變更、按鍵和表單提交。 也包含條件選項，例如Cookie值、瀏覽器類型等。 對於「動作」，僅可使用「自訂程式碼」選項。

針對Adobe Analytics追蹤，必須安裝數個其他擴充功能，如安裝與設定擴充功能中所述。 具體說明：

  • Dynamic Media檢視器擴充功能將支援的事件清單延伸至Dynamic Media檢視器專屬的事件，例如檢視器載入、資產交換、放大和視訊播放。
  • Adobe Analytics擴充功能擴充了支援動作的清單，其中包含傳送資料至追蹤伺服器所需的兩個動作：設定變數​和​傳送信標。

若要追蹤Dynamic Media檢視器，可使用下列任何類型：

  • 來自Dynamic Media檢視器擴充功能、核心擴充功能或任何其他擴充功能的事件。
  • 規則定義中的條件。 或者，您可以將條件區域保留為空白。

在「動作」區段中，您必須有​設定變數​動作。 此動作會告訴Adobe Analytics如何將資料填入追蹤變數。 同時，設定變數​動作不會傳送任何內容至追蹤伺服器。

設定變數​動作後面必須有​傳送信標​動作。 傳送信標​動作實際上會將資料傳送至分析追蹤伺服器。 設定變數​和​傳送信標​這兩個動作都來自Adobe Analytics擴充功能。

請參閱規則。

配置示例

下列Experience Platform Launch中的範例設定示範如何在檢視器載入時追蹤資產名稱。

  1. 從​資料元素​標籤中，定義資料元素AssetName，該資料元素會從Dynamic Media檢視器擴充功能參照LOAD事件的asset參數。

    image2019-11

  2. 從​Rules​標籤中，定義規則​TrackAssetOnLoad。

    在此規則中，Event​欄位使用來自Dynamic Media檢視器擴充功能的​LOAD​事件。

    image2019-22

  3. 「動作」設定有來自Adobe Analytics擴充功能的兩種「動作」類型：

    設定變數，將您選擇的分析變數對應至資料元素 AssetName 的值。

    傳送信標，這會將追蹤資訊傳送至Adobe Analytics。

    image2019-3

  4. 產生的規則設定如下所示：

    image2019-4

關於Adobe Analytics for Audio and Video

訂閱Experience Cloud帳戶以使用Adobe Analytics for Audio and Video時，就足以在​Dynamic Media Viewers​擴充功能設定中啟用視訊追蹤。 視訊量度可在Adobe Analytics中使用。 視訊追蹤取決於是否有Adobe MediumAnalytics for Audio and Video擴充功能。

請參閱安裝及設定擴充功能。

目前，視訊追蹤的支援僅限於「核心播放」追蹤，如追蹤概述所述。 尤其是不支援QoS、廣告、章節/區段或錯誤追蹤。

使用Dynamic Media檢視器擴充功能

如整合的使用案例所述，您可以透過Experience Manager網站中的新Experience Platform Launch整合及使用內嵌程式碼來追蹤Dynamic Media檢視器。

在Experience Manager網站中追蹤Dynamic Media檢視器

若要在Experience Manager網站中追蹤Dynamic Media檢視器，必須執行設定所有整合片段區段下方列出的所有步驟。 具體來說，您必須建立IMS設定和Experience Platform Launch雲端設定。

在正確設定後，您使用Dynamic Media支援的WCM元件新增至Sites頁面的任何Dynamic Media檢視器，都會自動追蹤Adobe Analytics或Adobe Analytics的視訊資料，或兩者皆有。

使用內嵌程式碼追蹤Dynamic Media檢視器

若客戶未使用Experience Manager網站，或將Dynamic Media檢視器內嵌至Experience Manager網站以外的網頁，或兩者皆未使用，仍可使用Experience Platform Launch整合。

完成配置Adobe Analytics和配置Experience Platform Launch部分的配置步驟。 不過，不需要Experience Manager相關的設定步驟。

在正確設定後，您可以使用Dynamic Media檢視器將Experience Platform Launch支援新增至網頁。

請參閱新增Platform launch內嵌程式碼以進一步了解如何使用Experience Platform Launch程式庫內嵌程式碼。

若要使用內嵌程式碼追蹤Dynamic Media檢視器：

  1. 為內嵌Dynamic Media檢視器的網頁做好準備。
  2. 先登入Experience Platform Launch，取得Experience Platform Launch程式庫的內嵌程式碼(請參閱設定Experience Platform Launch)。
  3. 按一下「屬性」，然後按一下「環境」標籤。
  4. 挑選與網頁環境相關的環境層級。 然後，在​Install​欄中，按一下方塊圖示。
  5. 在「Web安裝指 示」對話方塊中，複製完整的Experience Platform Launch程式庫內嵌程式碼以及周圍的 <script/> 標籤。

Dynamic Media檢視器擴充功能參考指南

關於Dynamic Media檢視器設定

如果下列條件成立，Dynamic Media檢視器擴充功能會自動與Experience Platform Launch程式庫整合：

  • Experience Platform Launch庫全局對象(_satellite)出現在頁面上。

  • Dynamic Media檢視器擴充功能_dmviewers_v001()已定義於_satellite上。

  • config2= 檢視器參數未指定，這表示檢視器不使用舊版Analytics整合。

此外，還有選項可在檢視器的設定中指定launch=0參數，以明確停用檢視器中的Experience Platform Launch整合。 此參數的預設值為1。

設定Dynamic Media檢視器擴充功能

Dynamic Media檢視器擴充功能的唯一設定選項是「啟用音訊和視訊Adobe Medium分析」。

當您勾選（啟用）此選項，並安裝及設定「Adobe MediumAnalytics for Audio and Video」擴充功能時，視訊播放量度會傳送至Adobe Analytics for Audio and Video解決方案。 停用此選項會關閉視訊追蹤。

如果您啟用此選項​而未安裝 Adobe MediumAnalytics for Audio and Video擴充功能，則此選項沒有作用。

image2019-7-22_12-4-23

關於Dynamic Media檢視器擴充功能中的資料元素

「動態媒體檢視器」擴充功能提供的唯一「資料元素」類型是「資 料元素類型」下拉式清單中的「檢​​ 視器事件」。

選取後，資料元素編輯器會轉譯包含兩個欄位的表單：

  • DM檢視器事件資料類型 -一個下拉式清單，可識別動態媒體檢視器擴充功能支援的所有檢視器事件 (具有引數)，加上特殊的 COMMON 項目。COMMON ​​項目代表檢視器所傳送之所有類型事件的共同事件參數清單。
  • 追蹤參數 — 所選Dynamic Media檢視器事件的引數。

image2019-7-22_12-5-46

如需各檢視器類型支援的事件清單，請參閱Dynamic Media檢視器參考指南;前往「特定檢視器」區段，然後按一下「支援Adobe Analytics追蹤」區段。 目前，Dynamic Media檢視器參考指南不會記錄事件引數。

現在請考量Dynamic Media檢視器​資料元素​的生命週期。 此類「資料元素」的值會在頁面上發生對應的Dynamic Media檢視器事件後填入。 例如，假設資料元素指向​LOAD​事件及其"asset"引數。 在這種情況下，當檢視器首次執行​LOAD​事件後，此類資料元素的值會接收有效資料。 如果資料元素指向​ZOOM​事件及其"scale"引數，則此類資料元素的值會保持空白，直到檢視器首次傳送​ZOOM​事件為止。

同樣地，當檢視器在頁面上傳送對應事件時，資料元素的值也會自動更新。即使未在規則設定中指定特定事件，也會進行值更新。例如，假設為ZOOM事件的"scale"參數定義了資料元素​ZoomScale。 不過，規則設定中唯一存在的規則是由​LOAD​事件觸發。 每次使用者在檢視器內執行縮放時，ZoomScale​的值仍會更新。

任何動態媒體檢視器在網頁上都有唯一識別碼。「資料元素」會追蹤值本身，以及填入值的檢視器。 例如，假設同一頁面上有數個檢視器，且有一個​AssetName​資料元素指向​LOAD​事件及其"asset"引數。 「AssetName​資料元素」會維護與頁面上載入的每個檢視器相關聯的資產名稱集合。

資料元素傳回的確切值取決於內容。 如果在由Dynamic Media檢視器事件觸發的規則中請求資料元素，則會為啟動規則的檢視器傳回資料元素值。 而且，資料元素是在某個其他Platform launch擴充功能的事件所觸發的規則中請求。 此時，資料元素的值會來自上次更新此資料元素的檢視器。

請考量下列範例設定：

  • 具有兩個Dynamic Media縮放檢視器的網頁：viewer1​和​viewer2。

  • ​​ZoomScaleData元素指向ZOOMevent ​​及其「scale」引數。

  • ​​TrackPanRule，包含下列項目：

    • 使用Dynamic Media檢視器​PAN​事件作為觸發器。
    • 將​ZoomScale​資料元素的值傳送至Adobe Analytics。

  • ​​TrackKeyRule，包含下列項目：

    • 使用核心Experience Platform Launch擴充功能的按鍵事件作為觸發器。
    • 將​ZoomScale​資料元素的值傳送至Adobe Analytics。

現在，假設使用者載入包含兩個檢視器的網頁。 在​viewer1​中，它們放大至50%比例；然後，在​viewer2​中，它們會放大至25%縮放。 在​viewer1​中，它們將影像平移，最後在鍵盤上選取鍵。

一般使用者的活動會導致對Adobe Analytics進行下列兩個追蹤呼叫：

  • 第一次呼叫的發生是因為當使用者在​viewer1​中平移時，會觸發​TrackPan​規則。 該呼叫會傳送50%作為​ZoomScale​資料元素的值，因為資料元素知道規則是由​viewer1​觸發，並擷取對應的縮放值；
  • 第二個呼叫是因為當使用者按下鍵盤上的鍵時，會觸發​TrackKey​規則。 該呼叫會傳送25%作為​ZoomScale​資料元素的值，因為檢視器未觸發規則。 因此，資料元素會傳回最新的值。

上述設定的範例也會影響「資料元素」值的壽命。 即使檢視器本身已置於網頁上，由Dynamic Media檢視器管理的資料元素值仍會儲存在Platform launch程式庫程式碼中。 此功能表示，如果有非Dynamic Media檢視器擴充功能觸發的規則並參考這類資料元素，資料元素會傳回最後一個已知值。 即使檢視器不再存在於網頁上。

無論如何，由Dynamic Media檢視器驅動的資料元素值不會儲存在本機儲存體或伺服器上；而是只會保留在用戶端Experience Platform Launch程式庫中。 當網頁重新載入時，這類資料元素的值會消失。

通常，資料元素編輯器支援儲存持續時間選擇。 不過，使用Dynamic Media檢視器擴充功能的資料元素僅支援​None​的儲存期間選項。 在使用者介面中可設定任何其他值，但在此情況下未定義資料元素行為。 擴充功能會自行管理資料元素的值：在整個檢視器生命週期中維護檢視器事件引數值的資料元素。

關於Dynamic Media檢視器擴充功能中的規則

在規則編輯器中，擴充功能會為事件編輯器新增設定選項。 此外，編輯器也提供選項，讓您以簡短選項的形式手動參考動作編輯器中的事件參數，而非使用預先設定的資料元素。

關於事件編輯器

在「事件」編輯器中，「Dynamic Media檢視器」擴充功能會新增​名為​[!UICONTROL Viewer Event]​的「事件類型」。

選取時，事件編輯器會轉譯下拉式清單​Dynamic Media檢視器事件，列出Dynamic Media檢視器支援的所有可用事件。

image2019-8-2_15-13-1

關於動作編輯器

Dynamic Media檢視器擴充功能可讓您使用Dynamic Media檢視器的事件參數，對應至Adobe Analytics擴充功能的「設定變數」編輯器中的分析變數。

最簡單的方法是完成下列兩步驟程式：

  • 首先，定義一或多個資料元素，其中每個資料元素代表Dynamic Media檢視器事件的參數。
  • 最後，在Adobe Analytics擴充功能的「設定變數」編輯器中，按一下「資料元素」選取器圖示（三個堆疊磁碟）以開啟「選取資料元素」對話方塊，然後從中選取資料元素。

image2019-7-10_20-41-52

不過，您也可以使用替代方法並略過「資料元素」的建立。您可以直接參考Dynamic Media檢視器事件的引數。 在Analytics變數指派的​value​輸入欄位中，輸入事件引數的完全限定名稱。 請務必用百分比(%)的標誌包圍它。 例如，

%event.detail.dm.LOAD.asset%

image2019-7-12_19-2-35

使用資料元素和直接事件引數參考之間有重要的差異。 對於資料元素，哪個事件會觸發「設定變數」動作並不重要。 觸發規則的事件可能與動態檢視器無關。 例如，按一下核心擴充功能中的網頁。 但是，使用直接引數參考時，請務必確保觸發規則的事件與其參考的事件引數相對應。

例如，如果 %event.detail.dm.LOAD.asset% 規則是由動態媒體檢視器擴充功能的 LOAD 事件觸發，則參照會傳回正確的資產名稱。但是，它會傳回任何其他事件的空白值。

下表列出Dynamic Media檢視器事件及其支援的引數：

檢視器事件名稱 引數參考
COMMON %event.detail.dm.objID%
%event.detail.dm.compClass%
%event.detail.dm.instName%
%event.detail.dm.timeStamp%
BANNER %event.detail.dm.BANNER.asset%
%event.detail.dm.BANNER.frame%
%event.detail.dm.BANNER.label%
HREF %event.detail.dm.HREF.rollover%
ITEM %event.detail.dm.ITEM.rollover%
LOAD %event.detail.dm.LOAD.applicationname%
%event.detail.dm.LOAD.asset%
%event.detail.dm.LOAD.company%
%event.detail.dm.LOAD.sdkversion%
%event.detail.dm.LOAD.viewertype%
%event.detail.dm.LOAD.viewerversion%
METADATA %event.detail.dm.METADATA.length%
%event.detail.dm.METADATA.type%
MILESTONE %event.detail.dm.MILESTONE.milestone%
PAGE %event.detail.dm.PAGE.frame%
%event.detail.dm.PAGE.label%
PAUSE %event.detail.dm.PAUSE.timestamp%
PLAY %event.detail.dm.PLAY.timestamp%
SPIN %event.detail.dm.SPIN.framenumber%
STOP %event.detail.dm.STOP.timestamp%
SWAP %event.detail.dm.SWAP.asset%
SWATCH %event.detail.dm.SWATCH.frame%
%event.detail.dm.SWATCH.label%
TARG %event.detail.dm.TARG.frame%
%event.detail.dm.TARG.label%
ZOOM %event.detail.dm.ZOOM.scale%

配置所有整合部件

開始之前

Adobe建議您仔細檢閱本節之前的所有檔案，以了解完整的整合。

本節說明整合Dynamic Media檢視器與Adobe Analytics和Adobe Analytics for Audio and Video所需的設定步驟。 雖然可將Dynamic Media檢視器擴充功能用於Experience Platform Launch中的其他用途，但本檔案未涵蓋此類案例。

您將使用下列Adobe產品來設定整合：

  • Adobe Analytics — 用來設定追蹤變數和報表。
  • Experience Platform Launch — 用來定義屬性、一或多個規則以及一或多個資料元素，以啟用檢視器追蹤。

此外，如果此整合解決方案用於Experience Manager網站，也必須進行下列設定：

  • Adobe I/O 主控台 — 已針對Experience Platform Launch建立整合。
  • Experience Manager製作節點 — IMS設定和Experience Platform Launch雲端設定。

在設定中，請確定您擁有已啟用Adobe Analytics和Experience Platform Launch之Adobe Experience Cloud中公司的存取權。

為整合配置Adobe Analytics

設定Adobe Analytics後，將針對整合設定下列項目：

  • 報表套裝已就緒且已選取。
  • Analytics變數可用來接收追蹤資料。
  • 報表可用來檢視Adobe Analytics內收集的資料。

另請參閱Analytics實作指南。

若要設定Adobe Analytics以進行整合：

  1. 首先，從Experience Cloud首頁存取Adobe Analytics。 在功能表列中，按一下頁面右上角附近的「解決方案」圖示（三乘三個點表），然後按一下​Analytics。

    2019-07-22_18-08-47

    現在選取報表套裝。

選取報表套裝

  1. 在Adobe Analytics頁面的右上角，「搜尋報表」欄位的右側，從下拉式清單中選取正確的報表套裝。​​如果有多個報表套裝可供使用，而您不確定要使用哪個報表套裝，請連絡您的Adobe Analytics管理員，以協助您選取要使用哪個報表套裝。

    在下方螢幕擷取中，使用者建立了名為​DynamicMediaViewersExtensionDoc​的報表套裝，並從下拉式清單中選取該報表套裝。 報表套裝名稱僅是範例名稱。 您最終選取的報表套裝名稱由您決定。

    如果沒有可用的報表套裝，您或您的Adobe Analytics管理員必須先建立報表套裝，才能繼續進行設定。

    請參閱報表與報表套裝和建立報表套裝。

    在Adobe Analytics中，報表套裝是在​Admin > 報表套裝​下管理。

    2019-07-22_18-09-49

    現在設定Adobe Analytics變數。

設定Adobe Analytics變數

  1. 指定一或多個您要用來追蹤網頁上Adobe Analytics檢視器行為的Dynamic Media變數。

    您可以使用Adobe Analytics支援的任何類型變數。 關於變數類型的決策(例如自訂流量[props]、轉換[eVar])是由您Analytics實作的特定需求所驅動。

    請參閱Prop和eVars概觀。

    在本檔案中，只有自訂流量(prop)變數會被使用，因為這些變數會在網頁上發生動作後幾分鐘內，便可在Analytics報表中使用。

    若要啟用新的自訂流量變數，請在Adobe Analytics的工具列中按一下​管理 > 報表套裝。

  2. 在​報表套裝管理器​頁面上，選取正確的報表，然後在工具列中按一下​編輯設定 > 流量 > 流量變數。

  3. 選取未使用的變數，為其指定描述性名稱(檢視器資產(prop 30))，並在「啟用」欄中將下拉式方塊變更為「已啟用」。

    以下螢幕擷取是自訂流量變數(prop30)的範例，用於追蹤檢視器使用的資產名稱：

    image2019-6-26_23-6-59

  4. 在變數清單的底部，按一下「儲存」。

設定報表

  1. 一般而言，在Adobe Analytics中設定報表是由特定專案需求所驅動。 因此，詳細的報表設定不在此整合的範圍內。

    不過，在您於設定Adobe Analytics變數中設定自訂流量變數後，您就可以知道自訂流量報表在Adobe Analytics中自動可用了。

    例如，檢視器資產(prop 30)​變數的報表可從​自訂流量 > 自訂流量21-30 > 檢視器資產(prop 30)​下的「報表」功能表取得。

    在檢視器資產(prop 30)建 立後立即造訪此報表 ，不會顯示任何資料；在這個整合階段，就是預期的。

    image2019-6-26_23-12-49

配置整合的Experience Platform Launch

設定Experience Platform Launch後，將針對整合設定下列項目：

  • 建立新屬性以將所有設定保持在一起。
  • 擴充功能的安裝與設定。 屬性中安裝之所有擴充功能的用戶端程式碼會一併編譯至程式庫中。 網頁稍後會使用此程式庫。
  • 資料元素和規則的設定。 此設定會定義要從Dynamic Media檢視器擷取的資料、觸發追蹤邏輯的時機，以及在Adobe Analytics中傳送檢視器資料的位置。
  • 程式庫的發佈。

若要設定整合的Experience Platform Launch:

  1. 首先，從Experience Cloud首頁存取Experience Platform Launch。 在功能表列中，按一下頁面右上角附近的「解決方案」圖示（三乘三個點表），然後按一下​Launch。

    您也可以直接開啟Experience Platform Launch。

    image2019-7-8_15-38-44

在Experience Platform Launch中建立屬性

Experience Platform Launch中的屬性是已命名的設定，可讓所有設定保持一致。 會產生配置設定的程式庫，並發佈至不同的環境層級（開發、測試和生產）。

另請參閱建立Launch屬性。

  1. 在Experience Platform Launch中，按一下​新屬性。

  2. 在「建 立屬性 」對話方塊的「名稱 ​​」欄位中，輸入描述性名稱，例如網站的標題。例如， DynamicMediaViewersProp.

  3. 在​網域​欄位中，輸入網站的網域。

  4. 在​進階選項​下拉式清單中，啟用​設定擴充功能開發（以後無法修改），以備您要使用的擴充功能(在此例中為​Dynamic Media檢視器)尚未發行時使用。

    image2019-7-8_16-3-47

  5. 按一下「儲存」。

    按一下新建立的屬性，然後繼續​安裝和設定擴展。

安裝和設定擴充功能

Experience Platform Launch中所有可用的擴充功能都列在​擴充功能 > Catalog​下方。

若要安裝擴充功能，請按一下「安裝」。 如果需要，請執行一次性擴展配置，然後按一下​Save。

視需要，必須安裝並設定下列擴充功能：

  • （必要）Experience CloudID服務​擴充功能。

無需額外設定，接受任何建議的值。 完成後，請務必按一下​Save。

請參閱Experience CloudID服務擴充功能。

  • （必要）Adobe Analytics​擴充功能

若要設定此擴充功能，您需要位於Adobe Analytics中​Admin > Report Suite​下方的​Report Suite ID​欄標題下方的報表套裝ID。

(僅供展示之用，DynamicMediaViewersExtensionDoc​報表套裝的報表套裝ID用於下列螢幕擷取畫面。 此ID已建立並用於 選取報表套裝 。)

image2019-7-8_16-45-34

在「安裝擴充功能」頁面的「開發報表套裝」欄位中，輸入「報表套裝ID」。此欄位包括「 測試報表套裝」欄位和「 生產報表套裝 ​​​ 」欄位。

image2019-7-8_16-47-40

只有在您打算使用視訊追蹤時，才設定下列項目：

在​安裝擴充功能​頁面上，展開​一般，然後指定追蹤伺服器。 追蹤伺服器會遵循範本<trackingNamespace>.sc.omtrdc.net，其中<trackingNamespace>是在布建電子郵件中取得的資訊。

按一下「儲存」。

請參閱Adobe Analytics擴充功能。

  • (可選；僅在需要視訊追蹤時才需要)Adobe MediumAnalytics for Audio and Video​擴充功能

填寫追蹤伺服器欄位。 Adobe MediumAnalytics for Audio and Video​擴充功能的追蹤伺服器與Adobe Analytics使用的追蹤伺服器不同。 它遵循範本<trackingNamespace>.hb.omtrdc.net，其中<trackingNamespace>是布建電子郵件的資訊。

所有其他欄位均為選用。

請參閱Adobe MediumAnalytics for Audio and Video擴充功能。

  • （必要）Dynamic Media檢視器​擴充功能

選取 啟用Adobe Analytics for Video ，以啟用 (開啟) 視訊心率追蹤。

自撰寫本文起，Dynamic Media檢視器​擴充功能僅在為開發建立Experience Platform Launch屬性時才可用。

請參閱在Experience Platform Launch中建立屬性。

安裝擴充功能並完成設定後，至少下列五個擴充功能（若您未追蹤視訊，則為四個）會列在「擴充功能>已安裝」區域中。

image2019-7-22_12-7-36

設定資料元素和規則

在Experience Platform Launch中，建立追蹤Dynamic Media檢視器所需的資料元素和規則。

請參閱資料和事件追蹤在整合中的運作方式，以了解使用Experience Platform Launch追蹤的概觀。

如需Experience Platform Launch中的範例設定，如需示範如何在檢視器載入時追蹤資產名稱，請參閱範例設定。

如需擴充功能功能的深入資訊，請參閱設定Dynamic Media檢視器擴充功能。

發佈程式庫

若要變更Experience Platform Launch設定（包括已設定的「屬性」、「擴充功能」、「規則」和「資料元素」），您必須​publish​進行此類變更。 在Experience Platform Launch中發佈是從「屬性」設定下的「發佈」索引標籤執行。

platform launch可能有多個開發環境、一個測試環境和一個生產環境。 依預設，Experience Manager中的「Platform launch雲端設定」會將Experience Manager製作節點指向Platform launch的Stage環境。 「Experience Manager發佈」節點指向Platform launch的生產環境。 這表示使用預設的Experience Manager設定時，必須將Platform launch程式庫發佈至測試環境。 這麼做可讓您在Experience Manager作者中使用。 接著，您就可以將其發佈至生產環境，以便用於Experience Manager發佈。

如需Experience Platform Launch環境的詳細資訊，請參閱環境。

發佈程式庫包含下列兩個步驟：

  • 將所有必要的變更（新的變更和更新）加入程式庫，以新增和建置新程式庫。
  • 在不同環境層級（從開發到測試和生產）中向上移動程式庫。

添加和建立新庫

  1. 第一次在Experience Platform Launch中開啟「發佈」索引標籤時，程式庫清單為空。

    在左欄中，按一下​新增程式庫。

    image2019-7-15_14-43-17

  2. 在「建立新庫」頁的​Name​欄位中，為新庫輸入描述性名稱。 例如，

    DynamicMediaViewersLib

    從「環境」下拉式清單中，選擇「環境」層級。 起初，僅可選取開發層級。 在頁面的左下側附近，按一下「新增所有已變更的資源」。

    image2019-7-15_14-49-41

  3. 在頁面的右上角附近，按一下「儲存並建置以開發」。

    幾分鐘後，程式庫就會建立並可供使用。

    image2019-7-15_15-3-34

    注意

    下次您變更Experience Platform Launch設定時，請前往​Property​設定下的​Publishing​標籤，然後按一下先前建立的程式庫。

    在程式庫發佈畫面中，按一下​新增所有變更的資源，然後按一下​儲存並建置以開發。

在環境層級中上移程式庫

  1. 新增程式庫後，即可在開發環境中找到。 若要將其移至測試環境層級（對應至已提交欄），請在程式庫的下拉式功能表中，按一下「提交以進行核准」。

    image2019-7-15_15-52-37

  2. 在確認對話方塊中，按一下​提交。

    程式庫移至「已提交」欄後，從程式庫的下拉式功能表中，按一下「為測試建置​」。

    image2019-7-15_15-54-37

  3. 若要將程式庫從測試環境移至生產環境（即「已發佈」欄），請遵循類似的程式。

    首先，從下拉式功能表中按一下「核准以發佈」。

    image2019-7-15_16-7-39

  4. 從下拉式功能表中，按一下「建立並發佈至生產環境」。

    image2019-7-15_16-8-9

    請參閱發佈 ，以取得Experience Platform Launch中發佈程式的詳細資訊。

為整合配置Adobe Experience Manager

必備條件:

  • Experience Manager同時執行製作和發佈執行個體。
  • Experience Manager製作節點是在Dynamic Media - Scene7執行模式(dynamicmedia_s7)中設定
  • Dynamic Media WCM元件可在Experience Manager網站中啟用。

Experience Manager設定包含下列兩個主要步驟：

  • 設定Experience ManagerIMS
  • Experience Platform Launch雲的設定。

配置Experience ManagerIMS

  1. 在Experience Manager作者中，按一下「工具」圖示（槌子），然後按一下​Security > AdobeIMS設定。

    2019-07-25_11-52-58

  2. 在「AdobeIMC配置」頁的左上角附近，按一下​Create。

  3. 在​AdobeIMS技術帳戶設定​頁面的​雲端解決方案​下拉式清單中，按一下​Experience Platform Launch。

  4. 啟用​建立新憑證，然後在文字欄位中，為憑證輸入任何有意義的值。 例如， AdobeLaunchIMSCert。 按一下​建立憑證。

    將顯示以下資訊消息：

    若要擷取有效的存取權杖，新憑證的公開金鑰會新增至Adobe I/O的技術帳戶！

    要關閉「資訊」對話框，請按一下「確定」​。

    2019-07-25_12-09-24

  5. 若要將公開金鑰檔案(*.crt)下載到您的本地系統，請按一下「下載公開金鑰」。

    注意

    此時，請 開啟​Adobe IMS技術帳戶設定頁面 ;不 要關閉頁面 ，也不 要按「下一步 」。您稍後將在步驟中返回此頁面。

    2019-07-25_12-52-24

  6. 在新的瀏覽器標籤中，導覽至Adobe I/O Console。

  7. 在​Adobe I/O主控台整合​頁面右上角附近，按一下​新整合。

  8. 在「建 立新整合 」對話方塊中，確定已選取「 存取API 」選項按鈕，然後按一下「繼 續」。

    2019-07-25_13-04-20

  9. 在第二個「 建立新整合 」頁面上，啟用 (開啟) ​​Experience Platform Launch API選項按鈕。在頁面的右下角，按一下「繼 續」。

    2019-07-25_13-13-54

  10. 在第三個​建立新整合​頁面上，執行下列動作：

    • 在​名稱​欄位中，輸入描述性名稱。 例如， DynamicMediaViewersIO。

    • 在​Description​欄位中，輸入整合的說明。

    • 在​公開金鑰憑證​區域中，上傳您先前在這些步驟中下載的公開金鑰檔案(*.crt)。

    • 在​為Experience Platform LaunchAPI​標題下，選擇​管理。

    • 在​為Experience Platform LaunchAPI​標題選取一或多個產品設定檔，選取名為​Launch - <your_company_name>​的產品設定檔。

    2019-07-25_13-49-18

  11. 按一下​建立整合。

  12. 在​已建立的整合​頁面上，按一下​繼續前往整合詳細資料。

    2019-07-25_14-16-33

  13. 此時會出現整合詳細資訊頁面， ​​類似下列：

    注意

    請離開此「整合詳細資訊」頁面。您只需片刻，就會需要​Overview​和​JWT​標籤中的各種資訊。

    2019-07-25_14-35-30

    整合詳細資訊頁面。

  14. 返回您先前 未開啟的「Adobe IMS技術帳戶設定 」頁面。在頁面的右上角，按一下「下一 步 」以開啟「 ​​Adobe IMS Technical Account Configuration 」視窗中的「Account 」 (帳戶) 頁面。

    (如果您先前關閉頁面，請返回Experience Manager作者，然後按一下​工具 > 安全性 > AdobeIMS設定。 按一下​建立。在​雲端解決方案​下拉式清單中，選取​Experience Platform Launch。 在​Certificate​下拉式清單中，選取先前建立之憑證的名稱。)

    2019-07-25_20-57-50

    AdobeIMS技術帳戶設定 — 憑證頁面。

  15. 「帳戶」頁面有5個欄位，您必須使用上一步「整合詳細資訊」頁面中的資訊來填寫這些欄位。

    2019-07-25_20-42-45

    AdobeIMS技術帳戶設定 — 帳戶頁面。

  16. 在​Account​頁面上，填寫下列欄位：

    • 標題 — 輸入描述性帳戶標題。
    • 授權伺服器 — 返回您先前開啟的「整合詳細資訊」頁面。按一下​JWT​標籤。 複製伺服器名稱（不含路徑），如下方強調顯示。

（僅伺服器名稱為範例） 返回「帳 戶 」頁面，然後將名稱貼到相應欄位。例如， https://ims-na1.adobelogin.com/
（僅伺服器名稱為範例）

2019-07-25_15-01-53

整合詳細資料頁面 — JWT索引標籤

  1. API金鑰 -返回「整合詳細資訊」頁面。按一 下「概述 」標籤，然後按一下「 API金鑰 (用戶端ID) 」欄位右側的 「復 制」。

    返回​帳戶​頁面，然後將金鑰貼入相應的​​​欄位。

    2019-07-25_14-35-333

    整合詳細資訊頁面。

  2. 用戶端密碼-返回「整合詳細資訊」頁面。在「概述」 標籤中 ，按一下「 擷取用戶端密碼」。在「用戶端密碼」欄位的 右側 ，按一下「 複製」。

    返回「帳 戶 」頁面，然後將金鑰貼入個別欄位。

  3. 裝載 — 返回「整合詳細資訊」頁面。從​JWT​標籤的「JWT裝載」欄位中，複製整個JSON物件程式碼。

    返回「帳 戶 」頁面，然後將程式碼貼至個別欄位。

    2019-07-25_21-59-12

    整合詳細資訊頁面 — JWT索引標籤

    「帳戶」頁面已填入所有欄位，外觀如下：

    2019-07-25_22-08-30

  4. 在​Account​頁面的右上角附近，按一下​Create。

    設定Experience ManagerIMS後，您現在會在​AdobeIMS設定​下方列出新的IMSAccount。

    image2019-7-15_14-17-54

為整合配置Experience Platform Launch雲

  1. 在Experience Manager作者中，在左上角附近，按一下「工具」圖示（槌子），然後按一下「Cloud Services >Experience Platform Launch設定​」。

    2019-07-26_12-10-38

  2. 在​Experience Platform Launch配置​頁面的左側面板中，選擇要為其應用Experience Platform Launch配置的Experience Manager站點。

    僅供範例之用，下方螢幕擷取中會選取​We.Retail​網站。

    2019-07-26_12-20-06

  3. 在頁面左上角附近，按一下「建 立」。

  4. 在​建立Experience Platform Launch配置​窗口的​一般資訊​頁（1/3頁）上，填寫以下欄位：

    • 標題 — 輸入描述性的設定標題。例如， We.Retail Launch cloud configuration。

    • 關聯AdobeIMS設定 — 選取您先前在設定Experience ManagerIMS中建 立的IMS設定。

    • 公司 — 從「 ​​公司」下拉式清單中，選取您的Experience Cloud公司。清單會自動填入。

    • 屬性 — 從「屬性」下拉式清單中，選取您先前建立的Experience Platform Launch屬性。清單會自動填入。

    填妥所有欄位後，您的​一般​頁面看起來將類似下列：

    image2019-7-15_14-34-23

  5. 在左上角附近，按一下​Next。

  6. 在​建立Experience Platform Launch配置​窗口的​測試​頁（2/3頁）上，填寫以下欄位：

    在​程式庫URI​欄位中，檢查Experience Platform Launch程式庫的測試版本位置。 Experience Manager會自動填入此欄位。

    此步驟僅用於Experience Platform Launch程式庫，部署用於AdobeCDN。

    注意

    檢查以確定自動填入的庫URI（統一資源標識符）的格式不正確。 如有必要，請修正它，使URI表示協定相對URI。 也就是說，從雙正斜線開始。

    例如：//assets.adobetm.com/launch-xxxx。

    您的​測試​頁面可能出現如下。 Archive​和​Load Library Assorly​選項為​not​設定：

    image2019-7-15_15-21-8

  7. 在右上角附近，按一下​Next。

  8. 在​建立Experience Platform Launch配置​窗口的​生產​頁面（3/3頁）上，根據需要修復自動填入的生產URI，如同在前一個​測試​頁面上所做的操作。

  9. 在右上角附近，按一下​Create。

    您的新Experience Platform Launch雲端設定現在會建立，並列在您的網站旁，類似下列範例：

  10. 選取新的Experience Platform Launch雲端設定（選取時，設定標題左側會顯示勾號）。 在工具列上，按一下​Publish。

    image2019-7-15_15-47-6

目前，Experience Manager作者不支援Dynamic Media檢視器與Experience Platform Launch的整合。

不過，Experience Manager發佈節點支援此功能。 使用「Platform launch雲端設定」的預設設定，Experience Manager發佈節點會使用Experience Platform Launch的生產環境。 因此，在測試期間，必須每次都將Experience Platform Launch程式庫更新從開發推送至生產環境。

您可以解決此限制。 在上方Platform launch發佈節點的Platform launch雲端設定中，指定Experience Manager程式庫的開發或測試URL。 這樣會使Experience Manager發佈節點使用Platform launch程式庫的開發或測試版本。

如需設定Experience Manager雲設定的詳細資訊，請參閱透過 Adobe I/O整合Experience Platform Launch與Experience Platform Launch。

本頁內容