例えば、自社とのやり取りやコンテンツに基づいてコンタクトのセグメンテーションを強化する必要があるとします。そのためには、さらに多くの情報が必要です。コンタクトとのやり取りに関して詳細なコンテキスト情報を示すカスタムイベント（最近のウェビナーへの登録のみで欠席したコンタクト、コンタクトが登録を完了したフローなど）を、アプリで作成することが考えられます。
## イベントテンプレートを作成する
イベントを作成するには、事前にイベントテンプレートを作成しておく必要があります。イベントテンプレートでは、HubSpotの中のコンタクト、会社、または取引オブジェクトのタイムラインにアプリが追加するアクションを記述します。アクションの例としては、動画表示、ウェビナー登録、アンケート記入などがあります。アプリごとに、最大750件のイベントテンプレートを作成できます。
既定では、イベントテンプレートはコンタクトに対して作成されますが、`objectType`フィールドを使用することによって会社や取引について作成することもできます。詳細は、タイムライン イベント テンプレートの作成に関する説明を参照してください。
イベントテンプレートごとに、トークンとテンプレートの固有のセットがあります。コンタクトに対して作成されたイベントを、新しいコンタクトリストまたはワークフローを作成する際の条件として使用できます。例えば、「動画名にXYZが含まれる動画にいいね！を付けた全てのコンタクトのリストを作成する」というように設定できます。この場合、イベントテンプレートは「Video Like」という名前が付けられ、「video name」というイベントトークンを持っています。"
### APIを使用してイベントテンプレートを作成する
この例では、新しいイベントテンプレート「Example Webinar Registration」を作成します。認証には開発者APIキーを使用します。これは、アプリ開発者アカウントで確認できます。
```shell theme={null}
curl -X POST
-H "Content-Type: application/json" -d '
{
"name": "Example Webinar Registration",
"objectType": "contacts"
}' \
'https://api.hubapi.com/crm/v3/timeline/<
新しいイベントテンプレートの下書きから始めます。イベントのオブジェクトタイプ、さらに詳細テンプレートとヘッダーテンプレートを設定したら、［作成］をクリックします\*\*。\*\*
イベントテンプレートの作成または編集を行う際には、使用するトークンを［データ］タブで設定します。
［詳細を表示］をクリックすると、詳細テンプレートが表示されます。
イベントの横に表示されるアイコンを設定するには、"後述の「[カスタムアイコンの設定"](/api-reference/crm-timeline-v3/guide#customicon)」を参照してください。
ここでの「Example App Name」というテキストはアプリの名前です。CRMタイムライン内では、アプリ単位でイベントを絞り込むことができます。
### 1回の呼び出しでイベントテンプレートの全ての要素を定義する
ここまではイベントテンプレートの各要素を紹介してきましたが、1回の`POST`呼び出しで全ての要素を定義できます。
```shell theme={null}
curl -X POST -H "Content-Type: application/json" -d '
{
"name": "Another Webinar Registration",
"objectType": "contacts",
"headerTemplate": "Registered for [{{webinarName}}](https://mywebinarsystem/webinar/{{webinarId}})",
"detailTemplate": "Registration occurred at {{#formatDate timestamp}}{{/formatDate}}",
"tokens": [
{
"name": "webinarName",
"label": "Webinar Name",
"type": "string"
},
{
"name": "webinarId",
"label": "Webinar Id",
"type": "string"
},
{
"name": "webinarType",
"label": "Webinar Type",
"type": "enumeration",
"options": [
{
"value": "regular",
"label": "Regular"
},
{
"value": "ama",
"label": "Ask me anything"
}
]
}
]
}' \
'https://api.hubapi.com/crm/v3/timeline/<
### イベントタイムスタンプを設定する
イベントがオブジェクト内のタイムラインに現れる位置は、イベントのタイムスタンプによって決まります。イベントタイムスタンプには、既定でPOSTコマンドの送信時刻が設定されます。イベント時刻は、タイムスタンププロパティーのリクエスト本文に明示することによりカスタマイズできます。
```shell theme={null}
curl -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer <
このリンクをクリックするとモーダルウィンドウが開き、`url`に設定されているページが表示されます。
### CRMオブジェクトのプロパティーに対してイベントデータを付加する
イベントを追加するコンタクト、会社、取引のプロパティーに、変更が必要になるケースは少なくありません。特に、イベントを追加することでコンタクトが作成される場合が該当します。Eメールアドレスとイベントだけのコンタクトを作成しないためにも、コンタクトの姓名のプロパティーを更新する必要があるはずです。
カスタム イベント トークンをコンタクト、会社、または取引のプロパティーにマッピングすることにより、イベントからの関連オブジェクトのデータを付加することができます。
カスタム イベント テンプレートを更新するための次の`PUT`コマンドで、`objectPropertyName`フィールドに注目してください。
```shell theme={null}
curl -X PUT -H "Content-Type: application/json" -d '
{
"label" : "Updated Webinar Name",
"objectPropertyName": "zz_webinar_name"
}' \
'https://api.hubapi.com/crm/v3/timeline/<
注：イベントトークンがカスタムプロパティーに付加される際に該当するカスタムプロパティーがHubSpotアカウント上に存在しない場合、イベントには値が設定されますが、対応するオブジェクト側では無視されます。
### `extraData`について
イベント テンプレート トークンによって使用される「トークンと値」の単純な構造が適さない詳細なデータを、イベントに追加することが必要になるかもしれません。あるいは連携のイベントに、リストまたは階層状の内訳が必要になる場合も考えられます。こうした状況で役立つのが`extraData`です。
`extraData`属性をイベントのJSON本文に追加することができます。この`extraData`の値として、任意の有効なJSONを指定できます。以下に例を示します。
```shell theme={null}
curl -X POST -H "Content-Type: application/json" \
-H "Authorization: Bearer <
注：`extraData`属性は、イベントの詳細テンプレート内でのみ参照できます。ヘッダーテンプレートやリストセグメンテーションの中では使用できません。
### カスタムアイコンを設定する
タイムライン上の項目にビジュアル効果を付けるために、必要に応じてカスタムアイコンを追加できます。
アイコンには、次のような画像ファイルを使用してください。
* ほぼ正方形に近い形
* 背景を透過にする
* コンテンツをアイコンの中央に配置する
* 30×30ピクセルにまで縮小可能
* ファイルサイズが5MB以下
タイムラインイベントに使用するアイコンを設定するには、［タイムラインイベント］に進みます。プレースホルダー画像または既存のアイコンをクリックして、設定または変更します。
設定したアイコンは、アプリに関連する全てのタイムラインイベントの横に表示されます。
### イベントインスタンスの制限
イベントを作成するとき、シリアル化された各イベントインスタンスには、次のサイズ制限が適用されます。
* イベントインスタンスIDは500バイト
* プロパティー／トークンあたり510KB
* イベントインスタンスの合計サイズは1 MB
***
#### 関連ドキュメント
[CRMについて](/guides/crm/understanding-the-crm)
[CRMカード](/api-reference/crm-public-app-crm-cards-v3/guide)