ドキュメント Commerce Data Connection extension for Adobe Commerce

カスタムイベントの作成

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

管理者
開発者

独自のストアフロントイベントを作成して業界に固有のデータを収集することで、イベントプラットフォームを拡張できます。カスタムイベントを作成して設定すると、そのイベントは Adobe Commerce イベントコレクターに送信されます。

カスタムイベントの処理

カスタムイベントは、Adobe Experience Platformでのみサポートされています。カスタムデータは、Adobe Commerce ダッシュボードおよび指標トラッカーに転送されません。

custom イベントの場合、コレクターは以下を行います。

ECID をプライマリ ID として identityMap を追加します
イベントで設定されているセカンダリ ID ifpersonalEmail.address として identityMap に email を含めます
Edgeに転送する前に、xdm オブジェクト内でイベント全体をラップします

例：

Adobe Commerce Events SDK を通じて公開されたカスタムイベント：

mse.publish.custom({
    commerce: {
        saveForLaters: {
            value: 1,
        },
    },
});

EdgeのExperience Platformで：

{
  xdm: {
    identityMap: {
      ECID: [
        {
          id: 'ecid1234',
          primary: true
        }
      ],
      email: [
        {
          id: "runs@safari.ke",
          primary: false
        }
      ]
    },
    commerce: {
        saveForLaters: {
            value: 1
        }
    }
  }
}

NOTE

カスタムイベントを使用すると、デフォルトのAdobe Analytics レポートに影響する可能性があります。

イベントの上書きの処理（カスタム属性）

標準イベントの属性のオーバーライドは、Experience Platformでのみサポートされています。カスタムデータは、Commerce ダッシュボードおよび指標トラッカーに転送されません。

customContext を含むイベントの場合、コレクターは、関連するコンテキストで設定されたフィールドを customContext のフィールドでオーバーライドします。オーバーライドのユースケースは、開発者が、既にサポートされているイベントでページの他の部分が設定したコンテキストを再利用および拡張する場合です。

NOTE

カスタムイベントを上書きする場合は、重複カウントを避けるために、そのイベントタイプのExperience Platformへのイベント転送をオフにする必要があります。

例：

Adobe Commerce Events SDK を通じて公開されたオーバーライドを含む製品ビュー：

mse.publish.productPageView({
    productListItems: [
        {
            productCategories: [
                {
                    categoryID: "cat_15",
                    categoryName: "summer pants",
                    categoryPath: "pants/mens/summer",
                },
            ],
        },
    ],
});

EdgeのExperience Platformで：

{
  xdm: {
    eventType: 'commerce.productViews',
    identityMap: {
      ECID: [
        {
          id: 'ecid1234',
          primary: true,
        }
      ]
    },
    commerce: {
      productViews: {
        value : 1,
      }
    },
    productListItems: [{
        SKU: "1234",
        name: "leora summer pants",
        productCategories: [{
            categoryID: "cat_15",
            categoryName: "summer pants",
            categoryPath: "pants/mens/summer",
        }],
    }],
  }
}

NOTE

カスタム属性を使用してイベントを上書きすると、デフォルトのAdobe Analytics レポートに影響する場合があります。

recommendation-more-help

6bf243c8-c8c6-4074-826f-546af445e840