変換でデータを修正する

変換は、クエリ時にイベントデータを書き換えることで、コードに触れることなく計測ミスを修正します。 これらのルールはすべての履歴データに遡って適用されるため、1 つのルールで作成前と作成後の両方で影響を受けたイベントを修正できます。 一般的な修正には、重複イベントのマージ、プロパティ名の統合、プロパティ値の名前変更、UI からの値の非表示化などがあります。

過去および将来のイベントにわたってデータを遡及的に修正する必要がある場合に、計装を再導入することなく変換を使用してください。オリジナルをクエリ可能なままにしておきながら、既存のイベントを新しい分析イベントにグループ化したい場合は、代わりにカスタムイベントを使用してください。

**「変換を表示」**トグルをオンONに設定した場合にのみ、プロジェクトのmainブランチで変換を作成できます。また、Amplitudeのデフォルトユーザープロパティを変換することはできません。

イベント、イベントプロパティ、およびユーザープロパティをマージする

多くのAmplitudeユーザーは、不要なイベントや重複したイベント、イベントプロパティ、ユーザープロパティをマージする必要があります。 変換により、このプロセスが容易になります。

イベントをマージする

この変換を使用すると、イベントをマージできます。2つ以上のイベントを追跡している場合に、代わりに1つのイベントとして追跡したい場合に使用します。たとえば、イベント comment_reply_like と comment_share を統合して 1 つのイベント comment にすることができます。

イベントをマージする場合、2 つの元のイベントをマージした後に区別するのに役立つプロパティを追加することもできます。 この変換は、類似した構文を持つ 2 つのイベントにデータをログに記録する場合に役立ちますが、代わりにこの情報を異なるプロパティ値を持つ 1 つのイベントとして記録できます。 たとえば、イベント comment と comment_share を変換して 1 つのイベント comment_reply_like にすることができます。そのイベcommentントには、値 reply likeと を持つ新しいイベcomment typeントプロパティが作成されますshare。

イベントをマージするには、次の手順に従ってください。

1. Amplitudeデータで、[イベント] に移動します。

2. 一緒にマージしたいイベントを見つけ、その名前の横にあるチェックボックスをクリックします。

3. イベントを選択すると、イベントリストの上のメニューバーに [変換] オプションが表示されます。 [変換] をクリックします。

4. 選択したイベントを1つのイベントにマージするのか、または追加の識別プロパティを持つ1つのイベントにマージするのかを選択します。次に、次へをクリックします。

5. 「イベントの変換とマージ」モーダルのドロップダウンを使用して、選択したイベントを新しいイベントにマージするか、または既存の別のイベントにマージするかどうかをAmplitudeデータに伝えます。新しいイベントにマージする場合は、ここにイベントの名前を付けます。次に、「プレビュー」をクリックします。

6. ステップ 5 で、マージされたイベントに特別な識別プロパティを追加しない場合は、ステップ 9 に進みます。

それ以外の場合は、［プロパティを選択］ドロップダウンから差別化要因として使用するイベントプロパティを選択します。次に、次へをクリックします。

7. 次に、選択したイベントを、選択したプロパティの新しい値にマッピングします。 ［プロパティ値...］フィールドに新しい値を入力し、［プレビュー］をクリックします。
8. 変更内容を確認し、［マージ］をクリックして変換を完了します。

イベントプロパティまたはユーザープロパティをマージする

この変換により、イベントまたはユーザーのいずれかのプロパティをマージできます。 同じ情報を追跡するが、異なる命名構文を使用する2つのプロパティがある場合にこれを使用します。

たとえば、ある場合にはイベントプロパティを TITLE と呼び、他の場合には title と呼ぶと仮定します。ただし、これらのプロパティはすべてのイベントで同じことを表しています。データをクリーンアップするには、title と TITLEをTitle に変換して、データを結合します。

同様に、ユーザープロパティはすべてのユーザーに対して同じものを表している場合でも、ある場合には NAMEと呼び、別の場合には nameと呼ぶことがあります。name と NameをNAME に変換することで、混乱の可能性が解消されます。

イベントプロパティを他のイベントプロパティとだけマージでき、ユーザープロパティを他のユーザープロパティとだけマージできます。

