イベントの送信

ADD_CONTACTSイベント

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

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

組織が複数のイベントを使用してオーダーを送信する場合、ゲストを識別するためにADD_CONTACTSイベントが必要です。

組織が1つのイベントを使用して注文を送信する場合、ADD_CONTACTSイベントは使用しません。

ADD_CONTACTSイベントを送信するには、次の必須属性を使用します。

属性	種類	形容	例
channel	string (大文字)	ユーザーがブランドとやり取りするタッチポイント。	"MOBILE_APP" "MOBILE_WEB" "WEB"
type	string (大文字)	ユーザーがブランドと対話したときに発生するイベントの種類。	"ADD_CONTACTS"
language	文字列 (大文字ISO 639-1)	ユーザーがアプリを使用している言語。	"DE" "EN" "FR"
currency	文字列 (大文字のISO 4217)	ユーザーがアプリで使用している通貨のアルファベット順の通貨コード。	"EUR" "GBP" "USD"
page	糸	ブランドとのインタラクションが行われるウェブページの名前。これは、選択したカスタム値です。	"home" "contact-us.html"
pos	糸	ブランドとのインタラクションが行われるPOSの名前。	"myretailsite/ireland" "spinair.com/france"
browser_id	糸	ブラウザID。	"a38b230c-11eb-4cf9-8d5d-274e9f344925"
contact	オブジェクトの配列	連絡先の詳細。	該当なし

オブジェクトのcontact配列:

属性	種類	形容	例	必須/オプション
title	string (タイトルケース)	連絡先のタイトル。	"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	string (タイトルケースを推奨)	連絡先の名。	"Jane"	随意
lastname	string (タイトルケースを推奨)	連絡先の姓。	"Doe"	随意
mobile	糸	連絡先の携帯電話番号。	"+3531234567"	随意
phone	糸	連絡先の電話番号。	"+3531234567"	随意
street	文字列の配列 (タイトルケースを推奨)	連絡先の住所。	"Tara Street"	随意
city	string (タイトルケースを推奨)	連絡先の市区町村の住所。	"Dublin"	随意
state	string (タイトルケースを推奨)	連絡先の都道府県の住所。	"Oregon"	随意
country_code	文字列 (大文字ISO 3166-1 alpha-2)	連絡先の国コード。	"IE"	随意
postal_code	string (大文字を推奨)	連絡先の郵便番号。	"D15"	随意
dob	文字列 (ISO 8601)	連絡先の生年月日。	"1990-08-23T00:00"	随意
email	string (小文字を推奨)	連絡先のメールアドレス。	"[email protected]"	随意
gender	string (小文字)	連絡先の性別。	"male" "female" "rather_not_say"	随意
identifiers	オブジェクトの配列	アプリのユーザーを識別するために使用される識別子。	該当なし	必須

オブジェクトのcontact.identifiers配列:

属性	種類	形容	例	必須/オプション
id	糸	組織のIDシステム(顧客関係管理(CRM)システムなど)によって提供される一意のゲスト識別子。	"123456"	必須
provider	糸	一意のゲスト識別子を提供した組織のIDシステムの名前 ( Sitecore Personalizeの外部)。	"BXLP"	必須
expiryDate	文字列 (ISO 8601)	一意のゲスト識別子の有効期限が切れる日付。これは、組織のIDシステムによって決まります。	"2025-04-15T08:39:44.868Z"	随意

Example 48。 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": "[email protected]",
         "gender": "male",
         "identifiers": [
            {
               "provider": "BXLP",
               "id": "123456",
               "expiryDate": "2025-01-01T16:17:16.000Z",
            }
         ]
      }
   ]
}

ADD_CONTACTSイベントは、Sitecore CDPで注文を作成するために必要です。連絡先は注文の所有者であるため、連絡先がないと注文はSitecore CDPに存在できません。注文の連絡先は、お客様のguest_typeである必要があります。

ADD_CONTACTSイベントを送信するには、次の必須属性を使用します。

