計装とガバナンスの問題

計装とガバナンスに関する一般的な質問に対する回答：Amplitudeが非表示、ブロック、削除されたイベントをどのように扱うか、内部トラフィックとボットトラフィックをどのようにフィルタリングするか、履歴データをどのように変更するか、日付ピッカーがどのようにオフセットと除外を処理するか。

計装の基本

データを取り込んだ後に値を削除したり変更したりすることはできますか？

Amplitudeがデータを取り込んだ後、データを変更することはできません。Amplitudeのアーキテクチャは、ユーザーとイベントの両方について、時間、日、週、月ごとに事前に集計されたセットを使用しています。 このアプローチは大規模なクエリをサポートしますが、不変なデータが必要です。

ユーザープライバシーAPIを使用して、GDPRやその他のプライバシー法に準拠して、個々のユーザーレベルでデータを削除できます。

AmplitudeはどのようにデバイスIDを設定しますか？

Amplitudeはクライアント側のイベント（AmplitudeのSDKを使用）とサーバー側のイベント（HTTP API）でデバイスIDを設定する方法が異なります。

• SDK
  • Android の場合、Google の広告 ID をデバイス ID として使用することを選択しない限り、デバイス ID はランダムに生成された UUID がデフォルトになります。
  • iOS SDK の場合、利用可能な場合はデバイス ID がデフォルトで IDFV (ベンダー識別子) に設定されます。利用できない場合は、SDK がランダムに生成します。利用可能な場合、代わりに広告識別子（IDFA）を使用することを選択できます。
• サーバー側（HTTP API）
  • サーバー側のイベントの場合、イベント内でデバイスIDを手動で送信する必要があります。デバイス ID が使用できない場合、Amplitude はデバイス ID をランダムに生成されたハッシュバージョンの user_id に設定します。 詳細については、HTTP V2 API を参照してください。
  • サーバー側とクライアント側のイベントに対して同じデバイス ID 設定を維持していない場合、デバイス モデル、言語、およびキャリアが同じであっても、同じユーザーは異なるデバイス ID を持ちます。

2つの異なるイベントに同じ名前を持つことはできますか？

いいえ。各イベント名はプロジェクト全体で一意である必要があります。 Amplitudeは、同じ名前を持つ2つのイベントを同じイベントとして扱います。 プロジェクト内に同じ名前の2つのイベントがあることに気づいた場合、そのうちの1つのイベントの表示名が別のイベントと同じ名前に設定されている可能性があります。Amplitude データでイベントを展開することで、より詳細な情報を確認できます。

配列値をAmplitudeに送信できますか？

はい ただし、Amplitudeは配列プロパティの正確なマッチングをサポートしていません。 contains演算子を使用して、配列内の値をフィルタリングできます。

• SDK
  • ユーザープロパティ配列
  • イベントプロパティ配列
• HTTP API アレイ

プロジェクトでデバイス情報（デバイスタイプやデバイスファミリなど）が「null」を返すのはなぜですか？

Amplitudeは、デバイスまたはブラウザからデバイス情報を解析できない場合、またはデバイスがAmplitudeのシステムにマップされていない場合にNULL値を返します。 新しいデバイス値をマッピングするには、Amplitudeのサポートチームに以下の情報を連絡してください。

• 製造元（例：Samsung）。
• モデル（たとえば、sm-g930u）。
• デバイスファミリ（Samsung Galaxy Phoneなど）。
• デバイスの種類（例：Samsung Galaxy S7）。

セッションが新しいセッションID値を生成するのはなぜですか？

AmplitudeのSDKを通じて取り込まれたイベントは、イベントが同じデバイスから発生した場合、同じセッションを維持します。 セッション ID は、デバイス ID が変更されるたびに変更されます。

JavaScript SDKのデフォルトのセッションタイムアウトは30分です。iOS/Androidの場合、5分です。

定期的な収益サブスクリプションイベントをどのように送信していますか？

