イベント・データ・オブジェクト

ADDイベント

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

ADDイベントのイベント・データ・オブジェクトには、イベント・データ・オブジェクトに必要なすべての属性に加えて、次の属性が含まれている必要があります。

属性	種類	形容	例
product	オブジェクト	ユーザーがカートに追加した製品に関するデータ。	該当なし

productオブジェクト:

属性	種類	形容	例	必須/オプション
name	string (タイトルケースを推奨)	ユーザーがカートに追加した商品の名前。	"GHT 84 Lace Sneaker"	必須
type	string (大文字)	ユーザーがカートに追加した商品のタイプ。	"FOOTWEAR"	必須
item_id	糸	ユーザーがカートに追加した商品のアイテムID。抽出、変換、ロード (ETL) データ統合で注文を作成するために使用されます。注文を正常に作成するには、この文字列をCONFIRMイベントのproduct配列内のオブジェクトに渡す必要があります。	"SHOES_8475GHT"	必須
productId	糸	ユーザーがカートに追加した商品のID。 Analyticsでレポートに使用されます。	"example_product_id"	必須
referenceId	糸	注文品目を参照するために組織によって生成されるID。	"FOOTWEAR-001-01"	必須
orderedAt	文字列 (ISO 8601) 形式： YYYY-MM-DD’T’hh:mm:ss.<timezone>	ユーザーが商品をカートに追加した日時。	"2025-04-15T12:42:16.001Z"	必須
quantity	整数	ユーザーがカートに追加した商品のユニット数。合計金額 = quantity × price	1	必須
price	浮く	商品の単価です。合計金額 = quantity × price	7.99	必須
currency	文字列 (大文字のISO 4217)	商品価格が指定されている通貨のアルファベット順の通貨コード。	"EUR" "GBP" "USD"	必須
originalPrice	浮く	組織の通貨に換算する前の注文品目の単価。	7.79	随意
originalCurrencyCode	文字列 (大文字のISO 4217)	注文品目の元の通貨コード。	"EUR" "GBP" "USD"	随意

このイベント・データ・オブジェクトを作成した後、オプションで拡張データ・オブジェクトを使用してこのイベントを拡張できます。その後、Engage.event() 関数を使用してイベントを送信できます。

ADDイベントのイベントデータオブジェクトの例を次に示します。

const eventData = {
    channel: "WEB",
    currency: "EUR",
    pointOfSale: "myretailsite/ireland",
    language: "EN",
    page: "products",
    product: {
        name: "GHT 84 Lace Sneaker",
        type: "FOOTWEAR",
        item_id: "SHOES_8475GHT",
        productId: "example_product_id",
        referenceId: "FOOTWEAR-001-01",
        orderedAt: "2025-04-15T12:42:16.001Z",
        quantity: 1,
        price: 7.99,
        currency: "EUR",
        originalPrice: 7.79,
        originalCurrencyCode: "USD"
    }
}

Example 25。 ADDイベントとCONFIRMイベントの商品アイテムID

以下は、ADDイベントオブジェクトとCONFIRMイベントデータオブジェクトで複数の商品アイテムIDがリンクされている例です。

CONFIRMイベント・データ・オブジェクトのproduct配列内のオブジェクトに含まれる各アイテムID、製品アイテムIDがproduct.item_idで指定されている先行するADDイベント・データ・オブジェクトが存在する必要があります。

// ADD event data object for "SHOES_8475GHT"
const addEventData = {
    // ...
    product: {
        // ...
        item_id: "SHOES_8475GHT"
    }
}

// ADD event data object for "JEANS_W33L31"
const addEventData = {
    // ...
    product: {
        // ...
        item_id: "JEANS_W33L31"
    }
}

// CONFIRM event data object listing all product item IDs
const confirmEventData = {
    // ...
    product: [
        { item_id: "SHOES_8475GHT" },
        { item_id: "JEANS_W33L31" }
    ]
}

この記事を改善するための提案がある場合は、お知らせください!