このページでは

For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

設定とターゲティング

ターゲティングは、ガイドやアンケートを受け取るユーザーを制御します。 トリガーは、表示のタイミングと場所を制御します。どちらの設定もビルダーの*「設定」*タブに存在します。

ターゲット設定

すべてのメッセージがすべてのユーザー向けというわけではありません。 ターゲティングを使用すると、どのユーザーがガイドやアンケートを受け取るか、またそのタイミングを定義できます。すべてのユーザーまたはターゲットユーザーのいずれかをターゲットに設定できます。

「すべてのユーザー」は、このガイドまたはアンケートでサイトを訪問したすべてのユーザーを対象としています。

ターゲットユーザーを使用すると、ガイドやアンケートを受け取るユーザーセグメントを作成できます。

各セグメントはプロパティまたはコホートによってフィルタリングすることができ、複数のフィルタを持つことができます。 たとえば、ガイドやアンケートを過去30日以内に新規ユーザーとなった米国外のユーザーにターゲットを絞りましょう。

プロパティピッカーには、標準ユーザープロパティと並んでAmplitudeデータで定義された変換済みユーザープロパティが含まれています。変換済みのプロパティをターゲットに設定することで、ガイドやアンケートがリーチするユーザーと、アナリティクスのグラフやコホートに表示されるユーザーと一致することが保証されます。これは、両者とも同じ変換ルールを使用しているためです。

Arrayユーザープロパティのガイド

とサーベイは、リモート評価期間中にターゲット設定ルールを評価します。この評価を支えるユーザープロパティストアは、ネストされたオブジェクトを平坦化しますが、配列値のプロパティを平坦化することはありません。

プロパティをオブジェクトの配列として送信する場合(たとえばsubscription: [{plan, state, length}])、subscription.planのようなドット付きパスは、分析のユーザープロフィールに表示されている場合でも、評価時には使用できません。カート分析では、分析用にこれらのドット付きプロパティが作成されますが、ガイドとサーベイが読み取るユーザープロパティストアとは同期されません。

配列から派生した値をターゲットにするには、フラットスカラーのユーザープロパティ (例: subscription_plan: "enterprise") を設定し、代わりにそのプロパティをターゲットにします。

ユーザーセグメントに対してロールアウト率とバケット単位の両方を設定できます。 たとえば、ガイドを最初に公開するときにセグメントの10%をターゲットに設定し、エンゲージメントデータを確認した後でそれを100%に増やします。

複数のセグメントの使用

ターゲティングに複数のセグメントを追加する場合、Amplitudeは各セグメントをOR評価します。つまり、ユーザーが任意のセグメントに属している場合、Amplitudeはユーザーにガイドやアンケートを表示します。

資格を均等に割り当てる

Even distributionでは、対象となるユーザー全員をすぐに利用対象とするのではなく、一定期間にわたってウェブガイドやアンケートを配信します。継続的なNPSプログラムのように、公開時の急増ではなく、インプレッションやレスポンスの継続的な流れが必要な場合に使用してください。

各ユーザーには、繰り返し期間ごとに、一貫した14日間の資格期間が与えられます。Amplitudeはウィンドウの開始日を期間全体に分散させ、同じユーザーIDを使用してユーザーの割り当てをセッションやデバイス間で安定させます。 匿名の訪問者の場合、AmplitudeはデバイスIDを使用するため、同じ訪問者が各デバイスで異なるウィンドウを持つ可能性があります。

繰り返し期間は、各ユーザーのウィンドウが繰り返される頻度を制御します。 14日間のウィンドウの長さは変更されません。たとえば、90 日の期間の場合、ユーザーは各 90 日のサイクルで割り当てられた 14 日の期間中に資格を得ることができます。期間を変更した場合、Amplitudeは割り当てられた開始日を再計算します。これにより、ユーザーが次に資格を得るタイミングが変わる可能性があります。

Even distribution(均等分散)もまた、別のターゲティングチェックを追加します。ガイドやアンケートは、ユーザーがウィンドウ内にいて、オーディエンス、ページターゲティング、トリガー、ステータス、制限のチェックにも合格した場合にのみ表示されます。 均等な配信であっても、インプレッションや反応を保証するものではありません。ユーザーが期間中に訪問しなかったり、トリガーに合致しなかった場合、ユーザーは次のサイクルで期間を待つ必要があります。