属性	種類	形容	例
channel	string (大文字)	ユーザーがブランドとやり取りするタッチポイント。	"MOBILE_APP" "MOBILE_WEB" "WEB"
type	string (大文字)	ユーザーがブランドと対話したときに発生するイベントの種類。	"ADD_CONTACTS"
language	文字列 (大文字ISO 639-1)	ユーザーがアプリを使用している言語。	"DE" "EN" "FR"
currency	文字列 (大文字のISO 4217)	ユーザーがアプリで使用している通貨のアルファベット順の通貨コード。	"EUR" "GBP" "USD"
page	糸	ブランドとのインタラクションが行われるウェブページの名前。これは、選択したカスタム値です。	"home" "contact-us.html"
pos	糸	ブランドとのインタラクションが行われるPOSの名前。	"myretailsite/ireland" "spinair.com/france"
browser_id	糸	ブラウザID。	"a38b230c-11eb-4cf9-8d5d-274e9f344925"
contact	オブジェクトの配列	連絡先の詳細。	該当なし

オブジェクトのcontact配列:

属性	種類	形容	例	必須/オプション
title	string (タイトルケース)	連絡先のタイトル。	"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	string (タイトルケースを推奨)	連絡先の名。	"Jane"	必須
lastname	string (タイトルケースを推奨)	連絡先の姓。	"Doe"	必須
mobile	糸	連絡先の携帯電話番号。	"+3531234567"	随意
phone	糸	連絡先の電話番号。	"+3531234567"	随意
street	文字列の配列 (タイトルケースを推奨)	連絡先の住所。	"Tara Street"	随意
city	string (タイトルケースを推奨)	連絡先の市区町村の住所。	"Dublin"	随意
state	string (タイトルケースを推奨)	連絡先の都道府県の住所。	"Oregon"	随意
country_code	文字列 (大文字ISO 3166-1 alpha-2)	連絡先の国コード。	"IE"	随意
postal_code	string (大文字を推奨)	連絡先の郵便番号。	"D15"	随意
dob	文字列 (ISO 8601)	連絡先の生年月日。	"1990-08-23T00:00"	随意
email	string (小文字を推奨)	連絡先のメールアドレス。	"[email protected]"	必須: 組織でemail属性を使用してゲストのIDを判断している場合。オプション: 組織でIDを使用してゲストIDを特定している場合。
gender	string (小文字)	連絡先の性別。	"male" "female" "rather_not_say"	随意
identifiers	オブジェクトの配列	アプリのユーザーを識別するために使用される識別子。	該当なし	必須: お客様の組織がお客様の身元を特定するために識別子を使用している場合。省略可: 組織でemail属性を使用してゲストIDを判断している場合。

オブジェクトのcontact.identifiers配列:

属性	種類	形容	例	必須/オプション
id	糸	組織のIDシステム(顧客関係管理(CRM)システムなど)によって提供される一意のゲスト識別子。	"123456"	必須
provider	糸	一意のゲスト識別子を提供した組織のIDシステムの名前 ( Sitecore Personalizeの外部)。	"BXLP"	必須
expiryDate	文字列 (ISO 8601)	一意のゲスト識別子の有効期限が切れる日付。これは、組織のIDシステムによって決まります。	"2025-04-15T08:39:44.868Z"	随意

告知

ADD_CONTACTSイベントを送信するときに、contact.identifiers配列とcontact.email属性の両方を含める必要はありません。組織では、contact.identifiers配列またはcontact.email属性を使用して、ゲストのIDを判別します。組織がゲストのIDを判別するためにcontact.email属性を使用している場合、contact.identifiers配列は無視されます。組織でcontact.identifiers配列を使用してゲストのIDを判別する場合、contact.email属性の送信はオプションです。

Example 49。 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": "[email protected]",
         "gender": "male",
         "identifiers": [
            {
               "provider": "BXLP",
               "id": "123456",
               "expiryDate": "2025-01-01T16:17:16.000Z",
            }
         ]
      }
   ]
}

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