Piano analytics(ex AT Internet)

Why combine AT Internet and Purchasely?

Pre-requisites

The minimal version of the Purchasely SDK supporting this integration is 3.3.0. If the Purchasely SDK integrated with your app is under the minimal version, please update it.

The AT Internet SDK also needs to be integrated inside the app.

Subscription events

General overview

AT Internet is a is a leading product analytics software company, they work to gives product ans marketing teams the ability to gain insights into how to best acquire, convert, and retain their users across web and mobile platforms.

This integration will allow you to get all the available Purchasely events to AT Internet and get a better and deeper understanding of your subscription business and customer behavior.

Purchasely provides a unified dataset to track the subscription events for all stores. These events are generated by the Purchasely Backend and can be sent to AT Internet.

Subscription events generated by Purchasely will be sent to AT Internet using a server-to-server integration.

Events

The following events are the main ones that can be sent to AT Internet by Purchasely. See the full list here.

Event	Description
SUBSCRIPTION_STARTED	Sent when the user purchased a product wether it is the start of a trial or a regular purchase of a consumable product.
SUBSCRIPTION_RENEWED	Sent when a subscription renews
SUBSCRIPTION_EXPIRED	Sent when the subscription actually ends
SUBSCRIPTION_REACTIVATED	Sent when an expired subscription is reactivated. This event is particularly useful for win-back & retargeting campaigns
SUBSCRIPTION_REFUNDED_REVOKED	Sent when the subscription actually ends
RENEWAL_DISABLED	Sent when the user deactivates the renewal of a subscription wether it is in trial period or not.
RENEWAL_ENABLED	Sent when the user reactivates
TRIAL_STARTED	Sent when a trial starts
TRIAL_CONVERTED	Sent when a user converts from a free trial to a normal paid-period
TRIAL_NOT_CONVERTED	Sent when a user finishes it's trial period without renewing to a paid-period

The names of events sent to AT Internet can be overriden when setting up the integration.

Integrating Purchasely with AT Internet

The integration requires 2 steps:

1. Associate the user to events by providing the AT Internet Client id to the Purchasely SDK

2. Activate the AT Internet integration in the Purchasely Console

1. Associating users to events

See the AT Internet Documentation for more information

Swift

Purchasely.setAttribute(.atInternetIdClient, value: ATInternet.sharedInstance.defaultTracker.getUserId())

Kotlin

ATInternet.getInstance().defaultTracker.getUserId {
    if(it != null) Purchasely.setAttribute(Attribute.AT_INTERNET_ID_CLIENT, it)
}

Java

String atInternetUserId = ATInternet.getInstance().getDefaultTracker().getUserId();
if(atInternetUserId != null) {
  Purchasely.setAttribute(Attribute.AT_INTERNET_ID_CLIENT, atInternetUserId);
}

React Native

Purchasely.setAttribute(Attributes.AT_INTERNET_ID_CLIENT, atInternetUserId);

---

2. Activating the AT Internet integration

The activation requires 6 steps:

1. Retrieving your Site ID from the AT Internet Dashboard

2. Setting up a new Javascript Tag Composer Configuration in the AT Internet Dashboard

3. Retrieving your Collect Server from the AT Internet Dashboard

4. Picking a Collect Path (ie "subscription")

5. Configuring the AT Internet to accept the event names you will be using

6. Enabling the AT Internet integration in the Purchasely Console

a. Retrieve your Site ID from the AT Internet Dashboard

1. Log into your AT Internet Dashboard
2. You will find your Site ID next to your site's name

b. Set up a new Javascript Tag Composer Configuration in the AT Internet Dashboard

1. Access the Tag Composer section of your AT Internet Dashboard
2. Create a new Configuration

3. Pick a name

4. On the next screen, choose the "Websites" environment

5. On the next screen, deselect all plugins

6. On the next screen, deselect all options and create your Configuration

c. Retrieving your Collect Server from the AT Internet Dashboard

1. Access the Tag Composer section of your AT Internet Dashboard
2. Open your newly created configuration

3. On the next screen, click on the button to deploy your Configuration

4. On the sites list, select your website and continue

5. On the settings screen, retrieve and write down your Configuration's SSL Collect Server

d. Pick a collect path to later use when configuration your AT Internet integration in the Purchasely Console

e. Configure the AT Internet to accept the event names you will be using

1. Access the Data Models Events configuration section of your AT Internet Dashboard
2. Create and configure your custom events

Events using any other name than AT Internet's default ones or the ones set up here will be ignored by AT Internet.

f. Enable the AT Internet integration in the Purchasely Console

1. Go in the "External integrations" section, and open the edition form for AT Internet:

2. Enable the integration

3. Set your AT Internet Collection Domains

4. Set your AT Internet Collect Path

5. Set your AT Internet Site Id

6. Enable the events you want to be sent to AT Internet

7. (Optional) Override the names of the events that will be sent to AT Internet

8. Save

Events using any other name than AT Internet's default ones or the ones set up here will be ignored by AT Internet.

Testing your integration

To test your integration, you can perform a set of in-app purchases in a Sandbox environment (eg: TestFlight for the App Store) and verify your events are received in the AT Internet dashboard.