[PaaSのみ]{class="badge informative" title="Adobe Commerce on Cloud プロジェクト（Adobeで管理されるPaaS インフラストラクチャ）とオンプレミス プロジェクトにのみ適用されます。"}

Audience Activation

Audience Activation拡張機能を使用すると、Adobe CommerceでReal-Time CDP オーディエンスをアクティブ化して、カート内に一意のオファーを作成できます。 これらのオファーとインセンティブには、buy 2 get 1 free​などの一般的なコマースマーチャンダイジング手法、その顧客を対象としたヒーローバナー、さまざまなオファーを通じた商品価格の変更などが含まれます。 Real-Time CDP内で構築されるオーディエンスは、ERP （Enterprise Resource Planning）、CRM （Customer Relationship Management）、POS、マーケティングシステムなど、様々なエンタープライズシステムからのデータにもとづいています。 顧客セグメント情報は常に更新されるため、顧客がストアで買い物をするときに、セグメントに関連付けられたり、関連付けられなかったりする可能性があります。

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

リリースノート

この節では、Audience Activation拡張機能のアップデートに関する情報を説明します。次の内容を含みます。

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

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

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

サポートされているサービス更新

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

2.4.0

[互換性]{class="badge informative" title="互換性"} Adobe Commerce バージョン 2.4.4以降

2025年3月24日

- PHP 8.4のサポートを追加しました。

2.3.1

[互換性]{class="badge informative" title="互換性"} Adobe Commerce バージョン 2.4.4以降

2024年11月12日

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

2.3.0

[互換性]{class="badge informative" title="互換性"} Adobe Commerce バージョン 2.4.4以降

2024年7月29日

- コマンドライン構文を追加しました。これにより、資格情報をテストして、Adobe Experience Platformからオーディエンスデータを取得するために更新する必要があるかどうかを判断できます。

2.2.0

[互換性]{class="badge informative" title="互換性"} Adobe Commerce バージョン 2.4.4以降

2024年6月12日

- オーディエンスから通知された関連製品ルール ​のGA リリース。

2.1.1

[互換性]{class="badge informative" title="互換性"} Adobe Commerce バージョン 2.4.4以降

2024年4月4日

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

2.2.0-beta1

[互換性]{class="badge informative" title="互換性"} Adobe Commerce バージョン 2.4.4以降

2024年2月16日

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

2.1.0

[互換性]{class="badge informative" title="互換性"} Adobe Commerce バージョン 2.4.4以降

2024年1月24日

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

2.0.1

[互換性]{class="badge informative" title="互換性"} Adobe Commerce バージョン 2.4.4以降

2023年11月16日

– 安定性が向上しました。

2.0.0

[互換性]{class="badge informative" title="互換性"} Adobe Commerce バージョン 2.4.4以降

2023年10月10日

- Audience Activation拡張機能をconfigureすると、OAuth 2.0のサポートが追加されました。
– 安定性が向上しました。

1.2.0

[互換性]{class="badge informative" title="互換性"} Adobe Commerce バージョン 2.4.4以降

2023年8月15日

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

1.1.0

2023年5月30日

[互換性]{class="badge informative" title="互換性"} Adobe Commerce バージョン 2.4.4以降

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

1.0.1

2023年5月11日

[互換性]{class="badge informative" title="互換性"} Adobe Commerce バージョン 2.4.4以降

– 動的ブロックまたはカート価格ルールがストアフロントに適用されない問題を修正しました。
– 販売者が動的ブロックを作成または更新しようとしたときに、Audience Activation拡張機能の未設定のインストールでエラーが発生する問題を修正しました。

1.0.0

2023年3月31日

[互換性]{class="badge informative" title="互換性"} Adobe Commerce バージョン 2.4.4以降

– 一般公開リリース

導入

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

拡張機能のインストール

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

composer require magento/audiences

拡張機能の設定

Audience Activation拡張機能をインストールしたら、Commerce管理者にログインして、次の操作を行う必要があります。

CommerceのReal-Time CDP オーディエンスの使用方法

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

Real-Time CDP audiences dashboard

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

Real-Time CDP Audiences ダッシュボードにアクセスするには、管理者 サイドバーに移動し、Customers > Real-time CDP Audience​に移動します。

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

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

ヘッドレスのサポート

AEMやPWAなどのヘッドレスAdobe Commerceインスタンスでオーディエンスをアクティベートし、オーディエンスにもとづいて、カートの価格ルール、関連商品ルール、動的ブロックを表示できます。

カートの価格ルールと関連商品のルール

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

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

{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の入力属性を含めることができます。 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 クエリについて詳しくは、開発者ドキュメント ​を参照してください。

Adobe Experience Platform Mobile SDKを使用したオーディエンスの取得

Real-Time CDP オーディエンスは、Adobe Experience Platform Mobile 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 アプリで、オーディエンス情報に基づいた​ カート価格ルール ​、動的ブロック ​、関連商品ルール ​を作成するために使用できます。

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権限が不十分であることが原因で発生する可能性があります。 トークンに適切な権限を付与するには、次の手順を実行します。