アンプリチュードコネクタ構成ガイド | サーバーサイドコネクタ

API情報

このコネクタは、以下のベンダーAPIを使用します：

API名：Amplitude HTTP API
APIバージョン：v2
APIエンドポイント：https://api2.amplitude.com/2/httpapi
ドキュメンテーション：Amplitude HTTP API

コネクタアクション

アクション名	AudienceStream	EventStream
イベント送信	✓	✓
イベント送信（非バッチ）	✓	✓

構成の構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法の一般的な指示については、About Connectorsの記事を参照してください。

コネクタを追加した後、以下の構成を構成します：

APIキー
構成→プロジェクトの下にあります。
サーバーエンドポイント
使用するAmplitudeエンドポイントを入力します。
- 標準サーバー：https://api2.amplitude.com/2/httpapi
- EU居住サーバー：https://api.eu.amplitude.com/2/httpapi
  値を入力しない場合、コネクタはデフォルトで標準サーバーエンドポイントを使用します。

コネクタの構成が完了したら、完了をクリックします。

アクション構成 - パラメータとオプション

続行をクリックしてコネクタアクションを構成します。アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

アクション - イベント送信（バッチ）

リアルタイム処理が必要な場合は、イベント送信（バッチ）アクションを使用しないでください。

バッチ制限

このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、Batched Actionsを参照してください。リクエストは、以下のいずれかの閾値が達成されるか、プロファイルが公開されるまでキューに入れられます：

リクエストの最大数：2000
最古のリクエストからの最大時間：10分
リクエストの最大サイズ：1 MB

パラメータ

パラメータ	説明
イベントタイプ	(必須) イベントの一意の識別子。Amplitudeは以下のイベント名を内部使用のために予約しています：`[Amplitude] Start Session`, `[Amplitude] End Session`, `[Amplitude] Revenue`, `[Amplitude] Revenue (Verified)`, `[Amplitude] Revenue (Unverified)`, and `[Amplitude] Merged User`.
APIキーオーバーライド	APIキー構成を上書きします。
サーバーエンドポイントオーバーライド	サーバーエンドポイント構成を上書きします。
Android ID	AndroidデバイスのAndroid ID（広告IDではありません）。
アプリバージョン	アプリケーションの現在のバージョン。
キャリア	ユーザーが使用しているキャリア。
市区町村	ユーザーがいる市区町村。
国	ユーザーがいる国。
指定市場エリア	ユーザーの現在の指定市場エリア（DMA）。
デバイスブランド	ユーザーが使用しているデバイスのブランド。
デバイスID	デバイス固有の識別子、例えばiOSのベンダー識別子。イベントと共にデバイスIDが送信されない場合、デフォルト値はユーザーIDのハッシュ化バージョンです。
デバイスIPアドレス	ユーザーのIPアドレス。AmplitudeはIPアドレスを使用してユーザーの位置情報（市区町村、国、地域、DMA）を逆引きします。
デバイス製造者	ユーザーが使用しているデバイスの製造者。
デバイスモデル	ユーザーが使用しているデバイスのモデル。
イベントID	同じユーザーIDとタイムスタンプを持つイベントを区別するための増加カウンター。特に同時にイベントが発生すると予想される場合、Amplitudeは時間と共に増加するイベントIDを送信することを推奨します。
Google Play Services Advertising ID	AndroidデバイスのGoogle Play Services広告ID。
iOS広告主識別子	iOSデバイスの広告主識別子。
iOSベンダー識別子	iOSデバイスのベンダー識別子。
挿入ID	イベントの一意の識別子。Amplitudeは、過去7日間で同じデバイスIDと挿入IDを持つ後続のイベントを重複排除します。Amplitudeは、UUIDを生成するか、デバイスID、ユーザーID、イベントタイプ、イベントID、時間の組み合わせを使用することを推奨します。
言語	ユーザーが構成した言語。Amplitudeは自動的にISO-639言語コードを人間が読みやすい言語名に変換します（例：`en-US`を`English`に）。
位置緯度	ユーザーの現在の緯度。
位置経度	ユーザーの現在の経度。
OS名	ユーザーが使用しているモバイルオペレーティングシステムまたはブラウザの名前。
OSバージョン	ユーザーが使用しているモバイルオペレーティングシステムまたはブラウザのバージョン。
プラットフォーム	データを送信するデバイスプラットフォーム。
価格	アイテムの購入価格。収益フィールドが送信されない場合、収益データに必要です。返金の場合は負の値を使用します。
製品ID	購入したアイテムの識別子。このフィールドには価格と数量を含めるか、収益を含める必要があります。
数量	購入したアイテムの数量。指定されていない場合、デフォルト値は`1`です。
地域	ユーザーの現在の地域。
収益	トランザクションからの収益、これは価格と数量の積です。価格、数量、収益のすべてのフィールドを送信する場合、収益の値は価格と数量の積です。返金の場合は負の値を使用します。
収益タイプ	購入したアイテムの収益のタイプ。このフィールドには価格と数量の値を送信するか、収益の値を送信する必要があります。
セッションID	セッションの開始時間（エポックからのミリ秒）。特定のシステムとイベントを関連付けたい場合は、このパラメータが必要です。`-1`の値は値が指定されていないことを表します。
時間	イベントのタイムスタンプ（エポックからのミリ秒）。時間がイベントと共に送信されない場合、デフォルト値はリクエストのアップロード時間です。
ユーザーID	ユーザーのID。
イベントプロパティ	イベントと共に送信される追加データを表すキーと値のペアの辞書。空の値はスキップされ、含まれません。
ユーザープロパティ	ユーザーに関連付けられた追加データを表すキーと値のペアの辞書。各異なる値はAmplitudeダッシュボード上のユーザーセグメントとして表示されます。空の値はスキップされ、含まれません。
グループ	エンタープライズのみ。ユーザーグループを表すキーと値のペアの辞書。グループについての詳細は、our Javascript SDK excerptを参照してください。空の値はスキップされ、含まれません。
テンプレート変数	データ入力としてテンプレート変数を提供します（参照：Template Variables Guide）。ネストしたテンプレート変数の名前はドット表記法で指定します（例：`items.name`）。ネストしたテンプレート変数は通常、データレイヤーリスト属性から構築されます。
テンプレート	ボディデータで参照されるテンプレートを提供します（参照：Templates Guide）。テンプレートは、サポートされるフィールドに名前でダブルカーリーブレースで注入されます（例：`{{SomeTemplateName}}`）。

