The Adobe and Braze integration is currently in beta. Please contact your Braze account manager if you are interested in participating in the beta.
Adobe
Built on the Adobe Experience Platform, Adobe’s Real-time Customer Data Platform (Real-time CDP) helps companies bring together known and anonymous data from multiple enterprise sources in order to create customer profiles that can be used to provide personalized customer experiences across all channels and devices in real-time.
The Braze and Adobe CDP integration allows brands to connect and map their Adobe data (custom attributes and segments) to Braze in real-time. Brands can then act on this data, delivering personalized targeted experiences to those users. With Adobe, the integration is intuitive. Simply take any Adobe identity, map it to a Braze external ID, and send it off to the Braze platform. All data sent will be accessible in Braze through a new AdobeExperiencePlatformSegments
attribute.
Pre-Requisites
Requirement | Description |
---|---|
Adobe Account | You must have an active Adobe account to utilize their services with Braze |
Braze REST API Key | A Braze REST API Key with users.track permissions. This can be created within the Braze Dashboard -> Developer Console -> REST API Key -> Create New API Key |
Braze REST Endpoint | Your REST Endpoint URL. Your endpoint will depend on the Braze URL for your instance. |
Please note that the sending of additional custom attributes may cause data points concerns. We advise speaking with your respective rep for a better understanding of this potential data point increase.
Integration Overview
Step 1: Connect Adobe Account to Braze Destination
From the Adobe settings page, select Destinations under Collections. From there, locate the Braze tile and select Configure.
If a connection with Braze already exists, you will see an Activate button on the destination card. For more information about the difference between Activate and Configure, refer to the Catalog section of the Adobe destination workspace documentation.
Step 2: Provide Braze Token
In the account step, provide your Braze account token API key. For more information on how to obtain your API key in the Braze REST API Key Overview. Enter this key and click Connect to destination.
Step 3: Authentication
Next, you will be presented with the Authentication step. Here, you must enter your Braze connection details:
- Name: Enter the name you would like to recognize this destination by in the future.
- Destination: Enter a description that will help you identify this destination.
- Endpoint Instance: Please reach out to your Braze representative about which endpoint instance you should use.
- Marketing Use Case: Marketing use cases indicate the intent for which data will be exported to the destination. You can select from Adobe-defined marketing use cases or you can create your own marketing use case. To read more about Adobe marketing use cases, visit their Data Governance in Adobe Experience Platform documentation.
Step 4: Create Destination
Lastly, click Create destination. Your destination has now been created. You can click Save & Exit if you want to activate segments later, or you can select Next to continue the workflow and select segments to Activate.
Step 5: Activate Segments
Activate the data you have in the Adobe Real-Time CDP by mapping segments to the Braze destination.
Listed below are the general steps required to activate a segment. For thorough guidance on Adobe segments and the segment activation workflow, visit their Segment Documentation.
- Select and activate the Braze destination.
- Select applicable segments.
- Configure scheduling and file names for each segment you export.
- Select attributes to send to Braze.
- Review and verify activation.
Step 6: Field Mapping
To correctly send your audience data from Adobe Experience Platform to Braze, you must complete the field mapping step. Mapping consists of creating a link between the Adobe Experience Data Model fields and the corresponding Braze Platform fields.
- In the Mapping Step, click Add new mapping.
- In the Source Field Section, click the arrow button next to the empty field, this will open the Select source field window.
- From the Select source field window, you must select Adobe attributes to map to your Braze Attributes.
Next, you must select the identity namespace. This option is used to map a Platform identity namespace to a Braze namespace.
Choose your source fields, then click Select. - In the Target Field section, click the mapping icon to the right of the field.
- In the Select target field window, you can choose between three categories of target fields:
• Select attributes: Use this option to map your Adobe XDM attributes to standard Braze Attributes.
• Select identity namespace: Use this option to map Platform identity namespaces to Braze identity namespaces.
• Select custom attributes: Use this option to map Adobe XDM attributes to custom Braze Attributes that you defined in your Braze account.
You can also use this option to rename existing XDM attributes into Braze. For example, mapping alastname
XDM attribute to a customLast_Name
attribute in Braze, will create theLast_Name
attribute in Braze if it doesn’t already exist, and map thelastname
XDM attribute to it.
Choose your target fields, the click Select. - You should now see your field mapping in the list.
- To add more mappings, repeat steps 1 through 6 as necessary.
Example
Let’s say your XDM profile schema and your Braze instance contains the following attributes and identities:
XDM Profile Schema | Braze Instance | |
---|---|---|
Attributes | - person.name.firstname - person.name.lastname - mobilePhone.number |
- FirstName - LastName - PhoneNumber |
Identities | - Email - Google Ad ID (GAID) - Apple ID For Advertisers (IDFA) |
- external_id |
The correct mapping would look like this:
Exported Data
To verify if data has been exported successfully to Braze, check your Braze account. Adobe Experience Platform segments are exported to Braze under the AdobeExperiencePlatformSegments
attribute.
Data Usage and Governance
All Adobe Experience Platform destinations are compliant with data usage policies when handling your data. For detailed information on how the Adobe Experience Platform enforces data governance, see Adobe’s Data Governance in Real-Time CDP documentation.