均等な分布を設定する

  1. ウェブガイドまたはアンケートを開き、[設定] タブに移動します。
  2. *[ターゲティング] *セクションで、均等分布を有効にします。
  3. 分散 の下で、30 日ごと、60 日ごと、90 日ごと、180 日ごと、または 365 日ごと を選択します。Amplitudeはデフォルトで90日を選択しています。
  4. ガイドまたは調査を保存します。

テスト期間中、デバッグツールバーのターゲティングステータスを開き、現在のユーザーが14日間の期間内にいるかどうかを確認してください。

ユースケース

  • 定期的な NPS サーベイ: 四半期ごとの NPS プログラムを 90 日間かけて実施することで、四半期を通してより安定した回答の流れを収集できます。
  • 継続的なプロダクトフィードバック: 満足度調査または機能フィードバック調査を繰り返し実施することで、回答が期間内のさまざまな時点を反映するようになります。
  • 段階的なガイド配信: 常時関連性の高い教育ガイドを徐々に展開することで、リリース当日のインプレッション数や後続のアクティビティが急増するのを抑えます。

制限と可用性

均等配信は制限を置き換えるのではなく、制限を伴って機能します。体験を完了または終了したユーザーは、[完了時に表示を停止] または [終了時に表示を停止] のいずれかの制限が適用される場合、以降のウィンドウでは対象外となります。これらの設定を確認し、ユーザーが繰り返しアンケートを受け取りつつ表示頻度を制限したい場合は、クールダウン制限を設定してください。アンケート回答上限は累積であり、引き続きアンケートの公開を終了させる可能性があります。

プランに繰り返しが含まれている場合、ツールチップを除くウェブガイドとサーベイに均等な配布を使用できます。モバイルガイドとサーベイでは、これはサポートされていません。

First Seen タイムスタンプ

ターゲティングプロパティピッカーには、組み込みの「First Seen」プロパティが含まれています。 ガイドとサーベイはリモート評価の際にこのタイムスタンプを Amplitude ID テーブルから取得するため、ユーザーの最初のセッションでもこのタイムスタンプを利用できます。

新規ユーザーをターゲットに設定する際は、コホートではなく「初見」を使用してください。 コホートメンバーシップの更新には遅延があります。つまり、コホートベースの新規ユーザーフィルタは、ユーザーが初めて訪問したときにユーザーと一致しません。 First Seenはリアルタイムで評価を行います。

例: 本日登録したユーザーを対象に設定

ターゲティングセグメントで、初回確認日が今日の日付以降であるフィルターを追加してください。初回表示タイムスタンプが今日以降であるユーザーのみが対象となります。

最初のログインを逃した場合

:ユーザーが最初のログイン時にガイドが表示されるページにアクセスしなかった場合でも、今後のログインで引き続き対象となります。「初回確認」タイムスタンプは変更されないため、ターゲット設定条件に引き続き一致します。

バケティング単位

バケット設定単位は、ロールアウト率を使用する場合に、Amplitudeがガイドまたはアンケートを受信するユーザーをどのように割り当てるかを決定します。 バケティングにより、同じエンティティのデバイスやセッション間でエクスペリエンスの一貫性が保たれます。

利用可能なバケティング単位

バケット化の例

例 1: ユーザー ID のバケット化

ユーザー ID バケット化を使用して 50% ロールアウトを設定しました。 ユーザーがノートパソコンを使用してログインすると、ガイドが届きます。ユーザーが後で同じユーザー ID で電話からログインした後も、ガイドが引き続き表示されます。これは、Amplitude がユーザー ID に基づいてバケット処理を行うためです。

例 2: アカウント ID のバケット化

アカウント ID バケット設定を使用して 50% ロールアウトを設定しました (カスタムaccount_idプロパティを使用)。 ユーザー数が 10 人のアカウント「Acme Corp」は、選択された 50% に含まれます。 Acme Corpのユーザー10人全員に、デバイスに関係なくこのガイドが表示されます。残りの 50% に属する "ベータ Inc" のユーザーは全員、このガイドが表示されません。

例 3:デバイス ID のバケット化

デバイス ID バケット化を使用して 50% ロールアウトを設定しました。 ユーザーのノートパソコンが選択された 50% に該当し、ガイドを受信します。 同じユーザーの電話機が残りの 50% に含まれているため、両方のデバイスが同じユーザーに属していても、ガイドは電話機に表示されません。

