Adding loyalty points via Braze
Let's set up Braze to give loyalty points to a customer when Talon.One receives a specific Braze event.
To do this, we must send a request to Talon.One from a campaign or canvas body using the Track event endpoint for Braze.
Talon.One requirements
- You have an Application and campaign in Talon.One.
- You have at least one customer profile in Talon.One. This profile also exists in Braze.
- You have set up a profile-based loyalty program for your Application.
Braze requirements
- You have created a campaign or canvas in Braze.
- You have a way to identify a given customer across Talon.One and Braze.
In this tutorial, we assume a customer's Talon.One
integrationId
is always equal to Braze'suser_id
. You can also create a new property on your Braze customer profiles to store Talon.One's integration ID.
Creating an API key in Talon.One
In the Campaign Manager, create a Braze-specific API key:
- In your Talon.One Application, click Settings > Developer settings.
- Click Create API Key.
- For Do you want to use this API Key with a 3rd party service?, select Yes.
- From Platform, select Braze.
- Select an expiration date, and click Create API Key.
- Copy the key for later use.
We will use the API key in the Braze campaign template.
Creating the Talon.One rule
-
Create a new custom attribute that represents the event sent from Braze:
Property Value Associated Entity Event Event type My Braze event
Attribute Type String API name myBrazeEvent
Rule Builder name My Braze event
-
Open your campaign and create a rule to award points:
What Name Properties Conditions Check for event types
and custom event values- Event type:
My Braze event
- Attribute My Braze event (Event) is equal to
test_string
.
Effects Add loyalty points Select your profile-based loyalty program and set the amount of points to award. - Event type:
Sending the event to add loyalty points
To send the event, we use the Track event endpoint for Braze integrations:
https://integration.talon.one/braze/event
See API Docs
To trigger the endpoint, we must use Braze's Connected Content feature and Braze's Liquid tags.
We assume that your customer profile in Braze contains a unique identifier that is equal to the customer integration ID in Talon.One.
In this tutorial, we use ${user_id}
. Ensure the user ID matches the integration ID in Talon.One.
-
Open your Braze campaign/canvas for editing.
-
According to the Braze docs, add the following Connected Content call to the body of your message, where:
YOUR_API_KEY
is the API key you created.YOUR_DEPLOYMENT_URL
is the base URL of your Talon.One deployment.
{% capture postbody %}
{"eventType": "My Braze Event", "identifier": "{{campaign.${dispatch_id}}}",
"type":"string", "customerProfileId":"{{${user_id}}}",
"eventAttributes": {"myBrazeEvent": "test_string"}}
{% endcapture %}
{% connected_content https://integration.talon.one/braze/event
:headers {
"Authorization": "ApiKey-v1 YOUR_API_KEY",
"destination-hostname": "YOUR_DEPLOYMENT_URL"
}
:method post
:body {{postbody}}
:content_type application/json
:save result
%}
{% for effect in result.effects %}
{% if effect.effectType == "addLoyaltyPoints" %}
<p>You were awarded {{effect.props.value}} loyalty points!</p>
<p>(Reason: '{{effect.props.name}}')</p>
{% endif %}
{% endfor %}
<p>HTTP response code: {{result.__http_status_code__}}.</p> -
To test your request:
- Click Preview in the template editor.
- In Preview as User, click Select existing user and search for an existing user in Braze.
noteLoyalty points are only added when you use the preview function for the first time. The next time you use it, the same message appears, but no loyalty points are added to the customer's profile. This is because the
dispatch_id
isn't available at campaign creation. When your campaign is running, the sample behaves as expected.