イベントプロパティまたはユーザープロパティをマージするには、次の手順を実行します。

1. Amplitude Dataで、*[プロパティ] に移動し、マージしたいプロパティのタイプに応じて、[イベント] または [ユーザー] *タブをクリックします。
2. 一緒にマージするプロパティを見つけ、その名前の横にあるチェックボックスをクリックします。 イベントプロパティを選択すると、[変換] オプションがメニューに表示されます。
3. 「変換」ドロップダウンから、「プロパティをマージ」を選択します。
4. [プロパティをマージ] モーダルが表示されます。 新しいイベントプロパティ名を入力するか、選択したイベントプロパティをマージするイベントプロパティの名前を入力します。[次へ] をクリックします。
5. 変更内容を確認し、［マージ］をクリックして変換を完了します。

プロパティ値の名前を変更する

この変換を使用すると、イベントとユーザープロパティ値を再割り当てることができます。プロパティにスペルミスやドロップダウンに意味のない値が含まれている場合にこの変換を使用します。 これにより、UI からそれらを非表示にしたり、別の値に変換したりできます。

たとえば、true と TRUE の値を再割り当てできますTrue。

プロパティ値の名前を変更するには、次の手順に従います。

1. 名前を変更するプロパティのタイプに応じて、［プロパティ］に移動し、［イベント］タブまたは［ユーザー］タブを開きます。
2. 名前を変更するプロパティ値を持つプロパティを見つけ、その名前の横にあるチェックボックスをクリックします。
3. 「変換」ドロップダウンから、「値の名前を変更」を選択します。
4. 「名前変更された値の編集」モーダルが表示されます。現在のプロパティ値の下で、**値を選択...**をクリックします。
5. リストから名前を変更する値を選択し、［Apply］ をクリックします。
6. 「派生値」の下で「値を選択...」**をクリックして新しい値を設定します。
7. ［New Value］ をクリックし、表示されるフィールドに新しい値を入力します。
8. 名前を変更するすべての値について、手順 4〜7 を繰り返します。次に、次へをクリックします。
9. 確認画面が表示されます。 ［名前を変更］をクリックします。

プロパティ値を非表示にする

プロパティ値の表示ステータスを非表示に設定することは、追跡したいが、どのグラフでもダッシュボードに表示したくない値の場合に役立ちます。 プロパティ値を非表示にしてもその生データは削除されません。また、その値はユーザーの個々のイベントストリームに引き続き表示されます。

プロパティ値を非表示にするには、次の手順に従います。

1. 非表示にしたい値を持つイベントまたはユーザープロパティを検索します。 名前の横にあるボックスにチェックを入れてください。
2. ［変換］ドロップダウンから［非表示］を選択します。
3. Amplitudeから非表示にしたい値を選択し、[次へ] をクリックします。
4. 確認画面が表示されます。 ［非表示］をクリックします。

変換の編集と削除

変換は永続的なものではありません。 これらは元に戻すことができ、いつでも編集または削除できます。

変換を編集するには、次の手順に従ってください。

1. 関心のある変換済みイベント、イベントプロパティ、またはユーザープロパティを検索します。
2. 変換の名前をクリックすると、詳細パネルが開きます。 [変換された値] をクリックすると、[変換] タブが表示されます。
3. 編集したい変換の横にある [編集] をクリックし、必要な変更を加えてから保存します。

変換を削除するには、次の手順に従ってください。

1. 関心のある変換済みイベント、イベントプロパティ、またはユーザープロパティを検索します。
2. 削除する変換の横にあるチェックボックスをクリックします。
3. **[変換を元に戻す]**をクリックします。
4. 確認画面が表示されます。 **[変換を元に戻す]**をクリックします。

変換を削除しても元のイベントは削除されません。

変換されたプロパティをターゲット設定に使用する

Amplitudeは、変換されたユーザープロパティを、実験、機能フラグ、ガイドとサーベイのターゲティング基準として使用できるようにします。評価時にAmplitudeはターゲティングルールを評価する前にプロジェクトの変換設定を適用するため、アナリティクスデータをクリーンアップするのと同じマージルールと名前変更ルールがターゲティングとエクスポージャーにも適用されます。

