{"_id":"561c8067be5c860d007bc1cf","user":"55d29988486de50d00327118","__v":3,"project":"561c70aabe5fb20d00077758","category":{"_id":"561c726bf0e0580d00ddd9a4","pages":["561c8067be5c860d007bc1cf"],"project":"561c70aabe5fb20d00077758","version":"561c70aabe5fb20d0007775b","__v":1,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-10-13T02:54:35.490Z","from_sync":false,"order":3,"slug":"audiences-segmentation","title":"Audiences (Segmentation)"},"version":{"_id":"561c70aabe5fb20d0007775b","__v":6,"project":"561c70aabe5fb20d00077758","createdAt":"2015-10-13T02:47:06.824Z","releaseDate":"2015-10-13T02:47:06.824Z","categories":["561c70abbe5fb20d0007775c","561c725c4b0a9b0d00c0f515","561c7260cd5e7b0d00eb48c6","561c726bf0e0580d00ddd9a4","561c7271d2fb350d004bf89a","564de219b5bea52b00c3457a"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-10-13T03:54:15.375Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"[block:html]\n{\n  \"html\": \"<style>.embed-container { position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden; max-width: 100%; } .embed-container iframe, .embed-container object, .embed-container embed { position: absolute; top: 0; left: 0; width: 100%; height: 100%; }</style><div class='embed-container'><iframe src='https://player.vimeo.com/video/104629220' frameborder='0' webkitAllowFullScreen mozallowfullscreen allowFullScreen></iframe></div>\"\n}\n[/block]\nAudiences are a great way for you to create re-usable segments of your mobile users, which you can later target or analyze.  There are endless ways to segment your audience, but common ways include:\n\n* Users who haven't used your apps in the last 7 days\n* Users who have purchased an in-app subscription or performed a certain action\n* Users who have recently installed the app\n* Users from a particular city or area\n\n## Creating Audiences\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/1cRHm3zsQi63wdGNnd4E_audience-list.png\",\n        \"audience-list.png\",\n        \"1678\",\n        \"577\",\n        \"#30a3ec\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nThe audience tab contains a list of audiences which you will have previously created, allowing you to reuse them for targeting and analyzing.  To create an audience, click on the \"Create\" button in the top navigation bar under the Audiences tab.\n\nYou can create a highly customized Audience based on device attributes, and user behaviors, and location. \n\n### By Behaviors\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/Og4xiR9UQoOAamBpjjSs_Screen%20Shot%202015-10-13%20at%204.48.31%20pm.png\",\n        \"Screen Shot 2015-10-13 at 4.48.31 pm.png\",\n        \"1206\",\n        \"645\",\n        \"#202729\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nThe create Audience dialog has a set of attributes and behaviors which allow you to filter down your segment based on device specific information, such as:\n\n* Locale\n* Timezone\n* App Version\n* OS Version\n* Hardware Type\n* Install Time\n* Last Opened\n\n#### By Attributes\n\nCustom Attributes offer great flexibility when you need to segment your audience. They come in the form of <i>some thing</i> has <i>some value</i>. This lets you define values you can expect from your users and then target based on those values.\n\nFor example:\n\n* Max Budget : 50,000\n* Birthday : 3rd of December 1992\n* Average Score : 4.32\n* Current Level : 51\n* Twitter Handle : :::at:::CarnivalMobile\n\nYou can segment with values that are words (strings), but more flexibility is available with ranges. For example:\n\n* Send all users over level 50 a custom message (Current Level is greater than 50)\n* Send a message to all millennials about something (Birthday is between 1980 and 2004)\n\nRanges can be less than, greater than and in between. Setting these attributes are simple for a developer and you can learn how [here](/developers/advanced/current/audience-segmentation-custom-attributes/).\n\n\n\n### By Location\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/kKMJ2qILSNGirDErtiLJ_Screen%20Shot%202015-10-13%20at%204.49.08%20pm.png\",\n        \"Screen Shot 2015-10-13 at 4.49.08 pm.png\",\n        \"1209\",\n        \"649\",\n        \"#09b6ee\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nThe Location interface allows you to filter your Audience based on where your users are.  You are able to create polygons on various areas of the map, for maximum accuracy around the city or area you are targeting. \n\nAll 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. \n\n### By CSV\n\nIn 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.\n\nOnce 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. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/asOP7N9gRj63Xx8JHpgt_upload-csv.png\",\n        \"upload-csv.png\",\n        \"642\",\n        \"333\",\n        \"#294454\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nWhen 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.\n\nCSV file specs:\n\n* File must be saved with the .CSV extension\n* First column must include a list of unique User Identifiers on each row\n* Information in columns outside of the first column will not be uploaded\n* Header row is not necessary\n\nSee our Sample CSV below:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"example_user_1@example.com\\nexample_user2@example.com\\nexample_user3@example.com\\nexample_user4@example.com\",\n      \"language\": \"text\",\n      \"name\": \"CSV\"\n    }\n  ]\n}\n[/block]\nPlease 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). \n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Ensure you send User IDs\",\n  \"body\": \"To support this feature, you need to ensure that you are sending a [User ID](http://docs.carnival.io/docs/collecting-user-data#setting-a-user-id) to Carnival from your app.\"\n}\n[/block]\nFor each imported audience, we will add a flag named `Imported_File_Upload_AUDIENCE_NAME` (where `AUDIENCE_NAME` is the name you chose) to each user on the list who is present in your current installed base. We will add the field only to matching users, so that you can exclude users not originally on the list, or target users who match multiple imported audiences.","excerpt":"","slug":"introduction-to-audiences","type":"basic","title":"Introduction to Audiences"}

Introduction to Audiences


[block:html] { "html": "<style>.embed-container { position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden; max-width: 100%; } .embed-container iframe, .embed-container object, .embed-container embed { position: absolute; top: 0; left: 0; width: 100%; height: 100%; }</style><div class='embed-container'><iframe src='https://player.vimeo.com/video/104629220' frameborder='0' webkitAllowFullScreen mozallowfullscreen allowFullScreen></iframe></div>" } [/block] Audiences are a great way for you to create re-usable segments of your mobile users, which you can later target or analyze. There are endless ways to segment your audience, but common ways include: * Users who haven't used your apps in the last 7 days * Users who have purchased an in-app subscription or performed a certain action * Users who have recently installed the app * Users from a particular city or area ## Creating Audiences [block:image] { "images": [ { "image": [ "https://files.readme.io/1cRHm3zsQi63wdGNnd4E_audience-list.png", "audience-list.png", "1678", "577", "#30a3ec", "" ] } ] } [/block] The audience tab contains a list of audiences which you will have previously created, allowing you to reuse them for targeting and analyzing. To create an audience, click on the "Create" button in the top navigation bar under the Audiences tab. You can create a highly customized Audience based on device attributes, and user behaviors, and location. ### By Behaviors [block:image] { "images": [ { "image": [ "https://files.readme.io/Og4xiR9UQoOAamBpjjSs_Screen%20Shot%202015-10-13%20at%204.48.31%20pm.png", "Screen Shot 2015-10-13 at 4.48.31 pm.png", "1206", "645", "#202729", "" ] } ] } [/block] The create Audience dialog has a set of attributes and behaviors which allow you to filter down your segment based on device specific information, such as: * Locale * Timezone * App Version * OS Version * Hardware Type * Install Time * Last Opened #### By Attributes Custom Attributes offer great flexibility when you need to segment your audience. They come in the form of <i>some thing</i> has <i>some value</i>. 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 simple for a developer and you can learn how [here](/developers/advanced/current/audience-segmentation-custom-attributes/). ### By Location [block:image] { "images": [ { "image": [ "https://files.readme.io/kKMJ2qILSNGirDErtiLJ_Screen%20Shot%202015-10-13%20at%204.49.08%20pm.png", "Screen Shot 2015-10-13 at 4.49.08 pm.png", "1209", "649", "#09b6ee", "" ] } ] } [/block] The Location interface allows you to filter your Audience based on where your users are. You are able to create polygons on various areas of the map, for maximum accuracy around the city or area you are targeting. 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 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. 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. [block:image] { "images": [ { "image": [ "https://files.readme.io/asOP7N9gRj63Xx8JHpgt_upload-csv.png", "upload-csv.png", "642", "333", "#294454", "" ] } ] } [/block] 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 See our Sample CSV below: [block:code] { "codes": [ { "code": "example_user_1@example.com\nexample_user2@example.com\nexample_user3@example.com\nexample_user4@example.com", "language": "text", "name": "CSV" } ] } [/block] 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). [block:callout] { "type": "info", "title": "Ensure you send User IDs", "body": "To support this feature, you need to ensure that you are sending a [User ID](http://docs.carnival.io/docs/collecting-user-data#setting-a-user-id) to Carnival from your app." } [/block] For each imported audience, we will add a flag named `Imported_File_Upload_AUDIENCE_NAME` (where `AUDIENCE_NAME` is the name you chose) to each user on the list who is present in your current installed base. We will add the field only to matching users, so that you can exclude users not originally on the list, or target users who match multiple imported audiences.