Page tree


Creatives are the media assets associated with an ad, such as an image, text, or video file. 

Adding Creatives

There are several ways to add creatives:

  • From the Main Navigation:  select Transactions | Creatives from the main navigation and click Add New Creative.
  • From List of Line Items: for a line item that is either in Draft or Delivering status, click the drop-down menu in the Actions column for the line item you want to add a creative to, then select Add New Creative.
  • From Line Item Details: click Add New Creatives at the bottom of the page.

Creative Information

  1. Specify if the creative will be copied from an existing creative. If  Yes, select the source from the drop-down list.
  2. Enter the creative Name.

    Use a naming convention that reflect the content of the creative; for example, Cars111_Video_Spring01
  3. Add a Description.

  4. Select the Advertiser for this creative from the drop-down list.

    Advertiser must be created prior to creation of the Creative

Creative Details

Select a Creative Type and follow the instructions below for the type selected. 

  • Image
  • Native Ads
  • Text
  • Video
  • Rich Media
  • HTML5
Each type requires a different set of specifications. 

Image

  1. Image File: Select Upload file or choose Remote File and enter the URL.
  2. Choose Test URL to make sure the image displays appropriately. The Asset Preview also displays the image.
  3. Enter the Alt Text that describes the image's contents. Alt Text will display if the image cannot render.
  4. Click-through URL: Either select No Click-through or, if there is a URL for click-through from the image, select  Click-through URL and enter the URL in the box provided. Choose Test URL to make sure URL opens appropriately. Learn More on Macro Usability.   
  5. Size: Select the size that best fits targeted devices.
  6. 3rd Party Tracking Pixel: choose Add Tracking Pixel to add an Impression Tracking URL. Learn More on Macro Usability
  7. Frequency Cap: select one or more frequency limits for different time periods; for example, 10 a day, 20 a week, or other limits. (To remove a cap, use the "X" to the right of the entry.)

    GDPR opt-out /PubMatic opt-out: If a user has not provided the consent to PubMatic (opt-out ), UAS will filter all the Ad Units/Orders/Line Items/Creative that having a frequency cap applied. 

Native Ads

The options for the Native ad will vary based on the Native template selected. For example, if it is an App Wall template, the CTA Text field will appear, if it is a Carousel template, the Main Image and Description fields will appear, and so on. Some of the fields included in these instructions may not appear if they do not apply to your selected Native template.
  1. Select the Native Template type that most closely matches your targeted media. Choose Preview Template Attributes to view the selected template's attributes.   The details for the native ad will change based on the template selected.

    Native Templates are created when the Ad Unit is created. Refer to Creating a Native Template (UAS) for more information.
  2. Click-through URL: Either select No Click-through or, if there is a URL for click-through from the image, select  Click-through URL and enter the URL in the box provided. 
  3. Add one or more macros, if desired, to the click-through URL by choosing Select macros. From the list that appears, select a category to expand it, then choose  Add Macro next to the macros you would like to add.
  4. Enter a Title for the ad.
  5. Select Upload a file and use the Select File button to add it, or add a URL for the Remote file for the Main Image and Icon.
  6. Enter a Description.
  7. Enter CTA Text (max length will vary based on selected template) that should appear as the call to action (CTA) on a button or text field for the ad.
  8. Enter a Rating (max length will vary based on selected template) that reflect the number of stars in a rating.
  9. 3rd Party Tracking Pixel: Choose Add Tracking Pixel to add an Impression Tracking URL. Learn More on Macro Usability
  10. Frequency Cap: Select one or more frequency limits for different time periods; for example, 2 a day, 20 a week, or other limits. You can add one or more frequency caps.

    GDPR opt-out /PubMatic opt-out:  If a user has not provided the consent to PubMatic (opt-out ), UAS will filter all the Ad Units/Orders/Line Items/Creative that having a frequency cap applied. 

Text

  1. Creative Text: Type text in the text box. 
    The Thumbnail to the right displays the text.
  2. Click-through URL: Either select  No Click-through  or, if there is a URL for click-through from the image, select  Click-through URL , then enter the URL in the box provided. 
  3. Add one or more macros, if desired, to the click-through URL by selecting Show available macros, then select macros by expanding the list and choosing Add Macro. Be sure your cursor is in the location in the URL at the top of the list where you want to insert the code. Click Done when all macros have been added.
  4. Add text that describes the ad in the Create Description  field.
  5. Select a Size from the drop-down list.
  6. Choose Add Tracking Pixel  to add a 3rd Party Tracking Pixel. 
    - Select Impression Tracking or Click Tracking.
    - Add a Tracking URL.
    - Select Macros if desired. Learn More on Macro Usability
  7. Choose Add Frequency Cap  to add one or more frequency limits for different time periods; for example, 2 a day, 20 a week, or other limits. You can add one or more frequency caps.

    GDPR opt-out /PubMatic opt-out:  If a user has not provided the consent to PubMatic (opt-out ), UAS will filter all the Ad Units/Orders/Line Items/Creative that having a frequency cap applied. 

