---
title: "EngageServer.event(type, eventData, req, extensionData)"
slug: "engageserver-event"
abstract: "Sitecore Engage SDK(Sitecore CDP Stream API)のサーバーサイドイベント()機能について説明します。"
---
# EngageServer.event(type, eventData, req, extensionData)

> !注これは [サーバーサイドトラッキング](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/functions/server-side-tracking-with-the-engage-sdk-package.html "Server-side tracking with the Engage SDK package")の実装に使われるサーバーサイド関数です。もしクライアント側トラッキングを実装したい場合は、[クライアント側の機能を](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/functions/sending-events-using-the-engage-sdk.html "Sending events using the Engage SDK")使いましょう。

event()関数は以下のいずれかを送ります。

-   標準的なイベント、例えば[ADD](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/objects/event-data-object/add-event.html "ADD event")、[CONFIRM、](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/objects/event-data-object/confirm-event.html "CONFIRM event")[CHECKOUT](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/objects/event-data-object/checkout-event.html "CHECKOUT event")などです。
-   カスタム [イベント](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/objects/event-data-object/custom-event.html "Custom event") で、あなたの選んだカスタムデータも用意しています。

サイドバー。標準イベントのパラメータ

パラメータ

種類

概要

type

ストリング

標準的なイベントの種類。この値をSitecore CDPの予約イベント名のいずれか(例:VIEW、ADD、CONFIRM)に設定すると、そのイベントは標準イベントとなります。  
  
Sitecore CDPが予約したイベント名:  
  

-   イベント名は "SC\_"
-   "ADD" - 標準 [的なADD](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/functions/add-event.html) イベント。
-   "ADD\_CONSUMERS" - 標準 [ADD\_CONSUMERS](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/functions/add_consumers-event.html) イベント。
-   "ADD\_CONTACTS" - 標準 [ADD\_CONTACTS](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/functions/add_contacts-event.html) イベント。
-   "CAMPAIGN\_TRACKING" - 内部予約イベント。使用しないでください。
-   "CHECKOUT" - 標準 [的なチェックアウト](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/functions/checkout-event.html) イベント。
-   "CLEAR\_CART" - 標準 [CLEAR\_CART](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/functions/clear_cart-event.html) イベント。
-   "CONFIRM" - 標準 [的なCONFIRM](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/functions/confirm-event.html) イベント。
-   "FEEDBACK" - フィードバックイベント。
-   "IDENTITY" - 標準 [的な同一イベント](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/functions/identity-event.html) 。
-   "INTERACTION" - 内部予約イベント。使用しないでください。
-   "ORDER\_CHECKOUT" - 標準 [ORDER\_CHECKOUT](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/functions/order_checkout-event.html) イベント。
-   "PAYMENT" - 標準 [的な支払い](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/functions/payment-event.html) イベント。
-   "SUBSCRIPTION" - 内部予約イベント。使用しないでください。
-   "SEARCH" - 標準 [的なSEARCH](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/functions/search-event.html) イベント。
-   "TRACKING" - 内部予約イベント。使用しないでください。
-   "VIEW" - 標準 [的なVIEW](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/functions/view-event.html) イベント。

[eventData](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/functions/event-data-object.html)

目的

標準イベントタイプに固有のすべてのイベントデータ、例えば [ADDイベント](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/functions/add-event.html)などです。

req

目的

HTTPリクエストです。

[extensionData](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/functions/extension-data-object.html)  
  
任意

目的

イベントに関するカスタムデータ。  
  
最大50のカスタム属性を選べます。

サイドバー。カスタムイベントのパラメータ

パラメータ

種類

概要

type

ストリング

