diff --git a/_docs/_user_guide/data_and_analytics/tracking.md b/_docs/_user_guide/data_and_analytics/tracking.md index 4801847a195..0250af509b1 100644 --- a/_docs/_user_guide/data_and_analytics/tracking.md +++ b/_docs/_user_guide/data_and_analytics/tracking.md @@ -4,7 +4,7 @@ article_title: Tracking page_order: 5 layout: dev_guide guide_top_header: "Tracking" -guide_top_text: "You can track many actions on your apps. We recommend viewing the following articles to learn how to implement the tracking that best fits your use case." +guide_top_text: "You can track many user actions on your apps. We recommend viewing the following articles to learn how to implement the tracking that best fits your use case." page_type: landing description: "This landing page is home to resources on implementing tracking in your apps, such as open pixel and click tracking, uninstall tracking, influences opens, and segment analytics tracking." diff --git a/_docs/_user_guide/data_and_analytics/tracking/email_tracking.md b/_docs/_user_guide/data_and_analytics/tracking/email_tracking.md index c253d6d9be3..c79f45ecfc9 100644 --- a/_docs/_user_guide/data_and_analytics/tracking/email_tracking.md +++ b/_docs/_user_guide/data_and_analytics/tracking/email_tracking.md @@ -9,16 +9,16 @@ description: "This reference article covers how to implement open pixel and clic # Email open pixel and click tracking -> [Open pixel tracking][open_tracking] and click tracking can be disabled per user profile. This flexibility helps you follow regional privacy laws, where an individual user profile might indicate they no longer want to be tracked. +> [Open pixel tracking][open_tracking] and click tracking can be turned on or off for each user profile. This flexibility helps you follow regional privacy laws, where an individual user profile might indicate they no longer want to be tracked. -## Implementation +## Turning on open pixel or click tracking When either importing or updating a user profile via [API][api_doc] or [CSV][csv_doc], two fields are available for you to modify: -- `email_open_tracking_disabled` -- `email_click_tracking_disabled` +- `email_open_tracking_disabled`: Accepts `true` or `false`. Set to `false` to add the open tracking pixel to all future emails sent to this user. +- `email_click_tracking_disabled`: Accepts `true` or `false`. Set to `false` to add click tracking to all links within a future email, sent to this user. -For easy reference, this information is reflected on the user profile in the email **Contact Settings**, located in the **Engagement** tab. +For reference, this information is reflected on the user profile in the email **Contact Settings**, located in the **Engagement** tab. ![Email open and click tracking pixel fields on the Engagement tab of a user's profile][1]{: style="max-width:60%;"} diff --git a/_docs/_user_guide/data_and_analytics/tracking/influenced_opens.md b/_docs/_user_guide/data_and_analytics/tracking/influenced_opens.md index 61109595309..4a42cb7297b 100644 --- a/_docs/_user_guide/data_and_analytics/tracking/influenced_opens.md +++ b/_docs/_user_guide/data_and_analytics/tracking/influenced_opens.md @@ -3,24 +3,26 @@ nav_title: Influenced Opens article_title: Influenced Opens page_order: 7 page_type: reference -description: "This reference article explains Influenced Opens and how you can track them to provide a richer level of detail into your push campaigns." +description: "This reference article explains influenced opens and how you can track them to provide a richer level of detail into your push campaigns." channel: push --- # Influenced opens -> Push notifications are a good way to catch users' attention and increase engagement. Often that is through direct opens when users click on the notification and are sent to the app. However, the behavior of users who do not click the message may still be influenced by your push campaigns. Braze provides data on influenced opens to provide a richer level of detail into the effect of your push campaigns. +> When a user selects a push notification and is sent to your app, Braze logs it as a direct open. When users don't select the notification but may still be influenced by the push notification, Braze logs it as an influenced open. This provides a richer level of detail into the effect of your push campaigns. -At their base, influenced opens measure the number of users who open the app after receiving a notification without clicking on the notification. Because there is no direct action linking the notification to the app open, an influenced open is awarded if the user opens the app less than 30 minutes after receiving the push notification or under half the average time since the user's last session. +## How it works -For example, say you send a push to users of a messaging app, and you have a group of users who don't click through the notification. If a user who normally opens the app 30 times a day opens the app 6 hours after receiving the push, the push will get little to no credit for influencing the open. However, if a user who normally uses the app once a month opens the app 6 hours after receiving the push, the open would have a much better chance of being counted as an influenced open. +At their base, influenced opens measure the number of users who open the app after receiving a notification without selecting the notification. Because there is no direct action linking the notification to the app open, an influenced open is logged if the user opens the app less than thirty minutes after receiving the push notification or under half the average time since that user's last session. + +For example, say you send a push notification to your app users. If a user who normally opens the app 30 times a day opens your app six hours after receiving the push, the push gets little to no credit for influencing the open. However, if a user who normally uses the app once a month opens the app six hours after receiving the push, the open has a much better chance of being counted as an influenced open. This differs from setting app opens as a conversion event for a push campaign. For conversions, all opens within the conversion window will be attributed to the campaign. Influenced opens set a time window and attribution credit based on an individual user's behavior. -## Campaign details +## Viewing a campaign's influenced opens -Influenced opens are added to the direct opens of a campaign to give a number of total opens. This can be seen on a push campaign's **Details** page. Total opens and direct opens are shown in the **Message Performance** and **Historical Performance** sections. Influenced opens are the difference between the two measures. +Influenced opens are added to the direct opens of a campaign to give a number of total opens. This is displayed on a push campaign's **Campaign Analytics** page. Total opens and direct opens are shown in the message performance and **Historical Performance** sections. Influenced opens are the difference between the two measures. ![Influenced opens statistics on the Campaign Details page for a campaign][1] diff --git a/_docs/_user_guide/data_and_analytics/tracking/segment_analytics_tracking.md b/_docs/_user_guide/data_and_analytics/tracking/segment_analytics_tracking.md index 71c7839f84f..fcfa25c8ca3 100644 --- a/_docs/_user_guide/data_and_analytics/tracking/segment_analytics_tracking.md +++ b/_docs/_user_guide/data_and_analytics/tracking/segment_analytics_tracking.md @@ -3,7 +3,7 @@ nav_title: Segment Analytics Tracking article_title: Segment Analytics Tracking page_order: 8 page_type: reference -description: "This reference article covers Segment Analytics tracking and how to view revenue and purchases over time, sessions over time, and custom events over time." +description: "This reference article covers segment analytics tracking and how to view revenue and purchases over time, sessions over time, and custom events over time." tool: - Segments - Reports @@ -11,26 +11,34 @@ tool: # Segment analytics tracking -> When you turn on analytics tracking for a segment, you can view sessions, custom events, and revenue over time for this segment. +> When analytics tracking is turned on for a segment, you can view sessions, custom events, and revenue over time for that segment. -![Analytics tracking toggle for a segment][16] +If you don't turn analytics tracking on for a segment, you can still access [real-time statistics][11] for that segment and target its users with campaigns. The only difference is whether you can access the specific analysis tools mentioned on this page. + +## Turning on segment analytics -If you don't turn analytics tracking on for a segment, you can still access [real-time statistics][11] for that segment and target its users with campaigns. The only difference is the access to the specific analysis tools mentioned on this page. +In a segment's page **Segment Details** section, turn on **Analytics Tracking**. + +![Analytics tracking toggle for a segment][16] An app can have tracking turned on for up to 25 segments. Braze recommends tracking segments that are important for you to analyze when understanding your campaigns' effects on sessions, revenue, and purchases. -## Revenue and purchases over time +## Viewing revenue and purchases over time Go to **Analytics** > **Revenue Report** to view data on [revenue and purchases over time for this segment][14]. {% alert note %} -If you are using the [older navigation]({{site.baseurl}}/navigation), you can find **Revenue** under **Data**. +If you're using the [older navigation]({{site.baseurl}}/navigation), you can find **Revenue** under **Data**. {% endalert %} -To visually compare segment data for any custom time range, add or remove segments from the graph. Select **By Segment** and search for your segments to view them in the chart. Click any legend item to toggle visibility for that metric on or off. - ![Revenue data by segment][17] +To visually compare segment data for any custom time range, add or remove segments from the graph. Select **By Segment** in the **Breakdown** dropdown, and then select your segments in **Breakdown values**. + +Select any segment name above the graph to turn on or off visibility for that segment's metrics. + +![Revenue for multiple segments][21] + ## Sessions over time Similarly, you can find data on [sessions over time for this particular segment][13] on the **Home** page. @@ -41,11 +49,11 @@ If you are using the [older navigation]({{site.baseurl}}/navigation), this is yo ![Session data by segment][18] -## Custom events over time +## View custom events over time -Braze also provides the ability to view data on [Custom events over time for segments][20] by navigating to **Analytics** > **Custom Events Report**. +View data on [Custom events over time for segments][20] by going to **Analytics** > **Custom Events Report**. -## Query Builder +## Using Query Builder templates When analytics tracking is turned on, you can use Query Builder report templates to break down performance metrics for campaigns, Canvas, variants, and steps by segments. To learn more, check out [Segment data]({{site.baseurl}}/user_guide/data_and_analytics/reporting/viewing_and_understanding_segment_data/#performance-data-by-segment). @@ -56,3 +64,4 @@ When analytics tracking is turned on, you can use Query Builder report templates [17]: {% image_buster /assets/img_archive/Revenue.png %} [18]: {% image_buster /assets/img_archive/events_over_time2.png %} [20]: {{site.baseurl}}/user_guide/data_and_analytics/custom_data/custom_events/#analytics +[21]: {% image_buster /assets/img_archive/segment_revenue_multiple.png %} diff --git a/_docs/_user_guide/data_and_analytics/tracking/uninstall_tracking.md b/_docs/_user_guide/data_and_analytics/tracking/uninstall_tracking.md index e47632ccac0..805a8b81a58 100644 --- a/_docs/_user_guide/data_and_analytics/tracking/uninstall_tracking.md +++ b/_docs/_user_guide/data_and_analytics/tracking/uninstall_tracking.md @@ -10,38 +10,48 @@ tool: Reports # Uninstall tracking +> This article shows how you can view aggregate app uninstalls over time to locate trends and anomalies, and track campaign-level uninstalls to determine if a specific campaign is driving or preventing app installs. + Uninstall tracking in Braze provides the following details: 1. Daily app-level uninstall statistics in a time series graph on the **Home** page. 2. Campaign-level uninstall statistics in a time series graph on the **Campaign Details** page of a specific campaign. This statistic specifies the number of campaign recipients that uninstall each day. -Showing aggregate uninstalls over time can help you visualize trends and anomalies so that you can monitor app uninstalls with ease. Similarly, tracking campaign-level uninstalls can reveal whether a specific campaign is driving or preventing app uninstalls. +{% alert note %} +You must opt-in to uninstall tracking on your Braze dashboard. This feature is currently available for apps on iOS, Android, and Fire OS. +{% endalert %} -Braze automatically collects a base level of uninstall information from your regular push campaigns. However, because the frequency that different users receive push campaigns may vary, Braze offers Uninstall Tracking to provide a more accurate snapshot of uninstall activity among your users. +## How it works -{% alert note %} You must opt-in to uninstall tracking on the dashboard. This feature is currently available for apps on iOS, Android, and Fire OS. {% endalert %} +Braze automatically collects a base level of uninstall information from your regular push campaigns. However, because the frequency with which different users receive push campaigns may vary, we offer uninstall tracking to provide a more accurate snapshot of uninstall activity among your users. -## Implementation +## Turning on uninstall tracking -You can enable uninstall tracking on the **App Settings** page, under **Settings**, for each app you are interested in tracking. +You can turn on uninstall tracking on the **App Settings** page, under **Settings**, for each app you want to track. {% alert note %} -If you are using the older navigation, **App Settings** is **Settings** and is located under **Manage Settings**. +If you're using the older navigation, **App Settings** is **Settings** and is located under **Manage Settings**. {% endalert %} -When uninstall tracking is enabled for an app, background push messages will be sent nightly to users who have not recorded a session or received a push in 24 hours. +When uninstall tracking is turned on for an app, background push messages will be sent nightly to users who haven't recorded a session or received a push in 24 hours. + +### Configuration + +To configure uninstall tracking for your iOS application, use a [utility method][iOS docs]. For your Android application, use [`BrazeNotificationUtils.isUninstallTrackingPush()`][8]. When Braze detects an uninstall, whether from uninstall tracking or normal push campaign delivery, we will record the best estimated time of the uninstall on the user. This time is stored in the user profile as a standard attribute and can be used to define a segment of users for win-back campaigns. -If you are interested in filtering Braze background push on iOS, you can use a [utility method][iOS docs]. On Android, you can use [`BrazeNotificationUtils.isUninstallTrackingPush()`][8] to detect uninstall push. When Braze detects an uninstall, whether from Uninstall Tracking or normal push campaign delivery, we will record the best estimated time of the uninstall on the user. This time is stored in the user profile as a standard attribute. +## Filtering segments by uninstalls -This time can be used to define a segment of users for win-back campaigns. Using the "Uninstalled" filter on the **Segments** page, you can select users who uninstalled your app within a time range. Since determining the exact time of an uninstall is difficult, we recommend that uninstall filters have wider time ranges to make sure everyone who uninstalls falls into the segment at some point. +The **Uninstalled** filter on the **Segments** page selects users who uninstalled your app within a time range. Because it's difficult to determine the exact time of an uninstall, we recommend that uninstall filters have wider time ranges to make sure everyone who uninstalls falls into the segment at some point. ![Uninstall Segment][5] -## App-level analysis +### App-level analysis -Daily statistics on uninstalls are found on the **Home** page. The visualization can be broken down by segment, similar to other statistics Braze provides. Set **View Statistics For** to "Usage Analytics", and then select "Uninstalls" from the dropdown to display the graph. +Daily statistics on uninstalls are on the **Home** page. The graph can be broken down by app and segment, similar to other statistics Braze provides. In the **Performance overview** section, select your date range and, if desired, an app. Then scroll down to the **Performance Over Time** graph and do the following: -The graph can then be broken down by segment and app using the dropdowns. +1. In the **Statistics For** dropdown, select **Uninstalls**. +2. In the **Breakdown** dropdown, select **By segment**. +3. In the **Breakdown Values** dropdown, select the segments to include in the graph. {% alert note %} Apps without uninstall tracking enabled will report uninstalls from only a subset of their users (those who were targeted with push notifications), so daily uninstall totals may be higher than what is shown. @@ -49,35 +59,34 @@ Apps without uninstall tracking enabled will report uninstalls from only a subse ![Uninstall Graph Selection][2] -![Uninstall Graph][3] - ## Uninstall tracking for campaigns -Campaign uninstall tracking allows you to see the number of users who received a specific campaign and subsequently uninstalled your app within the selected time frame. This tool gives marketers insight into how campaigns may be encouraging unintended negative user behaviors and helps to measure overall campaign efficacy. +Campaign uninstall tracking shows the number of users who received a specific campaign and subsequently uninstalled your app within the selected time frame. This tool gives insight into how campaigns may be encouraging unintended negative user behaviors and helps to measure overall campaign efficacy. + +Uninstall statistics for campaigns are located on a specific campaign's **Campaign Analytics** page. For multichannel and multivariate campaigns, uninstalls can be broken down by channel and variant, respectively. -Braze tracks uninstalls by observing when push messages sent to users' devices return a signal from either Firebase Cloud Messaging (FCM) or Apple Push Notification Service (APNs) that the app is no longer installed. If Global Uninstall Tracking is enabled for a particular app, Braze sends a daily silent push message to users to detect whether they have uninstalled. This "silent" push is sent to all users (unless the user has disabled silent pushes in their app settings), however it does not appear to users. If Braze detects that a user has uninstalled, that platform: +![Uninstall Campaign Level][6] -* Increments the app's total uninstall count by 1. -* Increments the uninstall count for every campaign that the user successfully received in the past 24 hours by 1. -* If a user receives 3 campaigns in a 24 hour period and then uninstalls, we will increment the count of "uninstalls" for all 3 campaigns. +### How it works -Uninstall tracking is subject to restrictions placed on this information by FCM and APNs. Braze only increments the uninstall count when FCM or APNs tells us that a user has uninstalled, but these third-party systems reserve the right to notify us of uninstalls at any point in time. As a result, Uninstall Tracking should be used to detect directional trends as opposed to precise statistics. +Braze tracks uninstalls by observing when push messages sent to users' devices return a signal from either Firebase Cloud Messaging (FCM) or Apple Push Notification Service (APNs) that the app is no longer installed. If Global Uninstall Tracking is turned on for a particular app, we send a daily silent push message to users to detect whether they have uninstalled. This "silent" push is sent to all users (unless the user has disabled silent pushes in their app settings); however, the push does not appear to users. If we detect that a user has uninstalled, we: -For more on using uninstall tracking, see [this blog post][7]. +* Increment the app's total uninstall count by one. +* Increment the uninstall count for every campaign that the user successfully received in the past 24 hours by one. +* If a user receives three campaigns in a 24-hour period and then uninstalls, we increment the count of "uninstalls" for all three campaigns. -Uninstall statistics for campaigns are located on the Campaign Details page. For multichannel and multivariate campaigns, uninstalls can be broken down by channel and variant, respectively. +Uninstall tracking is subject to restrictions placed on this information by FCM and APNs. Braze only increments the uninstall count when FCM or APNs tell us that a user has uninstalled, but these third-party systems reserve the right to notify us of uninstalls at any point in time. As a result, uninstall tracking should be used to detect directional trends as opposed to precise statistics. -![Uninstall Campaign Level][6] +For more on using uninstall tracking, see our blog post [Uninstall Tracking: An Industry Look at its Strengths and Limitations][7]. ## Troubleshooting -### Why am I seeing a spike in uninstalls all of a sudden? +### Why am I suddenly seeing a spike in uninstalls? If you see a spike in app uninstalls, it may be due to Firebase Cloud Messaging (FCM) and Apple Push Notification Service (APNS) revoking old tokens at a different frequency. [1]: {% image_buster /assets/img_archive/Uninstall_Tracking2.png %} "Uninstall Tracking Checkbox" [2]: {% image_buster /assets/img_archive/Uninstall_Tracking_App2.png %} "Uninstall Graph Selection" -[3]: {% image_buster /assets/img_archive/Uninstall_232.png %} "Uninstall Graph" [4]: {% image_buster /assets/img_archive/User_Profile.png %} "Uninstall Attribute" [5]: {% image_buster /assets/img_archive/Uninstall_Segment.png %} "Uninstall Segment" [6]: {% image_buster /assets/img_archive/campaign_level_uninstall_tracking.png %} diff --git a/assets/img_archive/A_Tracking_2.png b/assets/img_archive/A_Tracking_2.png index 48d91672f07..1bd8b9d05e4 100644 Binary files a/assets/img_archive/A_Tracking_2.png and b/assets/img_archive/A_Tracking_2.png differ diff --git a/assets/img_archive/Influenced_Opens2.png b/assets/img_archive/Influenced_Opens2.png index 47a31cf2373..464799a67ac 100644 Binary files a/assets/img_archive/Influenced_Opens2.png and b/assets/img_archive/Influenced_Opens2.png differ diff --git a/assets/img_archive/Revenue.png b/assets/img_archive/Revenue.png index ad9d4a307f7..f35b614cec4 100644 Binary files a/assets/img_archive/Revenue.png and b/assets/img_archive/Revenue.png differ diff --git a/assets/img_archive/Uninstall_Segment.png b/assets/img_archive/Uninstall_Segment.png index 81166fe6551..cda40bd2615 100644 Binary files a/assets/img_archive/Uninstall_Segment.png and b/assets/img_archive/Uninstall_Segment.png differ diff --git a/assets/img_archive/Uninstall_Tracking_App2.png b/assets/img_archive/Uninstall_Tracking_App2.png index 0c37a930b7b..2d9604bf304 100644 Binary files a/assets/img_archive/Uninstall_Tracking_App2.png and b/assets/img_archive/Uninstall_Tracking_App2.png differ diff --git a/assets/img_archive/campaign_level_uninstall_tracking.png b/assets/img_archive/campaign_level_uninstall_tracking.png index a6af8c85957..215cc81d1e8 100644 Binary files a/assets/img_archive/campaign_level_uninstall_tracking.png and b/assets/img_archive/campaign_level_uninstall_tracking.png differ diff --git a/assets/img_archive/events_over_time2.png b/assets/img_archive/events_over_time2.png index 932cb61af62..33300a071de 100644 Binary files a/assets/img_archive/events_over_time2.png and b/assets/img_archive/events_over_time2.png differ diff --git a/assets/img_archive/segment_revenue_multiple.png b/assets/img_archive/segment_revenue_multiple.png new file mode 100644 index 00000000000..2959bb77d4f Binary files /dev/null and b/assets/img_archive/segment_revenue_multiple.png differ