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所用擴充功能的相關功能變更和修正。

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管理員並完成下列作業：

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

啟用Audience Activation擴充功能後，您可以：

Real-Time CDP受眾控制面板

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

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

儀表板包含下列欄位：

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>&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閱聽眾。

完成設定後，請使用行動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中，原因可能是：

以下兩節說明如何疑難排解任一案例。

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

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

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