Skip to main content

​
Amplitude

ShanoneのAmplitude連携では、分析クエリ、ユーザー/イベントのタクソノミー管理、コホート、アノテーション、プライバシー/削除リクエストをカバーする62個のツールをエージェントに提供します。

​
はじめに

1

AmplitudeのAPI認証情報を取得する

AmplitudeでプロジェクトのSettings > Projectsを開き、API KeyとSecret Keyをコピーします。
2

Shanoneで接続する

エージェントにAmplitudeで何か作業をしてもらう(例:「過去30日間のリテンション分析を見せて」)か、Shanoneダッシュボードのインテグレーションから両方のキーを事前に登録します。
3

リクエストを再試行する

両方のキーが保存されると、amplitude_*ツールに対するshanone_execute_toolの呼び出しが成功するようになります。
AmplitudeはOAuthではなくAPIキー認証を使用し、ShanoneはAPI KeyとSecret Keyの両方を必要とします — ほとんどのエンドポイントがHTTP Basic認証でこのペアを要求します。

​
利用可能なツール

Shanoneは Amplitude向けに62個のツールを提供しており、以下のカテゴリに分類されています。
amplitude_get_event_types, amplitude_get_user_properties, amplitude_get_event_properties, amplitude_create_event_type, amplitude_update_event_type, amplitude_delete_event_type, amplitude_create_event_property, amplitude_update_event_property, amplitude_delete_event_property, amplitude_create_user_property, amplitude_update_user_property
amplitude_upload_cohort, amplitude_update_cohort_membership, amplitude_request_cohort_download, amplitude_check_cohort_status, amplitude_download_cohort_file, amplitude_get_cohort_usage, amplitude_get_user_mappings, amplitude_map_users, amplitude_list_cohorts, amplitude_get_cohort
amplitude_get_funnel_analysis, amplitude_get_retention_analysis, amplitude_get_realtime_active_users, amplitude_get_user_profile, amplitude_export_events, amplitude_query_dashboard, amplitude_get_events_list, amplitude_get_event_segmentation, amplitude_get_chart_results
amplitude_identify_user, amplitude_identify_group, amplitude_set_group_properties, amplitude_batch_identify, amplitude_get_revenue_ltv, amplitude_alias_users, amplitude_unalias_users
amplitude_send_events, amplitude_batch_upload_events, amplitude_send_attribution_event, amplitude_validate_events
amplitude_delete_user_data, amplitude_get_deletion_requests, amplitude_cancel_deletion_request, amplitude_create_dsar_request, amplitude_get_dsar_status, amplitude_download_dsar_output
amplitude_create_annotation, amplitude_list_annotations, amplitude_get_annotation, amplitude_update_annotation, amplitude_delete_annotation, amplitude_manage_annotation_categories, amplitude_create_release, amplitude_list_releases
amplitude_get_session_length_distribution, amplitude_get_average_session_length, amplitude_get_sessions_per_user, amplitude_get_active_users, amplitude_search_user, amplitude_get_user_activity, amplitude_get_user_composition

​
よくある使い方

リテンションレポート

機能リリースについてリテンション・ファネル分析を取得し、傾向をまとめる

タクソノミーのガバナンス

データ品質向上の取り組みの前に、イベント/プロパティ定義を点検・整理する

コホートの活用

コホートを作成・更新し、他のマーケティングやプロダクトツールで使えるようにエクスポートする

GDPR/CCPA削除リクエスト

ユーザーデータ削除リクエストを申請し、完了まで追跡する

​
トラブルシューティング

Amplitudeでは API KeyとSecret Keyの両方の接続が必要です — ほとんどのエンドポイントは1つのキーだけでは動作しません。Shanoneダッシュボードのインテグレーションで両方の値を確認してください。
amplitude_get_event_typesでイベント名を確認してください — Amplitudeのイベント名は大文字小文字を区別し、実際に取り込まれた名前と完全に一致させる必要があります。
コホートのダウンロードや同期はAmplitude側で非同期に処理されます。amplitude_request_cohort_downloadの即時レスポンスを期待するのではなく、amplitude_check_cohort_statusを定期的にポーリングしてください。