Purchasely
Rechercher…
Braze
Purchasely can send all your transactional events to Braze to enrich your users data. Use these events to trigger automatic campaigns, pushs...

Events

The following events will be sent. You can set the event name of your choice in the console.
You can find the full list of events 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.
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
SUBSCRIPTION_TERMINATED
Sent when the subscription actually ends
SUBSCRIPTION_RENEWED
Sent when a subscription renews
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

Associate users to events

There is nothing special to be done to associate Purchasely events to your logged in users in Braze. Just setup Braze SDK as you would normally, and use the changeUser method to set the user ID in Braze:
Swift
Objective-C
Kotlin
Java
React Native
Cordova
1
Appboy.sharedInstance()?.changeUser("YOUR_USER_ID")
Copied!
1
[[Appboy sharedInstance] changeUser:@"YOUR_USER_ID"];
Copied!
1
Appboy.getInstance(context).changeUser("YOUR_USER_ID")
Copied!
1
Appboy.getInstance(context).changeUser("YOUR_USER_ID");
Copied!
1
ReactAppboy.changeUser("YOUR_USER_ID");
Copied!
1
AppboyPlugin.changeUser("YOUR_USER_ID");
Copied!
Make sure the User ID you give to Braze matches thevendor_id you give to Purchasely, as our servers refer to this ID when sending events for the user. Read Braze documentation on Setting User IDs for more information.

Handle anonymous users

If you have anonymous users in your app, you will need to add their Purchasely anonymous_id as a user alias to Braze:
Swift
Objective-C
Kotlin
Java
React Native
Cordova
1
Appboy.sharedInstance()?.user.addAlias(
2
Purchasely.anonymousUserId,
3
withLabel: "purchasely_anonymous_id"
4
)
Copied!
1
[[Appboy sharedInstance].user addAlias:[Purchasely anonymousUserId] withLabel:@"purchasely_anonymous_id"];
Copied!
1
Appboy.getInstance(applicationContext)?.currentUser?.addAlias(
2
Purchasely.anonymousUserId,
3
"purchasely_anonymous_id"
4
)
Copied!
1
Appboy.getInstance(getApplicationContext()).getCurrentUser().addAlias(
2
Purchasely.getAnonymousUserId(),
3
"purchasely_anonymous_id"
4
);
Copied!
1
ReactAppboy.addAlias(
2
Purchasely.getAnonymousUserId(),
3
"purchasely_anonymous_id"
4
);
Copied!
1
AppboyPlugin.addAlias(
2
Purchasely.anonymousUserId,
3
withLabel: "purchasely_anonymous_id"
4
);
Copied!
The label MUST be set to "purchasely_anonymous_id", as our servers refer to this label when sending events while the user is anonymous.
When the anonymous user later becomes logged in, Purchasely will automatically send following events using the provided vendor_id

Configure the integration in the Purchasely Console

Go to the "External integrations" section, and open the edition form for Braze:

Getting Braze API key

Go to your Braze Developer Console, and click on "Create New API Key"
Give a relevant name to your API Key. In the "User Data" permission area, check users.track as our servers need this permission to report backend events to Braze.
Click "Save API Key" at the bottom of the page.
Finally, paste the API key Identifier value into Purchasely console.

Selecting the correct REST Server

Refer to Braze API Endpoints table. You can use your Braze Dashboard URL find the correct server. E.g. if your dashboard is accessible at https://dashboard-01.braze.eu, then you should select the EU-01 server.

Customising Server Event Names

If you want to, you can rename events sent to Braze:
Please refer to Braze documentation on Event Naming Conventions to choose appropriate event names.

Event properties

Each event sent to Braze carries a set of properties that you can use to further personalize your campaigns:
Property
Description
application_name
Name of the application as set in Purchasely Console, e.g. "Purchasely Demo"
application_package_id
Application package ID in the Store, e.g. "com.purchasely.demo"
application_platform
Platform of the application, e.g. "ANDROID"
plan_id
Plan Vendor ID, e.g. "PURCHASELY_PLUS_MONTHLY"
plan_name
Plan name as set in Purchasely Console, e.g. "Monthly"
plan_store_product_id
Store product identifier, e.g. "com.purchasely.plus.monthly"
plan_type
Type of the plan, e.g. "RENEWING_SUBSCRIPTION"
product_id
Product Vendor ID, e.g. "PURCHASELY_PLUS"
product_name
Product name as set in Purchasely Console, e.g. "Purchasely +"
store
Store associated with the event, e.g. "GOOGLE_PLAY_STORE"
Read Braze documentation on Custom Event Properties for more details on how you can use the properties above.