When creating a Match and Activate audience, all columns/headers in the file will be available as macros in the audience.
Below are the file requirements when creating a Match & Activate Audience:
- The file must contain headers
- Header names must not contain “Connect_”
- Header names must not contain any special characters or spaces - only letters and numbers
- Header names must not exceed 24 characters
- Header names must not be duplicated in the same file
Note: CUSTOM_URL is no longer a valid macro. Any macro can be used as a URL. Only macros that are valid URLs beginning with http:// or https:// should be used as the main CTA.
Custom macros are displayed on the audience details page:
Custom Macros contained in the selected audience are available to be used in the HTML. We are no longer using CUSTOM1-25 macros. The new custom macro names to be used in the HTML are the same as those in the audience.
Example: Audience for Order123 contains the following custom macros:
|
PRODUCT NAME |
|
REGION |
|
STORE URL |
Macros in the HTML:
When implemented in the HTML, the same macro names are to be used enclosed in double curly brackets.
Macros that Contain URLs:
When using macros that contain URLs, including main CTAs, we expect the URL to begin with “http://(s)”:
- <a href=””>Visit Store</a>
- If the STOREURL value is “https://www.mystore.com”, when the email is sent, it would look like this:
- <a href=”https://www.mystore.com”>Visit Store</a>
Order:
After selecting an audience for your order, all available macros, both standard and custom, will show.
Flight:
When creating your flight, all available macros, both standard and custom, will show.
Email Testing:
Please ensure the seed and test list you upload follows the exact column order as the test list macros shown below.
HTML Validation:
After running HTML validation, only macros found in your HTML, From Name, and Subject will show.
If any macros were found in your HTML/Subject/From Name but are NOT contained in your audience, they will be highlighted in RED.
Main CTA:
The CUSTOM_URL macro is no longer valid. Any macro that contains a valid URL beginning with http or https:// can be selected as a main CTA.
- It is the user’s responsibility to ensure that any URL is valid, or this will result in email campaigns not performing and errors in email campaigns.
Personalized URLs (PURLs):
We support 3 different implementations for PURLs (personalized URLs) which support multiple use cases:
In HTML:
1: Macro in Query String:
- <a href=”https://www.mywebsite.com/display?product=”>View Product</a>
- The macro value in the audience for this record in the PRODUCTID column is “123”
2: Macro in the URL path:
- <a href=”https://www.mywebsite.com/?product=123”>View Product</a>
- The macro value in the audience for this record in the CHANNEL column is "display"
3: Macro as the full URL
- <a href=””>View Product</a>
- The macro value in the audience in the FULLURL column is “https://www.mywebsite.com/display?product=123”
For more information, view our Connect Self-Serve Guide.