共用方式為


RankRequest interface

要求個人化工具服務排名的一組動作。

屬性

actions

個人化工具服務可以從中挑選的一組動作。 此集合不應包含超過 50 個動作。 動作的順序不會影響排名結果,但順序應該符合您的應用程式用來顯示的順序。

contextFeatures

用於個人化工具做為字典的內容功能。 這取決於應用程式,通常包含目前使用者、其裝置、配置檔資訊、時間和日期的相關數據等功能。

deferActivation

如果使用者會看到排名結果,則傳送 false,因此個人化工具預期會呼叫 Reward,否則會將預設 Reward 指派給事件。 如果使用者可能看不到排名結果,請傳送 true,因為頁面稍後正在轉譯,或排名結果可能會由程式代碼進一步下游覆寫。 默認值:false。

eventId

選擇性地傳遞可唯一識別此 Rank 事件的 eventId。 如果為 null,服務會產生唯一的 eventId。 eventId 將用於將此要求與其獎勵產生關聯,以及在進行個人化工具呼叫時植入虛擬隨機產生器。

excludedActions

要從排名中排除的一組動作標識碼。

屬性詳細資料

actions

個人化工具服務可以從中挑選的一組動作。 此集合不應包含超過 50 個動作。 動作的順序不會影響排名結果,但順序應該符合您的應用程式用來顯示的順序。

actions: RankableAction[]

屬性值

contextFeatures

用於個人化工具做為字典的內容功能。 這取決於應用程式,通常包含目前使用者、其裝置、配置檔資訊、時間和日期的相關數據等功能。

contextFeatures?: any[]

屬性值

any[]

deferActivation

如果使用者會看到排名結果,則傳送 false,因此個人化工具預期會呼叫 Reward,否則會將預設 Reward 指派給事件。 如果使用者可能看不到排名結果,請傳送 true,因為頁面稍後正在轉譯,或排名結果可能會由程式代碼進一步下游覆寫。 默認值:false。

deferActivation?: boolean

屬性值

boolean

eventId

選擇性地傳遞可唯一識別此 Rank 事件的 eventId。 如果為 null,服務會產生唯一的 eventId。 eventId 將用於將此要求與其獎勵產生關聯,以及在進行個人化工具呼叫時植入虛擬隨機產生器。

eventId?: string

屬性值

string

excludedActions

要從排名中排除的一組動作標識碼。

excludedActions?: string[]

屬性值

string[]