Google Vertex AI 検索

AmplitudeデータのGoogle Vertex AI連携は、AmplitudeイベントデータをGoogle Cloud Vertex AI Search for Commerceにストリーミングします。

考慮事項

• AmplitudeはイベントデータをVertex AIのuserEvents.writeエンドポイントに投稿し、FreeMarkerテンプレートを使用して各Amplitudeイベントを必要なVertex AIスキーマにマッピングします。
• 送信先を有効にする前に、マッピングがGoogle Cloud User Eventsスキーマと一致することを確認してください。

連携を設定する

前提条件

開始する前に、適切なアクセス権を持つ Google IAM サービスアカウントを作成してください。

Amplitudeは連携をセットアップするためにVertex AIから4つのことを必要としています：

• Google サービスアカウント JSON：Amplitude Vertex AI 連携用の専用サービスアカウントを作成します。この手順に関するヘルプについては、Googleのドキュメントを参照してください。
• GCP プロジェクト ID: リテールカタログが存在する GCP プロジェクトの名前です。
• リテールロケーション：地域のカタログがない場合はglobalを使用します。
• リテールカタログID：追加のカタログを作成していない場合はdefault_catalogを使用します。

Google Vertex AIのセットアップ

Vertex AI userEvents.writeエンドポイントを有効にし、サービスアカウントを作成した後、サービスアカウント用のキーを作成します。Amplitudeのセットアップを完了するには、このキーが必要です。 この手順に関するヘルプについては、Googleのドキュメントを参照してください。

Amplitude設定

1. Amplitudeデータで、カタログ > 送信先に移動します。
2. [イベントストリーミング] セクションで、[Google Vertex AI] をクリックします。
3. 同期名を入力し、[同期を作成] をクリックします。
4. 編集をクリックし、サービスアカウントのJSONをアップロードします。
5. 必要に応じて、GCPプロジェクトID、リテールロケーション、リテールカタログIDを更新します。
6. Apache FreeMarker テンプレートを使用してペイロードをカスタマイズします。 FreeMarker テンプレート言語のセクションを参照してください。
7. イベントを送信フィルタを使用して、送信するイベントを選択します。
8. 完了したら、送信先を有効にし、**[保存]**をクリックします。

FreeMarker テンプレート言語

AmplitudeはApache FreeMarkerテンプレートを使用して、AmplitudeイベントをVertex AIユーザーイベントスキーマに一致するJSONに変換します。 input変数は、Amplitudeのエクスポート形式における各イベントを参照します。

日付時刻の書式設定やオプションフィールドなど、高度なFreeMarkerパターンについては、Webhooksストリーミングの送信先を参照してください。

テンプレートの例

{
      <#if input.user_id??>
      "visitorId" : "${input.user_id}",
      </#if>
      "eventType" : "${input.event_type}",
      "eventTime" : "${input.event_time}",
      "productDetails" : [{
            "product" : {
                  "id" : "${input.event_properties.product_id!}"
            }
      }]
}

このテンプレートを使用すると、次のJSONペイロードがVertex AI userEvents.writeエンドポイントに送信されます。

{
  "visitorId": "some user id",
  "eventType": "detail-page-view",
  "eventTime": "2022-10-24T20:07:32.123Z",
  "productDetails": [
    {
      "product": {
        "id": "product-123"
      }
    }
  ]
}

フィールド名と入れ子になったオブジェクトを調整して、送信するイベントの種類とプロパティに合わせます。Amplitude event_propertiesとuser_propertiesをカタログに必要なVertex AIフィールドにマップします。