延遲事件啟用

重要

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

考慮到使用者可能永遠不會看到該頁面或開啟該電子郵件，延遲啟用事件可讓您能建立個人化網站或郵寄行銷活動。 在這些案例中，應用程式在是否會使用或向使用者顯示得知結果之前，可能就需要先呼叫「順位」。 若使用者從未看過該內容，則不會有預設的「獎勵」(通常為零)，以使其進行學習。 您可透過延遲啟用，在某個時間點使用呼叫「順位」的結果，然後決定是否要在稍後或在您程式碼中的某處，學習該事件。

延遲啟用的典型案例

延遲啟用事件在以下範例的案例中發揮了巨大作用：

• 您要為某位使用者預先呈現一個個人化網頁，但該名使用者可能因為某些商務邏輯會覆寫個人化工具所選擇的動作，而永遠都不會看到該網頁。
• 您要將某個網頁中「需要捲動畫面才能看到的」的內容個人化，而使用者非常有可能永遠也不會看到此內容。
• 您要將行銷電子郵件個人化，且需要避免以使用者永遠都不會打開的電子郵件來進行訓練。
• 您要將動態媒體頻道個人化，而使用者可能會在頻道播放個人化工具挑選的歌曲或影片之前，就先停止了播放頻道。

大致上來說，這些案例會發生於以下情況：

• 您要將使用者因為 UI 或時間限制而可能會或可能不會看到的內容，預先呈現。
• 您的應用程式要執行預測性個人化，在您知道是否要使用該輸出之前，就先呼叫「順位」。

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

若要延遲啟用事件，請在要求本文中以 deferActivation = True 呼叫順位。

一旦得知使用者已看過個人化的內容或媒體，且預期會獲得獎勵後，就必須啟動該事件。 若要啟動事件，請使用事件識別碼呼叫 Activate API 。

在到達獎勵等待時間的期限之前，必須先接收呼叫該事件識別碼的呼叫啟動 API。

延遲啟動的行為

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

• 若使用 deferActivation = True 呼叫「順位」，但不呼叫該事件識別碼的 Activate API，但呼叫「獎勵」，則個人化工具不會學習該事件。
• 若您使用 deferActivation = True 呼叫「順位」，並會呼叫該事件識別碼的 Activate API，且呼叫「獎勵」，則個人化工具將會學習該事件並給予指定的「獎勵」分數。
• 若使用 deferActivation = True 呼叫「順位」，並會呼叫該事件識別碼的 Activate API，但略過呼叫「獎勵」，則個人化工具將會學習該事件，並給予設定中的「預設獎勵」分數。

下一步

• 如何設定預設獎勵。
• 了解如何決定獎勵分數以及應納入考量的資料。