Skip to main content

Create a new key momentt

POST 

/key-moments

Create a new key moment with the given parameters

Request

Body

required

    audienceTracking boolean

    Indicates if the key moment is used for audience

    conditionsData

    object

    Conditions by which visitors will be segmented

    firstLevel

    object[]

    First level conditions. Every level can have many conditions inside. E.g. we have 'firstLevelOrOperators' = [true], 'firstLevel'=[{OrOperators:[false], conditions: [SKY_STATUS, DAY_NIGHT]}, {OrOperators:[true], conditions: [PAGE_TITLE, NEW_VISITORS]}]. Then the expression will look like (SKY_STATUS AND DAY_NIGHT) OR (PAGE_TITLE OR NEW_VISITORS)

  • Array [

  • conditions

    object[]

    Add conditions (see TargetingConditionIO) to define a segment. The more conditions you add, the more precise your segment will be.

  • Array [

  • oneOf

    Includes or excludes visitors according to the time elapsed since the beginning of the session

    targetingType stringrequired

    Targeting condition type. According to this field it's necessary to add some additional fields

    Possible values: [PAGE_URL, PAGE_TITLE, LANDING_PAGE, ORIGIN, ORIGIN_TYPE, REFERRERS, NEW_VISITORS, BROWSER_LANGUAGE, GEOLOCATION, DEVICE_TYPE, SCREEN_DIMENSION, VISITOR_IP, AD_BLOCKER, PREVIOUS_PAGE, KEY_PAGES, PAGE_VIEWS, FIRST_VISIT, LAST_VISIT, ACTIVE_SESSION, TIME_SINCE_PAGE_LOAD, SAME_DAY_VISITS, VISITS, VISITS_BY_PAGE, INTERNAL_SEARCH_KEYWORDS, TABS_ON_SITE, HEAT_SLICE, SKY_STATUS, TEMPERATURE, DAY_NIGHT, FORECAST_SKY_STATUS, FORECAST_TEMPERATURE, DAY_OF_WEEK, TIME_RANGE, HOUR_MINUTE_RANGE, JS_CODE, COOKIE, EVENT, EXPLICIT_TRIGGER, BROWSER, OPERATING_SYSTEM, DOM_ELEMENT, MOUSE_OUT, TARGET_EXPERIMENT, TARGET_PERSONALIZATION, EXCLUSIVE_EXPERIMENT, CONVERSIONS, CUSTOM_DATUM, YSANCE_SEGMENT, YSANCE_ATTRIBUT, TEALIUM_BADGE, TEALIUM_AUDIENCE, PRICE_OF_DISPLAYED_PAGE, NUMBER_OF_VISITED_PAGES, VISITED_PAGES, SEGMENT, KEY_MOMENT, CUSTOM, SDK_LANGUAGE, VISITOR_CODE, EXCLUSIVE_FEATURE_FLAG, TARGET_FEATURE_FLAG, APPLICATION_VERSION]

    weight int32required

    More important conditions have greater values. Default value: 1

    Example: 1
    count int32

    Count of time elapsed since session became active according to the 'unitOfTime' field

    include boolean

    Should visitors who match to the condition be included to or excluded from the segment. Default value: 'true'

    matchType string

    How to match the specified amount of time

    Possible values: [EQUAL, LOWER, GREATER]

    unitOfTime string

    What unit of measurements will be used to define if sessions are active for the required duration

    Possible values: [SECOND, MINUTE, HOUR, DAY]

  • ]

  • orOperators boolean[]

    Array of booleans ("or"=true, "and"=false) for binding conditions of second level.

  • ]

  • firstLevelOrOperators boolean[]

    Array of booleans ("or"=true, "and"=false) for binding firstLevel outer conditions.

    description string

    Description of the key moment

    Example: The key moment is for new ab tests
    isFavorite boolean

    Indicates whether the key moment is marked as a favorite.

    name stringrequired

    Name of the key moment

    Example: My Key Moment
    siteId int64required

    Unique identifier for the site where the key moment was, or will be created.

    Example: 8372

Responses

Created

