Table of Contents

minLevel	1
maxLevel	7

Benjamin Reynolds (Deactivated) recording → Targeted Coupons Through Braze-20220322_123641-Meeting Recording.mp4

Info
Your RBI product or customer success team can tell you whether you should follow the “Traditional Offers Assignment” or “Loyalty Offers Assignment” flow for your market.

Traditional Offers Assignment

Sanity Setup

Use Required assignment ruleset

Add the offer to Feature Offers
1. please note that wherever you order the offer in the Feature Offer List, is where the offer will show as available to the user
On the offer in sanity, set the Requires Assignment rule
1. if there are other rules in the offer, make sure that the Requires Assignment Rule is the LAST ONE listed
  Image Removed

Example: https://prod-bk-menu.de.rbi.tools/desk/orderLevelContent;menu;offers;offer;b3d0ed6f-f0b9-4ae0-8b74-c9036436345d;ccc12e32-6c91-4f8b-820a-cf073dd5194f%2Ctype%3Dcombo%2CparentRefPath%3Doption;38107448-4933-4e73-bfbd-63cdcd67e5a4%2Ctype%3DcomboSlot%2CparentRefPath%3Doptions[_key%3D%3D"91b3816ff9ad"]

Find here documentation on Sanity rulesets.

Info
Make sure that all the PLUs are set to the correct value. If set to Empty, the assigned offer won’t show in the offer list

Braze Configuration

Body request

Code Block

language	json

{
  "couponId": "0526d543-3871-4e9c-bec5-327ebcd3f1db",
  "tokenId": "tester",
  "userId": "{{${user_id}}}",
  "expiresOn": "2020-08-11T08:59:59.000Z"
}

Replace couponId with the offer Sanity ID of the coupon you want to assign
tokenId should be a unique identifier for each campaign
userId -> leave as is
expiresOn -> this field determines when the offer assignment will expire, so i.e. the end of the offer life

Request headers

Webhook URLs

US-East-1 (Americas Timezone Markets)

Code Block

language	json

https://prod-bk.rbictg.com/api/v2/braze/webhooks/assign-coupon-token

EU-Central-1 (EU Timezone Markets)

Code Block

language	json

https://euc1-prod-bk.rbictg.com/api/v2/braze/webhooks/assign-coupon-token

AP-SouthEast-1 (APAC Timezone Markets)

Code Block

language	json

https://apse1-prod-bk.rbictg.com/api/v2/braze/webhooks/assign-coupon-token

Info

Make sure you use v2 - in the past the URL used to be v1

If you would like to test in Staging the Offer assignment first, replace prod with staging in the Webhook URL.

Authorization

Code Block
Authorization: Basic <Get this from your RBI Product or Customer Success Team>

Content-type

Code Block

language	json

Content-Type: application/json

...

Loyalty Offers Assignment (Loyalty Offers Platform)

Sanity Setup

Create a template offer (e.g. template offer for Braze Offers in BK UK)
- this offer can be used for all future Braze Offer Assignments
- save the Loyalty Engine ID of the template offer to input into Braze after
  Image Removed
- under Mechanics ensure a config offer is added under Config Offer and under the Required Rules drop down the Date Band toggle is turned on
  - it does not make a difference which config offer is within the template offer in Sanity - it just needs to be added so the offer can be Published
    Image Removed

...

Assign Offers to Users Using Braze Webhook

Sanity Setup

Create a Config Offer (e.g. config offer for for BK UK)
- you will need a different Config Offer created for each offer you would like to assign using Braze
- save the Loyalty Engine ID of the template offer to input into Braze after
- within this config offer, in the Mechanics dropdown under Benefits you will need to link the offer benefits (e.g. Picker or Offer Combo)
- Make sure to add the config offer to the list of Live Config Offers in the Loyalty Live Offers UI in Sanity, so the offer shows in the app to the user after it is assigned
  Image RemovedImage Added

Info
If the same offer is assigned multiple times, the user will see the same offer added multiple times to their offer list. This means that the user will see multiple instances of the same offer in their offer list - as many as offer assignments done for that offer. Each offer will maintain their own configuration settings

Braze Configuration

Body request

Code Block

language	json

{
  "userIdemail": "{{${useremail_idaddress}}}",
  "templateId": "31860003-2e04-4b2e-9008-a6aa33f69da9",
  "source": "braze-test",
  "rank": 123456, (optional)
  "configId": "Loyalty engine id of config offer",
  "ruleParams": {
    "startDate": "yyyy-mm-dd",
    "endDate": "yyyy-mm-dd"
  }
}

Replace templateIdconfigId with the Loyalty Engine ID of the Template Offer used for Braze OffersReplace configId with the Loyalty Ending ID of the offer you want to assign using Braze
source should be braze in Production; braze-test in lower environments (Dev, Staging)
userId email -> leave as is

Note
Note that in the past we relied on `"userId": "{{${user_id}}}"` , but after the EUC1 user data migration all campaigns should use `"email": "{{${email_address}}}"`

