HTML Insertion Points

 HTML Insertion Points

The Actinic system was essentially designed and developed for users with no programming knowledge and for those who do not necessarily know how to use JavaScript or HTML code.

In the large majority of cases, it is not at all necessary to know these languages to design a site with the Actinic solution.

However, there are many actors on the Internet today and some of them propose interesting services but, because of their variety, require a supplemental programming possibility for your site, and not just an additional configuration possibility.

Note that the need to use these advanced services often signifies that you are already taking in dozens (if not hundreds) of orders every month. If this is not the case, there are other ways to intelligently invest in your site with more simple tools. Don't forget that on the Internet, like in life, the best is often the enemy of the good. Before throwing yourself into complex affiliation systems, verify that you are already using all of the basic available systems (price engines, newsletters, etc.). The same goes for Google Analytics. Verify beforehand that you have gone to the limits of what you can achieve with the statistics provided by Actinic. This is a very important note. One of the biggest causes of failure on the net is that the necessary steps that need to be followed during the development of a site are not executed. Do things in the right order.

The Actinic system provides a certain number of entry points that allow you to integrate complex solutions. But be careful! We are addressing techniques here that are intended for experienced users (if not very experienced), and Actinic technical support may not be able to help you if you need to write your own JavaScript or HTML code. Actinic support technicians are trained to solve problems related to the Actinic platform and under no circumstances are they able to build or debug scripts that may have been supplied to you by another company.

Keep in mind that it is absolutely possible to place JavaScript or HTML code in the simple home page of your site or in WebBlock text blocks. This can allow you to insert some simple services. In addition, the advertising banner management tool is perfectly adapted to manage these services without needing to program in HTML or JavaScript.

That being said, there are other services (complex statistics, affiliations, campaign tracking, etc.) that require a more advanced integration. For this purpose, Actinic puts 5 free blocks at your disposal that can be inserted in strategic places throughout your site.
 
 Free Text Blocks (Insertion Points)

These blocks can be independently defined for each language used by your site (English, Spanish, French, etc.) and are located in the page accessible through the [Site\Properties by Language] menu.

HTML Header Block
This block is inserted at the end of the HTML header of your site just before the HTML end tag </HEAD>. You can, among other things, use this block to insert content description metadata necessary for navigators and parental control software. For more information, consult the Internet Content Rating Association's website (ICRA - http://www.icra.org/)
WARNING: This property is not designed to introduce SEO tags and keyword tags. For this purpose, use the SEO Properties page of the Marketing menu.

Block start <BODY> (Your code is placed just after the <BODY> tag)
This block is inserted in the body of the page just after the HTML opening tag <BODY>.
If defined, this block is inserted in the source code of all of the pages of your site.

Block end </BODY> (Your code is placed just before the </BODY> tag)
This block is inserted in the body of the page just before the HTML end tag </BODY>.
If defined, this block is inserted in the source code of all of the pages of your site.
This block is especially useful for inserting an external visit statistics solution. In this block, you can insert JavaScript code and you are able to use several variables that have already been filled in by Actinic. Here are several examples of these variables:
var OxCompName = "" ; //The Actinic component name, this is an invariable mnemonic name in English.
var OxPageName = "" ; //The page title or WebBlock name.
var OxCatName = "" ; //The name of the category selected in the component.

Let's take an example illustrating the use of these variables. Simply copy the code below in the block and then navigate on your site. You should see this information displayed on the bottom of each page.

<script type="text/javascript">
var strStatName = OxCompName ;
if ( OxPageName.length > 0 ) strStatName = strStatName + "/" + OxPageName ;
if ( OxCatName.length > 0 ) strStatName = strStatName + "/" + OxCatName ;
if ( strStatName.length > 0 ) document.write( strStatName );
</script>

By default, external statistics tools uses the site URLs to point to statistics, which doesn't allow for easily exploitable results. Indeed, the example "http://www.mysite.com/PBCPPlayer.asp?ID=103584" is much less explicit than "Detailed Price List". However, it is often possible to pass on specific information using the statistics tool. This is when the variables presented by Actinic will turn out to be very useful. For more information, read the case study about Google Analytics at the end of this document.

Shopping Cart Block: Intent of purchase page
This block is inserted in the body of the intent of purchase page. This is the last page before payment in the purchasing process. This is the page that contains the order summary and possibly the final terms of sale acceptance validation. This block can be used to insert a code provided by certain affiliation programs in order to know the number of abandoned purchases before order validation or during the payment phase.
Actinic fills in a certain number of variables relating to the order (the values given here are used as an example):
var OxOrderSubTotal = 100.00 ; //Total before tax of items in shopping carts.
var OxOrderSubTotalTax = 19.60 ; //Tax total relating to the elements in the shopping cart.
var OxOrderShipPrice = 10 ; //Shipping total before tax.
var OxOrderShipTax = 1.96 ; //Tax total associated to the shipping mode.
var OxOrderTotalTax = 21.56 ; //Total taxes applied to the order.
var OxOrderTotal = 131.56 ; //Order total after tax.
var OxCustEmail = "smith@domain.com" ; //Customer email associated with the order.

