Native templates

With the new version of our rendering engine, you can use a new creative template for use in Google Ad Manager. This new template provides additional features such as the advertiser name, an excerpt/description and up to 5 custom fields to be used for sponsored text, call to action, button labels or logo URLs.

Installation

  1. Download the template and extract the zip file
  2. Navigate to Delivery => Creatives => Creative templates in your GAM account (see the Google Ad Manager documentation for more details)
  3. Click the "New creative template" button
  4. Click the import button and select the Jeeng Native 2.0 (JSON).json file you extracted in step (1)
  5. Click "Submit" then "Save to"
  6. A new creative template named Jeeng Native 2.0 (JSON) is now available for use in your GAM account

📘

Multiple Google Ad Manager accounts

If you have multiple Google Ad Manager accounts, you will have to follow steps (2) to (6) for each of those accounts.

Usage

When adding a new creative, first select the advertiser and then pick the Custom creative template option and select the Jeeng Native 2.0 (JSON) option.

Add a creative name and select the target ad unit size.

Make sure to pick the appropriate size as our rendering will use this size to render the ad. This differs from the previous native template integration where the size was set up in our backend.

🚧

Additional sizes

You need to let your account manager know which sizes are serving under the ad unit as our ad server will not request those additional sizes automatically.

Fill in the variables for the creative. By default, only the ClickURL and Headline variables are required. The usage of the other variables will depend on the design of the ads you discussed with your account manager.

The following fields are available:

FieldUsage
ClickURL*Click URL pointing to the advertisement page
Headline*Headline or title
SubtitleSubtitle / Product name / Advertiser domain name
ImageAd image
ExcerptExcerpt or description
AdvertiserNameName of the advertiser
CustomText1Custom piece of content (sponsored text, logo URL, call to action, button label, etc.)
CustomText2Custom piece of content (sponsored text, logo URL, call to action, button label, etc.)
CustomText3Custom piece of content (sponsored text, logo URL, call to action, button label, etc.)
CustomText4Custom piece of content (sponsored text, logo URL, call to action, button label, etc.)
CustomText5Custom piece of content (sponsored text, logo URL, call to action, button label, etc.)
ThirdPartyImpURL1Third-party impression URL used to track impressions delivered
ThirdPartyImpURL2Third-party impression URL used to track impressions delivered

Custom Field Usage

When using the five CustomText fields, additional care is needed when passing content that will not be used as simple text, such as a logo URL or a color. By default, the values are encoded when returned from GAM, and you will have to modify the creative template to remove the encoding when necessary.

Example

To use one of the CustomText fields for an advertiser logo, follow those steps:

  1. (Recommended) Clone the Jeeng Native 2.0 (JSON) creative template. Using separate versions of the creative template will allow you to work with multiple ad formats more efficiently.
  2. Edit the CustomText field you want to use for the logo
    1. Change the type to File
    2. (Optional) Change the variable name to Logo
  3. Edit the Code snippet (if you did not rename the variable, you can skip this step)
    1. Find the line "CustomText1": "[%URI_ENCODE:CustomText1%]",
    2. Replace it with "CustomText1": "[%URI_ENCODE:%Logo%]",
    3. Make sure not to remove the trailing commas and to keep the straight double quotes (curly quotes would render the code snippet invalid)
  4. Save the creative template
  5. When adding a creative, you will now be presented with a Logo field and the ability to upload a file.
Updating a field to use as Logo

Updating a field to use as Logo

Using CustomText1 for the logo URL

Using CustomText1 for the logo URL

Updated UI when adding a creative

Updated UI when adding a creative

Limitations

Due to the additional features and design options, rendering the images takes a bit longer and does not happen in real time. The first time our system sees a creative, it queues it for rendering and serves a backfill ad. As soon as the image is ready, it will be used for subsequent requests.

What this means in effect is that when you traffic a new creative, it will not serve immediately and the first few requests will result in backfill ads or a collapsed ad before the system is able to serve the rendered image. This usually only takes a few seconds so few of your users will see the backfill ads.

Those requests will not be recorded as valid impressions in GAM and you will not be charged service fees for them.

For reference, the following actions will trigger a new rendering:

  • New creative
  • Changes to any of the creative fields that impact the rendered images (usually everything except the Click URL and the two impression trackers)
  • Changes to the rendering templates on our side

Examples

Text ad with call to action

This ad design uses the excerpt for the article description and two of the custom text fields for the sponsored content label and the call to action.

Text ad with list number and link

This ad design uses the excerpt for the link label and two of the custom text fields for the Advertisement label and the list number.

Article-like ad with long excerpt

🚧

Jeeng Native 1.0 (DEPRECATED)

The legacy version of Jeeng’s GAM templates used our internal renderer that had limited customization options. The use of the Jeeng Native 1.0 creative template is no longer encouraged for new integrations.

The following features are available for the 1.0 template:

  • Click URL
  • Image
  • Title
  • Description
  • Third party implementation tracker (one by default, additional ones possible by editing the creative template manually)
  • Customization of the font, background color, text color and positioning of the image and text
    Note: You may already have this template under “PowerInbox Native Ad” in your Google Ad Manager account.

Note: You may already have this template under “PowerInbox Native Ad” in your Google Ad Manager account.

Jeeng Native 1.0 example

Jeeng Native 1.0 example

Q & A


  • Can I run both types of creatives at the same time?
    Yes, it is possible to have both types of creatives running at the same time under your ad units. Each one will render with the target renderer technology. We recommend slowly rotating out the old creatives to keep the look of your ads more consistent.

  • Can I run multiple sizes under the same ad unit with Jeeng Native 2.0?
    Yes, you can now run multiple native creative sizes (previously this was only available for display ads). Simply set multiple accepted sizes for your ad unit and pick one of those sizes when adding your creatives. Our renderer will use the size of the creative when rendering it. Note that there are still some limitations with the CSS / HTML required in your email templates if you want to avoid the images looking too big in some email clients (such as Outlook desktop).

  • Can I collapse my ad placements when using Jeeng Native 2.0?
    Yes, it is now possible to collapse placements when using native ads (previously this was only available for display ads). Simply traffic your native creatives and ask your account manager to configure backfill to collapse in the our backend.

  • Can I run Google Ad Manager real “Native” ads?
    No, those cannot be supported by our integration. You will need to continue to use creative templates. We are working on additional improvements that will give you more direct control over the design of your creatives.