> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kameleoon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ソースとしてのAmplitudeイベントストリーミング

> AmplitudeのイベントをKameleoonに送信し、Kameleoonが実験内の訪問者のためにゴールを作成してコンバージョンを記録できるようにします。

チームがすでにAmplitudeでユーザーのアクションを追跡しているなら、そのトラッキングプランをKameleoonで作り直すには開発者の時間がかかります。Amplitudeイベントストリーミング連携は、Amplitudeのイベントを Kameleoon に送信します。Kameleoonは、イベントごとにそのイベント名を付けたカスタムゴールを作成し、一致する訪問者のコンバージョンを記録します。ゴールをトリガーするためのコードを書く必要はありませんが、各イベントが訪問者と一致するように、Kameleoonの訪問者コードをAmplitudeに渡す必要があります。

## 連携がワークフローにどのように組み込まれるか

* **AmplitudeをKameleoonに接続する：** REST APIキーを生成し、サイトコードを確認して、イベントをKameleoonに送信する[Amplitudeで同期を作成](https://amplitude.com/docs/data/destination-catalog/kameleoon)します。
* **AmplitudeのユーザーをKameleoonの訪問者と照合する：** 各イベントとともに、Kameleoonの訪問者コードをAmplitudeに渡します。
* **Amplitudeイベントから作成されたゴールを管理する：** Kameleoonが Amplitudeイベントから作成するゴールを見つけて、名前を変更します。

## 始める前に

* **有料プラン：** 連携に必要な有料のKameleoonプランです。
* **REST APIキー：** Amplitudeがプロジェクトにイベントを送信できるようにするキーです。クライアントIDとクライアントシークレットから生成します。
* **サイトコード：** イベントを受信するKameleoonプロジェクトの識別子です。[プロジェクトダッシュボードで確認する](https://docs.kameleoon.com/ja/user-manual/project-management/manage-your-projects.md#how-do-i-find-my-sitecode)ことができます。
* **Amplitudeプロジェクト：** イベントを送信する各Amplitudeプロジェクトには、それぞれ有効化された送信先が必要です。

## AmplitudeをKameleoonに接続する

Amplitudeは、Amplitude側で作成する送信先を通じてKameleoonにイベントを送信します。送信先には、Kameleoonプロジェクトを識別するREST APIキーとサイトコードが必要です。Amplitudeは、イベントごとにすべてのユーザー、イベント、グループのプロパティを送信します。Kameleoonは、1イベントあたり最大1 MBのイベントデータを受け付けます。

### REST APIキーを生成する

クライアントIDとクライアントシークレットからREST APIキーを生成します。

1. [API認証情報](https://docs.kameleoon.com/ja/user-manual/account-and-team-management/users-and-teams/api-credentials.md)ページで `client_id` と `client_secret` をコピーします。クライアントシークレットがない場合は、そのページで **Generate a new Client-Secret key** をクリックします。
2. 以下のURLをブラウザで開き、`CLIENT_ID` と `CLIENT_SECRET` をそれぞれの値に置き換えます。

   ```
   https://customers.kameleoon.com/kameleoon/amplitude/getapikey?id=CLIENT_ID&secret=CLIENT_SECRET
   ```

Amplitudeの送信先を設定できるよう、キーを手元に用意しておきます。

### サイトコードを取得する

イベントを受信するKameleoonプロジェクトのサイトコードを確認します。プロジェクトダッシュボードで確認できます。場所については、[サイトコードの確認方法](https://docs.kameleoon.com/ja/user-manual/project-management/manage-your-projects.md#how-do-i-find-my-sitecode)を参照してください。

### Amplitudeの送信先を設定する

送信先は、Kameleoonアプリではなく、Amplitudeで設定します。[AmplitudeのKameleoon送信先ガイド](https://amplitude.com/docs/data/destination-catalog/kameleoon)に従って、同期を作成します。AmplitudeがKameleoonのREST APIキーとサイトコードを求めたら、前の手順で用意した値を使用します。

**Admin** > **Integrations** の下にある **Amplitude** カードは、Destination タグが付いた別の連携です。Kameleoonのテスト結果をAmplitudeに送信する連携であり、イベントストリーミングの設定はここでは行いません。

## AmplitudeのユーザーをKameleoonの訪問者と照合する

KameleoonがAmplitudeのイベントを訪問者に関連付けられるのは、両方のツールが同じ値でその訪問者を識別している場合に限られます。Kameleoonの実験またはパーソナライゼーションを使用しているプロジェクトでは、Kameleoonは訪問者ごとにCookieを設定し、匿名の一意の識別子であるKameleoonの訪問者コードを保存します。次のいずれかのオプションを選択して、そのコードをAmplitudeに渡します。

* **オプション 1：** 訪問者コードをAmplitudeイベントの `userId` として渡します。すると、KameleoonはAmplitudeからのすべてのイベントデータを正しい訪問者に関連付けます。
* **オプション 2：** Amplitudeイベントに `kameleoon_visitorcode` ユーザープロパティを設定します。値には訪問者コードを指定します。

Feature Experimentationのプロジェクトを使用している場合は、生成された訪問者コードの代わりに、KameleoonのSDKで独自のIDを設定します。SDKで独自のIDを設定する方法は、[Feature Experimentation の概要](https://docs.kameleoon.com/ja/developer-docs/feature-experimentation/get-started/overview.md)を参照してください。

### 訪問者コードをAmplitudeのユーザーIDとして使用する

Amplitude Browser SDKを使用して、Amplitudeのユーザー IDをKameleoonの訪問者コードに設定します。

```javascript theme={null}
amplitude.setUserId(Kameleoon.API.Visitor.code);
```

### 訪問者コードをユーザープロパティに保存する

以降のAmplitudeの呼び出しで、`kameleoon_visitorcode` ユーザープロパティを訪問者コードに設定します。

```javascript theme={null}
const visitorcode = Kameleoon.API.Visitor.code;

const identifyEvent = new amplitude.Identify();
identifyEvent.set('kameleoon_visitorcode', visitorcode);

amplitude.identify(identifyEvent);
```

## Amplitudeイベントから作成されたゴールを管理する

Kameleoonは、一致するゴールがないAmplitudeイベントを受信すると、`Amplitude - <event name>` という名前の[カスタムゴール](https://docs.kameleoon.com/ja/user-manual/assets/goals/create-a-goal.md#custom-goal)を作成します。Kameleoonは作成した各ゴールに `amplitude` タグを付けます。Kameleoonが作成するゴールは、任意の10秒間に最大50個、任意の60分間に最大1,000個です。

### Amplitudeイベントから作成されたゴールを見つける

`amplitude` タグでゴールをフィルタリングすると、Amplitudeイベントによって作成されたゴールを一覧表示できます。

1. **Goals** ダッシュボードを開きます。
2. サイドパネルで、`amplitude` タグでゴールをフィルタリングします。

### 自動作成されたゴールの名前を変更する

Kameleoonは、Amplitudeイベントのゴールを名前で見つけます。ゴールの名前を変更すると、Kameleoonはそのゴールを見つけられなくなるため、次のイベントではAmplitudeイベント名に基づく新しいゴールが作成されます。名前を変更する前に記録されたコンバージョンは、以前のゴールに残ります。

コンバージョンを1つのゴールにまとめるには、Amplitudeイベントの名前を新しいゴール名に一致させます。Amplitudeイベントの名前を変更した場合は、ゴールの名前も新しいイベント名に合わせて変更します。

### ゴールを自動的にコンバージョンする

Amplitudeが関連するイベントを送信すると、Kameleoonはゴールをコンバージョンします。Amplitudeイベントの名前が、Kameleoonアカウント内の既存のゴールの名前と完全に一致する場合、Kameleoonは、そのゴールをKameleoonが作成したかどうかに関係なく、各コンバージョンをそのゴールに関連付けます。ゴールのコンバージョンのために、Activation APIやSDKを呼び出す必要はありません。ゴールをトリガーするために、フロントエンドやバックエンドのコードを追加する必要もありません。
