Cloudinary

Dynamically select campaign assets based on targeting attributes

This integration method enables dynamic media personalization by intelligently selecting the best asset for each user based on their attributes in real time.

If you include Liquid tags as parameters in a Cloudinary link within a Braze campaign message, when the message is sent, the associated Braze attributes will dynamically replace the Liquid tags. This could be user-specific data such as language or customer tier. Cloudinary will then use those attributes to determine which campaign asset best fits that user, and automatically return the correct image or video. This results in recipients only receiving assets that are contextually relevant and brand approved.

How it works

Cloudinary organizes campaign assets using tags and Structured Metadata (SMD) to make them searchable.

Each campaign asset is grouped under a campaign tag (for example, spring_launch) and enriched with structured metadata fields that correspond to Braze attributes like language=en or tier=gold. When Braze calls the Cloudinary link, a Custom Function processes the incoming attributes, searches for the asset with matching tags and metadata, and then returns the best fitting match.

If an exact match isn’t found, the function automatically selects a fallback or “next best” option for continuity in every experience. When the asset is selected, Cloudinary’s transformation layer (for example, f_auto or q_auto) optimizes the media for delivery. This combination of tagging, metadata, and custom functions gives developers a flexible, API-driven way to automate personalized asset delivery.

Dynamic selection setup

1. Set up the tag and the metadata for assets in Cloudinary.
2. Upload your custom function to the Cloudinary DAM.
3. Create the Cloudinary URL for the desired tag.
4. Using the tag URL as a base, add dynamic image Liquid tags to incorporate Braze attributes and the custom function.

Example URL

This example presumes that assets in Cloudinary have two defined SMD fields (“locale” and “audience”) populated with the expected values corresponding to Braze attributes. Also, assets required for the campaign have been given the “samples” tag, and the custom function segmentedBanner.js has been uploaded into the Cloudinary account.

1
2
3
4
5
6
7
// Use the appropriate Braze attributes.
{% assign audience = {{custom_attribute.${sample_audience_identifier}}} %} 
{% assign locale = {{${language}}}%} 

// The URL for the "samples" tag used in the campaign is https://papish.cloudinary.us/image/list/v1690000000/samples.json, which is the base for the dynamic image URL.
<img src="https://papish.cloudinary.us/image/list/f_auto,q_auto/$locale_#{locale}/$audience_!{audience}!/fn_select:js:v1700000000:segmentedBanner.js/v1690000000/campaigns/samples.json" alt="Banner"> 

Output URLs

• Output URL for users with audience internal and locale en:

  1
  https://papish.cloudinary.us/image/list/f_auto,q_auto/$locale_!en!/$audience_!Internal!/fn_select:js:v1700000000:segmentedBanner.js/v1690000000/samples.json
  

• Output URL for users with audience external and locale es:

  1
  https://papish.cloudinary.us/image/list/$locale_!es!/$audience_!External!/fn_select:js:v1700000000:segmentedBanner.js/v1690000000/samples.json
  

• Fallback image URL:

  1
  https://papish.cloudinary.us/image/list/$locale_!unknown!/$audience_!unknown!/fn_select:js:v1700000000:segmentedBanner.js/v1690000000/samples.json