Offerit IM Popups - Revision history

OfferitMegan at 14:36, 16 August 2012

2012-08-16T14:36:34Z

OfferitRobC: /* Displaying an IM Popup */

2011-12-28T20:28:58Z

‎Displaying an IM Popup

OfferitRobC: /* Creating an IM Popup */

2011-12-28T20:27:20Z

‎Creating an IM Popup

OfferitRobC at 17:39, 28 December 2011

2011-12-28T17:39:58Z

OfferitRobC: /* Creating an IM Popup */

2011-12-21T17:47:37Z

‎Creating an IM Popup

OfferitRobC: Created page with "{{Offerit Manual | show_creative_types_section = true }} The IM Popups Creative type allows you to create multimedia popup advertisements in the form of an insta..."

2011-12-20T20:55:45Z

Created page with "{{Offerit Manual | show_creative_types_section = true }} The IM Popups Creative type allows you to create multimedia popup advertisements in the form of an insta..."

New page

{{Offerit Manual
| show_creative_types_section = true
}}

The IM Popups [[Ct#Creative|Creative]] type allows you to create multimedia popup advertisements in the form of an instant message box on your [[Ct#Offer|offer's]] pages, providing an interactive advertising method that lets you speak to [[Ct#Surfer|surfers]] and [[Ct#Customer|customers]].

IM Popups can also take certain [[Smarty]] variables, allowing you to automatically tailor your IM popup ads to information acquired from your [[Ct#Affiliate|affiliate]] or [[Ct#Surfer|surfer]]. For information, please see the [[#Custom Variables|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 [[Offerit Creatives Admin|Creatives Admin]]. Simply go to the [[Offerit Creatives Admin|Creatives Admin]], scroll down to the "Interactives Types" category, and click the "View Creatives" action icon next to the "IM Popups" [[Ct#Creative|creatives]] type.

[[File:Adtools admin interactives.PNG|450px|The Interactives Creative Category]]

On the next page, you will see a section labeled "New IM Popups Creative." 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#Creative|creative]].

[[File:IMPopup-adtool.png|450px|Adding a new IM Popups creative]]

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 an offer (or all offers) that you want this gallery to be enabled for.
* '''Publish Date''' - Input the date you want this gallery to be available from.
* '''Default Group''' - Select an creative group to categorize the gallery under.

Once you have defined all of the available fields, click "Add Creative" to add your new IM Popup advertisement to [[Offerit]].

Your new IM Popup will now appear in the "IM Popups Creative" 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 [[Ct#Creative|creative]].

== Displaying an IM Popup ==

In order to display your IM Popup creative on one of your pages, you must first download the corresponding .zip file from [[Offerit]] through the Affiliate Creatives 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 [[Ct#Template|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 [[Ct#Template|template(s)]], otherwise your IM popup will not display properly.

Before you can include your new IM Popup on one of your [[Ct#Offer|offers]], you must first add a [[Offerit Rules|"SHOW" rule]]. To do so, click on the "Add a new [[Offerit Rules|rule]]" action icon next to your new IM Popup.

[[File:Add im rule.PNG|450px|Adding rule for your IM Popup]]

On the next page, simply add a "SHOW" type rule for the affiliate(s), commission(s), and offer(s) you want this gallery to be enabled for. You can also choose to enable this gallery for all affiliates, commissions, and offers. For more information on rules in [[Offerit]], please see our [[Offerit Rules]] wiki article.

== Custom Variables ==

[[Offerit]] allows for certain [[Smarty]] custom variables with IM Popups. For example, this can allow for customized text in your popup, depending on the [[Ct#Surfer|surfer]] or [[Ct#Affiliate|affiliate]]'s location. You can output a surfer's country name, city name, area code, postal code, etc.

Supported [[Smarty]] variables include:

<pre>
$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"));
</pre>

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

To output values for the [[Ct#Surfer|surfers']] locations, enter the necessary [[Smarty]] code in the "HTML Source" field, found when editing an IM Popup in the [[Offerit Creatives Admin|Creatives Admin]].

For example:
* <code>Welcome to {$country_name}</code>
* <code>Find other people in ($city_name}!</code>

@@ Line 15: / Line 15: @@
 On the next page, you will see a section labeled "New IM Popups Creative." 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#Creative|creative]].
-[[File:IMPopup-adtool.png|450px|Adding a new IM Popups creative]]
+[[File:Admin_New_IM_Popups_Creative.png|600px|Adding a new IM Popups creative]]
 Once you have chosen a zip 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 3: / Line 3: @@
 }}
-The IM Popups [[Ct#Creative|Creative]] type allows you to create multimedia popup advertisements in the form of an instant message box on your [[Ct#Offer|offer's]] pages, providing an interactive advertising method that lets you speak to [[Ct#Surfer|surfers]] and [[Ct#Customer|customers]].
+The IM Popups [[Ct#Creative|Creative]] type allows you to create multimedia popup advertisements in the form of an instant message box on your [[Ct#Offer|offer's]] pages, providing an interactive advertising method that lets you speak to [[Ct#Visitor|visitors]] and [[Ct#Customer|customers]].
-IM Popups can also take certain [[Smarty]] variables, allowing you to automatically tailor your IM popup ads to information acquired from your [[Ct#Affiliate|affiliate]] or [[Ct#Surfer|surfer]]. For information, please see the [[#Custom Variables|Custom Variables]] section below.
+IM Popups can also take certain [[Smarty]] variables, allowing you to automatically tailor your IM popup ads to information acquired from your [[Ct#Affiliate|affiliate]] or [[Ct#Visitor|visitor]]. For information, please see the [[#Custom Variables|Custom Variables]] section below.
 == Creating an IM Popup ==
@@ Line 43: / Line 43: @@
 == Custom Variables ==
-[[Offerit]] allows for certain [[Smarty]] custom variables with IM Popups. For example, this can allow for customized text in your popup, depending on the [[Ct#Surfer|surfer]] or [[Ct#Affiliate|affiliate]]'s location. You can output a surfer's country name, city name, area code, postal code, etc.
+[[Offerit]] allows for certain [[Smarty]] custom variables with IM Popups. For example, this can allow for customized text in your popup, depending on the [[Ct#Visitor|visitor]] or [[Ct#Affiliate|affiliate]]'s location. You can output a visitor's country name, city name, area code, postal code, etc.
 Supported [[Smarty]] variables include:
@@ Line 61: / Line 61: @@
 The above examples define your [[Smarty]] variables, such as $country_code, $country_name, $postal_code, etc.
-To output values for the [[Ct#Surfer|surfers']] locations, enter the necessary [[Smarty]] code in the "HTML Source" field, found when editing an IM Popup in the [[Offerit Creatives Admin|Creatives Admin]].
+To output values for the [[Ct#Visitor|visitors']] locations, enter the necessary [[Smarty]] code in the "HTML Source" field, found when editing an IM Popup in the [[Offerit Creatives Admin|Creatives Admin]].
 For example:
 * <code>Welcome to {$country_name}</code>
 * <code>Find other people in ($city_name}!</code>

@@ Line 37: / Line 37: @@
 Before you can include your new IM Popup on one of your [[Ct#Offer|offers]], you must first add a [[Offerit Rules|"SHOW" rule]]. To do so, click on the "Add a new [[Offerit Rules|rule]]" action icon next to your new IM Popup.
-[[File:Add im rule.PNG|450px|Adding rule for your IM Popup]]
+[[File:Admin_IM_Popups_Rules.png|600px|Adding rule for your IM Popup]]
 On the next page, simply add a "SHOW" type rule for the affiliate(s), commission(s), and offer(s) you want this gallery to be enabled for. You can also choose to enable this gallery for all affiliates, commissions, and offers. For more information on rules in [[Offerit]], please see our [[Offerit Rules]] wiki article.

@@ Line 11: / Line 11: @@
 You can create a new IM Popup advertisement and upload photos to use with your IM Popup through the [[Offerit Creatives Admin|Creatives Admin]]. Simply go to the [[Offerit Creatives Admin|Creatives Admin]], scroll down to the "Interactives Types" category, and click the "View Creatives" action icon next to the "IM Popups" [[Ct#Creative|creatives]] type.
-[[File:Adtools admin interactives.PNG|450px|The Interactives Creative Category]]
+[[File:Admin_Interactive_Types_Creatives.png|600px|The Interactives Creative Category]]
 On the next page, you will see a section labeled "New IM Popups Creative." 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#Creative|creative]].

@@ Line 17: / Line 17: @@
 [[File:IMPopup-adtool.png|450px|Adding a new IM Popups creative]]
-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 zip 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.