永続的なプロパティを検証する

永続化されたプロパティは、クエリ時に前のソースイベントから後のターゲットイベントにプロパティ値を転送します。永続化されたプロパティを設定すると、そのプロパティはすぐにターゲットイベントの強化を開始します。このガイドでは、独自のライブデータを使用して、それらが機能していることを確認する方法について説明します。

このガイドで取り上げるパターン：

プロパティを起動させるイベント→分析したいイベント

たとえば、「閲覧済みアイテム」イベントが発生し、brandそのブランドが「購入完了」に引き継がれることを確認したい場合などです。または、「検索実行済み」イベントが発生し、「登録」時にsearch_termそのデータが必要な場合もあります。全体を通して、独自のイベントやプロパティを置き換えます。

検証プロセスは次のとおりです。

プロパティがそれを運ぶはずのイベントで発火していることを確認してください。
適切なユーザーが対象範囲内にあることを確認します。
データテーブル内の持続性を検証します。

始める前に

チェックを実行する前に、「**データ」>「プロパティ」**で永続化プロパティを作成済みであることを確認し、次のことを書き留めておいてください。

引き継ぎたいプロパティを起動させるイベントです。
そのイベントでプロパティが表示される際のプロパティ名。
分析したいイベントです。これは、あなたが永続化された値で強化したい対象です。

また、選択した割り当て方法（オリジナル（最初のタッチ）または最新（最後のタッチ））にも注意してください。この割り当てにより、ユーザーがターゲットに到達する前にソースイベントを複数回発行した場合に伝送される値が決まります。

ステップ 1: プロパティを保持するイベントでプロパティが発火していることを確認する

値が永続化されているかどうかを確認する前に、まずプロパティが実際にソースイベントに到着したことを確認してください。ターゲットイベントのレートが高い(none)場合、多くはここが原因です。

ユーザープロファイルを確認する

[ユーザーとグループ] > [ユーザープロファイル] に移動します。
特定のユーザーを対象としている場合は、検索バーを使用して名前、メールアドレス、またはユーザーIDでフィルタリングできます。
［Add Filter］をクリックし、［Performed event］を選択します。ソースイベントを選択します。これにより、リストは、それを少なくとも 1 回実行したユーザーに絞り込まれます。
結果から任意のユーザーをクリックします。イベントのタイムラインで、ソースイベントのインスタンスを見つけて展開します。永続化しようとしているプロパティがその値とともにリストされていることがわかります。

確認事項:

このプロパティは、ほとんどのユーザーにとってソースイベントにNULL以外の値で表示されます。時々NULLが発生することは正常です。一部のセッションは、そのコードパスに到達しない可能性があります。 30%を超えるヌルレートは、永続的なプロパティが機能する前に修正が必要な計装ギャップを示しています。

ソースは持っているがターゲットはまだ持っていないユーザーに絞り込む

診断には、ソースイベントを発行したが、同じ期間にターゲットイベントを発行していないユーザーを分離することが役立ちます。これらのユーザーを使用すると、完全なジャーニーのような複雑さがなくても、ソースプロパティを単独で検査できます。

フィルタを追加します。Performed event = your source event
2 つ目のフィルターを追加します。Did not perform = your target event
これらのユーザーのタイムラインを参照してください。すべてのソースイベントは、null以外の値を持つプロパティを保持する必要があります。このグループは、アップストリームデータが正常であることを示す最もクリーンな信号です。

ソースプロパティが確実に到着していることが確認できたら、検証プロセスに進みます。

ステップ2: 適切なユーザーが対象内にあることの確認

両方のイベントを発行したユーザーを確認してください。これらは、ソースからターゲットへ永続化された値を伝送するユーザーであり、データテーブルに表示されるユーザー層です。