各バケット単位を使用するタイミング

  • ユーザーID:ログインしているユーザーにデバイス間で一貫した体験を提供したい場合に使用します。
  • デバイス ID: 匿名のユーザーの場合や、デバイス固有のターゲティングが重要な場合に使用します。
  • アカウント/組織 ID: 組織内のすべてのユーザーが同じ体験を必要としている場合に使用します。 これは、B2B 製品や組織のロールアウトに役立ちます。

ユーザーのグループを除外する

特定のガイドや調査からユーザーグループを除外したい場合があります。 たとえば、調査を実施しても米国の顧客は除外したり、内部ユーザーを除外して実際の顧客からの回答のみを受け取ったりすることができます。

ユーザーは、コホートまたはセグメントレベルで除外できます。 このプロセスは両者とも同様です。 このセクションでは、コホートレベルでの除外に焦点を当てています。 コホートに関する詳細は、「コホート」を参照してください。

ユーザーのコホートを除外するには、where ステートメントを does not equal 除外したいコホートに設定します。

プロジェクト全体のデフォルトのユーザー除外

プロジェクトレベルでデフォルトのユーザー除外を設定することで、社内従業員やデモアカウントなどのユーザーグループからすべてのガイドやサーベイを非表示にできます。Amplitudeは、すでに実行されている体験を含め、プロジェクト内の既存および将来のすべてのガイドとサーベイに除外を適用するため、それぞれについて同じ除外を繰り返す必要はありません。

デフォルトのユーザー除外を設定するには:

  1. ガイドとサーベイで、ガイドまたはサーベイリストを開き、[設定] アイコンをクリックします。
  2. デフォルトのユーザー除外設定を展開します。
  3. **[ユーザーの除外条件] **の下で、1 つ以上のセグメントを追加します。コホートメンバーシップなど、ユーザーのプロパティ条件に基づいて各セグメントを構築します。
  4. 保存をクリックします。

これらのセグメントの任意のものに一致するユーザーは、プロジェクト内でガイドやサーベイを表示することはありません。個々のエクスペリエンスは、プロジェクト全体のデフォルトの上に独自の除外を追加できますが、それらを上書きしたり置き換えたりすることはできません。

デフォルトのユーザー除外には、スロットリングやデフォルトのページ除外と同じ権限が必要です。 ビルダーの推定露出量は、プロジェクト全体の除外項目に一致するユーザーを差し引きます。

ガイドへのリンクを送信する

ユーザーにガイドやアンケートへのリンクを送信することで、ユーザーをより直接的にターゲットにすることができます。 ガイドまたはアンケートビルダーから、[保存] ボタンの横にあるメニューを展開し、[リンクを共有] を選択します。

モーダル内:

  • ウェブの場合、クエリパラメータをコピーし、ガイドとサーベイで計測されているサイト上のページに追加します。受信者がクエリ パラメータが添付されたリンクを選択すると、ガイドが表示されます。
  • モバイルの場合は、アプリがインストールされているデバイスで QR コードをスキャンするか、共有リンクの URL を開きます。 ガイドはアプリ内に表示されます。

ユーザーとページのターゲティング

ガイドまたはサーベイへの直接リンクを送信する場合、Amplitudeは、ガイドで設定したすべてのオーディエンスまたはユーザーのターゲティングを上書きします。

Amplitudeはページターゲティングを上書きしません。 リンクが期待どおりに機能することを確認するには、送信するページにガイドが表示されていることを確認してください。

トリガー

トリガーは、体験がいつどこで表示されるかを制御します。

ターゲティングカード内で、体験を開始するイベントやインタラクションを選択し、体験を特定のページにゲートし、優先度を調整します。

いつ

Amplitudeは体験をトリガーするための以下のオプションを提供します。

エレメントクリック時に表示:SD

K を使用 ユーザーがボタンやその他のエレメントをクリックしたときにガイドやアンケートを表示するには、トリガーを None に設定し、エレメントのハンドonclickラーから .showSDK メソッドを呼び出すことをお勧めします。 これにより、どの体験がいつ表示されるかを正確に制御できます。

トリガー遅延

[即時]以外のすべてのトリガーオプションに対して、ガイドまたはサーベイが起動するまでの遅延時間(秒単位)を設定できます。遅延を使用すると、タイミングの押しつけがましさを軽減できます。たとえば、ユーザーが「チェックアウト」を選択した直後ではなく、5秒後にアンケートを表示できます。

以前は、「ページ/画面での滞在時間後」トリガーのみが待機をサポートしていました。トリガー遅延は、この機能をイベントベース、要素ベース、およびその他の非即時トリガーに拡張します。

