Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This guide will show you how you can create a Webhook campaign in Braze to assign offers to only specific usersguests. This means only these particular users guests will see these offers. In order to do this you will need to create a config Offer in Sanity and then create a Braze webhook campaign to assign this offer to users guests that meet a specific criteria set in Braze (e.g. assign Veggie Whopper Offer to guests that replied to a survey that they are vegetarian).

...

Note

The offer will only show in the guest app if it is assigned to the user guest and added in this section in Sanity.

...

Info

Note: If the same offer is assigned multiple times, the user guest will see the same offer added multiple times to their offer list. This means that the user guest 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

...

Info

“Campaign” assignment works well for if you are aiming to do a one-shot offer assignment. Instead, if you are aiming to perform one of the below tasks, you should use “Canvas” instead:

  • Assign several offers to the same segment

  • A/B tests different offers

  • Segment and assign offers according to user guest behavior

  • or if you have different segments you are planning to assign the offers to

More details here: https://rbictg.atlassian.net/wiki/spaces/IC1/pages/edit-v2/5157814281

...

Info

the Hot path should be used for any user guest 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

...

  • Region {reg} variables:

    • euc1 EU Timezone Markets

    • apse1 APAC Timezone Markets

    • use1 LAC Timezone Markets

    • euw3 Iberia Timezone Market

  • Environment {env} variables: dev, staging, qa or prod . Please always test with staging first.

  • Brand {brand} variables: bk, plk or fhs (other brands are not supported in International markets yet).

...

  • configId → replace configId with the Loyalty Engine ID of the config offer you want to assign using Braze

  • source → should be braze in Production; braze-test in lower environments (Dev, Staging)

  • email → leave as is

  • startDate and endDate → the endDate must be set after the startDate - this represents the duration of time the offer will be available for the guest in the guest app

Note

startDate and endDate always counts from 00:00 to 23:59 from their respective dates.

...

Note

Please reach out to your market setup representative to get you access to the API Key in Production or Staging for your brand

...

6. Test the offer is getting assigned to your

...

guest

Note

It is extremely important to test your offer webhook, before launching the campaign. Once an offer is assigned to a user guest its configuration and rules CANNOT be changed using Sanity.

In the “Compose” section in Sanity click on “Test”. Then choose “Select existing user” from the dropdown “Preview message as user”. After this input the email address of your test user in the guest app. Last but not least, click on “Send Test”. Now the offer should show on the top of your offer list.

...

Note

If you are assigning a high number of offers with a campaign ensure the rate limit is set to a maximum 50K offers assigned per minute as not to strain the APIs.

image-20250129-162019.pngImage Added
Info

Note: The rest of the Braze campaign needs to be configured like any other Braze campaign (e.g. email, IAM, or push campaign). You will need to input specific information on the Schedule Delivery of the campaign, the Target users the campaign will apply to and when the campaign should be delivered to these target

...

guests. For more information refer to: https://www.braze.com/docs/user_guide/engagement_tools/campaigns