サブスクリプション関連の最初の収益イベントの後、Apple または Google はサブスクリプションが有効かどうかを検証する必要があります。 サブスクリプションがアクティブな場合、Amplitudeはそのサブスクリプションの時間間隔でサブスクリプション収益イベントを受信します。

ボットトラフィックのユーザーをフィルタリングするにはどうすればよいですか？

Amplitude SDKはユーザーエージェントを使用して一部のユーザープロパティ（デバイスタイプなど）を入力しますが、ユーザーエージェント自体を収集または保存することはありません。一部のお客様は、ユーザーエージェントをカスタムユーザープロパティとして保存し、その方法でボットユーザーを削除するためのロジックを実装しています。

また、疑わしいボットユーザーのIPアドレスを特定できる場合は、データフィルターを使用してそのIPアドレスからのイベントをブロックできます。詳細については、ボットウェブトラフィックのブロックに関するAmplitudeのヘルプセンター記事を参照してください。

内部ユーザーのブロックとフィルタリング

データをきれいに保つために、Amplitudeは本番プロジェクトと並行して開発プロジェクトを設定し、テストデータを開発プロジェクトにのみ送信することをお勧めします。 本番環境をテストしても、内部データを本番プロジェクトに送信することは可能です。 内部ユーザーイベントは製品のメトリクスを誤って増大させる可能性があるため、正確なレポートを作成するには、これらのイベントをブロックまたはフィルタリングする必要があります。

特定のユーザーをブロックするにはどうすればよいですか？

組織のIPアドレスから発信されたすべての内部イベントデータがAmplitude アナリティクスに収集されないようにブロックできます。 プロジェクトの「データフィルタ」ページを使用してフィルタを設定できます。

指定された IP アドレスからのイベントをブロックするようにフィルタを設定するには、次の手順を実行します。

1. 「データ」から「フィルター」に移動し、「+Create Block Filter」をクリックします。
2. 表示されるフライアウトパネルで、フィルタを適用する環境を選択します。
3. ［Block］ ドロップダウンメニューから ［Events］ を選択します。
4. 他の 2 つのドロップダウン メニューから ［IP Address］ と ［equal］ を選択します。 次に、ブロックするIPアドレスを入力します。
5. *「ブロックデータ」*をクリックします。
6. ブロックするIPアドレスごとに手順4〜6を繰り返します。

このフィルタを設定すると、Amplitudeは、取り込み時にIPアドレスのリストから送信されたすべてのイベントをドロップします。

このフィルターは、AmplitudeのSDK設定を変更してIPアドレスの収集を防いでいる場合には機能しません。フィルタは、収集されたIPアドレスがブロックしたIPと一致するイベントのみをドロップします。

特定のユーザーをフィルタリングするにはどうすればよいですか？

任意のAmplitudeチャートのセグメンテーションモジュールを使用して、内部ユーザーイベントをいつでもセグメント化できます。 ユーザーID、デバイスID、Amplitude ID、IPアドレス、または識別可能なユーザープロパティ（ユーザー名やメールアドレスなど）によってユーザーをセグメント化します。

ユーザーセグメントを保存するにはどうすればよいですか？

ユーザーセグメントを保存してチャートにピン留めすることができるので、毎回フィルターを再作成する必要はありません。保存したセグメントをデフォルトとして設定すると、Amplitudeは「チャートを作成」または「新規作成」ボタンを使用して作成したすべての新しいチャートにそのセグメントを適用します。 適用されたフィルターがチャートに表示されます。

ユーザーリストはどのように管理すればよいですか？

内部ユーザーのリストは時間の経過とともに変化することがあります。また、ユーザーが共通の属性を共有していない場合、このリストを維持するのは手間がかかります。 このような場合、Amplitudeの行動コホート機能を使用し、Amplitude上でブロックするための内部ユーザーのコホートをインポートしてください。

このコホートをグラフに適用するには、ユーザープロパティを適用する場合と同じ方法を使用できます。 内部コホートを除外したユーザーセグメントを作成したら、簡単にアクセスできるようにセグメントを保存してピン留めしてください。

