NATS4 Geo Banners

From TMM Wiki
Jump to navigationJump to search
Members Admin
The Members Admin
View Member Details
Add Member
MySQL Auth
Mod Authn DB
Multisite Access
Member Logging
Member Password Retrieval
OpenID Connect
Mod Auth OpenIDC
ID Numbers
    Default Adtool Types
Adtool Types
Image Banners
Geo Banners
Flash Banners
Free Hosted Galleries
Fan Signs
Flash Videos
Embedded Videos
Hosted Videos
Page Peels
IM Popups
Footer Ads
Page Ads
Hosted Free Sites

The Geo Banners Adtool type allows you to add custom text to an image banner through an automated process in NATS, providing an easy way to customize banners for different affiliates and surfers.

Geo Banners in the Adtools Admin

In addition to allowing for custom text, Geo Banners can also take certain Smarty variables, allowing you to automatically tailor your banner ads to information acquired from your affiliate or surfer. For information, please see the Custom Variables section below.

Uploading a Geo Banner Image

You can upload a new image to be used as a Geo Banner through the Adtools Admin. Simply go to the Adtools Admin and click the "View Adtools" action icon next to the "Geo Banners" adtool type.

On the next page, you will see a section labeled "New Geo Banners Adtool." Use the available "Click to Browse for Image" link to upload the image file you wish to use for your new geo banner.

Adding a new Geo Banner

Once you have selected an image to use as your new geo banner, you can decide what text you want to add to the banner with the "Details" settings under the "New Geo Banners Adtool" section. Here, you can define the following settings:

  • Default Text - Input the text you want to be displayed on your geo banner. This field also accepts certain Smarty variables.
  • Text Align - Choose if you want the text to be aligned to the left, center, or right.
  • Vertical Align - Choose if you want your text to be at the top, center, or bottom of the banner.
  • Text Size - Input your desired font size for banner text here.
  • Text Color - Clicking the available field will bring up a color wheel, where you can select your desired font color.
  • Text Font - Choose your desired font for the geo banner.
  • Text Angle - Allows you to skew your banner text at a selected angle.
  • Text X Coordinate - Input the horizontal coordinates for your banner text.
  • Text Y Coordinate - Input the vertical coordinates for your banner text.
  • Text Max Width - Choose the maximum pixel width you want your banner to be displayed at.
  • Text Max Height - Choose the maximum pixel height you want your banner to be displayed at.

Once you have defined all of the available fields, click "Add Adtool" to add your new Geo Banner to NATS.

Displaying a Geo Banner

Before you can include your new Geo Banner on one of your sites, you must first add a "SHOW" rule. To do so, click on the "Add a new rule" action icon next to your new geo banner. On the next page, simply add a "SHOW" rule type for the affiliate(s), program(s), and site(s) you want this banner to be enabled for. You can also choose to enable this banner for all affiliates, programs, and sites. For more information on rules in NATS4, please see our NATS4 Rules wiki article.

Adding a rule for your geo banner

Once you create a "SHOW" rule for your new geo banner, affiliates will be able to grab the linkcode for that banner through their Ad Tools page.

Custom Variables

NATS4 allows for certain Smarty custom variables to be used when adding text to Geo Banners. This allows for customized text in your banner, depending on the surfer or affiliate's location. You can output a surfer's country name, city name, area code, postal code, etc.

Supported Smarty variables include:

$smarty->assign('country_code', $countrycode);
$smarty->assign('country_name', apache_note("GEOIP_COUNTRY_NAME"));
$smarty->assign('city_name', apache_note("GEOIP_CITY"));
$smarty->assign('region', apache_note("GEOIP_REGION"));
$smarty->assign('metro_code', apache_note("GEOIP_DMA_CODE"));
$smarty->assign('area_code', apache_note("GEOIP_AREA_CODE"));
$smarty->assign('latitude', apache_note("GEOIP_LATITUDE"));
$smarty->assign('longitude', apache_note("GEOIP_LONGITUDE"));
$smarty->assign('postal_code', apache_note("GEOIP_POSTAL_CODE"));

The above examples define your Smarty variables, such as $country_code, $country_name, $postal_code, etc.

Adding Smarty code to your geo banner

To output values for the surfers' locations, enter the necessary Smarty code in the "Default Text" field, found when editing a geo banner in the Adtools Admin.

For example:

  • Welcome to {$country_name}
  • Find other people in ($city_name}!