SDK やバックエンドに変換ロジックを再実装する必要はありません。 Amplitude Dataでルールを一度定義すると、そのルールはアナリティクス、実験、機能フラグ、ガイドとサーベイ全体で一貫して適用されます。

詳細については、「リモート評価」および「セットアップとターゲット設定」を参照してください。

変換済みイベントとカスタムイベント

よくある質問

イベント A とイベント B を統合してイベント C を作成しました。イベント A に関するクエリを送信していた保存済みのチャートはどうなりますか？

イベント A に対する保存済みのチャートのクエリは、マージ後も引き続き実行されます。 チャートはイベント A からイベント C に自動的に切り替わることはありません。マージ後に作成されたチャートの場合、イベント A もイベント B もチャートのドロップダウンに表示されず、イベント C のみが表示されます。

イベント A とイベント B を統合してイベント C を作成しました。イベント C を使用するように既存の保存済みチャートを一括更新するにはどうすればよいですか?

Amplitudeではチャートを一括更新することはできません。古いイベント（この例ではイベント A と B）をまだ使用しているすべてのチャートをダッシュボードに追加してみてください。検索と置換を使用してこれらのイベントをイベント C と交換し、[チャートに保存] > [既存のチャートを更新] をクリックします。

イベント プロパティ A とイベント プロパティ B を結合してイベント プロパティ C を作成しました。イベント プロパティ A とイベント プロパティ B に対してクエリを行っていた保存済みのチャートはどうなりますか？

保存されたチャートは、変換後に自動的に別のイベントプロパティに切り替わることはありません。各チャートは、チャートを編集するまで、そのチャートと一緒に保存したプロパティにクエリを送信し続けます。

変換後、チャートのドロップダウンには、マージされたプロパティまたはターゲットのプロパティのみが表示されます。古い変換されていないプロパティ名をそのまま照会する新しいグラフを作成することはできません。

既存のグラフをどのように更新するかは、プロパティをどのように結合したかによって異なります。

• **新しいイベントプロパティ C にマージされました。**イベントプロパティ A または B をまだ照会している保存済みのすべてのチャートを更新します。たとえば、各チャートを編集し、チャートコントロールでイベントプロパティ C を選択します。これらのチャートをダッシュボードに追加したり、検索と置換を使用して古いプロパティをプロパティ C に置き換えたり、[チャートに保存] > [既存のチャートを更新] をクリックしたりすることもできます。
• 既存のイベント プロパティにマージした場合（たとえば、新しい名前を作成する代わりに、A と B の両方をプロパティ A にマップした場合など）。 削除したソースプロパティにまだクエリが残っている保存済みのチャートを更新します。すでにターゲットプロパティにクエリを送信しているグラフは、マージされたプロパティをすでに使用しているため、変更する必要はありません。

イベント C のマージを解除したいのですが、このマージされたイベントを使用しているチャートはどうなりますか？

結果は、イベント C を最初にどのように作成したかによって異なります。

• イベント A とイベント B をイベント C にマージした場合、更新後にチャートのユーザー数とイベント数の合計はゼロになります。
• イベント A とイベント C をイベント C にマージした場合、更新後にチャートはソースイベント C を照会します。

既存の変換から新しい変換を作成することはできますか？

Amplitudeは変換の変換をサポートしていません。この機能をリクエストするには、機能リクエストを送信してください。

イベントCはソースイベントAとBで構成される統合イベントです。イベントAとイベントBを別々に表示し、その後、変換の日付からイベントCを開始することはできますか。

変換は遡及的に適用されるため、これは不可能です。

プロパティの結合で優先される値はどれですか？

この例を使用します。イベント A の 1 つのインスタンスに対してはイベント プロパティ event_property=false を送信し、イベント A の別のインスタンスに対してはイベント プロパティ event prop=true を送信します。 次に、両方のイベントプロパティを EVENT_PROPERTY にマージします。

イベント A に対してクエリを実行し、EVENT_PROPERTY でグループ化すると、このユーザーは 2 回表示されます。false の値に対して 1 つのデータポイントと、true に対して 1 つのデータポイントが表示されます。