ページトピックとサブスクリプションソースでユーザーをタグ付け

Documentation Index

Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt

Use this file to discover all available pages before exploring further.

​

パターンを選択

​

前提条件

• OneSignal Web SDK および/または モバイルSDK がインストールおよび初期化されていること。
• タグ と セグメント の使い方を理解していること。

​

ページトピック別タグ付け（毎回の訪問）

• ファッションサイトでは、ユーザーは男性用の靴にのみ興味があり、女性用のドレスには興味がありません。
• ニュースアプリでは、ユーザーは金融とスポーツの記事を常に訪れますが、エンターテイメントや政治には興味がありません。

​

1. トピック分類を定義する

• sports、finance、entertainmentなどの広範な分野
• laptops、accessories、premiumなどの製品タイプ
• 著者またはブランド

​

2. トピック訪問を追跡するコードを追加する

• ページまたは画面ごとに1つ以上のトピックを追跡します。
• トピックが表示されるたびに訪問カウントを増やします。
• 各ビューで更新されたカウントでユーザーにタグ付けします。

const topics = ["sports", "entertainment"]; // One or many

if (typeof localStorage !== "undefined" && Array.isArray(topics)) {
  topics.forEach(topic => {
    let count = parseInt(localStorage.getItem(topic), 10);
    count = isNaN(count) ? 1 : count + 1;
    localStorage.setItem(topic, count);
    OneSignal.User.addTag(topic, count.toString());
  });
}

​

3. セグメント化してパーソナライズされたメッセージを送信する

• セグメントを使用してルールベースのグループを構築（例：gaming >= 3のユーザー）。
• APIフィルターを使用して単一のキャンペーンに動的にユーザーを含める。

• 関連ページを5回以上訪問したユーザーにのみ特定のトピックについてメッセージを送信。
• 特定の著者から3つ以上の投稿を読んだユーザーに投稿を宣伝。
• 特定の製品カテゴリに何度も戻ってくる買い物客に割引を提供。

​

ベストプラクティス

• キャンペーンを開始する前に、console.log()（Web）またはプラットフォームのロガーを使用してタグロジックをテストします。
• ページ全体で一貫したトピック命名規則を使用します。
• すべてのページを変更せずに調整できるよう、トピックリストを中央の場所（設定ファイルまたはリモート設定）に保持します。

• 長すぎるまたは過度に具体的なタグキー（完全な記事タイトル、長いURL）。
• OneSignalのタグ制限を超えること。
• 個人を特定できる情報（PII）でタグ付けすること。

​

サブスクリプション時にタグ付け（一回限り、Webのみ）

​

1. オプトイン時にユーザーにタグ付けする

function pushSubscriptionChangeListener(event) {
  if (event.current.optedIn && !event.previous.optedIn) {
    // User just opted in — tag with subscription context
    var pathSegment = window.location.pathname.split('/')[1] || 'home';
    var pageTopic = document.querySelector('meta[name="article-topic"]')?.content || 'general';

    OneSignal.User.addTags({
      subscription_page: pathSegment,
      subscription_page_topic: pageTopic,
    });
  }
}

OneSignalDeferred.push(function(OneSignal) {
  OneSignal.User.PushSubscription.addEventListener("change", pushSubscriptionChangeListener);
});

• change イベントは、ユーザーのプッシュサブスクリプション状態が変化したとき（オプトイン、オプトアウト、トークンの更新）に発生します。
• ユーザーがアクティブなサブスクリプションを持つ場合、event.current.optedIn は true です。!event.previous.optedIn を確認することで、タグが最初のオプトイン時にのみ適用され、状態変化のたびに適用されないことが保証されます。
• window.location.pathname.split('/')[1] は、サブスクリプションコンテキストとしてパスの最初のセグメントをキャプチャします。たとえば、URLが https://example.com/gaming/article-123 の場合、subscription_page タグは gaming に設定されます。
• pageTopic は <meta> タグから抽出され、'general' にフォールバックします。サイトのメタデータ構造に合わせて調整してください。

​

2. タグでユーザーをセグメント化する

• subscription_page が gaming のユーザーにキャンペーンを送信。
• タグ値とタイミング（例：最初のセッションからの経過時間）に基づいて動的セグメントを作成。

​

3. フォローアップメッセージングを自動化する

​

4. セグメントをメッセージテンプレートと組み合わせる

• キャンペーンの各段階（イントロ、リマインダー、プロモーション）用のテンプレートを構築します。
• ユーザーが適切なセグメントに入ったときに、Journeysを使用してこれらのメッセージを送信します。

• ゲームコミュニティまたはソーシャルグループへの招待。
• トピックに関連するトレンド記事の推薦。
• 独占オファーまたは割引コードの送信。

​

ベストプラクティス

• 実際のユーザーの意図を反映する意味のあるタグ名と値を使用する。
• 可能な限りページメタデータからタグ値を動的に抽出する。
• 最初のオプトイン時にのみタグ付けする——上記のリスナー例では、状態変化のたびに再タグ付けされないよう !event.previous.optedIn を確認しています。

​

よくある質問

​

どちらのパターンを使うべきですか？

​

ユーザーがブラウザデータをクリアした場合、タグは持続しますか？

​

最初のサブスクリプション後にタグを更新できますか？

​

メッセージイベントフィルターの代わりにこれらのパターンを使うべきですか？

​

サブスクリプションソースパターンはモバイルで動作しますか？

​

関連ページ