おすすめの方法

読者のエンゲージメントとアカウント リンクのコンバージョン率（CVR）を最大化するには、パブリッシャーは実装に関する以下のベスト プラクティスに従う必要があります。パフォーマンスの高いパブリケーションの分析により、自動呼び出し戦略と厳格な再エンゲージメント クールダウン スケジュールを組み合わせることで、成功率が最も高くなることが明らかになりました。

呼び出し戦略

メインの自動呼び出しモデルを採用し、ログインしている読者向けにオプションのセカンダリ ボタン トリガー呼び出しを使用することをおすすめします。

プライマリ: 自動呼び出し

最も価値の高いロック解除のタイミングで、Subscription Linking のメッセージを自動的にトリガーします。

• 購入後: 社内サブスクリプションの購入直後、確認モーダルを閉じたとき。
• ユーザーのログイン: 既存の定期購入者がペイウォールで保護されたコンテンツにアクセスしたとき（再エンゲージメント戦略の一環として）。

セカンダリ: ボタンで呼び出す

まだアカウントをリンクしていないログイン済みの読者には、非侵入型のリンクボタンまたは行動を促すフレーズ（CTA）を永続的に表示します。

• 記事のヘッダーまたはフッター: リンクボタンを、ソーシャル メディアの共有アイコンとともに、スティッキー記事のヘッダーまたはフッターバーに配置します。認証済みの読者は主に記事の詳細ページにアクセスするため、CTA を消費中のコンテンツに直接アンカーすると、リンクの機会を最大限に増やすことができます。
• メンバーシップ管理ページ: 読者のアカウントまたはメンバーシップ管理ページで、Google アカウントをリンクするメリットの説明とともに、定期購入のリンクを宣伝します。

再エンゲージメントとクールダウンのロジック

Subscription Linking を 1 回限りのプロンプトとして扱わないでください。読者がリンクのプロンプトを閉じるか、リンクを拒否した場合は、行動を促すフレーズを再度表示する前に、クールダウン期間を繰り返し実装します。

• 推奨されるクールダウン期間: ユーザーがプロンプトを閉じるか拒否した後、再度プロンプトを表示する前に、30 ～ 45 日間（または、パブリッシャーの希望に応じてそれより短い期間）の待機期間を設けます。

eventListener で拒否を検出する

再エンゲージメントとクールダウンのロジックを実装するには、swg.js eventManager を使用して、ユーザーがリンクせずに定期購入のリンク ダイアログを閉じたか、拒否したかを検出します。アナリティクス イベントの一覧については、GitHub のイベント定義をご覧ください。

注: ブラウザ ランタイム（swg.js）では、self.SWG は AnalyticsEvent 列挙型を直接エクスポートしません。代わりに、event.eventType は protobuf 列挙値に対応する数値 ID を出力します（たとえば、ACTION_SUBSCRIPTION_LINKING_CLOSE の場合は 1086、EVENT_SUBSCRIPTION_LINKING_FAILED の場合は 2005）。

拒否または非表示イベントが発生した場合は、クールダウン期間が終了するまで自動再プロンプトを抑制するために、アカウント データベースにタイムスタンプを保存します。

// AnalyticsEvent numeric IDs from api_messages.ts
// list of the events: https://github.com/subscriptions-project/swg-js/blob/main/src/proto/api_messages.ts#L32
const ACTION_SUBSCRIPTION_LINKING_CLOSE = 1086;
const EVENT_SUBSCRIPTION_LINKING_FAILED = 2005;

subscriptions.getEventManager().then(manager => {
  manager.registerEventListener((event) => {
    // Inspect the analytics event
    console.log("Analytics event: ", event);

    // If the event indicates the user closed or rejected the linking prompt,
    // record the timestamp to enforce your 30-45 day cooldown schedule.
    if (event.eventType === ACTION_SUBSCRIPTION_LINKING_CLOSE ||
        event.eventType === EVENT_SUBSCRIPTION_LINKING_FAILED) {
      // Record rejection timestamp for cooldown suppression
      recordLinkingRejectionTimestamp();
    }
  });
});

読者の利用資格を定期的に同期する

サブスクリプション イベント（新規購入、更新、アップグレード、解約など）が発生したときに利用資格を直ちに更新するだけでなく、定期的なサーバーサイド同期ジョブを実装します。

• 定期的なバッチ同期: updateReaderEntitlements API メソッドを使用して、定期的なスケジュール設定ジョブ（毎日または毎週の cron タスクなど）を実行し、すべてのアクティブな読者のステータスを更新します。
• データの一貫性: 定期的な同期により、データベースと Google のシステムが常に一致し、一時的なネットワーク障害、Webhook イベントの欠落、サブスクリプション トークンの有効期限切れによって生じた不一致が修正されます。

重要: 許容される expire_time の最大値は、API 呼び出しの時点から 398 日です。購読者のメンバーシップ ステータスが変更されない場合（永久メンバーシップや自動更新の定期購入など）でも、expire_time を延長するために updateReaderEntitlements を定期的に呼び出す必要があります。それ以外の場合、利用資格は期限切れとなり、サブスクリプション リンクは 398 日後に削除されます。

実装の詳細とコード例については、ユーザー利用資格の同期ガイドをご覧ください。

Search Console でパフォーマンスを確認する

Google Search Console を使用すると、サブスクリプション リンク統合の直接的な影響と健全性をモニタリングできます。

• エンゲージメント指標をトラッキングする: Search Console のパフォーマンス レポートを開き、[検索での見え方] のタイプを [サブスクライブ コンテンツ] にフィルタして、ハイライト表示された購読者向け記事のクリック数、インプレッション数、クリック率（CTR）を測定します（検索での見え方レポートを参照）。
• 構造化データの健全性をモニタリングする: リッチリザルト レポートの定期購読コンテンツを使用して、パブリケーションのページ全体で構造化データのマークアップの構文エラーや検証エラーを特定し、トラブルシューティングを行います。