Filtering and mapping actions

Updated

How it works

Each destination has a list of available actions. An action is how we map source data to your destination. In most cases, the defaults are all you’ll ever need.

But you might want to add additional action filters or change the values we map to various events to change when we send data to your destination or fine-tune the data that we send with each action.

You can toggle actions on and off and change the data structure for actions in your destination’s Actions tab.

toggle actions on and off and change mappings
toggle actions on and off and change mappings

Here’s a quick demonstration showing how actions work and how easy it is to change actions to fit your needs.

Source API calls map to Actions

API calls come in from your sources. If they match the Trigger and Filter for your destination, we’ll perform an action that sends data to your destination.

flowchart LR a(source event)-->b{Does it match a
destination trigger} b-->|yes|c(Map data to
destination) b-.->|no|d(Event is not
forwarded to destination)

Actions have a few properties.

  • Action/Type: the type of action we’ll perform at the destination.
  • Filter/Trigger: the criteria that source events must match to trigger the action
  • Mappings: the data that we map from your source data to the destination.

Changing action mappings

Again, you’ll generally want to use our default actions and mappings. But, when you set up a destination, you can go to the Actions tab and enable or disable actions. You can also click to change the way we map values to actions.

 Be careful when editing Customer.io Journeys destination’s actions

The Customer.io Journeys destination is how data gets into Customer.io—the people, events, and other data that you’ll use to send messages to your audience. It’s already configured with actionsThe source event and data that triggers an API call to your destination. For example, an incoming identify event from your sources adds or updates a person in our Customer.io Journeys destination. to support incoming data from your sources. You can edit these actions if you want to change how we handle incoming data, but take care not to inadvertently break integrations with Customer.io.

When should I change triggers?

Changing a trigger determines when we send data to your destination. You might want to change a trigger to limit when we send data to your destination.

For example, many destinations have an some type of “Identify User” action that occurs whenever you pass an identify call. If your destination relies on an email trait, you might change the filter so that you only send identify calls when the call contain an email trait.

the filter field within an action lets you choose the trigger(s) for an action
the filter field within an action lets you choose the trigger(s) for an action

When should I change data structure mapping?

You’ll want to change the data structure of an action when your source data doesn’t naturally map to your destination. For example, you may want to add additional traitsInformation that you know about a person, captured from identify events in Data Pipelines. Traits are analogous to attributes in Customer.io Journeys. that you always capture in identify calls from sources.

For example, if your destination expects a phone number, and your source always captures an imei trait, you may want to add a new mapping that sends traits.imei to phone.

map properties in the source event to your destination
map properties in the source event to your destination
Copied to clipboard!
  Contents
Is this page helpful?