追加のゲストデータSend

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

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

ゲストデータエクステンションは、任意の名前と値のペア (属性) を指定できる配列です。ゲストデータエクステンションはオプションであり、組織はゲストに関するより堅牢な情報を取得できます。

ゲスト拡張データモデルは、ゲストオブジェクトにリンクされているため、独自の要件とカスタム属性をゲストオブジェクトに拡張できます。配列内に1つのデータエクステンションを挿入できます。

次に、ゲストデータエクステンションの使用に関するガイドラインを示します。

データエクステンションデータをオブジェクトのextensions配列に配置します。
name属性はextである必要があります。または、複数のソースからゲスト拡張データを送信する場合は、ext1、ext2、ext3、ext4 、またはext5である必要があります。
key属性はdefaultである必要があります。
ゲストデータエクステンションには、最大100個の属性があります。

以下は、データエクステンションで属性を使用するためのガイドラインのリストです。

属性名は、JSON RFC 7159仕様に従って、英数字 A-Z、a-z、0-9 である必要があります。
データエクステンションの属性名はキャメルケースで記述する必要があります。
属性名は、すべてのゲストデータエクステンショングループで一意である必要があります。
属性名は意味のあるものにすることをお勧めします。

組織は、複数のソースシステムからゲスト拡張データをSitecore CDPに送信できます。各ゲストデータエクステンショングループには、最大100個のカスタム属性を含めることができます。

たとえば、組織でロイヤルティシステムからゲストデータエクステンションを送信してロイヤルティデータを取得し、顧客関係管理 (CRM) システムを使用してメール設定や代替メールアドレスなどを取得することができます。

警告

複数のソース・システムからデータを送信するには、ソース・システムごとに異なる拡張グループ名を使用する必要があります。これを行わないと、ソースシステムがゲスト拡張データをSitecore CDPに送信するたびに、他のソースシステムから送信されたゲスト拡張データが上書きされます。

組織では、最大6つのゲストデータエクステンショングループを使用できます。各グループ名は、異なるソース・システムを表します。拡張グループ名は、次のように使用する必要があります。

ext
ext1
ext2
ext3
ext4
ext5

ゲストデータエクステンショングループは、name属性で指定する必要があります。

たとえば、ロイヤルティシステムからSitecore CDPにデータを送信する場合、組織は常にキーと値のペアの値と同じゲスト拡張グループ名を使用する必要があります。同じゲスト拡張グループ名を使用して、他のソースシステムから拡張を送信しないでください。

メモ

キーと値のペアのキー名に一貫したプレフィックスを使用します。これにより、ユーザーはバッチセグメンテーションUIで特定のソースシステムのすべてのゲストデータエクステンションをすばやく見つけることができます。たとえば、プレフィックスとしてmemberを使用すると、すべてのゲストデータエクステンションmember UIにアルファベット順にまとめて表示されます。これにより、他のソースシステムから送信されたキーと値のペアを上書きすることもなくなります。たとえば、ロイヤルティメンバーシップとCRMシステムに対してnumberを持つキーが存在するとします。

ユーザーは、次の例に示すように、バッチセグメンテーションでゲストデータエクステンションにアクセスできます。

Accessing guest data extensions in batch segmentation

この例では、memberCardBalance、memberCardCategory、memberCardTypeが組織のロイヤルティシステムから送信されるゲストデータエクステンションになります。

{
   "ref":"9d94ee11-7043-4b71-980c-a777d00a7b46",
   "schema":"guest",
   "mode":"upsert",
   "value":{
      "guestType":"customer",
      "firstSeen":"2010-03-07T16:15:11.000Z",
      "lastSeen":"2012-08-23T16:17:16.000Z",
      "identifiers":[
         {
            "provider":"IDENTITY_SYSTEM",
            "id":"B7524AE6-CF1C-440F-B1A2-0C9D42F5CB41",
            "expiryDate":"2016-08-23T16:17:16.000Z"
         }
      ],
      "extensions":[
         {
            "name":"ext",
            "key":"default",
            "memberCardBalance": 5012.25,
            "memberCardType":"vip",
            "memberCardType":"platinum"
         }
      ]
   }
}

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