Audience Activation
Audience Activation擴充功能可讓您在Adobe Commerce中啟用Real-Time CDP對象,以在購物車中建立唯一優惠方案。 這些優惠和獎勵包括常見的電子商務銷售技巧,例如 購買2獲得1免費、針對該客戶的主圖橫幅,以及通過各種優惠修改產品價格。 在Real-Time CDP中建立的受眾是以來自各種企業系統的資料為基礎,例如企業資源規劃(ERP)、客戶關係管理(CRM)、銷售點和行銷系統。 由於客戶區段資訊會持續更新,因此當客戶在您的商店購物時,他們可能會與區段建立關聯或解除關聯。
您可以在Luma店面或Headless店面中啟用對象。 在Luma店面中,對象資訊(區段會籍)會儲存在Commerce側的Cookie中。 在Headless店面中,受眾資訊會作為引數傳遞到GraphQL API標題,名稱為: aep-segments-membership
。
發行說明
本節包含Audience Activation擴充功能更新的相關資訊,並包含:
— 新功能
— 修正和改良
— 已知問題
請參閱即將發行的版本,瞭解發行排程和支援。
請參閱開發人員檔案以瞭解產品相容性。
支援的服務更新
以下發行說明說明說明說明Audience Activation所用擴充功能的相關功能變更和修正。
2023年8月15日
— 已更新Real-Time CDP Audiences儀表板以簡化篩選。
2023年6月27日
— 已在magento/module-data-services-graphql
封裝中新增對PHP 8.2的支援。
2023年5月30日
— 已更新Real-Time CDP對象儀表板,以包含排序、搜尋和篩選Adobe Commerce執行個體中作用中對象的能力。
2.3.0
[相容性]{class="badge informative" title="相容性"}
2024年7月29日
— 新增命令列語法,因此您可以測試認證以判斷是否需要更新認證以從Adobe Experience Platform提取對象資料。
2.2.0
[相容性]{class="badge informative" title="相容性"}
2024年6月12日
受眾通知的 - 相關產品規則的GA版本。
2.1.1
[相容性]{class="badge informative" title="相容性"}
2024年4月4日
— 已新增對PHP 8.3的支援。
2.2.0-beta1
[相容性]{class="badge informative" title="相容性"}
2024年2月16日
— 如果您正在參與Beta版,請確定您的composer.json
檔案在根層級有下列專案: "minimum-stability": "beta"
。
- (Beta)已新增從受眾通知建立相關產品規則的功能。
2.1.0
[相容性]{class="badge informative" title="相容性"}
2024年1月24日
— 更新Real-Time CDP對象儀表板,以納入包含對象的網站,並指定哪些動態區塊和購物車價格規則設定為使用這些對象。
2.0.1
[相容性]{class="badge informative" title="相容性"}
2023年11月16日
— 改善穩定性。
2.0.0
[相容性]{class="badge informative" title="相容性"}
2023年10月10日
— 新增在設定Audience Activation延伸時對OAuth 2.0的支援。
— 改善穩定性。
1.2.0
[相容性]{class="badge informative" title="相容性"}
2023年8月15日
— 已更新UI元件版本。
1.1.0
2023年5月30日
[相容性]{class="badge informative" title="相容性"}
— 已在Headless店面中新增對動態區塊的支援。
1.0.1
2023年5月11日
[相容性]{class="badge informative" title="相容性"}
— 修正動態區塊或購物車價格規則未套用至店面的問題。
— 修正當商家嘗試建立或更新動態區塊時,未設定的Audience Activation延伸安裝導致錯誤的問題。
1.0.0
2023年3月31日
[相容性]{class="badge informative" title="相容性"}
— 一般可用性版本
實施
以下工作同時適用於Luma和Headless店面實施。 若要在Adobe Commerce中啟用對象,您必須:
安裝擴充功能
從市集安裝Audience Activation擴充功能,或執行以下命令:
composer require magento/audiences
設定擴充功能
安裝Audience Activation擴充功能後,您必須登入Commerce管理員並完成下列作業:
-
在 管理員 側邊欄上,移至 System > Services>Commerce Services Connector。
-
登入您的Adobe帳戶並選取您的組織ID。
-
在 管理員 側邊欄上,移至 System > Services>Data Connection。
-
在 Datastream ID 欄位中,貼上您啟用 Adobe Commerce時建立的資料串流識別碼,作為Real-Time CDP中的目的地。
此資料流會將資料從您的Commerce網站傳送至Real-Time CDP,以判斷購物者是否屬於受眾。 如果您尚未建立資料流,請在Experience Platform中建立資料流,🔗將其新增至Real-Time CDP中的Commerce目的地,以及在Admin中的Data Connection擴充功能。
note note NOTE 當您指定資料串流ID時,就會將其與Data Connection擴充功能中的特定網站建立關聯。 如果您的Commerce商店有多個網站,請在Real-Time CDP中為每個網站建立目的地,並為每個網站使用不同的資料串流ID。 -
在 管理員 側邊欄上,移至 Stores > Settings>Configuration。
-
展開 Services 並選取 Data Connection。
-
新增服務帳戶與認證詳細資料。
在Commerce中的何處使用Real-Time CDP受眾
啟用Audience Activation擴充功能後,您可以:
Real-Time CDP受眾控制面板
您可以使用 Real-Time CDP Audiences 儀表板,檢視可在Adobe Commerce執行個體中個人化的所有作用中對象。
若要存取 Real-Time CDP Audiences 儀表板,請前往 管理員 側邊欄,然後前往 Customers > Real-time CDP Audience。
儀表板包含下列欄位:
Hide filters
Last updated
個篩選器。 此篩選器可讓您根據上次更新對象的時間來選取對象的日期範圍。Search
Name
Origin
Experience Platform
。Websites
Dynamic Blocks
Cart Price Rules
Related Product Rules
Last updated
Sync now
Customize table
Origin
、Websites
、Dynamic Blocks
、Cart Price Rules
和Last updated
欄。Headless支援
您可以在Headless Adobe Commerce例項(例如AEM和PWA)中啟用對象,以根據對象顯示購物車價格規則、相關產品規則或動態區塊。
購物車價格規則和相關產品規則
針對購物車價格規則和相關產品規則,Headless店面會透過Commerce integration framework(CIF)與Experience Platform通訊。 此架構提供使用GraphQL實作的伺服器端API。 對象資訊(例如購物者的區段)會透過名為aep-segments-membership
的GraphQL標題引數傳遞至Commerce。
整體架構如下:
在您安裝並設定擴充功能後,Experience PlatformWeb SDK會以區段會籍的形式包含對象資訊。
若要從SDK擷取這些區段會籍,請參閱此程式碼片段。
擷取區段後,您可以在GraphQL標題中將這些區段傳遞至Commerce。 例如:
curl 'http://magento.config/graphql' -H 'Authorization: Bearer abc123' -H 'aep-segments-membership: urlencoded_list_of_segments' -H 'Content-Type: application/json' --data-binary '{"query":"query {\ncustomer {\nfirstname\nlastname\nemail\n}\n}"}'
動態區塊
對於動態區塊,GraphQL dynamicBlocks
查詢可以包含audience_id
輸入屬性。 如果您在dynamicBlocks
查詢中指定一或多個audience_id
值,它會傳回指派給這些對象的動態區塊清單。
使用範例
下列查詢會傳回與多個對象ID相關聯的所有動態區塊。
要求:
{
dynamicBlocks(input:
{
type: SPECIFIED
audience_id: {
in: [
"cd29a789-9be8-40ad-a1ef-640c33b3742e"
"92c3e14d-c72b-40d0-96b7-b96801dcc135"
]
}
})
{
items {
uid
audience_id
content {
html
}
}
page_info {
current_page
page_size
total_pages
}
total_count
}
}
回應:
{
"data": {
"dynamicBlocks": {
"items": [
{
"uid": "MQ==",
"audience_id": [
"cd29a789-9be8-40ad-a1ef-640c33b3742e"
],
"content": {
"html": "<h2><strong>SAVE 20%</strong></h2>\r\n<p>(some restrictions apply)</p>\r\n<p> </p>"
}
},
{
"uid": "Mg==",
"audience_id": [
"cd29a789-9be8-40ad-a1ef-640c33b3742e",
"92c3e14d-c72b-40d0-96b7-b96801dcc135"
],
"content": {
"html": "<p><img src=\"{{media url="wysiwyg/save20.png"}}\" alt=\"save 20% red\"></p>"
}
}
],
"page_info": {
"current_page": 1,
"page_size": 20,
"total_pages": 1
},
"total_count": 2
}
}
}
在開發人員檔案中進一步瞭解dynamicBlocks
GraphQL查詢。
使用Adobe Experience Platform Mobile SDK擷取對象
您可以使用Adobe Experience Platform Mobile SDK擷取Real-Time CDP閱聽眾。
- 安裝Audience Activation延伸。
- 為您的行動Commerce網站安裝並設定SDK。
完成設定後,請使用行動SDK操作來擷取受眾資料。 例如:
Edge.sendEvent(experienceEvent: experienceEvent) { (handles: [EdgeEventHandle]) in
for handle in handles {
if handle.type == "activation:pull" {
let payloadItems = handle.payload ?? []
for payloadItem in payloadItems {
if let segments = payloadItem["segments"] as? any Sequence {
var segmentsArr = [Any]()
for segment in segments {
let response = segment as AnyObject?
segmentsArr.append(response?.object(forKey: "id")! ?? "")
}
print("Saving segments -> \(segments)")
storage.set(segmentsArr, forKey: "segments")
print("End saving segments")
}
// Show segments
let rSegments = storage.object(forKey: "segments") ?? nil;
print("Retrieving segments -> \(rSegments)")
}
}
}
}
對象不會顯示在Commerce中
如果Real-Time CDP對象未顯示在Commerce中,原因可能是:
- 無效的連線
- 在 資料連線 設定頁面中選取的驗證型別不正確
- 產生的權杖上的許可權不足
以下小節說明如何疑難排解這些問題。
驗證連線
若要驗證Adobe Experience Platform的認證和回應,請執行以下命令:
bin/magento audiences:config:status
此命令會傳回連線狀態。 新增-v
旗標以提供額外的詳細資訊:
./bin/magento audiences:config:status -v
例如:
+----------------------------------+---------------+---------------------------------------------+---------------------------------------------------------+--------------+
| Client ID | Client secret | Technical account ID | Technical account email | Sandbox name |
+----------------------------------+---------------+---------------------------------------------+---------------------------------------------------------+--------------+
| 1234bd57fac8497d8933327c535347d8 | ***** | 12341E116638D6B00A495C80@techacct.adobe.com | 12345-b95b-4894-a41c-a4130d26bd80@techacct.adobe.com | dev |
設定中選取的驗證型別不正確
- 開啟您的Commerce執行個體。
- 在 管理員 側邊欄上,移至 Stores > Settings>Configuration。
- 展開 Services 並選取 Data Connection。
- 確定您在 Authentication Type 欄位中指定的伺服器對伺服器授權方法正確。 Adobe建議使用 OAuth。 已棄用JWT。 深入瞭解。
產生的權杖上的許可權不足
此問題可能是由於所產生Token的API許可權不足所導致。 若要確保權杖具有正確的許可權:
- 識別組織中Adobe Experience Platform的系統管理員。
- 尋找您將使用的專案和認證。
- 識別技術帳戶電子郵件,例如:
fe3c9476-1234-1234-abcd-2a51a785009a@techacct.adobe.com
。 - 請系統管理員啟動Adobe Experience Platform並移至 Permissions -> Users -> API credentials。
- 使用上方的技術帳戶電子郵件,搜尋要修改的認證。
- 開啟認證,然後選取 Roles -> Add roles。
- 新增包含 Manage destinations 許可權的角色。
- 按一下 Save。
- 在主控台中重新產生存取權杖。
- 使用Target連線API驗證Token是否提供有效的回應。