Amplitude Identifyコネクタ構成ガイド | サーバーサイドコネクタ

API情報

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

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

構成

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

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

APIキー
- プロジェクトのAPIキー。APIキーはAmplitudeインスタンスの構成 > プロジェクトの下にあります。
エンドポイント
- エンドポイントを選択するか、エンドポイントURLを入力します。
- 標準サーバー：https://api2.amplitude.com/identify.
- EU居住者サーバー：https://api.eu.amplitude.com/identify.
- 提供されていない場合、デフォルトで標準サーバーエンドポイントを使用する必要があります。

アクション

アクション名	AudienceStream	EventStream
ユーザープロパティの更新	✓	✓

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

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

ユーザープロパティの更新

パラメータ

パラメータ	説明
`user_id`	指定する`UUID`（ユニークなユーザー`ID`）。Amplitudeシステムにまだ存在しない`user_id`でリクエストを送信すると、その`user_id`に紐づけられたユーザーは、最初のイベントまで新規とはマークされません。
`device_id`	デバイス固有の識別子、例えばiOSのベンダーの識別子（`IDFV`）。
`app_version`	ユーザーが使用しているアプリのバージョン。
`start_version`	ユーザーが最初に使用していたアプリのバージョン。
`groups`	ユーザーグループを表すキーと値のペアの辞書。グループを構成することで、アカウントレベルのレポーティングを使用できます。最大`5`種類のユニークなグループタイプと`10`の合計グループを追跡できます。詳細については、Amplitudeのアカウントレベルレポーティングを参照してください。この機能は、アカウント追加オプションを購入したエンタープライズ顧客のみが利用可能です。

`language`	ユーザーが構成した言語。
`paying`	ユーザーが支払いを行っているかどうかを指定します。

地理的なパラメータ

以下のすべてのフィールドを一緒に更新する必要があります。これらのフィールドのいずれかを構成すると、同じ識別呼び出しで明示的に構成されていない他のフィールドは自動的にリセットされます。

パラメータ	説明
`country`	ユーザーがいる国。
`region`	ユーザーがいる地理的な地域。
`city`	ユーザーがいる都市。
`DMA`	ユーザーの指定市場エリア。

デバイスパラメータ

以下のフィールドを一緒に更新する必要があります：

platform
os_name
os_version
device_brand
device_manufacturer
device_model
carrier

上記のフィールドのいずれかを構成すると、同じ識別呼び出しで明示的に構成されていない他のプロパティ値はすべてnullにリセットされます。それ以外の場合、プロパティ値は値が異なる文字列に変更されない限り、またはすべての値がnullとして渡されない限り、後続のイベントに持続します。Amplitudeはdevice_brand、device_manufacturer、device_modelを使用して対応するデバイスタイプをマッピングしようとします。

パラメータ	説明
`platform`	データを送信しているプラットフォーム。
`os_name`	ユーザーが使用しているモバイルオペレーティングシステムまたはブラウザ。
`os_version`	ユーザーが使用しているモバイルオペレーティングシステムまたはブラウザのバージョン。
`device_brand`	ユーザーが使用しているデバイスのブランド。
`device_manufacturer`	ユーザーが使用しているデバイスの製造元。
`device_model`	ユーザーが使用しているデバイスのモデル。
`carrier`	ユーザーが契約しているキャリア。
`user_properties`	ユーザーに関連付けられたデータを表すキーと値のペアの辞書。各異なる値はAmplitudeダッシュボード上のユーザーセグメントとして表示されます。オブジェクトの深さは`40`レイヤーを超えてはなりません。プロパティ値を配列に保存でき、日付値は文字列値に変換されます。