Third Party

Third Party Creative can be create and Link to Wrapper Type Of Line Item Only.  This is require when you are expecting to use Open Wrap with UAS.  See OpenWrap and UAS Integration for more detail.

  1. Code Snippet:  Whenever you are creating Wrapper Type of Line Item, you must setup the following Code Snippet in Third Party Creative. Following script notifies the client with slot / bid id of highest / winning bid and displays the creatives respectively.


    <script type='text/javascript'>
    var i = 0, w = window.self;
    while(w!== window.top && !(w.PWT && w.PWT.displayCreative) && i<10){
    w = window.self.parent; i++;
    }
    try{ w.PWT.displayCreative(document, '%%VAR_pwtsid%%'); } catch(e){}
    </script>


    Use the following code snippet if you are running any deal for your partner through PubMatic Open Wrap.


    <script type='text/javascript'>
         (function(){
              var i = 0, w = window.self;
              while(w!== window.top && !(w.PWT && w.PWT.displayCreative) && i<10){
                   w = window.self.parent; i++;
              }
              try{ w.PWT.displayPMPCreative(document, '%%VAR_pwtdeal_<partner_name>%%', []); } catch(e){}
         })();
    </script>
  2. Select a  Size  from the drop-down list.
  3. Choose  Add Tracking Pixel to add a 3rd Party Tracking Pixel. 
    - Select Impression Tracking.

Video

To display video files in your ad, select the following attributes:

  1. Type the URL for the Video Ad Serving Template (VAST).

    VAST standardizes the communication between video players and ad servers and enables video ads to be served across all compliant video players.
  2. Select the VAST Video Protocol (2.0 or 3.0)
  3. Select the level of VPAID support:
  • No VPAID support
  • VPAID 1.0
  • VPAID 2.0

    VPAID establishes a common interface between video players and ad units. For more information, reference IAB's VPAID page.
  1. Size: Select the size in which the video will display.
  2. Third-party tracking pixels: Use this to track impressions with a tracking pixel. A tracking pixel is code inserted into a third-party creative that makes a server call and returns a transparent 1x1 image (normally a GIF file).
    To select a 3rd party tracking system, choose Add Tracking Pixel and use the 3rd party Tracking Pixels drop-down list to select the type of URL you will enter. Learn More on Macro Usability

  3. Type the URL to add the URL that corresponds with the type of tracker you selected. Choose the X to delete a particular URL, as you can have multiple URLs added.
  4. Add Frequency Caps to specify how often a creative is served in a given time period. You can specify limits for minutes, weeks, hours, and months or a lifetime cap.

    GDPR opt-out /PubMatic opt-out:  If a user has not provided the consent to PubMatic (opt-out ), UAS will filter all the Ad Units/Orders/Line Items/Creative that having a frequency cap applied.

     

Rich Media

Rich media is a digital advertising term for an ad that includes advanced features like video, audio, or other elements that encourage viewers to interact and engage with the content. Rich media ads offer more ways to involve an audience with an ad and lets agencies create complex ads that can elicit strong user response. 

  1. Click-through URL: Either select  No Click-through  or, if there is a URL for click-through from the image, select  Click-through URL , then enter the URL in the box provided. Learn More on Macro Usability
  2. (Optional) Select one of the pre-defined Rich Media Template types:
  • Interstitial: The interstitial banner is displayed in front of the site for a maximum of 8 seconds. The banner has a close button generated through the template and supports image and click tracker.
  • Sticky: The sticky panoramic banner, which is located at either the top or the bottom of the web page. If the banner is at the top, the banner will stay static at the top of the page after a user closes it. If the banner is at the bottom, the banner will disappear after a user closes it.
  • Full Page Skin: The placement of ad units that take over the page interface. Refer to Using the Full Page Skin Rich Media Template (UAS) for more information.
  • Pushdown: The Pushdown creative is an ad unit that appears at the top of a webpage that can expand/collapse upon user click or mouse hover. It is referred to as a "pushdown" because when the ad is expanded to full size, it "pushes" the page content further down the page below it. Refer to Using the Rich Media Pushdown Template (UAS) for more information.


        3. Select Get Tags  and complete the  General Attributes . Choose  Apply.

        4. Select the  Size .

        5. Third-party tracking pixels:  Use this to track impressions with a tracking pixel. A tracking pixel is code inserted into a third-party creative that makes a server call and returns a transparent 1x1 image (normally a GIF file).  To select a 3rd party tracking system, choose   Add Tracking Pixel  and use the   3rd party Tracking Pixels   drop-down list to select the type of URL you will enter.  Learn More on Macro Usability

        

        6. Type the URL to add the URL that corresponds with the type of tracker you selected.  Choose  the X to delete a particular URL, as you can have multiple URLs added.

        7. Add   Frequency Caps   to specify how often a creative is served in a given time period. You can specify limits for minutes, weeks, hours, and months or a lifetime cap.