また、プログラムによって行動コホートを更新して、内部ユーザーのコホートを維持することもできます。 詳細については、Behavioral Cohorts API をご覧ください。

関連リソース

• ボットウェブトラフィックをブロック: ボットトラフィックがメトリクスに影響を及ぼさないようにします。
• 実験におけるウィンソリゼーション：実験結果を歪める可能性のある異常値を特定して解決します。

イベントやプロパティを非表示、ブロック、または削除する

イベントやプロパティの非表示、ブロック、削除の違いは、すぐには明らかではありません。非表示およびブロックされたイベントやプロパティは、引き続きプロジェクトの計測制限にカウントされますが、削除されたイベントやプロパティはカウントされません。

非表示のイベントやプロパティとは何ですか？

Amplitudeチャートでユーザーにクエリさせたくないが、データ収集は継続したい場合は、イベントやプロパティを非表示にします。

イベントやプロパティをドロップダウン、パスファインダーの結果、ペルソナチャートから非表示にすることができます。

• ドロップダウンから非表示にすることは、どのAmplitudeチャートでもそのイベントやプロパティをドロップダウンリストから選択できないことを意味します。
• パスファインダーやペルソナの結果からイベントやプロパティを非表示にすると、それらのチャートの計算からそのイベントが除外されます。Amplitudeは引き続きデータを取り込みます。イベントまたはプロパティは非表示化を解除すると再びクエリ可能になります。

イベントやプロパティをブロックすることはどのようなことを意味しますか？

過去データの照会を継続したいが、新しいデータの収集を停止したい場合は、イベントまたはプロパティをブロックします。 ブロック機能は、特定のイベントが原因で月間イベント数制限に達した場合に役立ちます。

イベントまたはプロパティをブロックすると、Amplitudeは取り込みと処理を停止します。ブロック前にAmplitudeが取り込んだブロックされたイベントとプロパティは、引き続きドロップダウンで選択可能であり、グラフで使用できます。 ブロックを作成した後に送信されたデータは、ユーザーストリームやチャート結果には表示されません。

ブロックしてもそのデータをAmplitudeに送信することは停止されないため、成功応答は引き続き受け取ることができます。 Amplitudeは処理段階の前にデータを破棄するため、復元することはできません。

削除されたイベントやプロパティはどうなりますか？

データ構造を整理しておく必要がなくなったイベントやプロパティを削除してください。 不要なイベントやプロパティが多すぎると、プロジェクトの計装制限に達する可能性があります。

ブロックと同様に、Amplitudeは削除されたイベントやプロパティを取り込むことはありません。また、削除後に送信されたデータを復元することはできません。 ブロックされたアイテムとは異なり、削除されたイベントやプロパティはドロップダウンでは表示できません。

削除されたイベントやプロパティを含むグラフは引き続き使用できますが、削除された項目を新しいグラフに含めることはできません。 削除されたイベントをチャートから削除した場合、削除を元に戻さない限り、そのイベントを元に戻すことはできません。削除されたイベントは引き続きチャート結果に表示されるため、削除されたイベントのチャートデータを削除または非表示にするには、イベントを削除する前にドロップフィルタを作成してください。

非表示化、ブロック化、削除の違いは何ですか？

履歴データの変更または削除

Amplitudeアーキテクチャは、ユーザーとイベントについて時間、日、週、月ごとに事前に集計されたセットを使用します。 このアプローチは拡張性が良好ですが、データが不変であるというトレードオフがあります。

Amplitudeがすでに取り込んだイベントを変更するにはどうすればよいですか？

お客様のアカウントがグロースまたはエンタープライズプランを利用している場合は、Amplitudeでのセルフサービスによるデータ削除を参照してください。

その他のアカウントタイプの場合、直接変更はできません。 回避策として：

1. Export API を使用してすべてのプロジェクトデータをエクスポートします。
2. データをクリーンアップします（たとえば、必要な変更を加えます）。
3. バッチ API を使用して、クリーンアップされたデータを新しいプロジェクトにアップロードします。

