---
title: "Send追加のゲストデータ"
slug: "send-additional-guest-data"
abstract: "バッチAPIを使った追加ゲストデータをSitecore CDPに送信する方法の概要。"
---
# Send追加のゲストデータ

::::タブ:::tab{title="2.1"}

ゲストデータ拡張は、任意の名前や値の組み合わせ(属性)を指定できる配列です。ゲストデータ拡張は任意で、組織がゲストに関するより堅牢な情報を収集できるようにします。

[ゲスト拡張データモデル](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/batch-api-guest/guest-extension-data-model.html "Guest extension data model")はゲストオブジェクトにリンクされており、ゲストオブジェクトに自分の要件やカスタム属性を拡張できます。配列内に1つのデータ拡張を挿入できます。

以下はゲストデータ拡張の使用に関するガイドラインの一覧です:

-   データ拡張データをオブジェクトの extensions 配列に配置します。
-   name属性はextでなければなりません。または、複数のソースからゲスト拡張データを送る場合は、ext1、ext2、ext3、ext4、またはext5でなければなりません。
-   key属性はdefaultでなければなりません。
-   ゲストデータ拡張には最大100の属性があります。

以下は、データ拡張で属性を使用する際のガイドラインの一覧です。

-   属性名は [JSON RFC 7159](https://www.rfc-editor.org/rfc/rfc7159) 仕様に従い、英数字\[A-Z,a-z,0-9\]でなければなりません。
-   データ拡張の属性名はキャメルケースで書かなければなりません。
-   属性名はすべてのゲストデータ拡張グループ間で一意でなければなりません。
-   属性名を意味のあるものにすることをおすすめします。

サイドバー。複数のソースシステムからゲスト拡張データを送信する

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

例えば、組織はロイヤルティシステムからロイヤルティデータを取得するためにゲストデータ拡張機能を送信し、顧客関係管理(CRM)システムからメールの好みや代替郵送先住所などを取得したい場合もあります。

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

組織は最大6つのゲストデータ拡張グループを使用できます。各グループ名は異なるソースシステムを表します。拡張グループ名は以下のように使用しなければなりません:

-   ext
-   ext1
-   ext2
-   ext3
-   ext4
-   ext5

名前属性でゲストデータ拡張グループを指定する必要があります。

例えば、ロイヤルティシステムからSitecore CDPにデータを送信したい場合、組織はキーと値の組み合わせの値と常に同じゲスト内線グループ名を使用しなければなりません。他のソースシステムからの内線送信時に同じゲスト内線グループ名を使わないでください。

> !注キー-値ペアのキー名に一貫したプレフィックスを用いましょう。これにより、バッチセグメンテーションUI内の特定のソースシステムのすべてのゲストデータ拡張を素早く見つけやすくなります。例えば、memberをプレフィックスとして使うと、すべてのmemberゲストデータ拡張がアルファベット順にUI内で一緒に表示されます。これにより、他のソースシステムから送信されたキー-値ペアを上書きしないようにします。例えば、ロイヤルティメンバーシップやCRMシステム用のnumberキーが存在することがあります。

サイドバー。バッチセグメンテーションにおけるゲストデータ拡張へのアクセス

ユーザーは以下の例のようにバッチセグメンテーションでゲストデータ拡張にアクセスできます。

![Accessing guest data extensions in batch segmentation](https://doc.sitecore.com/api/markdown-image/cdp/ja/developers/api/images/guestDataExt.png)

この例では、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"
 }
 
 }
}

::::::tab{title="2.0"}

2.0のデータモデルはこの機能をサポートしていません。

:::::::