GDPR opt-out /PubMatic opt-out:  If a user has not provided the consent to PubMatic (opt-out ), UAS will filter all the Ad Units/Orders/Line Items/Creative that having a frequency cap applied.

 HTML5

  1. To add the HTML5 File, choose  Upload a file  and use the Select File  button to add it, or select  Remote file  and add the URL. 


Important Notes:

  • Expandable HTML5 Creative and Video Creative are not currently supported. (Will be supported in a future release.)
  • If the Zip file contains more than one index file, only one can be selected. (The option will be presented to select the desired index file.)
  • After an index file has been selected in an uploaded zip file, changing the index file requires a re-uploading of the entire zip file.
  • A clickTag must be present in the HTML5 creative and cannot be added as a click-through URL after upload. If added after upload, no click-through URL will be served with the ad creative. However, if a clickTag is available, the click-through URL can be edited in the click-through URL field to change what is present in the HTML creative.
  • If the HTML5 creative contains a meta tag for ad size, and a different ad size is selected while adding the creative in PubMatic, the ad size selected in PubMatic will take precedence.
  • PubMatic validates zip files and index.html files only if they are uploaded in Unified Ad Server. PubMatic will not perform any validations on an index.html files that is hosted on a remote location.
  • Filenames of zip files and the files contained within zip files cannot contain spaces; for example, "my file.zip" is invalid. Filename should be "myfile.zip" or "my_file.zip."


        2. Choose Test URL  to make sure the image displays appropriately.

        3. Click-through URL:  Either select  No Click-through  or, if there is a URL for click-through from the image, select  Click-through URL  and enter the URL in the box provided. Choose  Test                    URL  to make sure the URL opens appropriately.  Learn More on Macro Usability .

Note that clickTag must be already be part of file if uploaded and cannot be added here.

         4. Select the Size from the drop-down list that best fits targeted devices.

The selection in this field will override any meta tag size information.

          5. Third-party tracking pixels:  Use this to track impressions with a tracking pixel. A tracking pixel is code inserted into a third-party creative that makes a server call and returns a transparent 1x1 image (normally a GIF file).
              To select a 3rd party tracking system, choose  Add Tracking Pixel and use the  3rd party Tracking Pixels  drop-down list to select the type of URL you will enter.

           6. Type the URL to add the URL that corresponds with the type of tracker you selected. Choose  the X to delete a particular URL, as you can have multiple URLs added.

           7. Add  Frequency Caps  to specify how often a creative is served in a given time period. You can specify limits for minutes, weeks, hours, and months or a lifetime cap.

GDPR opt-out /PubMatic opt-out:  If a user has not provided the consent to PubMatic (opt-out ), UAS will filter all the Ad Units/Orders/Line Items/Creative that having a frequency cap applied. 

Save

Choose Save or Save and Add Another Creative.

More on Macro Usability

Macros are Pattern strings; for example, %%MARCO_NAME%% which can be use by Publisher in Creative settings at various place like:

  • Click-Through URL,
  • 3rd Party Pixel Tracking ( Impression Tracking / Click Tracking ),
  • Rich Media Tag ( for Rich Media Creative Type ) and so on.

 

You can add one or more macros, if desired by choosing Select Macros, then selecting macros by expanding the list and choosing Add Macro. See Unified Ad Server Macros for details on standard and custom macros. 

 

Once you've configured macros and creative is actually delivering, the Ad Server replaces the Macro in given Tag / URL / Script with actual value if found. 

For example, you have to configure the third party impression tracking URL for your own purpose. In this case you might need to append some random number in URL ( Cache Bursting ) while executing; for example, https://www.your-domain.com/tracker/tracking.png&random=%%RANDOME%%

 

UAS Ad Server replaces the Macro here %%RANDOM%% with some random number while formulating the creative and responding back to ad request which results into  https://www.your-domain.com/tracker/tracking.png&random=0.32342323345 

GDPR: Do Not use the custom key macros to pass data that PubMatic or others could use or recognize as personally-identifiable information or personal data.