Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

BD-3358 Apply templates to non-nested data & analytics docs #7865

Merged
merged 3 commits into from
Aug 12, 2024
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion _docs/_user_guide/data_and_analytics.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ page_order: 3
layout: dev_guide

guide_top_header: "Data & Analytics"
guide_top_text: "Braze offers a breadth of metrics to measure your campaigns' performance. We also provide multiple reporting and tracking capabilities to ensure you get the numbers you need.<br><br>You can also leverage Braze data to augment BI and analytics efforts in other best-in-class reporting platforms using <a href='/docs/user_guide/data_and_analytics/braze_currents/'>Currents</a>, a data streaming export tool which enables your team to act on large amounts of granular customer data."
guide_top_text: "Braze offers a breadth of metrics to measure your campaign performance. We also provide multiple reporting and tracking capabilities to get you the numbers you need.<br><br>Leverage Braze data to supplement your business intelligence (BI) and analytics efforts in other best-in-class reporting platforms using <a href='/docs/user_guide/data_and_analytics/braze_currents/'>Currents</a>, a data streaming export tool that your team can use to act on large amounts of granular customer data."
description: "Braze offers a wide breadth of metrics for you to use when measuring the success of your campaigns. We also provide multiple reports and tracking capabilities to ensure you get the numbers you need."

guide_featured_title: "Topics"
Expand Down
18 changes: 9 additions & 9 deletions _docs/_user_guide/data_and_analytics/creating_a_formula.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,33 +9,33 @@ tool: Reports
---
# Creating a formula

> When viewing analytics in Braze, you can combine several data points together to get valuable insights into your user data. These are referred to as formulas. Formulas allow you to normalize your time series data based on your total number of monthly active users (MAU) and daily active users (DAU). They also help you to easily understand complex relationships that exist in your data.
> When viewing analytics in Braze, you can combine multiple data points to get valuable insights into your user data. These are referred to as formulas. Use formulas to normalize your time series data based on your total number of monthly active users (MAU) and daily active users (DAU).

For example, you can compare how many custom events were completed by daily active users that qualify for a particular segment versus the general population (or against another segment).
Formulas help you understand complex relationships that exist in your data. For example, you can compare how many custom events were completed by daily active users that qualify for a particular segment versus the general population (or against another segment).

## Use cases

Formulas, especially when combined with custom events, allow you to better understand user behaviors within your app. Formulas can also lend deeper insight into segment purchasing patterns, even if your company uses paid media in conjunction with Braze, such as Google Ads or TV.
Formulas, especially when combined with custom events, can help you understand user behaviors within your app. Formulas can also lend deeper insight into segment purchasing patterns, even if your company uses paid media in conjunction with Braze, such as Google Ads or TV.

The following are some examples of the kinds of behavior patterns that can be detected using formulas:

- **Ride-sharing apps:** If you have a custom event for when the user cancels a ride, configuring a function for Canceled Rides / DAU can be used to find if certain user segments tend to cancel more rides than others.
- **Ecommerce apps:** By configuring a function for purchases of a certain product ID / MAU, you can, compare the popularity of a recently promoted product between segments, even if all of the promotions couldn't be tracked using Braze.
- **Ride-sharing apps:** If you have a custom event for when the user cancels a ride, you can configure a function for Canceled Rides / DAU to find if certain user segments tend to cancel more rides than others.
- **Ecommerce apps:** By configuring a function for purchases of a certain product ID / MAU, you can compare the popularity of a recently promoted product between segments, even if all the promotions couldn't be tracked using Braze.
- **Media apps using ads:** If the users' experience is interrupted by ads between video or audio clips, recording mid-ad exits as a custom event and calculating the ratio of mid-ad exits / DAU can help find the best segments to target with a campaign for ad-free premium subscriptions.

## Creating formulas

Formulas can be accessed in the statistics panels on the [Home][9], [Revenue][10] and [Custom Events][11] pages in the dashboard. To view this panel, change the **View Statistics For** dropdown to **KPI Formulas**.
Formulas can be accessed in the statistics panels on the [Home][9], [Revenue Report][10] and [Custom Events Report][11] pages in the dashboard. To view this panel, go to the **Performance Over Time** chart, change the **Statistics For** dropdown to **KPI Formulas**, then select at least one KPI formula to populate the chart.

![View statistics for KPI formulas in the Braze dashboard][16]

To create a new formula:

1. Navigate to the appropriate dashboard (Home, Revenue, or Custom Events).
2. Click **Manage KPI Formulas**.
1. Go to the appropriate dashboard (**Home**, **Revenue Report**, or **Custom Events Report**).
2. Select **Manage KPI Formulas**.
3. Enter a name for your formula.
4. Select the relevant numerators and denominators.
5. Click **Save**.
5. Select **Save**.

