--- title: "ADD_CONTACTSイベント" slug: "add_contacts-event" abstract: "直接HTTPリクエスト(Sitecore CDPストリームAPI)を用いる際のADD_CONTACTSイベントのJSONオブジェクトを記述します。" --- # ADD\_CONTACTSイベント ::::タブ:::tab{title="2.1"} もし組織 [が複数のイベントで注文を送](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/direct-http-requests-reference/sending-events-1166442/sending-orders-1166443.html#UUID-e144dabf-4435-4dcb-9a67-d00afbf7087d_section-idm4519056393064033480657078262 "Sending orders using multiple events")る場合、ADD\_CONTACTSイベントでゲストを特定する必要があります。 もし組織 [が単一のイベントで注文を送](https://doc.sitecore.com/cdp/ja/developers/api/stream-api/direct-http-requests-reference/sending-events-1166442/sending-orders-1166443.html#UUID-e144dabf-4435-4dcb-9a67-d00afbf7087d_section-idm454949519144483348065516175 "Sending orders using a single event")る場合、ADD\_CONTACTSイベントは使いません。 ADD\_CONTACTSイベントを送信するには、以下の必要な属性を使用します。 属性 種類 概要 例 channel 文字列(大文字) ユーザーがブランドと関わる接点です。 - "MOBILE\_APP" - "MOBILE\_WEB" - "WEB" type 文字列(大文字) ユーザーがあなたのブランドと関わる際に起こるイベントの種類。 "ADD\_CONTACTS" 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/cdp/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/cdp/ja/developers/api/stream-api/direct-http-requests-reference/sending-events-1166442/retrieve-the-browser-id.html)。 "a38b230c-11eb-4cf9-8d5d-274e9f344925​" contact オブジェクトの配列 連絡先情報。 該当なし contactオブジェクトの配列: 属性 種類 概要 例 必須/任意 title ストリング(タイトルケース) 連絡先のタイトル。 "Br", "Brigadier", "Capt", "Colonel", "Dame", "Dr", "Elder", "Fr", "General", "Hon", "Judge", "Lord", "Master", "Miss", "Mr", "Mrs", "Ms", "Mstr", "Prof", "Rabbi", "Rev", "Shaikha", "Sheikh", "Sir", "Sister", "Sr" オプション firstname ストリング(タイトルケース推奨) 連絡先の名前。 "Jane" オプション lastname ストリング(タイトルケース推奨) 連絡先の姓。 "Doe" オプション mobile ストリング 連絡先の携帯番号。 "+3531234567" オプション phone ストリング 連絡先の電話番号。 "+3531234567" オプション street 文字列の配列(タイトルケース推奨) 連絡先の住所。 "Tara Street" オプション city ストリング(タイトルケース推奨) 連絡先の市住所。 "Dublin" オプション state ストリング(タイトルケース推奨) 連絡先の州住所。 "Oregon" オプション country\_code 文字列(大文字 [ISO 3166-1アルファ-2](https://en.wikipedia.org/wiki/ISO_3166-1)) 連絡先の国コード。 "IE" オプション postal\_code 文字列(推奨大文字) 連絡先の郵便番号。 "D15" オプション dob 文字列([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) 連絡先の生年月日。 "1990-08-23T00:00" オプション email 文字列(小文字推奨) 連絡先のメールアドレス。 "jane.doe@myretailsite.com" オプション gender 文字列(小文字) 接触者の性別。 - "male" - "female" - "rather\_not\_say" オプション identifiers オブジェクトの配列 アプリのユーザーを特定するために使われる識別子です。 該当なし 必須 contact.identifiersオブジェクトの配列: 属性 種類 概要 例 必須/任意 id ストリング 顧客関係管理(CRM)システムなど、組織のアイデンティティシステムが提供する一意のゲスト識別子。 "123456" 必須 provider ストリング あなたの組織のアイデンティティシステムの名前で、Sitecore CDPの外部で、一意のゲスト識別子を提供している。 "BXLP" 必須 expiryDate 文字列([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) 一意のゲスト識別子が失効する日付。これは組織のアイデンティティシステムによって決まります。 "2026-04-15T08:39:44.868Z" オプション 例45。ADD\_CONTACTSイベントオブジェクト { "channel": "MOBILE\_APP", "type": "ADD\_CONTACTS", "language": "EN", "currency": "EUR", "page": "home page", "pos": "myretailsite/ireland", "browser\_id": "a38b230c-11eb-4cf9-8d5d-274e9f344925​", "contact": { "title": "Mr", "firstname": "Jack", "lastname": "Smith", "mobile": "(+353)1234567", "phone": "(+353)1234568", "street": "123 Fake Street" , "city": "Dublin", "country\_code": "IE", "postal\_code": "1234", "dob": "1975-04-23T00:00", "email": "jack.smith@gmail.com", "gender": "male", "identifiers": { "provider": "BXLP", "id": "123456", "expiryDate": "2026-01-01T16:\`17:16\`.000Z", } } } ::::::tab{title="2.0"} ADD\_CONTACTSイベントはSitecore CDPで注文を作成するために必要です。連絡先は注文の所有者であり、連絡先なしでSitecore CDPに注文は存在しません。注文の連絡先は顧客guest\_typeでなければなりません。 ADD\_CONTACTSイベントを送信するには、以下の必要な属性を使用します。 属性 種類 概要 例 channel 文字列(大文字) ユーザーがブランドと関わる接点です。 - "MOBILE\_APP" - "MOBILE\_WEB" - "WEB" type 文字列(大文字) ユーザーがあなたのブランドと関わる際に起こるイベントの種類。 "ADD\_CONTACTS" 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/cdp/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/cdp/ja/developers/api/stream-api/direct-http-requests-reference/sending-events-1166442/retrieve-the-browser-id.html)。 "a38b230c-11eb-4cf9-8d5d-274e9f344925​" contact オブジェクトの配列 連絡先情報。 該当なし contactオブジェクトの配列: 属性 種類 概要 例 必須/任意 title ストリング(タイトルケース) 連絡先のタイトル。 "Br", "Brigadier", "Capt", "Colonel", "Dame", "Dr", "Elder", "Fr", "General", "Hon", "Judge", "Lord", "Master", "Miss", "Mr", "Mrs", "Ms", "Mstr", "Prof", "Rabbi", "Rev", "Shaikha", "Sheikh", "Sir", "Sister", "Sr" 必須 firstname ストリング(タイトルケース推奨) 連絡先の名前。 "Jane" 必須 lastname ストリング(タイトルケース推奨) 連絡先の姓。 "Doe" 必須 mobile ストリング 連絡先の携帯番号。 "+3531234567" オプション phone ストリング 連絡先の電話番号。 "+3531234567" オプション street 文字列の配列(タイトルケース推奨) 連絡先の住所。 "Tara Street" オプション city ストリング(タイトルケース推奨) 連絡先の市住所。 "Dublin" オプション state ストリング(タイトルケース推奨) 連絡先の州住所。 "Oregon" オプション country\_code 文字列(大文字 [ISO 3166-1アルファ-2](https://en.wikipedia.org/wiki/ISO_3166-1)) 連絡先の国コード。 "IE" オプション postal\_code 文字列(推奨大文字) 連絡先の郵便番号。 "D15" オプション dob 文字列([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) 連絡先の生年月日。 "1990-08-23T00:00" オプション email 文字列(小文字推奨) 連絡先のメールアドレス。 "jane.doe@myretailsite.com" 必須:御社がメール属性を使ってゲストの識別を決定する場合。 オプション:組織が識別子を使ってゲストの識別子を判定する場合。 gender 文字列(小文字) 接触者の性別。 - "male" - "female" - "rather\_not\_say" オプション identifiers オブジェクトの配列 アプリのユーザーを特定するために使われる識別子です。 該当なし 必須:組織が識別子を使ってゲストの身元を特定する場合。 任意:組織がゲストIDを判定するためにメール属性を使用している場合。 contact.identifiersオブジェクトの配列: 属性 種類 概要 例 必須/任意 id ストリング 顧客関係管理(CRM)システムなど、組織のアイデンティティシステムが提供する一意のゲスト識別子。 "123456" 必須 provider ストリング あなたの組織のアイデンティティシステムの名前で、Sitecore CDPの外部で、一意のゲスト識別子を提供している。 "BXLP" 必須 expiryDate 文字列([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) 一意のゲスト識別子が失効する日付。これは組織のアイデンティティシステムによって決まります。 "2026-04-15T08:39:44.868Z" オプション > !注**通知**ADD\_CONTACTSイベントを送信する際に、contact.identifiers配列とcontact.email属性の両方を含める必要はありません。御社はcontact.identifiers配列かcontact.email属性のいずれかを使ってゲストの身元を特定します。もし組織がcontact.email属性を使ってゲストの身元を特定している場合、contact.identifiers配列は無視されます。もし組織がcontact.identifiers配列を使ってゲストの身元を特定する場合、contact.email属性の送信は任意です。 例46。ADD\_CONTACTSイベントオブジェクト { "channel": "MOBILE\_APP", "type": "ADD\_CONTACTS", "language": "EN", "currency": "EUR", "page": "home page", "pos": "myretailsite/ireland", "browser\_id": "a38b230c-11eb-4cf9-8d5d-274e9f344925​", "contact": { "title": "Mr", "firstname": "Jack", "lastname": "Smith", "mobile": "(+353)1234567", "phone": "(+353)1234568", "street": "123 Fake Street" , "city": "Dublin", "country\_code": "IE", "postal\_code": "1234", "dob": "1975-04-23T00:00", "email": "jack.smith@gmail.com", "gender": "male", "identifiers": { "provider": "BXLP", "id": "123456", "expiryDate": "2026-01-01T16:\`17:16\`.000Z", } } } :::::::