Objects

Not to be confused with JSON objects, an Object is a way to group people, like an account that people belong to, online courses that people enroll in, or recreational leagues that people can join.

This page covers object types and objects. Object types are the kinds of non-people things that you want to track in Customer.io—like companies, online classes, accounts, etc. An object is an individual thing—a single company, online class, or account—that you want to relate to one or more people.

 Check out our plans and how we bill to learn more about object pricing.

How it works

Objects let you group and relate data to people in your workspace, like accounts that people belong to, flights they’ve booked, or online courses they’ve enrolled in. Objects show up in the menu under People.

The left hand nav is collapsed and the object icon is highlighted underneath the people icon. On the main page, you see a list of objects in a table, each representing a company.
The left hand nav is collapsed and the object icon is highlighted underneath the people icon. On the main page, you see a list of objects in a table, each representing a company.

Each object has its own attributesA key-value pair that you associate with a person or an object—like a person’s name, the date they were created in your workspace, or a company’s billing date etc. Use attributes to target people and personalize messages. Attributes are analogous to traits in Data Pipelines. that you can use with liquidA syntax that supports variables, letting you personalize messages for your audience. For example, if you want to reference a person’s first name, you might use the variable {{customer.first_name}}. to personalize messages.

For example, you might message administrators of accounts to notify them when their accounts upgrade their plans. Without objects, you’d need to set attributes or send an event for every individual member of the account. But with objects, you can handle this one-to-many relationship the easy way.

flowchart LR subgraph Account direction LR b[Admin Angela] c[Admin Oscar] d[Staff Kevin] end Account-->|plan is equal to premium|e[Send a campaign to
admins of accounts] e-->f[Send message
to Angela] e-->g[Send message
to Oscar]

Quick Start

If you’re ready to try things out right away, here are the high points:

  1. Go to Custom Objects in the side menu to get started.
  2. Create an object type.
  3. Create one or more objects.
  4. Relate your objects to people.
  5. Trigger campaigns based on changes to objects or relationships.
    1. Check out how to reference objects in liquid.

You can also segment users by their relationships to objects.

Copied to clipboard!
  Contents
Is this page helpful?