設定方法

ナッジエディタで、「トリガー」セクションを開きます。 非即時トリガーを選択すると、[遅延]フィールドが表示されます。ガイドまたはサーベイを起動する前にAmplitudeが待機する秒数を入力します。

行動
  • 遅延カウントダウンは、トリガー条件が最初に一致した時点から開始されます。 ユーザーが遅延が経過する前に移動した場合、ガイドや調査は元のページで起動しません。
  • 遅延はトリガーごとに発生します。 同じナッジ上の異なるトリガーには、それぞれ異なる遅延を設定できます。
  • 遅延と条件付きロジックを組み合わせた場合(たとえば、「要素 X が表示されている場合にのみ起動」)、Amplitude はトリガー時ではなく遅延後の起動時に条件を再評価します。
例

purchase_completedイベントの10秒後にNPSサーベイを表示するには、トリガーを「イベントpurchase_completedで追跡されたイベント時」に設定し、遅延を設定します10。

SDK 要件

トリガー遅延には、エンゲージメントブラウザ SDK の最新バージョンが必要です。 この機能を使用するには、最新の SDK リリースにアップデートしてください。

セッションのプロパティ

セッションプロパティは、ガイドやサーベイに対するトリガーターゲティング制限のレイヤーを追加します。ガイドまたはサーベイがトリガーされ、セッションプロパティ条件が設定されている場合、体験を表示するには、設定済みのすべてのセッションプロパティ条件が一致している必要があります。

SDK は、このメソッドを使用してセッションプロパティを動的に設定します。これらのプロパティはsetSessionPropertyユーザーのセッションを通して変更できます。 セッションプロパティ値が変更されると、SDK はガイドやサーベイを表示できるかどうかを自動的に評価し、「即時」トリガーでセッションプロパティを有効にします。

セッションプロパティの一般的な使用例には次のものがあります。

  • ユーザーが複数の組織に属している場合: ユーザーの現在の組織の特徴に基づいてガイドやアンケートの可視性を制御できます(isFeatureEnabled: true)。
  • 進捗状況の追跡: ユーザーの進捗状況に基づいてガイドやサーベイを表示します(onboardingStep: 3)。
  • ユーザープロパティとして永続化すべきでない動的な状態: ユーザーの行動やアプリケーションの状態にリアルタイムで対応します。

機能の可用性

:セッションプロパティは、フィーチャーフラグによる機能です。実装でこの機能を使用するには、Amplitude サポートまでお問い合わせください。

場所

ガイドやアンケートをすべてのページに表示するか、特定のページのみに表示するか、特定のページを除外するかを制御できます。

特定のページを含めるか除外する際、Amplitudeは以下の一致タイプを受け入れます:

  • URLの一致
  • URLと画面が完全に一致する
  • URL/画面がパターンに一致
  • URL/画面に含まれるもの
  • URL/画面の始まりは
  • URL/画面の末尾は次のとおりです
  • URL/画面が正規表現に一致する
  • ページ上の要素のCSSセレクター

ページ上の要素のCSSセレクター

特定の DOM 要素がページ上に表示された場合にのみガイドまたはアンケートを表示するように設定します。 対象となる要素を識別するCSSセレクタを入力します。この一致タイプは、トリガーイベントが発生したときに評価します。

このルールを除外に使用できます。 たとえば、ページ上にCSSセレクター.class-fooを持つ要素があるページを除外します。

ページターゲット設定ルールの組み合わせ

AND/ORロジックを使用して、URLと要素の条件を組み合わせることができます。たとえば、(a) URL に /checkoutが含まれており、かつ (b) .payment-successが表示されている要素がある場合にガイドを表示できます。

プロジェクト全体のデフォルトページの除外

プロジェクトレベルでデフォルトのページ除外を設定し、すべてのエクスペリエンスに自動的に適用します。 プロジェクト設定 > ガイドとサーベイ > デフォルトページの除外項目でデフォルトを設定します。個々のエクスペリエンスは、ビルダーの*「Where」*セクションで独自の含めるルールまたは除外ルールを指定することで、プロジェクト全体のデフォルトルールを拡張できます。

上記の URL 一致タイプと同じもの (URL matches、URL contains 、URL starts with など) がプロジェクト全体のデフォルトの除外ルールに適用されます。

