Attributes

Attributes are key-value pairs attached to members. They enable targeting, segmentation, and personalisation of ad delivery. Each attribute has a key (a string identifier defined in the attribute schema) and a typed value.

Setting Attributes

Set one or more attributes on a member in a single request using the set endpoint. If an attribute already exists, it is overwritten with the new value. Attributes not included in the request are left unchanged.

{
  "member_base_id": "base_abc123",
  "ref": "user_001",
  "attributes": {
    "tier": "gold",
    "lifetime_spend": 2500,
    "interests": ["electronics", "outdoor"]
  }
}

Attribute changes take effect immediately for subsequent delivery decisions. There is no delay between setting an attribute and it being available for targeting rules.

Use Cases

• Segmentation: Group members by tier, location, or behaviour
• Targeting: Deliver ads based on attribute values (e.g., show premium offers to gold-tier members)
• Personalisation: Tailor creative content using attribute data

Listing and Deleting

• List all attributes for a member to inspect their current state
• Delete specific attribute keys when they are no longer relevant

Relationship to Attribute Schema

Attributes must conform to the attribute schema defined for the memberbase. The schema defines which keys are valid and their expected types. Only attributes matching the schema can be set on members. See the Attribute Schema page for details.