カスタムイベントの名前です。この値を予約された [イベント名](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/functions/engageserver-event.html#UUID-34368b1f-0321-a929-3046-8499363026be_para-idm19013416629508402)とは異なるカスタム値に設定すると、Sitecore CDP "CUSTOM\_EVENT\_SEARCH" や "myretailsite:CLICKED\_POPUP"のように、そのイベントはカスタムイベントとなります。

[eventData](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/functions/custom-event.html)

目的

すべてのイベントオブジェクトが含めるべき属性と、イベントオブジェクトが含められる[オプションの属性](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/functions/event-data-object.html#UUID-a7f441ce-7bee-9e1a-8a6c-7f995310e71b_UUID-88d3eb09-6119-a7c1-8d3f-f7a1fedf1447)[が必要でした](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/functions/event-data-object.html#UUID-a7f441ce-7bee-9e1a-8a6c-7f995310e71b_UUID-2cda931f-8a8a-520d-dd7c-fe7fa3c3d597)。

req

目的

HTTPリクエストです。

[extensionData](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/functions/extension-data-object.html)  
  
任意

目的

最大50のカスタム属性を選べます。

例15。イベントORDER\_CHECKOUT

::::タブ:::tab{title="2.1"}

event()関数を使ってORDER\_CHECKOUTイベントを送信する方法の例を紹介します。eventDataオブジェクトは、この例で[ORDER\_CHECKOUTイベント](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/objects/event-data-object/order_checkout-event.html "ORDER_CHECKOUT event")のイベントタイプに必要なすべての属性を含まなければなりません。

export async function middleware(req) {
 const res = NextResponse.next();

 // Load Engage API
 const engageSettings = {
 clientKey: "<client\_key\_PLACEHOLDER>",
 targetURL: "<stream\_api\_target\_endpoint\_PLACEHOLDER>",
 pointOfSale: "<point\_of\_sale\_PLACEHOLDER>"
 };

 const engageServer = await initServer(engageSettings);

 // Send ORDER\_CHECKOUT event
 const eventData = {
 channel: "WEB",
 currency: "EUR",
 pointOfSale: "myretailsite/ireland",
 language: "EN",
 page: "checkout page",
 order: {
 referenceId: "123456",
 orderedAt: "2026-08-23T16:\`17:16\`.000Z",
 status: "PURCHASED",
 currencyCode: "EUR",
 price: 200,
 paymentType: "Card",
 cardType: "Visa",
 extensions: 
 {
 name: "ext",
 key: "default",
 refundable: true
 }
 ,
 orderItems: 
 {
 type: "MOBILE\_PHONE",
 referenceId: "REF-123",
 orderedAt: "2026-08-23T16:\`17:16\`.000Z",
 status: "PURCHASED",
 currencyCode: "EUR",
 price: 200,
 name: "Mobile phone of type x",
 productId: "MOBILE\_PHONE\_TYPE\_X",
 quantity: 1,
 extensions: 
 {
 name: "ext",
 key: "default",
 phoneColor: "Gold",
 insurance: false
 }
 
 }
 
 }
};

 const extensionData = {
 customKey: "customValue"
 };

 await engageServer.event("ORDER\_CHECKOUT", eventData, req, extensionData);
 return res;
};

::::::tab{title="2.0"}

2.0のデータモデルはこの機能をサポートしていません。

:::::::

例16。ADDイベント

こちらはevent() 関数を使ってADDイベントを送信する方法の例です。 eventDataオブジェクトは、この例の[ADDイベント](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/objects/event-data-object/add-event.html "ADD event")に必要なすべての属性を含まなければなりません。

export async function middleware(req) {
 const res = NextResponse.next();

 // Load Engage API
 const engageSettings = {
 clientKey: "<client\_key\_PLACEHOLDER>",
 targetURL: "<stream\_api\_target\_endpoint\_PLACEHOLDER>",
 pointOfSale: "<point\_of\_sale\_PLACEHOLDER>"
 };

 const engageServer = await initServer(engageSettings);

 // Send ADD event
 const eventData = {
 channel: "WEB",
 currency: "EUR",
 language: "EN",
 page: "products",
 product: {
 name: "GHT 84 Lace Sneaker",
 type: "FOOTWEAR",
 item\_id: "SHOES\_8475GHT",
 productId: "example\_product\_id",
 referenceId: "MA-490094",
 orderedAt: new Date().toISOString(),
 quantity: 1,
 price: 7.99,
 currency: "EUR",
 originalPrice: 7.79,
 originalCurrencyCode: "USD"
 }
 };

 const extensionData = {
 customKey: "customValue"
 };

 await engageServer.event("ADD", eventData, req, extensionData);
 return res;
};

例17。CONFIRMイベント

こちらはevent() 関数を使ってCONFIRMイベントを送信する方法の例です。 eventDataオブジェクトは、この例では[CONFIRMイベント](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/objects/event-data-object/confirm-event.html "CONFIRM event")のイベントタイプに必要なすべての属性を含まなければなりません。

export async function middleware(req) {
 const res = NextResponse.next();

 // Load Engage API
 const engageSettings = {
 clientKey: "<client\_key\_PLACEHOLDER>",
 targetURL: "<stream\_api\_target\_endpoint\_PLACEHOLDER>",
 pointOfSale: "<point\_of\_sale\_PLACEHOLDER>"
 };

 const engageServer = await initServer(engageSettings);

 // Send CONFIRM event
 const eventData = {
 channel: "WEB",
 currency: "EUR",
 language: "EN",
 page: "checkout",
 product: 
 { item\_id: "SHOES\_8475GHT" }
 
 };

 const extensionData = {
 customKey: "customValue"
 };

 await engageServer.event("CONFIRM", eventData, req, extensionData);
 return res;
};

例18。チェックアウトイベント

こちらはevent() 関数を使ってCHECKOUTイベントを送信する方法の例です。 eventDataオブジェクトは、この例の[CHECKOUTイベント](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/objects/event-data-object/checkout-event.html "CHECKOUT event")のイベントタイプに必要なすべての属性を含まなければなりません。

export async function middleware(req) {
 const res = NextResponse.next();

 // Load Engage API
 const engageSettings = {
 clientKey: "<client\_key\_PLACEHOLDER>",
 targetURL: "<stream\_api\_target\_endpoint\_PLACEHOLDER>",
 pointOfSale: "<point\_of\_sale\_PLACEHOLDER>"
 };

 const engageServer = await initServer(engageSettings);

 // Send CHECKOUT event
 const eventData = {
 channel: "WEB",
 currency: "EUR",
 language: "EN",
 page: "home",
 reference\_id: "MA-490094",
 status: "PURCHASED"
 };

 const extensionData = {
 customKey: "customValue"
 };

 await engageServer.event("CHECKOUT", eventData, req, extensionData);
 return res;
};

例19。支払いイベント

こちらはevent() 関数を使ってPAYMENT eventを送信する方法の例です。 eventDataオブジェクトは、この例で[PAYMENT event](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/objects/event-data-object/payment-event.html "PAYMENT event")のイベントタイプに必要なすべての属性を含まなければなりません。

export async function middleware(req) {
 const res = NextResponse.next();

 // Load Engage API
 const engageSettings = {
 clientKey: "<client\_key\_PLACEHOLDER>",
 targetURL: "<stream\_api\_target\_endpoint\_PLACEHOLDER>",
 pointOfSale: "<point\_of\_sale\_PLACEHOLDER>"
 };

 const engageServer = await initServer(engageSettings);

 // Send PAYMENT event
 const eventData = {
 channel: "WEB",
 currency: "EUR",
 language: "EN",
 page: "home",
 paymentType: "voucher"
 };

 const extensionData = {
 customKey: "customValue"
 };

 await engageServer.event("PAYMENT", eventData, req, extensionData);
 return res;
};

例20。CLEAR\_CARTイベント

こちらはevent() 関数を使ってCLEAR\_CARTイベントを送信する方法の例です。 eventDataオブジェクトは、この例で[CLEAR\_CARTイベント](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/objects/event-data-object/clear_cart-event.html "CLEAR_CART event")に必要なすべての属性を含む必要があります。

export async function middleware(req) {
 const res = NextResponse.next();

 // Load Engage API
 const engageSettings = {
 clientKey: "<client\_key\_PLACEHOLDER>",
 targetURL: "<stream\_api\_target\_endpoint\_PLACEHOLDER>",
 pointOfSale: "<point\_of\_sale\_PLACEHOLDER>"
 };

 const engageServer = await initServer(engageSettings);

 // Send CLEAR\_CART event
 const eventData = {
 channel: "WEB",
 currency: "EUR",
 language: "EN",
 page: "home"
 };

 const extensionData = {
 customKey: "customValue"
 };

 await engageServer.event("CLEAR\_CART", eventData, req, extensionData);
 return res;
};

例21。サーチイベント

こちらはevent() 関数を使ってSEARCHイベントを送信する方法の例です。 eventDataオブジェクトは、この例の[SEARCHイベント](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/objects/event-data-object/search-event.html "SEARCH event")のイベントタイプに必要なすべての属性を含まなければなりません。

export async function middleware(req) {
 const res = NextResponse.next();

 // Load Engage API
 const engageSettings = {
 clientKey: "<client\_key\_PLACEHOLDER>",
 targetURL: "<stream\_api\_target\_endpoint\_PLACEHOLDER>",
 pointOfSale: "<point\_of\_sale\_PLACEHOLDER>"
 };

 const engageServer = await initServer(engageSettings);

 // Send SEARCH event
 const eventData = {
 channel: "WEB",
 currency: "EUR",
 language: "EN",
 page: "search result page",
 "product\_name": "airSupport",
 "product\_type": "RUNNERS"
 };

 const extensionData = {
 customKey: "customValue"
 };

 await engageServer.event("SEARCH", eventData, req, extensionData);
 return res;
};

例22。カスタムイベント

こちらはevent() 関数を使ってmyretailsite:CLICKED\_POPUPというカスタムイベントを送信する方法の例です。 eventDataは [イベントデータオブジェクトに必要なすべての属性](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/sitecore-engage-sdk-reference/functions/event-data-object.html#UUID-a7f441ce-7bee-9e1a-8a6c-7f995310e71b_UUID-2cda931f-8a8a-520d-dd7c-fe7fa3c3d597 "Required attributes")を含みます。 extensionDataはカスタムデータです。

export async function middleware(req) {
 const res = NextResponse.next();

 // Load Engage API
 const engageSettings = {
 clientKey: "<client\_key\_PLACEHOLDER>",
 targetURL: "<stream\_api\_target\_endpoint\_PLACEHOLDER>",
 pointOfSale: "<point\_of\_sale\_PLACEHOLDER>"
 };

 const engageServer = await initServer(engageSettings);

 // Send custom event
 const eventData = {
 channel: "WEB",
 currency: "EUR",
 language: "EN",
 page: "search result page"
 };

 const extensionData = {
 customKey: "customValue"
 };

 await engageServer.event("myretailsite:CLICKED\_POPUP", eventData, req, extensionData);
 return res;
};