{"_id":"55ee660b51ee721700b31575","parentDoc":null,"user":"55d2bd8e2463351700f67dd7","version":{"_id":"55e67aab9cc7c62b00c4a1ed","project":"55e67aaa9cc7c62b00c4a1ea","__v":10,"createdAt":"2015-09-02T04:27:23.612Z","releaseDate":"2015-09-02T04:27:23.612Z","categories":["55e67aac9cc7c62b00c4a1ee","55e67b5556007d23005fee7d","55e67b5dde6fef23009480ca","55e680efde6fef23009480db","55e6829485a9741900314e99","561c61b4ad272c0d00a892df","586c014c0abf1d0f000d04d4","58991d2ad207df0f0002186b","589b8e1fdbb7cd190026732c","58b8ca5e3265d70f001788d4"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"__v":4,"category":{"_id":"55e680efde6fef23009480db","project":"55e67aaa9cc7c62b00c4a1ea","version":"55e67aab9cc7c62b00c4a1ed","__v":3,"pages":["55ee660b51ee721700b31575","55ee661a1452cd0d009e5f96","561c4b191529740d00a70dd1"],"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-09-02T04:54:07.577Z","from_sync":false,"order":3,"slug":"messaging-your-users","title":"Messaging your users"},"project":"55e67aaa9cc7c62b00c4a1ea","updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-09-08T04:37:31.334Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"# Using Audience Builder\n\nMost of the time, you'll be creating Audiences with Audience Builder, which allows a very simple way to create complex selections from people in your app. \n\nInside, you can choose from a combination of User Attributes, Events and Location Data. On the righthand side, a summary and an estimate of the number of users that will be in that audience. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/xQ5QE6XhStaxzue0PBJD_Screen%20Shot%202015-10-13%20at%2012.08.59%20pm.png\",\n        \"Screen Shot 2015-10-13 at 12.08.59 pm.png\",\n        \"2176\",\n        \"1168\",\n        \"\",\n        \"\"\n      ],\n      \"caption\": \"Example of a combination of many attributes forming an audience\"\n    }\n  ]\n}\n[/block]\n# On the Fly\n\nThe [Notifications API](doc:notifications) allows you to create on-the-fly audiences (in other words, audiences that are not defined in Audience Builder) when sending a notification. These audiences are transient and don't persist between requests. To learn more, see the examples in the [Notifications API](doc:notifications) reference.\n\n# Via CSV\n\nIf you are [capturing User IDs](https://docs.carnival.io/docs/collecting-user-data#setting-a-user-id) in the app, you can upload a list of User IDs as a CSV (one ID per row) to create an audience segment. After you upload the CSV, we match CSV users with your installed base and we add a flag to a user profile if there's a match. This way you can target all users who belong to a specific upload or to subsequent uploads.\n\nYou can easily update an imported audience by always specifying the same audience name. In this case, Carnival will append new users to the last upload.","excerpt":"Segment your users into Audiences for sending targeted messages","slug":"create-an-audience-segment","type":"basic","title":"Create an Audience Segment"}

Create an Audience Segment

Segment your users into Audiences for sending targeted messages

# Using Audience Builder Most of the time, you'll be creating Audiences with Audience Builder, which allows a very simple way to create complex selections from people in your app. Inside, you can choose from a combination of User Attributes, Events and Location Data. On the righthand side, a summary and an estimate of the number of users that will be in that audience. [block:image] { "images": [ { "image": [ "https://files.readme.io/xQ5QE6XhStaxzue0PBJD_Screen%20Shot%202015-10-13%20at%2012.08.59%20pm.png", "Screen Shot 2015-10-13 at 12.08.59 pm.png", "2176", "1168", "", "" ], "caption": "Example of a combination of many attributes forming an audience" } ] } [/block] # On the Fly The [Notifications API](doc:notifications) allows you to create on-the-fly audiences (in other words, audiences that are not defined in Audience Builder) when sending a notification. These audiences are transient and don't persist between requests. To learn more, see the examples in the [Notifications API](doc:notifications) reference. # Via CSV If you are [capturing User IDs](https://docs.carnival.io/docs/collecting-user-data#setting-a-user-id) in the app, you can upload a list of User IDs as a CSV (one ID per row) to create an audience segment. After you upload the CSV, we match CSV users with your installed base and we add a flag to a user profile if there's a match. This way you can target all users who belong to a specific upload or to subsequent uploads. You can easily update an imported audience by always specifying the same audience name. In this case, Carnival will append new users to the last upload.