Amplitude コネクタ構成ガイド
この記事では、Amplitude コネクタの構成方法について説明します。
API 情報
このコネクタは以下のベンダー API を使用します:
- API 名:Amplitude HTTP API
- API バージョン:v2
- API エンドポイント:
https://api2.amplitude.com/2/httpapi
- ドキュメント:Amplitude HTTP API
コネクタのアクション
アクション名 | AudienceStream | EventStream |
---|---|---|
イベント送信 | ✓ | ✓ |
イベント送信(非バッチ処理) | ✓ | ✓ |
構成の構成
コネクタマーケットプレイスに移動して新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについての記事を参照してください。
コネクタを追加した後、以下の構成を構成します:
- API キー
構成 → プロジェクトの下に位置します。 - サーバーエンドポイント
使用する Amplitude エンドポイントを入力します。- 標準サーバー:
https://api2.amplitude.com/2/httpapi
- EU 居住サーバー:
https://api.eu.amplitude.com/2/httpapi
値を入力しない場合、コネクタはデフォルトで標準サーバーエンドポイントを使用します。
- 標準サーバー:
コネクタの構成が完了したら、完了をクリックします。
アクション構成 — パラメータとオプション
コネクタアクションの構成を続けるには、続行をクリックします。アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。
次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。
アクション — イベント送信(バッチ処理)
リアルタイム処理が必要な場合は、イベント送信(バッチ処理)アクションを使用しないでください。
バッチ制限
このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます:
- 最大リクエスト数:2000
- 最古のリクエストからの最大時間:10分
- リクエストの最大サイズ:1 MB
パラメータ
パラメータ | 説明 |
---|---|
イベントタイプ | (必須) イベントの一意の識別子です。Amplitudeは以下のイベント名を内部使用のために予約しています:[Amplitude] Start Session , [Amplitude] End Session , [Amplitude] Revenue , [Amplitude] Revenue (Verified) , [Amplitude] Revenue (Unverified) , [Amplitude] Merged User 。 |
APIキーオーバーライド | APIキー構成を上書きします。 |
サーバーエンドポイントオーバーライド | サーバーエンドポイント構成を上書きします。 |
Android ID | AndroidデバイスのAndroid ID(広告IDではありません)。 |
アプリバージョン | あなたのアプリケーションの現在のバージョン。 |
キャリア | ユーザーが使用しているキャリア。 |
市区町村 | ユーザーがいる市区町村。 |
国 | ユーザーがいる国。 |
指定市場エリア | ユーザーの現在の指定市場エリア(DMA)。 |
デバイスブランド | ユーザーが使用しているデバイスブランド。 |
デバイスID | デバイス固有の識別子、たとえばiOSのVendor識別子です。イベントにデバイスIDが送信されない場合、デフォルト値はユーザーIDのハッシュバージョンです。 |
デバイスのIPアドレス | ユーザーのIPアドレス。AmplitudeはIPアドレスを使用してユーザーの位置(市区町村、国、地域、DMA)を逆引きします。 |
デバイスメーカー | ユーザーが使用しているデバイスメーカー。 |
デバイスモデル | ユーザーが使用しているデバイスモデル。 |
イベントID | 同じユーザーIDとタイムスタンプを持つイベントを区別するための増加カウンター。特に同時に発生するイベントが予想される場合、Amplitudeは時間の経過とともに増加するイベントIDを送信することを推奨します。 |
Google Play Services広告ID | AndroidデバイスのGoogle Play Services広告ID。 |
iOS広告識別子 | iOSデバイスの広告識別子。 |
iOSベンダー識別子 | iOSデバイスのベンダー識別子。 |
挿入ID | イベントの一意の識別子。Amplitudeは、過去7日間に同じデバイスIDと挿入IDで送信された後続のイベントを重複排除します。Amplitudeは、デバイスID、ユーザーID、イベントタイプ、イベントID、時間の組み合わせを使用するか、UUIDを生成することを推奨します。 |
言語 | ユーザーが構成した言語。AmplitudeはISO 639言語コードを人間に優しい言語名に自動変換します(例:en-US をEnglish に)。 |
位置情報の緯度 | ユーザーの現在の緯度。 |
位置情報の経度 | ユーザーの現在の経度。 |
OS名 | ユーザーが使用しているモバイルオペレーティングシステムまたはブラウザの名前。 |
OSバージョン | ユーザーが使用しているモバイルオペレーティングシステムまたはブラウザのバージョン。 |
プラットフォーム | データを送信するデバイスプラットフォーム。 |
価格 | アイテムの購入価格。収益データには、収益フィールドが送信されていない場合、このフィールドが必要です。払い戻しの場合はマイナス値を使用します。 |
製品ID | 購入されたアイテムの識別子。このフィールドを使用する場合は、価格と数量を含めるか、収益と一緒に送信する必要があります。 |
数量 | 購入されたアイテムの数量。指定されていない場合、デフォルト値は1 です。 |
地域 | ユーザーの現在の地域。 |
収益 | 取引からの収益であり、価格と数量の積です。価格、数量、収益のすべてのフィールドを送信する場合、収益値は価格と数量の積です。払い戻しの場合はマイナス値を使用します。 |
収益タイプ | 購入されたアイテムの収益タイプです。このフィールドを使用する場合は、価格と数量の値を送信するか、収益の値を送信する必要があります。 |
セッションID | セッションの開始時間(エポックからのミリ秒)。特定のシステムとイベントを関連付けたい場合は、このパラメータが必要です。値が-1 の場合は、指定されていないことを表します。 |
時間 | イベントのタイムスタンプ(エポックからのミリ秒)。イベントと一緒に時間が送信されない場合、デフォルト値はリクエストのアップロード時間です。 |
ユーザーID | ユーザーのID。 |
イベントプロパティ | イベントと一緒に送信される追加データを表すキーと値のペアの辞書。 空の値はスキップされ、含まれません。 |
ユーザープロパティ | ユーザーに関連する追加データを表すキーと値のペアの辞書です。各異なる値はAmplitudeダッシュボード上でユーザーセグメントとして表示されます。 空の値はスキップされ、含まれません。 |
グループ | エンタープライズ専用。 ユーザーグループを表すキーと値のペアの辞書です。グループについての詳細は、JavaScript SDKの抜粋を参照してください。 空の値はスキップされ、含まれません。 |
テンプレート変数 | データ入力としてテンプレート変数を提供します。詳細については、コネクターテンプレート変数を参照してください。 ドット表記(例: items.name )でネストされたテンプレート変数を名前付けします。ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。 |
テンプレート | Body Dataで参照されるテンプレートを提供します。詳細については、コネクタテンプレートについてを参照してください。 テンプレートは、サポートされているフィールドに名前で二重中括弧で注入されます。例えば、 {{SomeTemplateName}} 。 |
アクション — イベント送信(非バッチ処理)
パラメータ
パラメータ | 説明 |
---|---|
イベントタイプ | (必須) イベントの一意の識別子です。Amplitudeは以下のイベント名を内部使用のために予約しています: [Amplitude] Start Session , [Amplitude] End Session , [Amplitude] Revenue , [Amplitude] Revenue (Verified) , [Amplitude] Revenue (Unverified) , [Amplitude] Merged User 。 |
APIキーオーバーライド | APIキー 構成をオーバーライドします。 |
サーバーエンドポイントオーバーライド | サーバーエンドポイント 構成をオーバーライドします。 |
Android ID | AndroidデバイスのAndroid ID(広告IDではありません)。 |
アプリバージョン | アプリケーションの現在のバージョン。 |
キャリア | ユーザーが使用しているキャリア。 |
市区町村 | ユーザーがいる市区町村。 |
国 | ユーザーがいる国。 |
指定市場エリア | ユーザーの現在の指定市場エリア(DMA)。 |
デバイスブランド | ユーザーが使用しているデバイスブランド。 |
デバイスID | デバイス固有の識別子、例えばiOSのVendor識別子です。イベントにデバイスIDが送信されない場合、デフォルト値はユーザーIDのハッシュバージョンです。 |
デバイスIPアドレス | ユーザーのIPアドレス。AmplitudeはIPアドレスを使用してユーザーの位置(市区町村、国、地域、DMA)を逆引きします。 |
デバイス製造元 | ユーザーが使用しているデバイスの製造元。 |
デバイスモデル | ユーザーが使用しているデバイスモデル。 |
イベントID | 同じユーザーIDとタイムスタンプを持つイベントを区別するための増加カウンター。Amplitudeは、特に同時に発生するイベントを予測する場合、時間とともに増加するイベントIDを送信することを推奨します。 |
Google Playサービス広告ID | AndroidデバイスのGoogle Playサービス広告ID。 |
iOS広告主識別子 | iOSデバイスの広告主識別子。 |
iOSベンダー識別子 | iOSデバイスのベンダー識別子。 |
挿入ID | イベントの一意の識別子。Amplitudeは過去7日間に同じデバイスIDと挿入IDで送信された後続のイベントを重複排除します。UUIDを生成するか、デバイスID、ユーザーID、イベントタイプ、イベントID、時間の組み合わせを使用することを推奨します。 |
言語 | ユーザーが構成した言語。AmplitudeはISO 639言語コードを人間に優しい言語名に自動変換します(例:en-US をEnglish に)。 |
位置情報緯度 | ユーザーの現在の緯度。 |
位置情報経度 | ユーザーの現在の経度。 |
OS名 | ユーザーが使用しているモバイルオペレーティングシステムまたはブラウザの名前。 |
OSバージョン | ユーザーが使用しているモバイルオペレーティングシステムまたはブラウザのバージョン。 |
プラットフォーム | データを送信するデバイスプラットフォーム。 |
価格 | アイテムの購入価格。収益データには、収益フィールドが送信されていない場合、このフィールドが必要です。払い戻しの場合はマイナス値を使用します。 |
製品ID | 購入されたアイテムの識別子。価格と数量を含めるか、このフィールドに収益を含める必要があります。 |
数量 | 購入されたアイテムの数量。指定されていない場合、デフォルト値は1 です。 |
地域 | ユーザーの現在の地域。 |
収益 | 取引からの収益で、価格と数量の積です。価格、数量、収益のすべてのフィールドを送信する場合、収益値は価格と数量の積です。払い戻しの場合はマイナス値を使用します。 |
収益タイプ | 購入されたアイテムの収益タイプ。価格と数量の値を送信するか、このフィールドに収益の値を送信する必要があります。 |
セッションID | セッションの開始時間をエポックからのミリ秒単位で表します。特定のシステムにイベントを関連付けたい場合、このパラメータが必要です。-1 の値は指定されていないことを表します。 |
時間 | イベントのタイムスタンプをエポックからのミリ秒単位で表します。イベントに時間が送信されていない場合、デフォルト値はリクエストアップロード時間です。 |
ユーザーID | ユーザーのID。 |
イベントプロパティ | イベントと共に送信される追加データを表すキーと値のペアの辞書。 空の値はスキップされ、含まれません。 |
ユーザープロパティ | ユーザーに関連する追加データを表すキーと値のペアの辞書。各異なる値はAmplitudeダッシュボード上でユーザーセグメントとして表示されます。 空の値はスキップされ、含まれません。 |
グループ | エンタープライズ専用。 ユーザーグループを表すキーと値のペアの辞書。グループについての詳細は、JavaScript SDKの抜粋を参照してください。 空の値はスキップされ、含まれません。 |
テンプレート変数 | データ入力としてテンプレート変数を提供します。詳細については、コネクターテンプレート変数を参照してください。 ドット表記(例: items.name )でネストされたテンプレート変数を名前付けします。ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。 |
テンプレート | Body Dataで参照されるテンプレートを提供します。詳細については、コネクタテンプレートについてを参照してください。 テンプレートは、サポートされるフィールドに名前で二重中括弧を使用して注入されます。例えば、 {{SomeTemplateName}} 。 |
最終更新日 :: 2025年June月13日