Identify APIを使用してユーザープロパティを更新しました。チャートにまだ「なし」の値が表示されているのはなぜですか？

Identify API は、将来のイベントのためにユーザープロパティ値を更新するだけです。 Amplitudeがすでに取り込んだデータを変更することはできません。 Amplitudeに別のイベントを送信して、更新されたプロパティ値を適用します。 Amplitudeがユーザープロパティをどのように更新するかについての詳細は、ユーザープロパティとイベントを参照してください。

ユーザーにイベントを誤って送信してしまいました。 この特定のユーザーのこの特定のイベントを削除するにはどうすればよいですか？

それはできません。取り込まれたデータは不変です。 同様の結果を得るには、次の手順を試してください：

1. イベントを削除またはブロックするには：
   • これにより、イベントがすべてのユーザーに対してAmplitudeに入るのを防ぎます。
   • イベントはユーザーのイベントストリームに引き続き表示されますが、クエリには使用できません。
2. 削除またはブロックが機能しない場合は、前述のFAQで説明されている回避策を試してください。

過去のデータをAmplitudeにバックフィルするにはどうすればよいですか？

データバックフィルガイドを参照してください。

日付ピッカーの動作

日付ピッカーは、実行中の分析の時間枠を選択します。 2つの日付の間に収集されたデータ、特定の日付以降のデータ、または過去x日、週、または月のデータを分析することを選択できます。

日付ピッカーは時間をどのように扱うかについてニュアンスがあります。

オフセット

Last を使用すると、クエリは指定された時間枠からのデータと、最新の未完了間隔を返します。

たとえば、日付ピッカーを過去 30 日間に設定した場合、Amplitude は過去 30 日間（丸 1 日単位）のデータと、今日の経過時間のデータを取得します。

未完了日のデータを除外する場合や、遅延バッチ取り込みシステムを使用する場合には、オフセットを使用します。 日付ピッカーで + オフセット をクリックし、オフセットする日数を入力します。

オフセットを削除するには、「Offset by」テキストの近くにある「X」をクリックします。

除外する

[Since]、または [Last x days]、[weeks]、[months] のオプションを使用する場合、現在の日、週、または月を除外することもできます。これは、選択した期間のデータが完全に利用できない場合に役立ちます。

チャートから不完全な時間間隔を除外するには、日付ピッカーで+除外をクリックし、[不完全な時間間隔] オプションを選択します。現在の日付は点線で囲まれて表示されなくなり、Amplitudeはそれを分析から除外します。

この設定を元に戻すには、[不完全な間隔] を選択解除してください。 同じプロセスを使用して、現在の週、現在の月、または現在の四半期を除外または含めることができます。

特定の日を除外する

分析から特定の曜日を除外することができます。 このオプションは、カスタムスケジュールで業務を行う組織に適しています。 たとえば、小売業者は店舗が営業していない日曜日を除外することができ、SaaS企業は週末を省略して平日週の行動に重点を置くことができます。

特定の日を除外すると、チャートのビジュアルと平均値やローリングウィンドウなどのメトリック計算の両方に影響します。

特定の日を除外する場合、サポートされているチャートタイプは次のみです。

• セグメンテーション
• ファネル。
• データテーブル
• リテンション
• セッション。

特定の日を除外することは、次の時間範囲のみをサポートします。

• 最後に
• 開始:

Amplitudeが除外日をどのように処理するか

日数を除外する場合、Amplitude:

• 計算とチャートの視覚化から日数を削除します。
• 平均値の場合、ウィンドウ内の有効な日数に基づいて計算します。たとえば、水曜日を削除した日曜日から土曜日までの範囲（7日間）を調べている場合:
  • 平均以外の時系列分析の場合、データは水曜日を除いた状態で通常通り表示されます。
  • 集計データ分析の場合、データは水曜日の集計をカウントしません。
