Before you start
Make sure you know how to set up the ad network. Read the Getting Started guide.
Navigate to the "Ad Unit Codes" step of the setup wizard in your Paved account to retrieve your header code and ad unit code.
Merge tags for this ESP
Paved will automatically insert the correct merge tags when you select Braze from the ESP list in your account. For reference, the tags used are:
Email ID: {{${email_address}}}
Campaign ID: {{campaign.${api_id}}}
How to install the header code
In your Paved account, copy the provided header code for your ad placement.
In Braze, go to Templates > Email Templates and select HTML Editor.
Select a blank template or upload your HTML file.
Paste your full email HTML into the editor.
Locate the </head> closing tag.
Paste your Paved header code directly above the </head> tag.
Click Save Template.
How to install the ad unit code
In your Paved account, click Copy Code to copy the ad unit code.
In the Braze HTML editor, locate the position in the email body where the ad should appear.
Paste the ad unit code at that location.
Click Save Template.
If using the drag-and-drop editor, drag an HTML block from the Advanced content section into your email at the desired position and paste the ad unit code into it.
Adding the ad to a reusable template
To avoid re-inserting the ad code with every send:
Save the HTML with the Paved ad unit code included as an email template in Braze.
Select it when building new campaigns or Canvas steps.
Testing your ad placement
Use your ESP's preview to check the visual layout before sending.
⚠ Do not send a test email. Do not use test sends to verify your Paved ad. Test emails often strip or fail to populate merge tags, which will cause a broken ad request. Instead, send a real email to:
The Paved draft email address provided in your Paved account
Yourself and/or your team
Your Paved account manager (if applicable)
Next steps
Head back to your Paved account to finish the setup process. Learn more in Ad Network: Getting Started.