ユーザープロファイルで、フィルタを追加します。Performed event = your source event
2 つ目のフィルターを追加します。Performed event = your target event
ユーザー数を記録してください。これは、次に作成するデータテーブルに表示されると予想されるユーザーグループです。
ユーザー数名をクリックしてください。各タイムラインで、ソースイベントとその後のターゲットイベントを見つけます。ソースイベントにプロパティが含まれていることを確認し、イベントの順序が割り当て方法で期待されるものと一致していることを確認してください。

割り当て方法は方向性に影響します。

**「Original（first touch）」は、ユーザーに対してこれまでに記録された最初のAmplitude値をロックします。**有効期限内にターゲットイベントの後にソースイベントが起動された場合でも、その値を帰属させることができます。

Most Recent は厳密に順方向で動作し、クエリ時刻より前に記録された最新の値を使用します。タイムラインを確認する際は、適切な方法を維持してください。オリジナル の場合、時系列的に最も古いソースイベントを見つけます。 **「最も最近」**の場合、ターゲットに最も近いものを検索します。

ステップ 3: データテーブル内の持続性の検証

データテーブルチャートは、永続値の分布を大規模に表示できるため、最も強力な検証ツールです。また、任意のセルの背後にあるユーザーをドリルダウンしてループを閉じることができます。

テーブルを作成する

*「作成」＞「データテーブル」*に移動します。
メトリックイベントをターゲットイベントに設定します（たとえば、「購入完了」）。イベントの合計をメトリックとして使用します。
「グループ化基準」フィールドに、永続化されたプロパティを追加します。ドロップダウンに標準イベントプロパティと一緒に表示されます。*「データ」>「プロパティ」*でそれに指定した名前を見つけます。
日付範囲を過去7日間または両方のイベントが発生したことがわかっている任意の期間に設定してください。

結果を読む

テーブルがロードされた後、永続プロパティのそれぞれの異なる値に対応する行を検索します。値はソースイベントからターゲットに転送されます。正常な設定では、ターゲットイベントボリュームのほとんどが名前付き値に起因し、小さな(none)行で表示されます。

表示されるもの	これが意味すること	何をすべきか
名前付き値はボリュームとともに表示され、`(none)`小さな割合を占めます。	永続化が機能しています。プロパティは順調に引き継がれています。	設定は正しいです。必要に応じて、割り当て方法や有効期限を調整してください。
`(none)` テーブルを支配する	多くのターゲットイベントには永続的な値がありません。ソースイベントがプロパティを確実に起動していないか、イベントの順序が使用している割り当て方法と一致していない可能性があります。	ステップ 1 のステップに戻り、ソースイベント計測を監査します。両方のイベントが有効期限内に発生することを確認してください。「最新」の場合、ソースはターゲットの前に来る必要があります。「オリジナル」の場合、順序に関係なく最初の発生が使用されます。
永続化されたプロパティはグループ化基準に表示されません	プロパティ定義がまだ保存されていないか、別のイベントをターゲットとしている可能性があります。	「データ」>「プロパティ」に移動し、永続化されたプロパティを開き、ソースイベントとプロパティ名が正しいことを確認します。

テーブルからユーザーをドリルダウンします

データテーブルの任意のセルをクリックすると、その数値の内訳であるユーザーのリストが開きます。これは、集合的な全体像と実際の個々のジャーニーとの間のループを閉じるための最も直接的な方法です。

セル内のカウントをクリックします。たとえば、特定の永続値に関連付けられたターゲットイベントの数です。
表示されるパネルで、をクリックしてコホートを作成します。これらのユーザーを、[正しいユーザーが対象範囲内にあることを確認する] ステップで特定したユーザーと照合します。これらはほぼ重複しているはずです。
これらのユーザーのいずれかをクリックして、そのユーザーのイベントタイムラインを開きます。ターゲットイベントを見つけ、そのイベントが永続プロパティを期待値で表示していることを確認します。次に、ソースイベントをトレースして、値が一致することを確認します。
*（オプション）*割り当て方法を並べて比較します。異なる割り当て方法 (オリジナルと最新) を使用して 2 つの永続プロパティを設定した場合、両方をグループ化基準として同じテーブルに追加してください。値が一致する行は、単一ソースセッションを表します。行が異なる場所では、複数のソースのジャーニーが明らかになります。どちらの値も正しいですが、単に異なる質問に答えているだけです。

