---
title: "補助製品のADDイベント"
slug: "add-event-for-ancillary-product"
abstract: "直接HTTPリクエスト(Sitecore PersonalizeストリームAPI)を使用した際の補助製品のADDイベントのJSONオブジェクトを記述します。"
---
# 補助製品のADDイベント

ADDイベントを使って、保険などユーザーがカートに追加した付随商品をキャプチャできます。このイベントは任意ですが、利用することで利用可能なデータ量に良い影響を与えることがあります。このイベントを使うのは、ユーザーがカートに追加した付随商品をキャプチャする唯一の方法です。また、ユーザーが放置カートに戻った際のカートの内容や注文価格の正確性を確保するのにも役立ちます。

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

補助製品に対してADDイベントを送信するには、以下の必要な属性を使用します。

属性

種類

概要

例

channel

文字列(大文字)

ユーザーがブランドと関わる接点です。

-   "MOBILE\_APP"
-   "MOBILE\_WEB"
-   "WEB"

type

文字列(大文字)

ユーザーがあなたのブランドと関わる際に起こるイベントの種類。

"ADD"

language

文字列(大文字 [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes))

ユーザーがアプリを使っている言語。

-   "DE"
-   "EN"
-   "FR"

currency

文字列(大文字の [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217#Active_codes))

ユーザーがアプリで使っている通貨のアルファベット順通貨コードです。

-   "EUR"
-   "GBP"
-   "USD"

page

ストリング

ブランドとのやり取りが行われるウェブページの名前。  
  
これはお好みのカスタム値です。

-   "home"
-   "contact-us.html"

pos

ストリング

[ブランドとのやり取りが行われる販売ポイントの名前。](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/direct-http-requests-reference/sending-events-1166442/collect-required-details.html#UUID-60c4c930-3cfe-e0ad-3b98-69ceff75989f_section-idm1903325950166538)

-   "myretailsite/ireland"
-   "spinair.com/france"

browser\_id

ストリング

[ブラウザID](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/direct-http-requests-reference/sending-events-1166442/retrieve-the-browser-id.html)。

"a38b230c-11eb-4cf9-8d5d-274e9f344925​"

product

目的

製品法人のデータ。

"mys3cr3tstr1ingforauth1!x"

productの目的:

属性

種類

概要

例

必須/任意

type

文字列(大文字)

カートに加えられる商品の種類。

-   "HOTEL"
-   "CAR"
-   "BAG"
-   "INSURANCE"
-   "LOUNGE\_ACCESS"
-   "HOTEL\_WIFI"
-   "INFLIGHT\_ENTERTAINMENT"
-   "CARBON\_OFFSET"
-   "INFLIGHT\_VOUCHER"
-   "CHARITY\_DONATION"
-   "TRANSFER"

  
  
廃止:  
  

-   "BAGGAGE"
-   "FEES"
-   "SEAT\_UPGRADES"
-   "INFLIGHT\_VOUCHERS"

必須

item\_id

ストリング

カートに追加された商品の商品ID。Extract, Transform, Load(ETL)データ統合で注文を作成するために使用されます。

"BAG\_1"

必須

name

ストリング(タイトルケース推奨)

商品名がカートに追加されました。

"DUB-LHR Economy Flight"  
  
"20kg Bag"

必須

currency

文字列(大文字の [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217#Active_codes))

商品の通貨がカートに加算されます。

"EUR"

必須

price

数字(通貨)

商品の単価。製品の総価格は単価に数量を掛けた値で計算されます。

100.00

必須

product\_id

ストリング

追加された製品の製品ID。分析で報告に使われます。

"Bag20"

必須

quantity

番号

加算単位数。製品の総価格は単価に数量を掛けた値で計算されます。

1

必須

例45。補助積のためのADD event object

{
 "channel": "MOBILE\_APP",
 "type": "ADD",
 "language": "EN",
 "currency": "EUR",
 "page": "passengers page",
 "pos": "spinair.com/france",
 "browser\_id": "a38b230c-11eb-4cf9-8d5d-274e9f344925​",
 "product": {
 "type": "BAG",
 "item\_id": "BAG\_1",
 "name": "20kg Bag",
 "currency": "EUR",
 "price": 10,
 "product\_id": "Bag20",
 "quantity": 1
 }
}

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

補助製品に対してADDイベントを送信するには、以下の必要な属性を使用します。

属性

種類

概要

例

channel

文字列(大文字)

ユーザーがブランドと関わる接点です。

-   "MOBILE\_APP"
-   "MOBILE\_WEB"
-   "WEB"

type

文字列(大文字)

ユーザーがあなたのブランドと関わる際に起こるイベントの種類。

"ADD"

language

文字列(大文字 [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes))

ユーザーがアプリを使っている言語。

-   "DE"
-   "EN"
-   "FR"

currency

文字列(大文字の [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217#Active_codes))

ユーザーがアプリで使っている通貨のアルファベット順通貨コードです。

-   "EUR"
-   "GBP"
-   "USD"

page

ストリング

ブランドとのやり取りが行われるウェブページの名前。  
  
これはお好みのカスタム値です。

-   "home"
-   "contact-us.html"

pos

ストリング

[ブランドとのやり取りが行われる販売ポイントの名前。](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/direct-http-requests-reference/sending-events-1166442/collect-required-details.html#UUID-60c4c930-3cfe-e0ad-3b98-69ceff75989f_section-idm1903325950166538)

-   "myretailsite/ireland"
-   "spinair.com/france"

browser\_id

ストリング

[ブラウザID](https://doc.sitecore.com/personalize/ja/developers/api/stream-api/direct-http-requests-reference/sending-events-1166442/retrieve-the-browser-id.html)。

"a38b230c-11eb-4cf9-8d5d-274e9f344925​"

product

目的

製品法人のデータ。

"mys3cr3tstr1ingforauth1!x"

productの目的:

属性

種類

概要

例

必須/任意

type

文字列(大文字)

カートに加えられる商品の種類。

-   "HOTEL"
-   "CAR"
-   "BAG"
-   "INSURANCE"
-   "LOUNGE\_ACCESS"
-   "HOTEL\_WIFI"
-   "INFLIGHT\_ENTERTAINMENT"
-   "CARBON\_OFFSET"
-   "INFLIGHT\_VOUCHER"
-   "CHARITY\_DONATION"
-   "TRANSFER"

  
  
廃止:  
  

-   "BAGGAGE"
-   "FEES"
-   "SEAT\_UPGRADES"
-   "INFLIGHT\_VOUCHERS"

必須

item\_id

ストリング

カートに追加された商品の商品ID。Extract, Transform, Load(ETL)データ統合で注文を作成するために使用されます。

"BAG\_1"

必須

name

ストリング(タイトルケース推奨)

商品名がカートに追加されました。

"DUB-LHR Economy Flight"  
  
"20kg Bag"

必須

currency

文字列(大文字の [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217#Active_codes))

商品の通貨がカートに加算されます。

"EUR"

必須

price

数字(通貨)

商品の単価。製品の総価格は単価に数量を掛けた値で計算されます。

100.00

必須

product\_id

ストリング

追加された製品の製品ID。分析で報告に使われます。

"Bag20"

必須

quantity

番号

加算単位数。製品の総価格は単価に数量を掛けた値で計算されます。

1

必須

linked\_consumer\_reference\_ids

文字列の配列

この製品を消費者に関連付けるための参照IDのリスト。

"CONSUMER\_1','CONSUMER\_2"

オプション

例46。補助製品用のADD event object

{
 "channel": "MOBILE\_APP",
 "type": "ADD",
 "language": "EN",
 "currency": "EUR",
 "page": "passengers page",
 "pos": "spinair.com/france",
 "browser\_id": "a38b230c-11eb-4cf9-8d5d-274e9f344925​",
 "product": {
 "type": "BAG",
 "item\_id": "BAG\_1",
 "name": "20kg Bag",
 "currency": "EUR",
 "price": 10,
 "product\_id": "Bag20",
 "quantity": 1,
 "linked\_consumer\_reference\_ids": "CONSUMER\_1", "CONSUMER\_2"
 }
}

:::::::