Last modified February 1, 2019 by Shelly Wolfe

Configuring event payloads

To properly capture the fine granularity of your target audience using payload targeting, you must first configure the events and payloads you want to use for targeting purposes. This article explains how to configure event payloads for audience targeting in your Swrve dashboard. If you need further assistance, contact your CSM at support@swrve.com. They will work with you to define the best schema for the events and payloads you want to use to target your users.


Prerequisites

To access Event Payload Configuration, you must have Manage permissions enabled in the App Admin activity group for your Swrve user role. For more information, see Managing Swrve user roles and permissions.

Custom events and payloads

Work with your development team to implement the custom events and payload values you want to use for targeting purposes. You can use a maximum of 10 events for payload targeting purposes, with a maximum of 10 payloads per event. Some flexibility is available if you need to use more than 10 events or payload, contact your CSM at support@swrve.com if required. For information on configuring custom events and payloads, see the related integration guide:

Date-type payloads

Our payload targeting system supports date filters, however you must specify the payload type as Date and make sure the payloads use ISO8601 format: YYYY-MM-DDTHH:MM:SS.000Z. For more information on how to implement custom DateTime user properties in your app, see the related integration guide:


Managing payload targeting events

To view and manage your app events that have been configured for payload targeting, on the Manage menu, select Event payload configuration.

Event payload configuration screen

Use the options available to configure a new event, enable or disable an event, edit the configuration of an event, or delete an event configuration. The Event Payload Configuration screen also displays the following details for each configured event:

Column Description
Name The event name, as implemented in your app.
Label A user-friendly label for the event, as it will appear in the User Behaviors section of the campaign audience builder.
Type The type of event, mainly a generic event that targets payload values, or a session_start event that targets recent session frequency.
Num. of Payloads The number of payloads configured for the event.
Status The current status of the event – draft or active.
Created at How long ago the event was configured for payload targeting.
Processing The current state of historical event processing.

Configuring event payloads

Complete the following steps to configure event payloads for your app:

Select events for configuration

Step 1: On the Event Payload Configuration screen, select Add Event.

Step 2: On the Configure Event for Payload Targeting screen, select the event you want to use for payload targeting:

  • Event name – select this box to display a list of your app’s custom events that Swrve has logged and then select the event you want to use. For example, search.flight.
  • Event label – enter a user-friendly label for the event as it will appear in the User Behaviors section of the campaign audience builder. For example, Flight search.
  • Event type – select an option for how you want to use this event:
    • event – use this event to target payload values.
    • session_start – use this event to target recent session frequency.

Step 3: To save the event and display the payload configuration screen, select Save Event.

Add event payloads

Edit event payload configuration

Step 1: To add a payload to your event, select Add Event Payload.

Configure event payload

Step 2: To display a list of payloads logged against the selected event, select the Payload name box, and then select the payload you want to configure. Once selected, a table appears displaying the values and counts that Swrve has received in the last 12 hours for that particular payload.

Payload values and counts

Step 3: In the Payload label box, enter a user-friendly label for the payload as it will appear in the User Behaviors section of the campaign audience builder.

Step 4: Select the Payload type – string, integer, date, or float. Use the table of payload values to help you to decide what is the most appropriate type (usually string). The payload type determines the operators that are available for filters on this payload in the audience builder.

Note: The value of any Date payload type is a date/timestamp in ISO8601 format in UTC:  YYYY-MM-DDTHH:MM:SS.000Z. This is the same format used for date-typed user properties.

Step 5: To add the payload to the event configuration, select Save Payload. To add additional payloads, complete steps 1 to 4 above as required.

Step 6: Once you’ve added the desired payloads, to save the event configuration, select Save & Exit.

Activate event to process payloads

Step 1: To activate an event for payload targeting, in the event row, select Enable.

Step 2: The Activate Event Payload Configuration screen displays details of all the payload values configured for the event.To confirm the activation, select Activate.

Activate event payload configuration

Once you activate the event payload configuration:

  • Going forward, any new events and payload values matching this configuration that Swrve logs are streamed into the payload targeting system and available for audience filtering.
  • The Processing status changes to Aggregating Historical Data and Swrve starts reprocessing all historical data for the app to find any earlier events and payload values matching the configuration. Once the events are reprocessed they are also available for targeting and filtering audiences. Depending on the app size, it may take several hours to process the volume of data. When the Processing status is Up to date, all event payloads are available for targeting in the campaign audience builder.

Audience filter with event payloads


Targeting session recency

If you want to target the recent frequency of sessions, for example, “users with at least five sessions in the last 30 days”, in the Event name box, select the Swrve.session.start event and set the Event type as session_start.

Session start event payload configuration

You do not need to include any payloads. To make the session start event available for audience targeting, save and activate the event as described above.

Target session recency


Next steps

Learn how to use event payloads to fine-tune your target campaign audiences. For more information, see Targeting your audience by event payloads.