このページでは

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.

変数によるパーソナライズ

変数によるパーソナライズ機能(補間とも呼ばれます)は、ユーザープロパティを動的に表示して、ガイドやサーベイのコンテンツをカスタマイズします。この機能を使用して、ユーザーのファーストネームやuser_idを表示するなどして、ユーザーごとにコンテンツをカスタマイズできます。パーソナライズされた変数を次のものに追加できます。

  • タイトル
  • コンテンツ
  • ボタンラベル
  • ボタンアクションURL

一般的な例

URLの一部を置換する

CTAリンクのユーザープロパティ変数を使用して、URLをパーソナライズします。たとえば、次のようなリンクを作成します。

plaintext
www.example.com/path?user_id=@{{property.user_id}}&country=@{{property.country}}

ユーザーがCTAリンクをクリックすると、Amplitudeはユーザープロパティ変数を実際の値に置き換えます。

plaintext
www.example.com/path?user_id=12345&country=US

ユーザー名でガイドをパーソナライズする

ユーザーの名前を保持するユーザープロパティを作成します(例:firstName)。ユーザーに名前で呼びかけたいガイドまたはサーベイの任意のフィールドにfirstNameプロパティを配置します。

フォールバック値の提供

ユーザープロパティは、すべてのユーザーまたはすべてのセッションで常に使用できるとは限りません。フォールバック値を使用して、プロパティが見つからない場合にデフォルト値を表示できます。 たとえば、ユーザーが名前をまだ入力していない場合に「こんにちは{firstName}さん」ではなく「こんにちは」を表示するには、{{property.firstName | there}}のようなフォールバックを使用します。

ユーザープロパティの要件

アクティブなセッション期間中に、Amplitude SDK または Engagement SDK のいずれかを使用して、クライアントからユーザープロパティを送信します。以前のセッションで送信されたプロパティや、サーバー上にのみ保存されているプロパティはサポートされていません。

ユーザープロパティを設定するには、Engagement SDKの_setUserPropertiesメソッドまたはAmplitude SDKのamplitude.identify()メソッドを使用してください。

Amplitudeはuser_idとdevice_idを自動的に入力します。これらの変数は、追加設定なしで常に使用できます。

条件付きロジックのユーザープロパティ

ユーザープロパティは条件付きロジックにも活用できます。条件付きロジックを使用して、ユーザーの特性に基づいてさまざまなボタンアクションやサーベイパスを作成できます。 たとえば、プレミアムユーザーを無料ユーザーとは異なるコンテンツに誘導できます。

ガイドやアンケートにパーソナライズされた変数を追加する
  1. 既存のガイドや調査を開くか、新しいガイドや調査を作成します。
  2. タイトル、コンテンツブロック、ボタン名、またはその他のテキストフィールドを選択します。 パーソナライズ変数アイコンは、選択したフィールドの右側に表示されます。
  3. ユーザープロパティアイコンを選択します。
  4. ポップアップにユーザーのプロパティ名を入力します。
  5. (オプション)ユーザープロパティのフォールバック値を入力します。
  6. 挿入を選択します。
  7. プロパティ変数を追加するすべてのフィールドに対して、この操作を繰り返します。

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