ループは次の場合に閉じられます：

このユーザーがフィルタに表示されます（両方のイベントを実行しました）。
これらはデータテーブル内で (none) ではなく、名前付きの持続値の下に表示されます。
これらのイベントのタイムラインには、同じ有効期限内に発生したソースとターゲットのイベントが表示され、持続性プロパティの値は、使用している割り当て方法で想定される値と一致します。

アイテムレベルのアトリビューションを使用してプロパティを確認する

永続化されたプロパティがアイテムレベルの属性を使用している場合、検証ではユーザーやセッションではなくアイテム識別子 (product.item_idなど) ごとにイベントがグループ化されます。カート内の各アイテムは異なる永続値を持つことができるため、チェックはアイテムごとに実行されます。

各項目について、次のことを確認してください。

リンクイベントからの最初のタッチと最後のタッチの候補値。
プロパティの割り当て方法に基づいて、Amplitudeが各カートイベントに対して保持する値。
永続化された値が期待値と一致するかどうか。不一致は、ソースイベントまたはリンクイベントにおける計測ギャップを示しています。

単一のアイテムをスポットチェックする

[ユーザーとグループ] > [ユーザープロファイル] で、Purchaseイベント (または Add to Cart) を完了したユーザーを開きます。
そのイベントのカート配列を展開します。 1 つのアイテムのアイテム識別子 (product.item_idなど) を記録してください。
同じユーザーのタイムラインで、プロパティの設定時に選択したリンクイベントを見つけます (例: View Item Detailsや Add to Cart)。各リンクイベントがソースプロパティとアイテム識別子の両方を伝送することを確認します。
そのアイテムのカートイベントの永続値を、ご使用の割り当て方法と比較してください。
- オリジナル: そのアイテムに対する最も古いリンクイベントからの値。
- 最新の値: カートイベントが発生する前のそのアイテムの最新のリンクイベントからの値。

データテーブルで大規模な検証を行う

永続化されたプロパティとアイテム識別子の両方に基づいてカートイベントをグループ化したデータテーブルを作成します。 (none)を含む行は調査対象の候補です。ソースイベントがそのアイテムのプロパティを起動しなかったか、リンクイベントがアイテム識別子を確実にキャプチャしていないかのいずれかです。

一般的な問題のトラブルシューティング

症状	考えられる原因と修正方法
ターゲットイベントに対する高い`(none)`レート	ほとんどのインスタンスでソースイベントがプロパティを起動していないか、ユーザーが有効期限外にターゲットイベントに到達している可能性があります。最初にソースイベント計測を監査します。ジャーニーが複数のセッションにまたがる場合は、有効期限をセッションからユーザーに切り替えます。
「グループ化基準」に不足している永続化プロパティ	プロパティ定義がまだ保存されていないか、間違ったイベントを指している可能性があります。「データ」>「プロパティ」に移動し、永続化されたプロパティを開き、ソースイベントとプロパティ名が使用しているタクソノミーと完全に一致することを確認します。
値がユーザーのタイムラインに表示されているものと一致しない	割り当てのミスマッチが発生している可能性があります。 Original が設定されている場合、ロックされる値は、ターゲットに最も近いイベントではなく、セッション内の最初のソースイベントからの値になります。タイムラインをセッション順に読み直してください。
ステップ 2 のユーザーはデータテーブルに表示されません	セッションまたはユーザーの有効期限ウィンドウが、2 つのイベントの間に終了した可能性があります。有効期限を延長するか、ユーザープロファイルで使用したのと同じ日付範囲でデータテーブルをフィルタリングしてください。

これは役に立ちましたか？