アプリにチェックアウトフロー、パスワードリセットフロー、エラーページなど、エクスペリエンスが表示されるべきでないページがある場合は、プロジェクト全体の除外を使用してください。 プロジェクトレベルで除外を一度設定すると、すべてのエクスペリエンスで同じルールを繰り返すことがなくなり、後で追加されたエクスペリエンスがそれらのページに表示されるのを防ぐことができます。ページセットではなくユーザーグループからすべてのエクスペリエンスを非表示にするには、プロジェクト全体のデフォルトのユーザー除外を設定します。

優先度

優先度を使用して、ユーザーが遭遇する可能性のある他のガイドや調査と比較してその重要性をランク付けします。

  • 緊急
  • ハイ
  • ミディアム
  • ロー

複数のガイドが表示可能な場合のタイブレーカー

複数のガイドまたはサーベイが同時に表示される資格がある場合、Amplitudeはこれらのタイブレークを使用して、どの体験を表示すべきかを決定します:

  1. アクティブなものを非アクティブなものより優先:Amplitudeは、アクティブなガイドやサーベイを、非アクティブなガイドやサーベイよりも前に表示します。
  2. 優先度: 優先度の高い体験が最初に表示されます (緊急 > 高 > 中 > 低)。
  3. 最近見た体験:ユーザーが関連付けられた体験を1つ以上以前に見たことがある場合、Amplitudeはユーザーが最近見た体験を表示します。
  4. 最近作成された体験:ユーザーがいずれの体験も見たことがない場合、または両方を同時に見た場合、Amplitudeは最も最近作成された体験を表示します。

優先順位付け表

早期アクセス

新しい優先順位付けテーブルでは、特定の優先順位内でガイドとサーベイを順序付けできるため、ガイドとサーベイごとに異なる順序を設定できます。サブプライオリティは、上記のタイブレーカーのルール3と4に代わるものです。

サブプライオリティはプラットフォームごとに異なります。 優先度ビューの上部にあるプラットフォームフィルタを使用して、特定のプラットフォーム(Web、iOS、Androidなど)に切り替え、それぞれのプラットフォームに個別に優先度とサブプライオリティを設定できます。

サブプライオリティもフォームファクタに固有です。 フォームファクタのグループ化は次のとおりです。

  • モーダル、ピン、ポップオーバー
  • チェックリスト
  • バナー

ツールチップや埋め込みに対して優先順位は関係ありません。 ツールチップと埋め込みは、ターゲット設定、トリガー設定、制限設定の基準がすべて満たされている場合に常にレンダリングされます。 Amplitudeは複数のツールチップと埋め込みを同時にレンダリングできます。

制限事項

制限を使用すると、ユーザーが過剰なメッセージを受信することを防ぐことができます。

ローカリゼーション

ローカリゼーションを使用すると、言語ごとに新しいガイドやサーベイを作成することなく、さまざまな言語でガイドやサーベイを提供できます。詳細については、「ローカリゼーション」を参照してください。

ステータス

ステータスを使用すると、ガイドやアンケートが表示されるタイミングを管理できます。

プロジェクトを公開する前にレビュー担当者がサインオフする必要がある場合は、承認ワークフローにアクセスして承認者を構成し、レビューをリクエストしてください。

一括で公開解除する

複数のガイドやアンケートを一度に非公開にするには、ガイドとアンケートの一覧ページに移動し、非公開にする項目を選択してから、[非公開] をクリックします。

一般的なユースケースは次のとおりです。

  • デモやテスト実行前にすべてのアクティブな体験を非公開にすること。
  • 異なるプラットフォーム間にある同じガイドの複数のバージョンを一度に非公開にすること。

設定

ビルダー上部にある歯車アイコンからガイドやサーベイ設定にアクセスできます。

アクティブ状態

ユーザーが最初にガイドまたは調査を表示すると、そのガイドまたは調査は「アクティブ」になります。 ガイドまたはサーベイは、ユーザーが完了するか、または閉じるまでアクティブなままです。例えば:

  • ユーザーは、あなたのホームページでガイドやアンケートを見ます。
  • ユーザーは連絡先ページに移動します。
  • トリガー条件が起動しなかった場合でも、ガイドまたはサーベイはアクティブなままです。 ガイドや調査はユーザーを追って連絡先ページへと移動します。

Amplitudeがガイドや調査を一時的に非表示にすると、ユーザーには表示されませんが、ガイドや調査はアクティブなままです。 temporarily hide if条件が適用されなくなった後は、アクティブなガイドまたはサーベイは再表示の対象となります。

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