Contact support

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:

  1. Go to the Creatives section of your direct insertion.
  2. Click Add a creative.
  3. Choose from the options From computer or Paste URL.
  4. Upload the image file, such as a GIF or PNG file, or add the file's URL.
  5. Specify the Click URL.
  6. 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:

  1. Go to the Creatives section of your direct insertion.
  2. Click on Add creative.
  3. Click Paste script.
  4. 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 of scripts is supported for a limited number of third party systems, including Google Campaign Manager 360, Integral Ad Science (IAS), MOAT, and other systems.

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:

  1. Paste each creative script individually and let the system format each one.
  2. Don't save the formatted creative scripts but copy/paste them into a local text file on your computer.
  3. 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.
  4. Save the insertion.

Pasting the third party creative script can have three outcomes:

  1. 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.
  2. The creative script is not supported by Equativ’s automatic formatting. In this case, insert the macros manually, following the Use 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. 
  3. 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 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.

 

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.