為盡量提高讀者參與度和帳戶連結轉換率，發布商應遵循下列導入最佳做法。分析成效最佳的出版物後，我們發現自動叫用策略搭配嚴格的重新參與冷卻期排程，可帶來最高的成功率。
叫用策略
建議採用主要自動呼叫模型，並為已登入的讀者提供次要按鈕觸發呼叫功能 (選用)。
主要：自動叫用
在價值最高的解鎖時刻自動觸發訂閱連結提示：
- 購買後：使用者在應用程式內購買訂閱項目後，關閉確認對話方塊時。
- 使用者登入：現有訂閱者登入時存取付費牆內容 (做為重新吸引使用者策略的一部分)。
次要：按鈕觸發的叫用
對於已登入但尚未連結帳戶的讀者，請顯示持續顯示且不具侵入性的連結按鈕或行動號召 (CTA)：
- 文章頁首或頁尾：在固定文章的頁首或頁尾列中，與社群分享圖示並列放置連結按鈕。已驗證的讀者主要會前往文章詳細資料頁面，因此直接將行動號召錨定至所消費的內容，可盡量增加連結機會。
- 會員管理頁面：在讀者的帳戶或會員管理頁面上宣傳訂閱連結，並說明連結 Google 帳戶的好處。
重新參與和冷卻邏輯
請勿將訂閱連結視為一次性提示。如果讀者關閉或拒絕連結提示，請先實施週期性冷卻期，再重新顯示行動號召。
- 建議的冷卻期：使用者關閉或拒絕提示後，請等待 30 至 45 天 (或更短，視發布商偏好而定)，再重新提示。
使用 eventListener 偵測拒絕
如要實作重新參與和冷卻邏輯，請使用 swg.js eventManager 偵測使用者何時關閉或拒絕訂閱連結對話方塊，但未連結訂閱項目。如需完整的 Analytics 事件清單，請參閱 GitHub 上的事件定義。
event.eventType發生拒絕或關閉事件時，請在帳戶資料庫中儲存時間戳記，以便在等待期結束前，禁止系統自動重新提示。
// 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();
}
});
});
定期同步處理讀者授權
除了在發生訂閱事件 (例如新交易、續訂、升級或取消) 時立即更新授權，也請實作週期性伺服器端同步處理工作。
- 定期批次同步：使用
updateReaderEntitlementsAPI 方法執行定期排程工作 (例如每日或每週的 Cron 工作)，以重新整理所有有效讀者的狀態。 - 資料一致性：定期同步可確保資料庫和 Google 系統保持一致，修正因暫時性網路故障、錯過的 Webhook 事件或過期的訂閱權杖而造成的任何差異。
如需完整的導入詳細資料和程式碼範例，請參閱「同步處理使用者權利」指南。
在 Search Console 中查看成效
您可以使用 Google Search Console 監控訂閱連結整合作業的直接影響和健康狀態。
