延遲事件啟用

重要

從 2023 年 9 月 20 日起，您將無法建立新的個人化工具資源。 個人化工具服務將于 2026 年 10 月 1 日淘汰。

延遲啟用事件可讓您建立個人化網站或郵件活動，並考慮使用者可能永遠不會實際看到頁面或開啟電子郵件。 在這些案例中，應用程式可能需要先呼叫 Rank，才能知道結果是否會使用或顯示給使用者。 如果內容從未向使用者顯示，則應該假設沒有預設 Reward （通常為零），才能從中學習。 延遲啟用可讓您在某個時間點使用排名呼叫的結果，並決定應該從稍後或程式碼中的其他地方學習事件。

延遲啟用的典型案例

延遲啟用事件在下列範例案例中很有用：

• 您正在為使用者預先轉譯個人化網頁，但使用者可能永遠不會看到它，因為某些商務邏輯可能會覆寫個人化工具的動作選擇。
• 您在網頁中將內容個人化為「折迭」，而且使用者不可能看到內容。
• 您正在個人化行銷電子郵件，而且您需要避免從使用者從未開啟過的電子郵件進行訓練。
• 您已將動態媒體頻道個人化，而且您的使用者可能會在進入個人化工具所選取的歌曲或影片之前停止播放頻道。

一般而言，這些案例會在下列情況下發生：

• 您是使用者可能或可能因為 UI 或時間限制而無法看到的預先轉譯 UI。
• 您的應用程式正在執行預測性個人化，您可以在其中進行排名呼叫，然後才知道您是否將使用輸出。

如何延遲啟用，以及稍後啟動事件

若要延遲事件的啟用，請在 bequest 主體中呼叫 Rank deferActivation = True 。

一旦您知道您的使用者已顯示個人化內容或媒體，且預期 Reward 是合理的，您必須啟用該事件。 若要這樣做， 請使用 eventId 呼叫 Activate API 。

在 Reward Wait Time 時間範圍到期之前，必須先接收該 EventID 呼叫的 Activate API 呼叫。

延遲啟用的行為

個人化工具會從事件和獎勵中學習，如下所示：

• 如果您使用 呼叫 Rank deferActivation = True ，且 未 Activate 呼叫該 eventId 的 API，並呼叫 Reward，則個人化工具不會從事件中學習。
• 如果您使用 呼叫 Rank， deferActivation = True 並 Activate 呼叫該 eventId 的 API，並呼叫 Reward，個人化工具將會從具有指定 Reward 分數的事件學習。
• 如果您使用 呼叫 Rank deferActivation = True ，並 Activate 呼叫該 eventId 的 API，但省略呼叫 Reward，個人化工具會從設定中設定預設獎勵分數的事件學習。

下一步

• 如何設定 預設獎勵 。
• 瞭解如何 判斷獎勵分數，以及要考慮 哪些資料。