云眼用户上下文

云眼May 11, 2023About 2 min

云眼用户上下文

本主题介绍功能实验 JavaScript（浏览器）的 EyeofcloudUserContext 对象，该对象允许做出标帜决策并跟踪用户上下文的事件。

对象允许做出标帜决策并跟踪已使用创建用户上下文方法创建的用户上下文的事件。

云眼用户上下文变体

EyeofcloudUserContext 在 SDK v3.7 及更高版本上受支持。

强制决策方法变体

setForcedDecision() 、getForcedDecision()、removeForcedDecision()和removeAllForcedDecisions()方法在 v4.9.0 及更高版本中受支持。

云眼用户上下文定义

以下代码显示了 EyeofcloudUserContext 的对象定义：

JavaScript

interface EyeofcloudUserContext {     
    // set an attribute for the user     
    setAttribute(key: string, value: unknown): void;      
    
    // return user attributes     
    getAttributes(): UserAttributes;      
    
    // make a decision about which flag variation the user buckets into for the flag key      
    decide(       
        key: string,       
        options: EyeofcloudDecideOption[] = []       
        ): EyeofcloudDecision;      
        
    // make decisions about which flag variations the user buckets into for flag keys     
    decideForKeys(       
        keys: string[],       
        options: EyeofcloudDecideOption[] = [],       
    ): { [key: string]: EyeofcloudDecision };      
    
    // make decisions about which flag variations the user buckets into for all flags     
    decideAll(       
        options: EyeofcloudDecideOption[] = []       
    ): { [key: string]: EyeofcloudDecision };      
    
    // track user event     
    trackEvent(eventName: string, eventTags?: EventTags): void;          
    
    // Sets the forced decision (variationKey) for a given decision context     
    setForcedDecision(context: EyeofcloudDecisionContext, decision: EyeofcloudForcedDecision): boolean;      
    
    // Returns the forced decision for a given decision context     
    getForcedDecision(context: EyeofcloudDecisionContext): EyeofcloudForcedDecision | null;      
    
    // Removes the forced decision for a given decision context     
    removeForcedDecision(context: EyeofcloudDecisionContext): boolean;      
    
    // Removes all forced decisions bound to this user context     
    removeAllForcedDecisions(): boolean; 
}

性能

下表显示了 EyeofcloudUserContext 对象的属性：

属性	类型	评论
用户标识	字符串	用户的 ID
（可选）属性	Map	自定义键值对的映射，用于指定用于受众群体定位的用户属性。创建用户时，可以使用用户 ID 传递映射。

方法

下表显示了 EyeofcloudUserContext 对象的方法：

方法	评论
setAttribute	Pass a custom user attribute as a key-value pair to the user context.
decide	Returns a decision result for a flag key for a user. The decision result is returned in an EyeofcloudDecision object, and contains all data required to deliver the flag rule. See Decide methods
decideAll

Returns decisions for all active (unarchived) flags for a user.
See Decide methods

decideForKeys

Returns a map of flag decisions for specified flag keys.
See [Decide methods])doc:decide-methods-javascript)

trackEvent

Tracks a conversion event (in other words, an action a user takes) for a user. Logs an error message if the specified event key doesn't match any existing events.
See Track Event

setForcedDecision

Forces a user into a specific variation.
See Set Forced Decision

getForcedDecision

Returns what variation the user was forced into.
See Get Forced Decision

removeForcedDecision

Removes a user from a specific forced variation.
See Remove Forced Decision

removeAllForcedDecisions

Removes a user from all forced variations.
See Remove All Forced Decisions