The Sharelink allows you to share your Retention Report using a simple link. Anyone with a Sharelink can download a CSV file that contains the Retention Report data without accessing the Airbridge dashboard.

Attention

The data shared via Sharelinks is the data from the report view you have created and have access to in the Airbridge dashboard.

Keep in mind that when you share Sharelinks, there are potential risks of exposing sensitive data unintentionally. Anyone with the Sharelink can import the report data, even if they don't have access permission or aren't Airbridge users.

Sharelinks can be created only for saved Airbridge reports. When entering the Sharelink into the address bar of a web browser, the report data is downloaded as a CSV file.

The data in the downloaded CSV file has the same cohort, date range, granularity, Start Event, Return Event, GroupBy, filter, and language settings as the original report.

Parameters can be added to customize some of the settings. Refer to this section of the article to learn more.

Attention

Sharelinks can be created only for saved reports. The [share] icon is only visible in saved reports. If you can't see the [share] icon in your report, save the report first.

You need to have a saved Retention Report to create a Sharelink. If you don't have a saved Retention Report, save a report view first.

1. Click Saved Reports at the top right to open the report you want to share from the drop-down list. Or, if you want to create a Sharelink of the report you have just created, click Save at the top right.

2. Click the [share] icon on the top right.

3. Switch on the [Create Sharelink] toggle. A Sharelink will appear below the toggle.

4. Click the Sharelink below the toggle to copy it. Share the Sharelink with anyone you want to share your report data. Note that if the toggle is turned off, the Sharelink won’t work anymore. Every time you switch on the toggle, a new Sharelink is created, and the new link must be shared.

The Sharelink can be customized by adding new parameters or editing the existing parameters to modify the settings in the data. The structure of a Sharelink looks like the following.

• Sharelink structure: Basic URL?parameter1&paramter2&parameter3

• Basic URL: report.airbridge.io/retention/(URL).csv

The data in the downloaded CSV file has the same cohort, date range, granularity, Start Event, Return Event, GroupBy, filter, and language settings as the original report. The CSV file downloaded from a Sharelink can carry up to 1,000 rows for top-rows by default. The sub-rows are provided based on the top rows.

By adding parameters or editing the existing parameters, the Sharelink can be customized to modify the settings in the data, such as the language settings, date range, number of rows, etc. A question mark (”?") must be present at the end of the URL before the parameters. For example, by adding the rowNo parameter to the Sharelink, up to 10,000 rows for top-rows can be downloaded.

The following table lists the parameters that are available.

When adding multiple parameters, separate them with an ampersand ("&").

Attention

The language parameter is present in all Sharelinks by default. To add more parameters, use ampersands (”&”) between parameters.

A Sharelink starts with “report.airbridge.io/retention/(URL).csv” followed by a question mark and parameters. See the following examples to understand how to customize Sharelinks.

?includesMetadata=true

Attention

The following settings in the CSV file downloaded from Sharelinks cannot be modified by adding parameters to the Sharelink and will be the same as the settings of the Airbridge dashboard.

• Cohort, granularity, Start Event, Return Event, Return Event ranges, GroupBys, filters

If you want to modify the above settings, modify them in the Retention Report in your Airbridge dashboard and save the changes.

It takes about an hour for the changes to be applied to the already shared Sharelink. If you want to see the changes immediately, open the data in a new Google Spreadsheet file. Or, switch off the [Create Sharelink] toggle and switch it on again to create a new Sharelink. Then, copy the new Sharelink for your data-sharing purposes.

The report data can be imported to Google Spreadsheets using the importdata function. Use the importdata function like the following example.

• =importdata("Full Sharelink")

The report data is pulled every 1 hour, allowing for near-realtime data monitoring on Google Spreadsheets. By using Sharelinks and the importdata function, you can create your own custom report that combines Airbridge data with data from any other source.

Troubleshooting retention rate errors in the Google Spreadsheet

When adding csvType=percent to the Sharelink, the data is the CSV file will show the retention data as retention rates. The retention rate may show in decimal numbers like 0.2051, instead of 20.51%. In such a case, select all cells that contain the retention rate value, select [Format] from the top menu bar, and select [Number]>[Percent]. Or, click the [percentage] icon in the format menu bar.

By importing the Retention Report data using Sharelinks and Google Spreadsheets, you can share the Retention Report data in your desired format regardless of the app access permissions in Airbridge. The Sharelinks and Google Spreadsheets will come in handy for the following purposes:

• Sharing Airbridge data externally, regardless of access permissions

• Monitoring the Airbridge data in Google Spreadsheets in real-time

• Creating a custom report by integrating Airbridge data with internal company data