Audience Activation

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

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

リリースノート

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

– 新機能
– 修正点と改善点
– 既知の問題

リリーススケジュールとサポートについては、 今後のリリースを参照してください。

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

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

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

2.3.1

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

2024 年 11 月 12 日

– 選択可能なReal-Time CDP オーディエンスをフィルタリングする際の問題を修正しました。

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 日

- ベータ版に参加している場合は、composer.json ファイルのルートレベルに次のものが含まれていることを確認してください： "minimum-stability": "beta"。
- （Beta）オーディエンスに基づいて 関連商品ルールを作成する機能が追加されました。

2.1.0

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

2024 年 1 月 24 日

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

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="互換性"}

- ヘッドレスストアフロントで 動的ブロックのサポートを追加しました。

1.0.1

2023 年 5 月 11 日

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

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

1.0.0

2023 年 3 月 31 日

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

– 一般提供リリース

実装

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

拡張機能のインストール

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

composer require magento/audiences

拡張機能の設定

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

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

Audience Activation 拡張機能を有効にすると、次のことができます。

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

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

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

{width="700" modal="regular"}

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

ヘッドレスサポート

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

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

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

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

{width="700" modal="regular"}

拡張機能を インストールおよび 設定した後、Experience Platform Web 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 input 属性を含めることができます。 dynamicBlocks クエリで 1 つ以上の 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 クエリについて詳しくは、developer ドキュメントを参照してください。

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

次の節では、これらの問題のトラブルシューティング方法について説明します。

接続の検証

資格情報と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          |

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

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

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