• 平均化分析（ローリングウィンドウなど）の場合、Amplitudeはドロップ日数を分子または分母でカウントしません。7日のローリングウィンドウがある場合、Amplitudeはデータポイントを0として扱い、ウィンドウ内の有効日数に基づいて平均値を分割します（この例では6日）。
• 毎日または毎時間以外の間隔の分析の場合、Amplitudeはチャートやテーブルからデータを削除しません。 ただし、データの基礎となる日数は削除されたままです。

この方法は、人為的に低い平均値を回避し、チャート上のウィンドウを一貫性のある状態に保ちます。

時刻入力

Since または Between を使用する場合、時刻の入力を有効にすることで範囲をさらに絞り込むことができます。 時刻入力機能を使用すると、開始時刻または終了時刻を入力して、分析をより細かくすることができます。

時間の細分性を有効にするには、日付ピッカーで +Time をクリックします。 時刻の入力を有効にした後、選択した日付範囲に合わせて開始時刻または終了時刻を時、分、秒単位で入力します。

時刻の入力をオフにするには、入力された時刻の近くにある「X」をクリックします。

プリセット

また、日付ピッカーはプリセットもサポートしており、繰り返し分析を効率化し、チーム間で一貫性を確保できます。

プリセットを使用する

プリセットを使用すると、以下のような事前定義された時間範囲にすばやくアクセスできます：

• 過去7日間。
• 先月。
• 年初来。
• カスタム会計期間。

プリセットを選択すると、日付ピッカーは関連する時間範囲を自動的に入力します。

カスタムプリセット

プロダクトの発売、キャンペーン、テスト期間など、繰り返し発生する分析ウィンドウ用のカスタムプリセットを作成できます。プリセットには次のものが含まれます。

• 具体的な開始日/終了日。
• 相対的な時間枠（たとえば、「過去60日間」）。
• オプションの除外（不完全なデータや特定の平日など）。

Amplitudeはプロジェクトレベルでプリセットを定義し、プロジェクト全体で使用できます。 管理者とマネージャーは、プロジェクト設定でこれらのプリセットを作成、編集、管理できます。

デフォルトのプリセット

また、ユーザーは特定のプロジェクトに対して独自のデフォルトプリセットを定義することもできます。 このプリセットは、新しいグラフを作成するときに自動的に適用されます。

新しい組織でメニューを開けない問題

新規ユーザーはなぜ左側のメニューを操作できないのですか？

Amplitudeで新しい組織を作成するとき、すべてのチームメンバーはAmplitudeの設定ページから作業を開始します。 左側のメニューを開くオプションが表示されません。新規ユーザーは設定ページで「立ち往生」しているように見えることがあり、Amplitudeの他のページに移動することができません。

これは、Amplitudeが処理するデータが揃うまでどのグラフにも入力できないためです。 左側のメニューを開くには、まずデータソースを設定し、Amplitudeにデータを送信してください。 チャートにクエリ対象のデータが追加されると、左側のメニューが展開され、Amplitude UIをナビゲートできるようになります。

Firefox の取り込み失敗

FirefoxがAmplitude SDKをブロックするのはなぜですか？

Firefoxでは、標準モードではトラッキング保護機能が自動的に有効になります。この機能を「厳密」に切り替えた場合や、プライベートブラウザウィンドウを使用している場合、Amplitudeはイベントを記録できません。 追跡保護機能は、クロスサイトトラッカーをブロックすることで、ウェブを閲覧する際のユーザーのプライバシーを保護します。

追跡保護とは何か、それが追跡にどのように影響するかについての詳細は、Mozillaのドキュメントを参照してください。

追跡保護はクロスサイトの追跡を防ぐため、Amplitude SDKをブロックします。 Firefoxはネットワーク要求をブロックするため、イベントの取り込みに失敗します。

Firefoxブラウザで追跡保護が有効になっている場合、次のエラーが表示されます：

POST 要求に失敗しました。

取り込みに関する問題を解決するにはどうすればよいですか？

Amplitudeのエンジニアリングチームによると、最善の解決策は、プロキシサーバーを構築し、JS SDKをそのサーバーに向けることです。詳細については、プロキシの作成方法に関するドキュメントを参照してください。