From 2cb1a47009cbed0e559a2e52f313bb7062543bb1 Mon Sep 17 00:00:00 2001 From: Bre Fitzgerald Date: Thu, 5 Dec 2024 13:06:55 -0800 Subject: [PATCH 1/3] BD-3675 --- _includes/campaign_analytics.md | 28 ++++++++++++++++++++++------ 1 file changed, 22 insertions(+), 6 deletions(-) diff --git a/_includes/campaign_analytics.md b/_includes/campaign_analytics.md index 71b05b8563e..5d3788cd91a 100644 --- a/_includes/campaign_analytics.md +++ b/_includes/campaign_analytics.md @@ -406,17 +406,28 @@ Here is a breakdown of some key metrics you may see while reviewing your message +> Delivery of notifications is a “best effort” by APNs. It is not intended to deliver data to your app, only to notify the user that there is new data available. The important distinction is that we will display how many messages we successfully delivered to APNs, not necessarily how many APNs successfully delivered to devices. + +##### Tracking unsubscribes + Push unsubscribes are not included as a metric in campaign analytics. Refer to [Tracking push unsubscribes]({{site.baseurl}}/help/help_articles/push/push_unsubscribes) for steps on how to manually track this metric. -{% alert tip %} +##### Understanding opens + Even though _Direct Opens_ and _Influenced Opens_ include the word "opens", they're actually different metrics. _Direct Opens_ refers to the direct opening of a push notification, as stated in the table above. _Influenced Opens_ refers to the opening of an app, without opening a push notification within a specific time frame after receiving it. So, _Influenced Opens_ refers to the app opens, not push notification opens. -{% endalert %} -> Delivery of notifications is a “best effort” by APNs. It is not intended to deliver data to your app, only to notify the user that there is new data available. The important distinction is that we will display how many messages we successfully delivered to APNs, not necessarily how many APNs successfully delivered to devices. +##### Why push sends can exceed unique recipients + +The number of _Sends_ may exceed the number of _Unique Recipients_ due to the following reasons: + +- **Re-eligibility is on:** When re-eligibility is enabled in your campaign or Canvas settings, users who meet the segment and delivery criteria can receive the same push notification multiple times. This results in a higher number of total sends. +- **Users have multiple devices:** If re-eligibility is not enabled, the difference may be explained by users having multiple devices associated with their profile. For instance, a user could have both a smartphone and tablet, and the push notification is being sent to all registered devices. Each delivery counts as a send, but only one unique recipient is recorded. +- **Users are assigned to multiple apps:** If users are associated with more than one app (such as when testing a new app), they may receive the same push notification on each app. This contributes to a higher number of sends. -#### Bounced push notifications {#bounced-push} +##### Why bounces occur {#bounced-push} -##### Apple push notification service +{% tabs %} +{% tab Apple Push Notification service (APNs) %} Bounces occur in the APNs when a push notification attempts delivery to a device that does not have the intended app installed. APNs also has the right to change tokens for devices arbitrarily. If you attempt to send to a user’s device in which their push token has changed in between when we previously registered their token (such as at the beginning of each session when we register a user for a push token) and the time of send, this would cause a bounce. @@ -424,7 +435,8 @@ If a user disables push within their device settings on subsequent app open the Push notifications that expire before delivery are not considered as failed and will not be recorded as a bounce. -##### Firebase Cloud Messaging +{% endtab %} +{% tab Firebase Cloud Messaging (FCM) %} Firebase Cloud Messaging (FCM) bounces could occur in three cases: @@ -435,6 +447,10 @@ Firebase Cloud Messaging (FCM) bounces could occur in three cases: | Updated application | When an application is updated, the previous version's registration ID may no longer work. As such, an updated application should replace its existing registration ID. | {: .reset-td-br-1 .reset-td-br-2} +{% endtab %} +{% endtabs %} + + {% elsif include.channel == "SMS" %} #### SMS metrics From eafe0f7cfc8c10a99c9ee05ea4715b720916cc37 Mon Sep 17 00:00:00 2001 From: Bre Fitzgerald Date: Thu, 5 Dec 2024 13:19:02 -0800 Subject: [PATCH 2/3] Fix tab characters --- _includes/campaign_analytics.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/_includes/campaign_analytics.md b/_includes/campaign_analytics.md index 5d3788cd91a..b2e73ae4439 100644 --- a/_includes/campaign_analytics.md +++ b/_includes/campaign_analytics.md @@ -427,16 +427,16 @@ The number of _Sends_ may exceed the number of _Unique Recipients_ due to the fo ##### Why bounces occur {#bounced-push} {% tabs %} -{% tab Apple Push Notification service (APNs) %} +{% tab Apple Push Notification service %} -Bounces occur in the APNs when a push notification attempts delivery to a device that does not have the intended app installed. APNs also has the right to change tokens for devices arbitrarily. If you attempt to send to a user’s device in which their push token has changed in between when we previously registered their token (such as at the beginning of each session when we register a user for a push token) and the time of send, this would cause a bounce. +Bounces occur in Apple Push Notification servies (APNs) when a push notification attempts delivery to a device that does not have the intended app installed. APNs also has the right to change tokens for devices arbitrarily. If you attempt to send to a user’s device in which their push token has changed in between when we previously registered their token (such as at the beginning of each session when we register a user for a push token) and the time of send, this would cause a bounce. If a user disables push within their device settings on subsequent app open the SDK will detect that push has been disabled and notify Braze. At this point we will update the push enabled state to be disabled. When a disabled user receives a push campaign before having a new session, the campaign would successfully send and appear as delivered. The push will not bounce for this user. Following a subsequent session, when you attempt to send a push to the user Braze is already aware of whether we have a foreground token as such no notification is sent. Push notifications that expire before delivery are not considered as failed and will not be recorded as a bounce. {% endtab %} -{% tab Firebase Cloud Messaging (FCM) %} +{% tab Firebase Cloud Messaging %} Firebase Cloud Messaging (FCM) bounces could occur in three cases: From b38a83116cce186f2e781a59a4e51eed76ea8ee7 Mon Sep 17 00:00:00 2001 From: Rachel Feinberg Date: Thu, 5 Dec 2024 14:18:18 -0800 Subject: [PATCH 3/3] Small edits --- _includes/campaign_analytics.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_includes/campaign_analytics.md b/_includes/campaign_analytics.md index b2e73ae4439..f9514084144 100644 --- a/_includes/campaign_analytics.md +++ b/_includes/campaign_analytics.md @@ -406,7 +406,7 @@ Here is a breakdown of some key metrics you may see while reviewing your message -> Delivery of notifications is a “best effort” by APNs. It is not intended to deliver data to your app, only to notify the user that there is new data available. The important distinction is that we will display how many messages we successfully delivered to APNs, not necessarily how many APNs successfully delivered to devices. +> Delivery of notifications is a “best effort” by Apple Push Notification services (APNs). It is not intended to deliver data to your app, only to notify the user that there is new data available. The important distinction is that we will display how many messages we successfully delivered to APNs, not necessarily how many APNs successfully delivered to devices. ##### Tracking unsubscribes @@ -429,7 +429,7 @@ The number of _Sends_ may exceed the number of _Unique Recipients_ due to the fo {% tabs %} {% tab Apple Push Notification service %} -Bounces occur in Apple Push Notification servies (APNs) when a push notification attempts delivery to a device that does not have the intended app installed. APNs also has the right to change tokens for devices arbitrarily. If you attempt to send to a user’s device in which their push token has changed in between when we previously registered their token (such as at the beginning of each session when we register a user for a push token) and the time of send, this would cause a bounce. +Bounces occur in Apple Push Notification services (APNs) when a push notification attempts delivery to a device that does not have the intended app installed. APNs also has the right to change tokens for devices arbitrarily. If you attempt to send to a user’s device in which their push token has changed in between when we previously registered their token (such as at the beginning of each session when we register a user for a push token) and the time of send, this would cause a bounce. If a user disables push within their device settings on subsequent app open the SDK will detect that push has been disabled and notify Braze. At this point we will update the push enabled state to be disabled. When a disabled user receives a push campaign before having a new session, the campaign would successfully send and appear as delivered. The push will not bounce for this user. Following a subsequent session, when you attempt to send a push to the user Braze is already aware of whether we have a foreground token as such no notification is sent.