Schema

    audienceTracking boolean

    Indicates if the key moment is used for audience

    audienceTrackingEditable boolean

    This flag shows if audienceTracking can be enabled or disabled. In some cases,audienceTracking can't be disabled. E.g. If a key moment has predictive conditions,it will be tracked by default.

    conditionsData

    object

    Conditions by which visitors will be segmented

    firstLevel

    object[]

    First level conditions. Every level can have many conditions inside. E.g. we have 'firstLevelOrOperators' = [true], 'firstLevel'=[{OrOperators:[false], conditions: [SKY_STATUS, DAY_NIGHT]}, {OrOperators:[true], conditions: [PAGE_TITLE, NEW_VISITORS]}]. Then the expression will look like (SKY_STATUS AND DAY_NIGHT) OR (PAGE_TITLE OR NEW_VISITORS)

  • Array [

  • conditions

    object[]

    Add conditions (see TargetingConditionIO) to define a segment. The more conditions you add, the more precise your segment will be.

  • Array [

  • oneOf

    Includes or excludes visitors according to the time elapsed since the beginning of the session

    htmlDescription string

    Html readable description of the targeting condition

    id int64

    Unique identifier

    targetingType stringrequired

    Targeting condition type. According to this field it's necessary to add some additional fields

    Possible values: [PAGE_URL, PAGE_TITLE, LANDING_PAGE, ORIGIN, ORIGIN_TYPE, REFERRERS, NEW_VISITORS, BROWSER_LANGUAGE, GEOLOCATION, DEVICE_TYPE, SCREEN_DIMENSION, VISITOR_IP, AD_BLOCKER, PREVIOUS_PAGE, KEY_PAGES, PAGE_VIEWS, FIRST_VISIT, LAST_VISIT, ACTIVE_SESSION, TIME_SINCE_PAGE_LOAD, SAME_DAY_VISITS, VISITS, VISITS_BY_PAGE, INTERNAL_SEARCH_KEYWORDS, TABS_ON_SITE, HEAT_SLICE, SKY_STATUS, TEMPERATURE, DAY_NIGHT, FORECAST_SKY_STATUS, FORECAST_TEMPERATURE, DAY_OF_WEEK, TIME_RANGE, HOUR_MINUTE_RANGE, JS_CODE, COOKIE, EVENT, EXPLICIT_TRIGGER, BROWSER, OPERATING_SYSTEM, DOM_ELEMENT, MOUSE_OUT, TARGET_EXPERIMENT, TARGET_PERSONALIZATION, EXCLUSIVE_EXPERIMENT, CONVERSIONS, CUSTOM_DATUM, YSANCE_SEGMENT, YSANCE_ATTRIBUT, TEALIUM_BADGE, TEALIUM_AUDIENCE, PRICE_OF_DISPLAYED_PAGE, NUMBER_OF_VISITED_PAGES, VISITED_PAGES, SEGMENT, KEY_MOMENT, CUSTOM, SDK_LANGUAGE, VISITOR_CODE, EXCLUSIVE_FEATURE_FLAG, TARGET_FEATURE_FLAG, APPLICATION_VERSION]

    weight int32required

    More important conditions have greater values. Default value: 1

    Example: 1
    count int32

    Count of time elapsed since session became active according to the 'unitOfTime' field

    include boolean

    Should visitors who match to the condition be included to or excluded from the segment. Default value: 'true'

    matchType string

    How to match the specified amount of time

    Possible values: [EQUAL, LOWER, GREATER]

    unitOfTime string

    What unit of measurements will be used to define if sessions are active for the required duration

    Possible values: [SECOND, MINUTE, HOUR, DAY]

  • ]

  • orOperators boolean[]

    Array of booleans ("or"=true, "and"=false) for binding conditions of second level.

  • ]

  • firstLevelOrOperators boolean[]

    Array of booleans ("or"=true, "and"=false) for binding firstLevel outer conditions.

    createdBy int64

    Account id of the creator of the key moment

    dateCreated date-time
    dateModified date-time
    description string

    Description of the key moment

    Example: The key moment is for new ab tests
    id int64

    Unique identifier of a key moment

    isFavorite boolean

    Indicates whether the key moment is marked as a favorite.

    name stringrequired

    Name of the key moment

    Example: My Key Moment
    siteId int64required

    Unique identifier for the site where the key moment was, or will be created.

    Example: 8372
Loading...