Shopping Cart Block: Confirmed purchase page
This block is inserted in the body of the purchase confirmation page if and only if the payment is accepted. Note that for certain payment types (check, cash on delivery, credit customer) the payment is always accepted. In this block, you are authorized to use to the same variables as those defined in the intent of purchase page in addition to the following variables (the values given here are used as an example):
var OxOrderID = 123456 ; //The order number.
var OxCustCity = "London" ; //The buyer's city.
var OxCustState = "" ; //The buyer's region/county.
var OxCustZipCode = "75016" ; //The buyer's postal code.
var OxCustCountry = "England" ; //The buyer's country.

If an affiliation service asks you to place the following code after the order confirmation:
<IMG src="https://www.affiliate.com/recordtrans.asp?orderid=#ORDERID#&amount=#ORDERAMOUNT#&email=#EMAIL#">

where the #ORDERID#, #ORDERAMOUNT# and #EMAIL# tags need to be respectively replaced by the order number, the order total after tax and the buyer's email, you are going to use the following JavaScript code:

<SCRIPT type="text/javascript" language="javascript">
var strHTML = '<IMG src="https://www.affiliate.com/recordtrans.asp?' ;
strHTML = strHTML + 'orderid=' + OxOrderID + '&amp;amount=' + OxOrderTotal ;
strHTML = strHTML + '&amp;email=' + OxCustEmail + '">' ;
document.write( strHTML );
</SCRIPT>

There are many possible cases and this JavaScript code represents an example that can be easily adapted to other situations.
 
 Case Study: Google Analytics

Fundamentally, Google Analytics is a statistics tool allowing you to manage affiliates.
The Google Analytics site can be accessed through the following address:
http://www.google.com/analytics/

Important: Google Analytics is a program that is constantly evolving. The JavaScript codes provided in this case study may be modified by Google without notice. Therefore, it is highly recommended that you verify these codes in the Google Analytics' online help when placing this interface on you site.

Once registered, Google Analytics will provide you with a Google Analytics account number in the following form: "UA-xxxxxx-x". Replace this account number in the following code with the one provided by Google Analytics:

<script">
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');

ga('create', 'UA-########-#', 'auto');
ga('send', 'pageview');

</script>

Next, click on the [Site\Properties by Language] menu and copy this code in the "End <BODY> block (just BEFORE </BODY>)" of your site. After positioning this code, all of the displayed pages of your site will be recorded in the Google Analytics statistics. This code provides Google Analytics with "legible" page names based on the component title or WebBlock name.

Campaign Tracking with Google Analytics

Google Analytics is integrated into Google Adwords. If you already use Google Adwords and you have integrated the Google Analytics code described above, then you will have access to the statistics results of your Google Adwords campaigns.

To know the return on investment (ROI) of your campaigns, Google Analytics needs to know the orders that are carried out successfully on your site. By adding the following code in the "Shopping Cart: Confirmed purchase page", you are going to be able to provide this information to Google:

<SCRIPT type="text/javascript" language="javascript">
function OxBODYOnLoad() {
var fShipTotal = OxOrderShipPrice + OxOrderShipTax ;
var pageTracker = _gat._getTracker("UA-xxxxxx-x");
pageTracker._addTrans(
OxOrderID, // order ID - required
"", // affiliation or store name
OxOrderTotal, // total - required
OxOrderTotalTax, // tax
fShipTotal.toFixed(2), // shipping
OxCustCity, // city
OxCustState, // state or province
OxCustCountry // country
);

for( var nIdx = 0; nIdx < OxOrderDetail.length ; nIdx++ ) {
pageTracker._addItem(
OxOrderID, // order ID - required
OxOrderDetail[nIdx][0].replace( /|/g, ""), // SKU/code
OxOrderDetail[nIdx][1].replace( /|/g, ""), // product name
"", // category or variation
OxOrderDetail[nIdx][2], // unit price - required
OxOrderDetail[nIdx][3] // quantity - required
);
}
pageTracker._trackTrans();
}
</SCRIPT>

If you examine this code carefully, you will notice the definition of the JavaScript function OxBODYOnLoad(). If it is defined, this function is automatically called when a page from the Actinic system is loaded. It is used here to prepare the necessary information for Google Analytics.

Important Warnings:
  • Actinic can in no case be held responsible for the poor execution of inserted codes.
  • Actinic support cannot offer help with the implementation of specialized codes from third party providers.
  • Actinic is not responsible for any difference in results (statistics, return on investment, etc.) that may be supplied by 2 outside services or by one outside service and the same service provided by Actinic. Actinic support can in no case spend time examining the why or how of divergent results, the causes of which may be multiple (unavailability of outside servers, partial page loads, supplemental code preventing execution, conflicting codes, etc.).
 

Add to favorites: http://www.actinic.co.uk/Help/HelpCenterContent.asp?ActionID=512&TID=55022&MID=3000&LangID=1
© 2001-2018 Actinic. All rights reserved.