## Available numerators and denominators

Expand Down
20 changes: 12 additions & 8 deletions _docs/_user_guide/data_and_analytics/data_points.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,33 +3,37 @@ nav_title: Data Points
article_title: Data Points Overview
page_order: 0
page_type: reference
description: "This reference article outlines what Data Points are at Braze and how you can be aware of their usage."
description: "This reference article outlines what data points are at Braze and how you can be aware of their usage."
search_rank: 6
---

# Data points

At Braze, data means action: each piece of data that arrives in Braze updates segment membership, can trigger and cancel messaging, is immediately available for messaging personalization, and more. Data points help you define the most impactful information for your business. By thoughtfully considering what information to track, you ensure that you're targeting the highest-impact data for your users' experience.
> At Braze, data means action: each piece of data that arrives in Braze updates segment membership, can trigger and cancel messaging, is immediately available for messaging personalization, and more. Data points help you define the most impactful information for your business. By thoughtfully considering what information to track, you ensure that you're targeting the highest-impact data for your users' experience.

Data points define a billing and pricing structure based on information logged against user profiles. Our Customer Success team can help recommend data best practices to fit your needs. You can find a more detailed breakdown of this definition in your Braze contract.

> "Data points" shall refer to a billable unit of use of the Braze Services, measured by a session start, session end, custom event, or purchase recorded, as well as any attribute set on an end user profile. For clarity, each one of the above-mentioned data (such as session start, session end, custom event, or purchase recorded, as well as any attribute) set to an end user’s profile at one point in time shall each count as a single data point.<br><br>Data and events collected by default by the Braze Services, including, for example, push tokens, device information, and all campaign engagement tracking events, such as email opens and push notification clicks, are *not* counted as data points.
## Definition

"Data points" shall refer to a billable unit of use of the Braze Services, measured by a session start, session end, custom event, or purchase recorded, as well as any attribute set on an end user profile. For clarity, each one of the above-mentioned data (such as session start, session end, custom event, or purchase recorded, as well as any attribute) set to an end user’s profile at one point in time shall each count as a single data point.

Data and events collected by default by the Braze Services, including, for example, push tokens, device information, and all campaign engagement tracking events, such as email opens and push notification clicks, are *not* counted as data points.

See this article's [Consumption count](#consumption-count) section to understand what data counts toward your data point allocation.

## Management and usage
## Viewing data point usage

To view your data point usage, go to **Settings** > **Billing** and select the **Total Data Points Usage** tab.

{% alert note %}
If you are using the [older navigation]({{site.baseurl}}/navigation), you can find this page by selecting your account icon > **Subscriptions and Usage** > **Total Data Points Usage**.
If you're using the [older navigation]({{site.baseurl}}/navigation), you can find this page by selecting your account icon > **Subscriptions and Usage** > **Total Data Points Usage**.
{% endalert %}

For more information on the data point dashboard components, refer to [Billing]({{site.baseurl}}/user_guide/onboarding_with_braze/subscription_and_usage/).

{% alert tip %}
**Don't waste data points. Only update changing data!**<br><br>
To ensure you minimize data point consumption, we recommend setting up a program to prevent sending the same unchanging data and only passing new and relevant data to Braze. Braze will work with you to establish this best practice during onboarding.
To minimize data point consumption, we recommend setting up a program to prevent sending the same unchanging data and only passing new and relevant data to Braze. Braze will work with you to establish this best practice during onboarding.
{% endalert %}

## Consumption count
Expand Down Expand Up @@ -57,7 +61,7 @@ If you set the whole array at once, it will count as a single data point. As suc

#### CSV

Custom attributes uploaded via CSV count toward your data points. However, CSV imports for segmentation purposes (imports made with `external_id`, `braze_id`, or `user_alias_name` as the only field) will not consume data points.
Custom attributes uploaded through CSV import count toward your data points. However, CSV imports for segmentation purposes (imports made with `external_id`, `braze_id`, or `user_alias_name` as the only field) will not consume data points.

Also, as subscription state changes do not consume data points, updating the `email_subscribe`, `push_subscribe`, `subscription_group_id`, or `subscription_state` fields in your CSV file will not incur charges.

Expand All @@ -66,7 +70,7 @@ Also, as subscription state changes do not consume data points, updating the `em
{% tabs %}
{% tab Non-billable %}

#### Non-billable data points (out of the box)
#### Non-billable data points (default)

<div class="small_table"></div>

Expand Down
Loading