Braze Tutorial: How To Set “Change Custom Attribute Value” As Conversion Event [Part 2]

🗣️ WATCH FULL YOUTUBE VIDEO HERE 🗣

https://www.youtube.com/watch?v=IPQttvmbRz8

[Braze-mas 2023, Day 23]

What’s up everyone, my name is Allan, Founder and Consultant at For Now Marketing, and welcome to Day 23 of Braze-mas 2023!

Before we get started, if you have any questions, whether you are currently using Braze or considering using Braze, please feel free to reach out! You can find these addresses and more in the Youtube description below.

So yesterday, in Part 1 of this series, we got most of our setup finished, and it’s time to build our Canvas User Update Step. Let’s get started!

Canvas User Update Step

So we are on page 5, the Build Canvas page, and we will create a User Update Step. I personally like to click the + button, click on one of the rectangles right below, scroll down a bit, and click “User Update”.

By the way, the User Update step is a really cool and convenient way for us to log data back to the Braze User Profiles. I posted a different video on how to do the exact same thing using Braze Webhooks, and they both work perfectly fine.

However, the extra nice thing about the User Update Step is that it allows us to skip the step of creating an API key, and just provides a nicer UI for this process.

Advanced JSON Editor

Anyway, back to our Canvas. Let’s click the User Update orange rectangle, and we see this screen. We’re currently on the UI editor which only allows us to edit Custom Attributes, but if we click the dropdown and choose “Advanced JSON Editor”, this gives us the raw input field, and we can log a lot more than just Custom Attributes, including Custom Events.

If we actually click the documentation link up here, there’s actually quite a bit of helpful information and few code snippets provided, so we will scroll down and grab the Custom Event script, which I’ll also include in the Youtube description below.

Custom Event Script

{% assign timestamp = ‘now’ | date: “%Y-%m-%dT%H:%M:%SZ” %}
{
“events”: [
{
“name”: “logged_user_event”,
“time”: “”
}
]
}

Paste the code into our textbox, and we get this little error, which just says that Braze will use what’s in the Advanced JSON Editor for this User Update Step, which that’s what we want, so I’ll close this out.

And the only thing to change in this code is the name of our Custom Event. Braze’s example says “logged_user_event”, but we will change this to “level_up” as we discussed in Part 1.

Preview and test

Just to make sure that our script is formatted properly, let’s go ahead and click “Preview and test”, find my user, and click Send Test to User. By the way, this is simply checking to see that our Custom Event will be logged properly.

We still haven’t tested whether the change in our Custom Attribute will fire this Canvas properly which we will do shortly.

Braze made this feature really well. We’re given some live updates, and even a direct link to the User Profile so we don’t have to exit out of this page and lose our spot.

User Profile

So, on our User Profile page, confirming that the Custom Event level_up is logged properly. So theoretically, every time our Custom Attribute level changes, Braze should automatically be logging a Custom Event called level_up.

Launch Canvas

That’s all that’s required for our Canvas Setup, so we are ready to launch this Canvas! By the way, two things to note about this Canvas:

1. This Canvas does not send any messages. So even though we’ve launched this Canvas, we will not be sending any messages to users.

2. However, every time this Canvas is fired, it will consume 1 data point for your Braze dashboard. So please consider the volume for this Canvas before you launch it.

Back To Original Campaign

At this point, we can go back to our original Push Campaign, “New User Level Up Tips (Level 1–10)”. This is the Campaign for which we wanted to track our Conversion Event on the change of Custom Attribute.

Now that we have a matching Custom Event that will fire everytime the Custom Attribute changes, we should be able to track the Conversion Event that we wanted.

On our Campaign Builder, under page 4: Assign Conversions, let’s click “Add Conversion Event”, choose “Performs Custom Event”, and find our new Custom Event “level_up”. Ahh, it’s there, we love to see it, and this officially ends our setup process.

End-To-End Testing

Now that we’ve finished setting up our tutorial, we’d love to do a full, end-to-end testing to make sure everything works properly. And we will do this on the next video, so stay tuned for Part 3!

Thank You!

That’s it for Day 23.

If you have any questions, please share them in the comments. We’re happy to help! 🙏

If you learned something from this video, please subscribe for more awesome Braze videos in the future!

Thank you for watching, and see you next time!

allan@fornowmarketing.com

fornowmarketing.com