Audience Activation

この Audience Activation 拡張機能を使用すると、Adobe CommerceでReal-Time CDP オーディエンスをアクティブ化して、買い物かごに一意のオファーを作成できます。 これらのオファーとインセンティブには、一般的な e コマースマーチャンダイジング手法が含まれ、例えば次のようなものがあります 2 つ購入すると 1 つ無料、その顧客に向けたヒーローバナーで、様々なオファーを通じて製品の価格を変更しました。 Real-Time CDP内に構築されるオーディエンスは、エンタープライズリソースプランニング（ERP）、顧客関係管理（CRM）、POS、マーケティングシステムなど、様々なエンタープライズシステムのデータに基づいています。 顧客セグメント情報は絶えず更新されるので、顧客はストアでの買い物の際にセグメントとの関連付けや関連付けの解除を行うことができます。

Luma ストアフロントまたは ヘッドレス ストアフロント。 Luma ストアフロントでは、オーディエンス情報（セグメントメンバーシップ）がCommerce側の cookie に保存されます。 ヘッドレスストアフロントでは、オーディエンス情報が、次の名前のパラメーターとしてGraphQL API ヘッダーに渡されます。 aep-segments-membership.

リリースノート

この節では、Audience Activation拡張機能のアップデートについて説明します。アップデートには次のものが含まれます。

– 新機能
– 修正点および改善点
– 既知の問題

参照： 今後のリリース リリーススケジュールとサポートについて説明します。

詳しくは、開発者向けドキュメントを参照してください 製品の互換性について説明します.

サポートされるサービスのアップデート

これらのリリースノートでは、Audience Activationで使用される拡張機能に関連する機能の変更と修正点について説明します。

2.1.1

[互換性]{class="badge informative" title="互換性"}

2024 年 4 月 4 日（Pt）

- PHP 8.3 のサポートを追加。

2.2.0-beta1

[互換性]{class="badge informative" title="互換性"}

2024 年 2 月 16 日（Pt）

- ベータ版に参加している場合は、必ずを入手してください composer.json ファイルのルートレベルは次のとおりです。 "minimum-stability": "beta".
- （ベータ版）作成する機能を追加しました 関連する製品ルール オーディエンス別に表示

2.1.0

[互換性]{class="badge informative" title="互換性"}

2024 年 1 月 24 日（Pt）

– が更新されました Real-Time CDP Audiences ダッシュボード オーディエンスを含む web サイトを含め、これらのオーディエンスを使用するように設定されている動的ブロックと買い物かごの価格ルールを指定します。

2.0.1

[互換性]{class="badge informative" title="互換性"}

2023 年 11 月 16 日（Pt）

– 安定性の向上。

2.0.0

[互換性]{class="badge informative" title="互換性"}

2023 年 10 月 10 日（Pt）

– 次の場合に OAuth 2.0 がサポートされるようになりました 設定 Audience Activation拡張機能。
– 安定性の向上。

1.2.0

[互換性]{class="badge informative" title="互換性"}

2023 年 8 月 15 日（Pt）

- UI コンポーネントバージョンを更新しました。

1.1.0

2023 年 5 月 30 日（Pt）

[互換性]{class="badge informative" title="互換性"}

– のサポートを追加 ダイナミック ブロック ヘッドレスストアフロントで。

1.0.1

2023 年 5 月 11 日（Pt）

[互換性]{class="badge informative" title="互換性"}

– 動的ブロックまたは買い物かごの価格ルールがストアフロントに適用されなかった問題を修正しました。
- マーチャントが動的ブロックを作成または更新しようとすると、Audience Activation拡張機能の未設定のインストールによってエラーが発生する問題を修正しました。

1.0.0

2023 年 3 月 31 日（Pt）

[互換性]{class="badge informative" title="互換性"}

– 一般提供リリース

実装

次のタスクは、Luma とヘッドレスストアフロントの両方の実装に適用されます。 Adobe Commerceでオーディエンスをアクティブ化するには、次の操作を行う必要があります。

拡張機能のインストール

のインストール Audience Activation からの拡張機能 marketplaceまたは、次のコマンドを実行します。

composer require magento/audiences

拡張機能の設定

をインストールしたら、 Audience Activation 拡張機能を使用するには、Commerce管理者にログインし、次の手順を実行する必要があります。

CommerceでReal-Time CDP オーディエンスを使用する場所

（を使用） Audience Activation 拡張機能を有効にすると、次のことが可能になります。

書き出し方法に関する完全なエンドツーエンドのユースケースについては、こちらを参照してください Commerce Real-Time CDPにデータを送信してオーディエンスを作成したあと、そのオーディエンスを次に対してアクティブ化します Commerceを参照してください を使用した、Real-Time CDPでのオーディエンスの作成 Commerce イベントデータ.

Real-Time CDP オーディエンスダッシュボード

すべて表示できます アクティブ を使用して、Adobe Commerce インスタンス内でパーソナライズするために使用可能なオーディエンス Real-Time CDP オーディエンス ダッシュボード。

にアクセスするには Real-Time CDP オーディエンス ダッシュボードで、 Admin サイドバーの後、に移動します。 Customers > Real-time CDP Audience.

ダッシュボードには、次のフィールドが含まれています。

ヘッドレスサポート

AEMやPWAなどのヘッドレス Adobe Commerce インスタンスでオーディエンスをアクティブ化して、買い物かごの価格ルール、関連する製品ルール、またはオーディエンスに基づく動的ブロックを表示できます。

買い物かご価格ルールおよび関連する製品ルール

Experience Platform買い物かごの価格ルールおよび関連する商品ルールの場合、ヘッドレスストアフロントは、 Commerce integration framework（CIF）. このフレームワークは、GraphQLを使用して実装されるサーバーサイド API を提供します。 買い物客のセグメントなどのオーディエンス情報は、次の名前のGraphQL ヘッダーパラメーターを介してCommerceに渡されます。 aep-segments-membership.

全体的なアーキテクチャは次のとおりです。

お先に install および 設定 拡張機能の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 入力属性。 1 つ以上を指定する場合 audience_id a の値 dynamicBlocks クエリを実行すると、これらのオーディエンスに割り当てられた動的ブロックのリストが返されます。

使用例

次のクエリは、複数のオーディエンス 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 オーディエンスを取得できます。

設定が完了したら、Mobile 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に表示されない場合は、次の原因が考えられます。

次の 2 つの節では、どちらの場合もトラブルシューティングを行う方法について説明します。

設定で選択された認証タイプが正しくありません

生成されたトークンに対する権限が不十分です

この問題は、生成されたトークンに対する API 権限が不十分なために発生する可能性があります。 トークンに正しい権限があることを確認するには、次の手順に従います。