Audience Activation

The Audience Activation 拡張機能を使用すると、Adobe CommerceでReal-Time CDPオーディエンスをアクティブ化して、買い物かご内の一意のオファーを作成できます。 これらのオファーとインセンティブには、次のような一般的な e コマースマーチャンダイジング技法が含まれます。 2 を無料で購入する、ヒーローバナーはその顧客に合わせて設定され、様々なオファーを通じて製品の価格を変更しました。 Real-Time CDPに組み込まれたオーディエンスは、企業リソース計画 (ERP)、顧客関係管理 (CRM)、POS、マーケティングシステムなど、様々な企業システムからのデータに基づいています。 顧客セグメント情報は常に更新されるので、顧客は、ストアで買い物をする際に、セグメントに関連付けられたり、セグメントから関連付けが解除されたりすることができます。

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

リリースノート

この節には、拡張機能の更新に関する情報が含まれ、以下がAudience Activationされます。

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

詳しくは、 今後のリリース を参照してください。

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

サポートされるサービスの更新

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

2.1.1

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

2024 年 4 月 5 日

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

2.2.0-beta1

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

2024 年 2 月 17 日

— ベータ版に参加している場合は、 composer.json ファイルのルートレベルは次のようになります。 "minimum-stability": "beta".
- (ベータ版) を作成する機能を追加しました。 関連製品ルール オーディエンスから情報を得た。

2.1.0

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

2024 年 1 月 25 日

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

2.0.1

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

2023 年 11 月 17 日

— 安定性が向上。

2.0.0

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

2023 年 10 月 11 日

— 次の場合に、OAuth 2.0 のサポートが追加されました。 設定 Audience Activation拡張。
— 安定性が向上。

1.2.0

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

2023 年 8 月 16 日

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

1.1.0

2023 年 5 月 31 日

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

— のサポートを追加しました 動的ブロック ヘッドレスな店の前に

1.0.1

2023 年 5 月 12 日

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

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

1.0.0

2023 年 3 月 31 日

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

— 一般リリース (GA)

実装

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

拡張機能のインストール

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

composer require magento/audiences

拡張機能の設定

インストール後、 Audience Activation 拡張機能を使用する場合は、コマース管理者にログインし、以下の手順を実行する必要があります。

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

を使用 Audience Activation 拡張機能を有効にすると、次の操作を実行できます。

Real-Time CDP audiences ダッシュボード

すべてを表示できます アクティブ Adobe Commerceインスタンス内で、 Real-Time CDP Audiences ダッシュボード。

次の手順で Real-Time CDP Audiences ダッシュボードに移動します。 管理者 サイドバー、次に移動 Customers > Real-time CDP Audience.

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

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

ヘッドレスサポート

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

買い物かごの価格ルールと関連製品ルール

買い物かごの価格ルールおよび関連する製品ルールの場合、ヘッドレスストアフロントは、 COMMERCE INTEGRATION FRAMEWORK(CIF). このフレームワークは、GraphQLを使用して実装されたサーバー側 API を提供します。 買い物客のセグメントなどのオーディエンス情報は、次の名前のGraphQLヘッダーパラメーターを通じてコマースに渡されます。 aep-segments-membership.

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

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

後で 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 の値 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オーディエンスを取得できます。

設定が完了したら、モバイル 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 にオーディエンスが表示されない

Real-Time CDPオーディエンスが Commerce に表示されない場合は、次の原因が考えられます。

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

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

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

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