この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

カスタムイベント

Salesforce Interactions SDK で提供されている推奨のカートインタラクション、カタログインタラクション、および注文インタラクションデータモデルを使用して、Salesforce 全体で統合されたデータモデルを使用します。推奨のインタラクションデータモデルに加えて、カスタムイベントの作成と取得ができます。

Web コネクタスキーマでカスタムイベントの形式を定義します。次に例を示します。

1{
2  "records": [
3    {
4      "developerName": "myCustomEvent",
5      "masterLabel": "My Custom Event",
6      "category": "Engagement",
7      "externalDataTranFields": [
8        {
9          "masterLabel": "My Custom Field",
10          "dataType": "Text",
11          "developerName": "myCustomField",
12          "isDataRequired": true
13        },
14        {
15          "masterLabel": "My Custom Num Attribute",
16          "dataType": "Number",
17          "developerName": "attributesMyCustomNum",
18          "isDataRequired": true
19        },
20        {
21          "masterLabel": "My Custom Text Attribute",
22          "dataType": "Text",
23          "developerName": "attributesMyCustomText",
24          "isDataRequired": true
25        },
26        {
27          "masterLabel": "eventId",
28          "dataType": "Text",
29          "developerName": "eventId",
30          "isDataRequired": true,
31          "primaryIndexOrder": 1
32        },
33        {
34          "masterLabel": "category",
35          "dataType": "Text",
36          "developerName": "category",
37          "isDataRequired": true
38        },
39        {
40          "masterLabel": "dateTime",
41          "dataType": "DateTime",
42          "developerName": "dateTime",
43          "isDataRequired": true
44        },
45        {
46          "masterLabel": "deviceId",
47          "dataType": "Text",
48          "developerName": "deviceId",
49          "isDataRequired": true
50        },
51        {
52          "masterLabel": "eventType",
53          "dataType": "Text",
54          "developerName": "eventType",
55          "isDataRequired": true
56        },
57        {
58          "masterLabel": "sessionId",
59          "dataType": "Text",
60          "developerName": "sessionId",
61          "isDataRequired": true
62        }
63      ]
64    }
65  ]
66}

次に、Salesforce Interactions SDK で、eventType または name 項目と、必須項目の自動入力では設定されない必須項目を指定して、このイベントを取得します。

1SalesforceInteractions.sendEvent({
2  interaction: {
3    name: 'myCustomEvent',
4    eventType: 'myCustomEvent',
5    myCustomField: 'some value'
6    attributes: {
7        myCustomNum: 1234,
8        myCustomText: "abcd"
9  }
10})

SDK で Data Cloud に対する次のようなイベントが生成されます。

1{
2"events": [{
3    "eventType": "myCustomEvent",
4    "myCustomField": "some value",
5    "attributesMyCustomNum": 1234,
6    "attributesMyCustomText": "abcd",
7    "eventId": "100d237b-e464-44df-9556-7481bbf52685",
8    "dateTime": "2022-10-18T18:25:26.680Z",
9    "sessionId": "6b6c33bfcfee93f4",
10    "deviceId": "6b6c33bfcfee93f4",
11    "interactionName": "myCustomEvent",
12    "sourceUrl": "https://{my site}",
13    "sourceUrlReferrer": "https://{my site}",
14    "sourceChannel": "Web",
15    "sourcePageType": "test",
16    "category": "Engagement"
17}]
18}

eventType を指定せずに name を指定した場合、eventType はデフォルトで name の値になります。

メモ

Data Cloud 開発者ガイド

カスタムイベント