startDate and endDate-> required fields; the endDate must be set after the startDate - this represents the duration of time the offer assignment will be available for
rank field (optional) determines the sequence priority of the assigned personalized offer. The lower the number, the higher the priority (i.e. 1 would rank at the top)

Request headers

Webhook URL

Info

the Hot path should be used for any user triggered campaigns that should happen in realtime

ie: T-Mobile Tuesdays, sign up bonuses

the Cold path should be used for any marketer triggered campaigns that can be processed over time

ie: mass offers assignments, mass points updates

...

If you would like to test in Staging the Offer assignment first, just replace prod with staging in the Webhook URL.

Markets in EU Timezone and APAC Timezone should add euc1- and apse1- prefixes to the URL respectively (e.g., https://euc1-prod-bk-loyalty-middleware.rbictg.com/bulk-action/cold/create-offer)

Content-type

Code Block

language	json

Content-Type: application/json

X-Region

Code Block
x-region: gb

Info
`x-region` is the 2-character ISO country code string of that market (e.g. `gb` = United Kingdom, `ch` = Switzerland)

X-Api-Key

Code Block
x-api-key: string

Note
Please reach out to Lopes da Costa, Valentina or another PM to get you access to the API Key in Production or Staging for your brand

...

Info

By default, the assigned offers will have the same rules as the ones configured in Sanity. If you want to override some of these with custom rules, for example, a custom End Date & Start Date, you can pass the following arguments:

Code Block
"ruleParams": { "startDate": "{{ "now" \| date:"%F" }}", "endDate": "{{ "now" \| date:'%s' \| plus:604800\| date:"%F" }}" }

In the above example, we set the Start Date to be the time when the Offer was assigned, and we set the End Date to be 7 days after the offer was assigned (now + 604800 seconds).

Note
`startDate` and `endDate` are part of the `Date Band` rule, which always counts from 00:00 to 23:59 from their respective dates.

Note
Be extremely careful and test your webhooks, once an offer is assigned to a user its rules CANNOT be changed from Sanity.

Other resources

Assign Loyalty Points to Users Using Braze Webhook

Tip
This can be used for all Markets with Loyalty

Body request

Code Block

language	json

{
"pointsEarned": 500,
"source": "braze",
"userIdemail": "{{${useremail_idaddress}}}"
}

Replace pointsEarned with the amount of points you would like users that receive this Braze web hook to receive
source should be braze in Production; braze-test in lower environments (Dev, Staging)
userId email -> leave as is

Note
Note that in the past we relied on `"userId": "{{${user_id}}}"` , but after the EUC1 user data migration all campaigns should use `"email": "{{${email_address}}}"`

Request headers

Webhook URL

Info

the Hot path should be used for any user triggered campaigns that should happen in realtime

ie: T-Mobile Tuesdays, sign up bonuses

the Cold path should be used for any marketer triggered campaigns that can be processed over time

ie: mass offers assignments, mass points updates

...

If you would like to test in Staging the Offer assignment first, just replace prod with staging in the Webhook URL.

Markets in EU Timezone and APAC Timezone should add euc1- and apse1- prefixes to the URL respectively (e.g., https://euc1-prod-bk-loyalty-middleware.rbictg.com/bulk-action/cold/assign-points)

Content-type

Code Block

language	json

Content-Type: application/json

X-Region

Code Block
x-region: gb

Info
`x-region` is the 2-character ISO country code string of that market (e.g. `gb` = United Kingdom, `ch` = Switzerland)

X-Api-Key

Code Block
x-api-key: string

...

Versions Compared

Old Version 20

New Version Current

Key

Traditional Offers Assignment

Sanity Setup

Braze Configuration

Body request

Request headers

Webhook URLs

US-East-1 (Americas Timezone Markets)

EU-Central-1 (EU Timezone Markets)

AP-SouthEast-1 (APAC Timezone Markets)

Authorization

Content-type

Loyalty Offers Assignment (Loyalty Offers Platform)

Sanity Setup

Assign Offers to Users Using Braze Webhook

Sanity Setup

Braze Configuration

Body request

Request headers

Webhook URL

Content-type

X-Region

X-Api-Key

Assign Loyalty Points to Users Using Braze Webhook

Body request

Request headers

Webhook URL

Content-type

X-Region

X-Api-Key

Page Comparison

Versions Compared

Old Version 20

New Version Current

Key

Traditional Offers Assignment

Sanity Setup

Braze Configuration

Body request

Request headers

Webhook URLs

US-East-1 (Americas Timezone Markets)

EU-Central-1 (EU Timezone Markets)

AP-SouthEast-1 (APAC Timezone Markets)

Authorization

Content-type

Loyalty Offers Assignment (Loyalty Offers Platform)

Sanity Setup

Assign Offers to Users Using Braze Webhook

Sanity Setup

Braze Configuration

Body request

Request headers

Webhook URL

Content-type

X-Region

X-Api-Key

Assign Loyalty Points to Users Using Braze Webhook

Body request

Request headers

Webhook URL

Content-type

X-Region

X-Api-Key