イベント取り込み連携の作成

イベント取り込み連携を構築することで、プラットフォームからのイベントを受け入れるようにAmplitude連携ポータルが設定され、その設定がソースタイルとしてパッケージ化されて、Amplitudeのお客様が有効化できるようになります。プラットフォームがイベントをデータソースとしてAmplitudeに送信する場合、イベント取り込み連携を使用してください。Amplitudeがイベントをプラットフォームに転送できるようにしたい場合は、代わりにイベントストリーミング連携を構築してください。このガイドでは、連携を構築する方法や、Amplitudeにイベントを送信する方法については説明していません。Amplitudeにイベントを送信する方法については、HTTP v2 APIドキュメントを参照してください。

1. 設定 > 開発者ポータルに移動します。
2. **[接続情報の追加] **をクリックします。
3. 接続情報を入力します。
   • 表示名：連携の表示名です。この名前が、連携カタログと連携タイルに表示されます。
   • カテゴリ： カテゴリを選択してください。 連携カタログはフィルタにこのカテゴリを使用します。
   • 概要：お客様のプロダクトの簡単な概要を説明します。
   • 詳細な説明：連携の詳細な説明です。一般的なユースケースを含め、ユーザーが連携を使用すべき理由を理解できるようにします。
   • 連携ロゴ：連携ロゴをPNG形式でアップロードします。

連携のセットアップ

Amplitudeが連携を検証したあと、Amplitudeのソースページに表示される連携タイルを設定します。

このページには次の2つのセクションがあります。

左パネル: 左側の「設定」セクションでは、データソースのセットアップ手順を作成し、連携タイルを設定できます。

右パネル：_データソース設定ページをプレビュー_セクションでは、ユーザーから見たセットアップ手順ビューを確認できます。

1. 連携ポータルページ（* 設定 > 開発者ポータル*）から、新しいソースを追加をクリックします。
2. [接続情報] セクションは、表示名を制御します。
3. サブタイトルを入力します。 これは、ユーザーが連携を設定するときに、タイトルの下に表示されます。

4. 必要に応じて設定手順を追加できますが、5～8ステップ以内を目指してください。ユーザーが理解するのに役立つ画像を含めることもできます。プロジェクトAPIキーを表示をマークすると、ユーザーに代わって関連するプロジェクトAPIが自動的に取得されます。Amplitudeのすべてのソースと宛先は、組織レベルではなくプロジェクトレベルで設定します。

5. 「その他のリソース」で、ドキュメントへのリンクを追加します。 例えば、Refer to the Amplitude [documentation](/docs/get-started) for more details and instructions.のようになります。
6. 完了したら、「次へ」をクリックして「テスト」タブに移動します。

連携をテストして提出する

ソース情報を設定したら、テストしてレビュー用に送信できます。

1. テストソースタブから、連携をテストするAmplitudeプロジェクトを選択します。
2. このソース連携の割り当て済みパートナーIDの値をコピーします。イベントをAmplitudeに送信する際には、この値をpartner_idパラメータに含める必要があります。Amplitudeは、パートナーからのイベントを追跡し、連携ユーザー数を検証するためにこの情報を必要としています。
3. システムからテストイベントを送信します。

{
  "api_key": "2a0d30356cbb278eee1a69b2bbe81c37",
  "events": [
    {
      "user_id": "test@example.com",
      "partner_id": "integration_name",
      "event_type": "Product Viewed",
      "time": 1663940508564,
      "event_properties": {
        "message_type": "push",
        "message_title": "Sample Message title",
        "message_id": "68b32868-b6ab-4511-b552-cf668a1c0e59",
        "message_contents": "Sample message content"
      }
    }
  ]
}

4. Amplitudeがイベントを検証するのを待ちます。

テストが完了したら、[送信] をクリックして連携をAmplitudeチームに送信してください。審査プロセスには約1週間かかります。 Amplitudeが連携を承認すると、Amplitudeからメールで通知が届き、Amplitudeのソースセクションに連携タイルが表示されます。