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中啟用對象,您必須:

  • 安裝Adobe Commerce 2.4.4版或更高版本
  • 在Real-Time CDP中啟動 Adobe Commerce作為目的地
  • 在Admin中安裝 Audience Activation擴充功能
  • 在Admin中設定 Audience Activation擴充功能

安裝擴充功能

市集安裝Audience Activation擴充功能,或執行以下命令:

composer require magento/audiences

設定擴充功能

安裝Audience Activation擴充功能後,您必須登入Commerce管理員並完成下列作業:

  1. 在​ 管理員 ​側邊欄上,移至​ System > Services>Commerce Services Connector

  2. 登入您的Adobe帳戶並選取您的組織ID。

  3. 在​ 管理員 ​側邊欄上,移至​ System > Services>Data Connection

  4. 在​ 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。
  5. 在​ 管理員 ​側邊欄上,移至​ Stores > Settings>Configuration

  6. 展開​ Services ​並選取​ Data Connection

  7. 新增服務帳戶與認證詳細資料。

在Commerce中的何處使用Real-Time CDP受眾

啟用Audience Activation擴充功能後,您可以:

TIP
如需有關如何將Commerce資料匯出至Real-Time CDP、建立對象,然後將該對象啟用至Commerce的完整端對端使用案例,請參閱使用 Commerce 事件資料在Real-Time CDP中建立對象

Real-Time CDP受眾控制面板

您可以使用​ Real-Time CDP Audiences ​儀表板,檢視可在Adobe Commerce執行個體中個人化的所有作用中對象。

若要存取​ Real-Time CDP Audiences ​儀表板,請前往​ 管理員 ​側邊欄,然後前往​ Customers > Real-time CDP Audience

Real-Time CDP受眾控制面板

儀表板包含下列欄位:

說明
Hide filters
可讓您顯示或隱藏可套用至控制面板的任何篩選器。 目前您只能套用Last updated個篩選器。 此篩選器可讓您根據上次更新對象的時間來選取對象的日期範圍。
Search
可讓您在Commerce例項中搜尋作用中對象。
Name
在Real-Time CDP中提供給對象的名稱。
Origin
指出對象的來源,例如Experience Platform
Websites
指出哪些網站已設定為可使用對象。
Dynamic Blocks
指出哪些動態區塊已設定為可使用對象。
Cart Price Rules
指出哪些購物車價格規則已設定為使用對象。
Related Product Rules
指出哪些相關產品規則已設定為使用對象。
Last updated
表示對象在Real-Time CDP中的修改時間。
Sync now
從Real-Time CDP擷取新的或更新對象。
Customize table
可讓您顯示或隱藏OriginWebsitesDynamic BlocksCart Price RulesLast updated欄。

Headless支援

您可以在Headless Adobe Commerce例項(例如AEM和PWA)中啟用對象,以根據對象顯示購物車價格規則、相關產品規則或動態區塊。

購物車價格規則和相關產品規則

針對購物車價格規則和相關產品規則,Headless店面會透過Commerce integration framework(CIF)與Experience Platform通訊。 此架構提供使用GraphQL實作的伺服器端API。 對象資訊(例如購物者的區段)會透過名為aep-segments-membership的GraphQL標題引數傳遞至Commerce。

整體架構如下:

從Headless店面傳送資料到後端

在您安裝設定擴充功能後,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>&nbsp;</p>"
          }
        },
        {
          "uid": "Mg==",
          "audience_id": [
            "cd29a789-9be8-40ad-a1ef-640c33b3742e",
            "92c3e14d-c72b-40d0-96b7-b96801dcc135"
          ],
          "content": {
            "html": "<p><img src=\"{{media url=&quot;wysiwyg/save20.png&quot;}}\" 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閱聽眾。

  1. 安裝Audience Activation延伸。
  2. 為您的行動Commerce網站安裝並設定SDK。
IMPORTANT
適用於iOS的Adobe Experience Platform Mobile SDK支援iOS 11或更新版本。

完成設定後,請使用行動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應用程式中使用該資料建立對象知悉的購物車價格規則動態區塊相關的產品規則

對象不會顯示在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          |

設定中選取的驗證型別不正確

  1. 開啟您的Commerce執行個體。
  2. 在​ 管理員 ​側邊欄上,移至​ Stores > Settings>Configuration
  3. 展開​ Services ​並選取​ Data Connection
  4. 確定您在​ Authentication Type ​欄位中指定的伺服器對伺服器授權方法正確。 Adobe建議使用​ OAuth。 已棄用JWT。 深入瞭解

產生的權杖上的許可權不足

此問題可能是由於所產生Token的API許可權不足所導致。 若要確保權杖具有正確的許可權:

  1. 識別組織中Adobe Experience Platform的系統管理員。
  2. 尋找您將使用的專案和認證。
  3. 識別技術帳戶電子郵件,例如: fe3c9476-1234-1234-abcd-2a51a785009a@techacct.adobe.com
  4. 請系統管理員啟動Adobe Experience Platform並移至​ Permissions -> Users -> API credentials
  5. 使用上方的技術帳戶電子郵件,搜尋要修改的認證。
  6. 開啟認證,然後選取​ Roles -> Add roles
  7. 新增包含​ Manage destinations ​許可權的角色。
  8. 按一下​ Save
  9. 在主控台中重新產生存取權杖。
  10. 使用Target連線API驗證Token是否提供有效的回應。
recommendation-more-help
09e7db7e-4210-474a-8bbf-c72a92c7537c