Add creative scripts and image creatives
Overview
This document explains how to add image creatives and creative scripts in direct insertions.
Add image creative
To add an image creative, proceed as follows:
- Go to the Creatives section of your direct insertion.
- Click Add a creative.
- Choose from the options From computer or Paste URL.
- Upload the image file, such as a GIF or PNG file, or add the file's URL.
- Specify the Click URL.
- Click Add.
Add creative script
Paste creative script
Do the following to traffic third party creative scripts—also known as redirect tags or redirects—from agencies or advertisers:
- Go to the Creatives section of your direct insertion.
- Click on Add creative.
- Click Paste script.
- Paste the script into the Creative script field.
Format creative script
Once the script is pasted, it is formatted automatically: all required macros are inserted. Automatic formatting is limited to scripts from the following third party systems: AdForm, Google Campaign Manager 360, Integral Ad Science (IAS), MOAT, Sizmek, and Weborama.
Automatic formatting only works, if the script is pasted into the Creative script field. Typing the script’s code manually doesn't trigger the formatting process.
If you paste multiple creative scripts from different third party systems, only the first one will be formatted: macros aren't inserted for any subsequent creative scripts. As a workaround, you can format them one by one:
- Paste each creative script individually and let the system format each one.
- Don't save the formatted creative scripts but copy/paste them into a local text file on your computer.
- Once you have formatted each individual creative script, paste the contents of your text file—containing all the readily formatted creative scripts—into the Creative script field.
- Save the insertion.
Pasting the third party creative script can have three outcomes:
- The creative script is supported by Equativ’s automatic formatting feature and the macros are inserted automatically. In this case, simply save the creative and you are done.
- The creative script is not supported by Equativ’s automatic formatting. In this case, insert the macros manually, following the Use creative template macros documentation and the documentation of the third party system the given creative script originates from. Additionally, reach out to your contact at Equativ to have your creative script formatted automatically in the future.
- The creative script is supported by Equativ’s automatic formatting but no macros were inserted because there is no need to do so. In this case, simply save the creative and you are done.
The following example shows a Google Campaign Manager 360 & Integral Ad Science creative script that was formatted automatically:
The following table contains the macros inserted during the formatting process:
Macro | Description |
---|---|
[countgo] |
Equativ’s click counting URL |
[sas_addtl_consent] |
Google Additional Consent string |
[sas_bundleid] |
Bundle ID of the app, inserted if applicable |
[sas_gdpr_applies] / [sas_gdpr_consent]
|
GDPR parameters |
[timestamp] |
Random number to ensure cache busting |
For a complete reference of all macros, see Use creative template macros .
The automatic formatting is also done when pasting creative scripts into any of the two Custom script fields—under Creative template or when editing a creative configured with the From computer or Paste URL options.
The redirection doesn't work if the click URL in a creative script contains special characters, such as é. If there is a special character, ask the agency or advertiser to either remove it or to generate a click URL that is free from special characters, using a URL shortener such as Bitly.
If your website is loaded over https
, Equativ ad tags, third party scripts, and landing pages must all be secure (https
). Otherwise, the browser will show a security error.
Limitations
The following limitations apply for automatic creative formatting:
- Automatic formatting only works if the creative script contains the parameter and a placeholder. For example, if the creative script contains the parameter
click=
and the placeholder$$$$
, then the placeholder is replaced by the click counting macro[countgo]
: the script formatter will convertclick=$$$$
intoclick=[countgo]
. - Automatic formatting doesn't work if the creative script contains the parameter without any placeholder. For example, if the creative script contains
click=
only, no macro will be inserted. In this case, format the creative manually by adding the appropriate macro. Ask the agency for guidance, if needed. - Automatic formatting doesn't work if the creative script contains no parameter and no placeholder. In this case, please format the creative manually by adding the appropriate parameter and macro. Ask the agency for guidance, if needed.
If you paste a third party tag from Google Ad Manager 360, the Personalized Ad option in the Delivery section of the insertion is enabled automatically. This minimizes counting discrepancies between Google Ad Manager 360 and Equativ. For more information about this option, see section "Targeting insertions to positive TCF consent (Personalized Ad)" in Create direct insertion: general settings.