直接HTTP要求の参照

イベントの送信

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

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

メモ

直接HTTPリクエストを使用する代わりに、Engage SDKを使用してイベントを送信することをお勧めします。Engage SDKを使用して、このセクションで説明する方法とは異なる方法でイベントデータをフォーマットして送信する必要があります。Sending eventsを参照してください。

GET /v1.2/event/create.json?client_key={:placeholder-token:}client_key{/:placeholder-token:}&message={:placeholder-token:}event{/:placeholder-token:}

直接HTTPリクエスト (VIEWイベントなど) を使用してSitecore Personalizeにイベントを送信するには、Event API (Stream APIタイプ) を使用してGETリクエストを行います。messageパラメーターでイベントオブジェクトを渡します。イベントオブジェクトを正しくフォーマットし、必要なすべての属性が含まれていることを確認してください。

パラメーター	種類	形容	例
{:placeholder-token:}client_key{/:placeholder-token:}	糸	クライアントキー。	ZpHxO9WvLOfQRVPlvo0BqB8YjGYuFfNe
{:placeholder-token:}event{/:placeholder-token:}	JSONオブジェクト	すべてのイベントの詳細。	{"key1":"value","key2":"value"}

イベントデータは、URLのJSONオブジェクトとして送信されます。以下の点に注意してください。

オブジェクトを中括弧で囲みます {}。
すべてのキーとすべての値を二重引用符で囲みます "".
改行は追加しないでください。
キーや値の周囲にスペースを追加しないでください。

Example 33。 VIEWイベントのイベントオブジェクトが正しくフォーマットされている

{"channel":"MOBILE_APP","type":"VIEW","language":"EN","currency":"EUR","page":"homepage","pos":"myretailsite/ireland","browser_id":"a38b230c-11eb-4cf9-8d5d-274e9f344925"}

少なくとも、すべてのイベントデータオブジェクトには、次の属性が含まれている必要があります。さまざまなイベントタイプのイベントデータオブジェクトには、この表に記載されているよりも多くの属性が必要な場合があることに注意してください。

属性	種類	形容	例
channel	string (大文字)	ユーザーがブランドとやり取りするタッチポイント。たとえば、Webページの場合、チャネルは "WEB"です。モバイルアプリの画面の場合、チャネルは "MOBILE_APP"です。	次のいずれかである必要があります。 "AIRPORT_KIOSK" "BRANCH" "CALL_CENTER" "EMAIL" "GDS" "KIOSK" "MOBILE_APP" "MOBILE_WEB" "SMS" "OFFLINE" "OTA" "OTHER" "WEB"
type	string (大文字)	ユーザーがブランドと対話したときに発生するイベントの種類。 VIEWやIDENTITYなどのSitecore Personalize標準イベントを送信するには、値をSitecore Personalize予約イベント名に設定します。カスタムイベントを送信するには、任意のカスタムイベント名に値を設定します。カスタムイベント名は、予約済みのイベント名とは異なるSitecore Personalizeする必要があります。 Sitecore Personalize予約済みイベント名: で始まる任意のイベント名 "SC_" "ADD" - 標準のADDイベント。 "ADD_CONSUMERS" - スタンダードADD_CONSUMERSイベント。 "ADD_CONTACTS" - スタンダードADD_CONTACTSイベント。 "CAMPAIGN_TRACKING" - 内部予約イベント。使用しないでください。 "CHECKOUT" - 標準のCHECKOUTイベント。 "CLEAR_CART" - スタンダードCLEAR_CARTイベント。 "CONFIRM" - 標準のCONFIRMイベント。 "FEEDBACK" - FEEDBACKイベント。 "IDENTITY" - 標準のIDENTITYイベント。 "INTERACTION" - 内部予約イベント。使用しないでください。 "ORDER_CHECKOUT" - スタンダードORDER_CHECKOUTイベント。 "PAYMENT" - 標準のPAYMENTイベント。 "SUBSCRIPTION" - 内部予約イベント。使用しないでください。 "SEARCH" - 標準のSEARCHイベント。 "TRACKING" - 内部予約イベント。使用しないでください。 "VIEW" - 標準のVIEWイベント。	"myretailsite:CLICKED_POPUP" "CUSTOM_EVENT_SEARCH" "CUSTOM_EVENT_BANNER_CLICK"
language	文字列 (大文字ISO 639-1)	ユーザーがアプリを使用している言語。例えば、ユーザーがWebサイトで日本語を選択した場合、その言語は "JA"になります。	"DE" "EN" "FR"
currency	文字列 (大文字のISO 4217)	ユーザーがアプリで使用している通貨のアルファベット順の通貨コード。たとえば、ユーザーがウェブサイトの通貨としてオーストラリアドルを選択した場合、通貨は "AUD"になります。	"EUR" "GBP" "USD"
page	糸	ブランドとのインタラクションが行われるウェブページの名前。これは、選択したカスタム値です。	"home" "contact-us.html"
pos	糸	ブランドとのインタラクションが行われるPOSの名前。この値は、Sitecore Personalizeのインスタンスに存在する販売時点情報の名前に設定する必要があります。	"myretailsite/ireland"
browser_id	糸	ブラウザID。	ブラウザIDは、次のような文字列です。 "a38b230c-11eb-4cf9-8d5d-274e9f344925"

curl -X GET -g '<baseURL>/v1.2/event/create.json?client_key=<client_key>&message={"channel":"MOBILE_APP","type":"VIEW","language":"EN","currency":"EUR","page":"homepage","pos":"myretailsite/ireland","browser_id":"a38b230c-11eb-4cf9-8d5d-274e9f344925"}'

{
    "status": "OK",
    "version": "1.2",
    "client_key": "ZpHxO9WvLOfQRVPlvo0BqB8YjGYuFfNe",
    "ref": "dcb27c41-688d-4c36-8ed7-536e7bf590ba"
}

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