1. REST API for Oracle Commerce Cloud 21C
  2. Tasks
  3. Admin
  4. Audiences

createAudience

post

/ccadmin/v1/audiences

Create Audience. This operation is used to create a new Audience in Oracle Commerce Cloud.

Request

Supported Media Types
Body ()
Root Schema : createAudience_request
Type: object
Show Source
  • The Audience description.
  • The display name for the Audience.
  • Indicates if this audience is enabled. Defaults to true.
  • The ID for the Audience. Can only contain the characters A-Z,a-z,0-9.
  • ruleSet
    The rule set for the Audience.
  • Indicates if this audience will be used in reporting. Defaults to false.
  • The type of visitors the audience allows. visitorType must be one of the following: "ANONYMOUS" (users not authenticated or soft logged in), "RECOGNIZED" (users that logged in before but, have not been authenticated in the current session), "AUTHENTICATED" (logged in users), "ANONYMOUS_OR_RECOGNIZED", "ANONYMOUS_OR_AUTHENTICATED", "REGISTERED", or "ALL". These correspond to various combinations of the options that appear in the UI (ANONYMOUS, RECOGNIZED, and AUTHENTICATED) where "REGISTERED" means the user selected RECOGNIZED and AUTHENTICATED and "ALL" means the user selected all three options.
Example:
{
    "useInReports":"false",
    "displayName":"Audience 1",
    "visitorType":"REGISTERED",
    "ruleSet":{
        "rules":[
            {
                "property":"user.gender",
                "category":"profile",
                "value":"male",
                "operator":"eq"
            },
            {
                "property":"lastPurchaseDate",
                "category":"profile",
                "value":{
                    "unit":"months",
                    "start":"now",
                    "interval":-3
                },
                "operator":"lt"
            },
            {
                "property":"numberOfOrders",
                "category":"profile",
                "value":[
                    5,
                    10
                ],
                "operator":"isBetween"
            },
            {
                "property":"audienceList",
                "category":"internalAudiences",
                "value":[
                    "audience2",
                    "audience3"
                ],
                "operator":"includesAny"
            }
        ],
        "operator":"all"
    },
    "description":"blah blah blah",
    "id":"audience1",
    "enabled":"true"
}
Nested Schema : ruleSet
Type: object
The rule set for the Audience.
Show Source
Nested Schema : rules
Type: array
The array of rules that make up the rule set.
Show Source
Nested Schema : items
Type: object
Show Source
  • The category of the property, i.e. the user profile.
  • The operator applied to the rule property.
  • The property to be evaluated.
  • The value used to compare against the property value to determine the rule result. Values can be strings, integers, doubles, floats, JSON objects or JSON arrays depending on the operator and how the property was described in the audienceRuleProperty endpoint. When mapping this field in Integration Cloud Service(ICS), the operators which expect string values alone can be used.
Back to Top

Response

Supported Media Types

200 Response

Following model is returned when operation succeeds.
Body ()
Root Schema : createAudience_response
Type: object
Show Source
Nested Schema : ruleSet
Type: object
The rule set for the Audience.
Show Source
Nested Schema : rules
Type: array
An array of rules that make up the rule set.
Show Source
Nested Schema : items
Type: object
Show Source
  • The category of the property, i.e. the user profile.
  • The operator applied to the rule property.
  • The property to be evaluated.
  • The value used to compare against the property value to determine the rule result. Values can be strings, integers, doubles, floats, JSON objects or JSON arrays depending on the operator and how the property was described in the audienceRuleProperty endpoint. When mapping this field in Integration Cloud Service(ICS), the operators which expect string values alone can be used.
Example Response (application/json)
{
    "useInReports":"false",
    "deleted":"false",
    "visitorType":"REGISTERED",
    "displayName":"Audience 1",
    "ruleSet":{
        "rules":[
            {
                "property":"user.gender",
                "category":"profile",
                "value":"male",
                "operator":"eq"
            },
            {
                "property":"lastPurchaseDate",
                "category":"profile",
                "value":{
                    "unit":"months",
                    "start":"now",
                    "interval":-3
                },
                "operator":"lt"
            },
            {
                "property":"numberOfOrders",
                "category":"profile",
                "value":[
                    5,
                    10
                ],
                "operator":"isBetween"
            },
            {
                "property":"audienceList",
                "category":"internalAudiences",
                "value":[
                    "audience2",
                    "audience3"
                ],
                "operator":"includesAny"
            }
        ],
        "operator":"all"
    },
    "description":"blah blah blah",
    "id":"audience1",
    "enabled":"true"
}

Default Response

The error response. The following are the internal error codes thrown by this API when the request processing fails in Oracle Commerce Cloud: |Error Code|Description| |------------------|------------------| |54020|The value of an enumList rule must be an array.| |54002|A non-empty audience name is required.| |54013|The audience rule set is missing a top level operator.| |54024|The audience ID must be 165 characters or less.| |54012|The JSON description of the rule set {0} is invalid.| |54023|Audience IDs must only contain the characters A-Z, a-z, and 0-9.| |54022|The audience ID already exists. Audience IDs must be unique.| |54021|A non-empty audience ID is required.| |54017|The rule set has valid JSON but a problem was encountered while translating to SGML.| |54016|Audience rule at index {0} is invalid.| |54004|An error occurred accessing audiences.| |54015|The audience rule set rules array is missing or invalid.| |54026|The audience description is too long.| |54003|The audience name already exists. Audience names must be unique.| |54014|The top level operator {0} must be either any or all.| |54025|The audience name is too long.| |54009|The audience repository was not initialized.| |54019|The operator {0} for an internalAudience rule must be either includesAny, notIncludesAny or includesAll.| |54018|The rule operator {0} is not supported. Rule operators must be one of the following: eq, ne, isOneOf, isNotOneOf, contains, containsIgnoreCase, startsWith, startsWithIgnoreCase, endsWith, endsWithIgnoreCase, includesAny, includesAll, notIncludesAny.| |54051|Rule {0} has invalid values. The first value for the "between" operator must be less than the second value.| |54049|Rule {0} has an invalid double value. Double values must be in the right format and between the max and min double values.| |54047|Rule {0} has an invalid float value. Float values must be in the right format and between the max and min float values.| |54050|Rule {0} has an invalid integer value. Integer values must be whole numbers between the max and min integer values.| |54106|Rule {0} has an invalid value. The value for a string must be less than or equal to 254 characters.| |54107|Rule {0} has an invalid value. The value for a rich text type must be less than or equal to 1000 characters.|
Body ()
Root Schema : errorModel
Type: object
Show Source
Nested Schema : errors
Type: array
An optional list of errors if multiple errors were encountered
Show Source
Nested Schema : items
Type: object
Show Source
Back to Top