Creating Mobile App Audiences

The Audience page in Carnival displays the list of audiences–or segments–which you have previously created. Once you create an audience you can reuse it for targeting and analytics.

62 06_04 Audience Page

1. There are two methods by which to create a new Audience:

  • Click Import CSV and choose the file you will use to create a new audience. Note: the first column for each row should be a user_id. See the By CSV section below for more details.
  •  Click the Create Audiences button in the top navigation bar on the Audiences page to launch the Create Audiences window.

From this window, you can create a highly customized audience based:

  • User device attributes
  • User behaviors
  • Location

2. When you select filters for your audience, these will be listed under Active Filters on the right side of the screen. Also listed here will be the total number of users in the audience based on the filters you’ve chosen. Note: Creating an audience without any filters will pull in all users to the new audience.

3. Once you complete selecting the filters for your audience, use the enter the Audience Name in the lower right and click Save to create your audience.

63 06_04 Create New Audience

User Device Attributes

The Device Attributes options allow you to create an audience based on a range of factors.

Attribute

Definition

Platform

The operating system (OS) of the device (i.e. iOS or Android).

App Version

The version of your app that the user has installed.

Locale

The geographic locale of the device.

Language

The language setting for the device.

Custom Attributes

Custom meta data, such as birthday, passed to Carnival.

Note: This is akin to custom profile fields (variables or vars) in Sailthru.

Device Alias

The alias set on a device in the Device Logs.

Timezone

The global time zone in which the device is located in.

A/B Testing Group

Groups which you can use to target different content to measure performance.

Note: Each Group is a random 10% of your audience. To run a 50:50 message performance test, create two audiences — one with Groups A, B, C, D, and E filtered and the second with Groups F, G, H, I, and J.

Device ID

The unique Carnival alpha-numeric identifier assigned to each device.

Device Model

The model of the device a user is user.

Push Enabled

Whether or not iOS device is push enabled.

Development Mode

Filter for devices set to “Development” from within the Device Logs.

OS Name

The name of the OS currently running on the device.

OS Version

The version of the OS currently running on the device.

SDK Version

The SDK version running the app on the device.

User ID

The custom user_id being set on the device.

By Location

The Location interface allows you to filter your Audience based on where your users are. You can target by Country or set specific areas on the Map tab.

The Map features allows you to create polygons on specific geographic areas of the map, for maximum accuracy around the city, state or area you are targeting. Alternatively, you can target a specific country based on the Carnival-tracked geo-data.

Note: By default, location is tracked by IP address. Other options include via GPS and iBeacons. For more information, see Using Location Tracking. Saithru’s location API also supports point and radius targeting.

64 06_04 Audience-Location Targeting Polygon

All targeting attributes can be combined together. All attributes are required, and if you want to exclude one, you may select “IS NOT” from the drop down. Combining uses of “IS” and “IS NOT” will let you target with even more power.

By Behaviors

Creating audiences based on user behaviors is a helpful to make messages specifically relevant to past actions of the user. For example, you can create an audience based on Last Opened App to regularly message with incentives, such as a sales or breaking news, to prompt these users to open the app.

Attribute

Definition

First Installed

The date on which the app was first installed.

Last Opened

The date on which the app was last opened.

Events

Events may be chosen from predefined common events or customized based on your app and marketing needs. See the section below on Custom Attributes.

Data from other analytics platforms, including Adobe Analytics and Google Analytics, can be passed to Carnival to set up audiences.

Examples:

  • Favorited item
  • Abandoned shopping cart
  • Shopped sale
  • Viewed item
  • Watched video
  • Adobe Analytic
  • Created Account
  • Read Article
  • Localytics
  • Shared item
  • Subscribed
  • Google Analytics: Shared Article
  • Mixpanel: Saved Article

By Custom Attributes

Custom Attributes offer great flexibility when you need to segment your audience. This lets you define values you can expect from your users and then target based on those values.

For example:

      • Max Budget : 50,000
      • Birthday : 3rd of December 1992
      • Average Score : 4.32
      • Current Level : 51
      • Twitter Handle : @CarnivalMobile

You can segment with values that are words (strings), but more flexibility is available with ranges. For example:

      • Send all users over level 50 a custom message (Current Level is greater than 50)
      • Send a message to all millennials about something (Birthday is between 1980 and 2004)

Ranges can be less than, greater than and in between. Setting these attributes are easy for a developer. For more information, please see our developer documentation.

By CSV

In addition to creating audiences through the Audience Builder, you can also create audiences by uploading a list of User Identifiers that you created outside of Carnival. You can now analyze and group your users in another platform, such as your CRM, Excel, or external analytics provider, and upload this list to Carnival’s Audience Builder via a CSV file.

Note: To take advantage of the option to create an audience by uploading a CSV, the CSV must include a User ID. As a best practice, always set up apps to pass a User ID. If the user_id does not exist in your app, it will not appear in the audience.

Once your CSV-created audience is uploaded, it will act as a segmentation filter like a Custom Attribute inside the Audience Builder. This means you can you can target your CSV-created audience even further – such as by geo-location or language.

66 06_04 Audience Upload CSV Dialog

When should you create an audience through CSV? When you know something about a group of users that doesn’t come from your mobile app or can’t be synced through our APIs, CSV upload is a great option. For example, use CSV upload if you’d like to retarget users who clicked a link in an email, but you don’t have a tech solution to push this info automatically to Carnival.

CSV file specs:

      • File must be saved with the .CSV extension
      • First column must include a list of unique User Identifiers on each row
      • Information in columns outside of the first column will not be uploaded
      • Header row is not necessary

The first column of your CSV would look like this example:

example_user_1@example.com
example_user2@example.com
example_user3@example.com
example_user4@example.com

Please note that the number of users that appear in the CSV-created Carnival audience may differ from the number of unique User Identifiers in your CSV list. Why? Your CSV list may include users who have not downloaded the app (making your Audience count smaller), or a User Identifier may be associated with more than one user device, like an iPhone and iPad, which Carnival registers as 2 Audience members (increasing the size of your Audience).

Note: To support this feature, you need to ensure that you are sending a User ID to Carnival from your app.  If the userID exists in Carnival, the device will be added to the audience. if the userID does not exist, the device will not be added to the audience.

Sailthru Lists

If you’re also a Sailthru user, you can take advantage of Lists that you’ve created in Sailthru and set up the List as an Audience.

65 06_04 Audience-Sailthru option

Top