アクション - イベント送信（非バッチ）

パラメータ

パラメータ	説明
イベントタイプ	(必須) イベントの一意の識別子。Amplitudeは以下のイベント名を内部使用のために予約しています：`[Amplitude] Start Session`, `[Amplitude] End Session`, `[Amplitude] Revenue`, `[Amplitude] Revenue (Verified)`, `[Amplitude] Revenue (Unverified)`, and `[Amplitude] Merged User`.
APIキーオーバーライド	APIキー構成を上書きします。
サーバーエンドポイントオーバーライド	サーバーエンドポイント構成を上書きします。
Android ID	AndroidデバイスのAndroid ID（広告IDではありません）。
アプリバージョン	アプリケーションの現在のバージョン。
キャリア	ユーザーが使用しているキャリア。
市区町村	ユーザーがいる市区町村。
国	ユーザーがいる国。
指定市場エリア	ユーザーの現在の指定市場エリア（DMA）。
デバイスブランド	ユーザーが使用しているデバイスのブランド。
Device ID	デバイス固有の識別子、例えばiOSのベンダーの識別子。デバイスIDがイベントと共に送信されない場合、デフォルト値はユーザーIDのハッシュ版です。
Device IP Address	ユーザーのIPアドレス。AmplitudeはIPアドレスを使用してユーザーの位置情報（市、国、地域、DMA）を逆引きします。
Device Manufacturer	ユーザーが使用しているデバイスの製造元。
Device Model	ユーザーが使用しているデバイスのモデル。
Event ID	同じユーザーIDとタイムスタンプを持つイベントを区別するための増加カウンター。特に同時にイベントが発生することを予想している場合、Amplitudeは時間と共に増加するイベントIDを送信することを推奨します。
Google Play Services Advertising ID	AndroidデバイスのGoogle Play Services広告ID。
iOS Identifier for Advertiser	iOSデバイスの広告主の識別子。
iOS Identifier for Vendor	iOSデバイスのベンダーの識別子。
Insert ID	イベントの一意の識別子。Amplitudeは、過去7日間で同じデバイスIDと挿入IDを持つ後続のイベントを重複排除します。Amplitudeは、UUIDを生成するか、デバイスID、ユーザーID、イベントタイプ、イベントID、時間の組み合わせを使用することを推奨します。
Language	ユーザーが構成した言語。Amplitudeは自動的にISO-639言語コードを人間が理解しやすい言語名（例：`en-US`を`English`に）に変換します。
Location Latitude	ユーザーの現在の緯度。
Location Longitude	ユーザーの現在の経度。
OS Name	ユーザーが使用しているモバイルオペレーティングシステムまたはブラウザの名前。
OS Version	ユーザーが使用しているモバイルオペレーティングシステムまたはブラウザのバージョン。
Platform	データを送信するデバイスプラットフォーム。
Price	アイテムの購入価格。収益フィールドが送信されない場合は、収益データに必要です。払い戻しの場合は負の値を使用します。
Product ID	購入したアイテムの識別子。このフィールドには価格と数量を含めるか、収益を含める必要があります。
Quantity	購入したアイテムの数量。指定されていない場合、デフォルト値は`1`です。
Region	ユーザーの現在の地域。
Revenue	取引からの収益、これは価格と数量の積です。価格、数量、収益のすべてのフィールドを送信する場合、収益の値は価格と数量の積です。払い戻しの場合は負の値を使用します。
Revenue Type	購入したアイテムの収益のタイプ。このフィールドには価格と数量の値を送信するか、収益の値を送信する必要があります。
Session ID	セッションの開始時間（エポックからのミリ秒）。特定のシステムとイベントを関連付けたい場合、このパラメーターは必要です。`-1`の値は指定されていない値を表します。
Time	イベントのタイムスタンプ（エポックからのミリ秒）。時間がイベントと共に送信されない場合、デフォルト値はリクエストのアップロード時間です。
User ID	ユーザーのID。
Event Properties	イベントと共に送信される追加データを表すキーと値のペアの辞書。空の値はスキップされ、含まれません。
User Properties	ユーザーに関連する追加データを表すキーと値のペアの辞書。各異なる値はAmplitudeダッシュボード上のユーザーセグメントとして表示されます。空の値はスキップされ、含まれません。
Groups	エンタープライズ専用。ユーザーグループを表すキーと値のペアの辞書。グループについての詳細は、Javascript SDKの抜粋を参照してください。空の値はスキップされ、含まれません。
Template Variables	テンプレート変数をデータ入力として提供します（参照：Template Variables Guide）。ネストしたテンプレート変数はドット表記法で名前を付けます（例：`items.name`）。ネストしたテンプレート変数は通常、データレイヤーリスト属性から構築されます。
Templates	Body Dataで参照されるテンプレートを提供します（参照：Templates Guide）。テンプレートは、サポートされるフィールドにダブルカーリーブレースで名前を付けて注入されます（例：`{{SomeTemplateName}}`;）。