Difference between revisions of "NATS4 IM Popups"

From TMM Wiki
Jump to navigationJump to search
 
(One intermediate revision by one other user not shown)
Line 15: Line 15:
 
On the next page, you will see a section labeled "New IM Popups Adtool." Use the available "Image Zip" field to choose a .zip file of images, videos, or both formats to be used in the IM Popup. You can also use the "Thumbnail" field to upload a thumbnail preview image for this [[Ct#Adtool|adtool]].
 
On the next page, you will see a section labeled "New IM Popups Adtool." Use the available "Image Zip" field to choose a .zip file of images, videos, or both formats to be used in the IM Popup. You can also use the "Thumbnail" field to upload a thumbnail preview image for this [[Ct#Adtool|adtool]].
  
−
[[File:New im popups adtool.PNG|450px|Adding a new IM Popups adtool]]
+
[[File:IMPopup-adtool.png|450px|Adding a new IM Popups adtool]]
  
 
Once you have chosen a site of images to use as content for your IM Popup, you can define all the other available settings for your gallery. These settings include:
 
Once you have chosen a site of images to use as content for your IM Popup, you can define all the other available settings for your gallery. These settings include:
Line 66: Line 66:
 
* <code>Welcome to {$country_name}</code>
 
* <code>Welcome to {$country_name}</code>
 
* <code>Find other people in ($city_name}!</code>
 
* <code>Find other people in ($city_name}!</code>
−
 
−
== Hosted IM Popups ==
 
−
 
−
Some [[Ct#Program Owner|program owners]] may choose to host the necessary IM Popup .zip files on their server, so that [[Ct#Affiliate|affiliates]] do not have to download and host their [[Ct#Adtool|adtools]]. In order to do this, however, you must also provide the HTML source code necessary to display these IM Popups. This allows your [[Ct#Affiliate|affiliates]] to just grab the code they need to display IM Popups and promote your [[Ct#Program|program(s)]], without requiring them to download and host the [[Ct#Adtool|adtool]].
 
−
 
−
In order to display the HTML code required to display a hosted IM popup on the [[NATS4.1 Affiliate Adtools|Affiliate Adtools]] page, you must first edit the [[Ct#Affiliate|affiliate]] [[Ct#Skin|skin]] you want to provide this on. To do so, go to the [[NATS4 Skins and Templates Admin|Skins and Templates Admin]].
 
−
 
−
Locate the [[Ct#Skin|skin]] you want to edit on the [[NATS4 Skins and Templates Admin|Skins and Templates Admin]] main page and click the "Edit Templates" action icon. Once you have done that, find the ''function_display_adtools_interactive_min'' [[Ct#Template|template]] and click the "Customize" action icon.
 
−
 
−
On the next page, enter your desired code into the [[Ct#Template|template]] body shown here. The following provides some example code to help you get started:
 
−
 
−
Add something like this:
 
−
<pre>
 
−
<div><textarea>MyText</textarea></div>
 
−
</pre>
 
−
 
−
To the ''function_display_adtool_interactive_min [[Ct#Template|template]] in the ''foreach'' loop:
 
−
<pre>
 
−
{foreach from=$adtools item=tool key=adid name=ads}
 
−
</pre>
 
−
 
−
This allows you to add your own HTML source to the page.
 
−
 
−
Save your [[Ct#Template|template]] once you have finished making your desired changes. Your [[NATS4.1 Affiliate Adtools|Affiliate Adtools]] page will now display the HTML source code necessary for your [[Ct#Affiliate|affiliates]] to display IM Popups hosted on your servers.
 
  
 
[[Category:NATS4 Adtool Types]]
 
[[Category:NATS4 Adtool Types]]

Latest revision as of 14:46, 21 July 2011

NATS 4
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
Mailers
Feeds
Content
Fan Signs
Flash Videos
Embedded Videos
Hosted Videos
Page Peels
IM Popups
Footer Ads
Page Ads
Hosted Free Sites
Overlays

The IM Popups Adtool type allows you to create multimedia popup advertisements in the form of an instant message box on your site's pages, providing an interactive advertising method that lets you speak to surfers and members.

IM Popups can also take certain Smarty variables, allowing you to automatically tailor your IM popup ads to information acquired from your affiliate or surfer. For information, please see the Custom Variables section below.

Creating an IM Popup

You can create a new IM Popup advertisement and upload photos to use with your IM Popup through the Adtools Admin. Simply go to the Adtools Admin, scroll down to the "Interactives Types" category, and click the "View Adtools" action icon next to the "IM Popups" adtool type.

The Interactives adtool category

On the next page, you will see a section labeled "New IM Popups Adtool." Use the available "Image Zip" field to choose a .zip file of images, videos, or both formats to be used in the IM Popup. You can also use the "Thumbnail" field to upload a thumbnail preview image for this adtool.

Adding a new IM Popups adtool

Once you have chosen a site of images to use as content for your IM Popup, you can define all the other available settings for your gallery. These settings include:

  • Name - The name of your IM popup advertisement.
  • HTML Source - Input the desired HTML code and body text for your popup advertisement.
  • Enabled on - Choose a site (or all sites) that you want this gallery to be enabled for.
  • Publish Date - Input what date you want this gallery to be available from.
  • Default Group - Select an adtool group to categorize the gallery under.

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

Your new IM Popup will now appear in the "IM Popups Adtool" table, along with your other available IM Popup advertisements. This table provides you with the ID number, name, and default group of each available IM Popup adtool.

Displaying an IM Popup

In order to display your IM Popup adtool on one of your pages, you must first download the corresponding .zip file from NATS through the Affiliate Adtools page. This .zip file will contain the image file, along with header_inc, jquery, and main scripts. It will also include the AC_OETags and pageear scripts.

Upload these scripts to your server, and copy them into the templates you wish to display your IM Popup on. Make sure that you include the header_inc script (ideally in the header) before the main script in your template(s), otherwise your IM popup will not display properly.

Before you can include your new IM Popup 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 IM Popup.

Adding rule for your IM Popup

On the next page, simply add a "SHOW" type rule for the affiliate(s), program(s), and site(s) you want this gallery to be enabled for. You can also choose to enable this gallery for all affiliates, programs, and sites. For more information on rules in NATS4, please see our NATS4 Rules wiki article.

Custom Variables

NATS4.1 allows for certain Smarty custom variables with IM Popups. For example, this can allow for customized text in your popup, 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.

To output values for the surfers' locations, enter the necessary Smarty code in the "HTML Source" field, found when editing an IM Popup in the Adtools Admin.

For example:

  • Welcome to {$country_name}
  • Find other people in ($city_name}!
Retrieved from "https://tmmwiki.com/index.php?title=NATS4_IM_Popups&oldid=13129"