Tips & Tricks

How to run only one cron task

We would like to describe you a bit about what's new in thecron job system related toyour Post affiliate Pro/Network installation. As default .. everything works like before (you can execute all cron job tasks at once and several times by a single click on the execution button) but there isa really cool improvement (latest PAP/PAN versions) which you can use for execute one task only.. For example: You can run a task which is stuck due to some other stuck task and practically cron job looks like...

Referred affiliate signup is not registered under parent affiliate

In this case we recommend to check what tracking codeyou have in the signup page source code. Most of older Post affiliate pro releases have/had this one: <script id="pap_x2s6df8d" src="../scripts/trackjs.php (view-source:http://nogluepap.postaffiliatepro.com/scripts/trackjs.php)" type="text/javascript"></script> <script type="text/javascript">papTrack();</script> Problem was that from time to time such code didnot register a par...

Using google recaptcha on custom signup page

To implement google recaptcha to work on your custom HTML signup page in same way as in signup form on your pap application pages you need just do simple steps here. Currentlyweareusinggooglerecaptchaversion1.0.AftercreatingyourcustomHTMLsignuppagefollowingthisarticlehttp://support.qualityunit.com/791436-HTML-signup-form all you need is just to input following code into <form> tags of your HTML form: <script type="text/javascript">var RecaptchaOptions = { theme : 'custom', ...

How can merchant login as an affiliate

In some cases you might want to log in as one of your affiliates. For example to get the link/banner code for some particular affiliate, or simply just to have a look at what the affiliate sees in their panel. There is a convenient way how to do it directly from your merchant panel even without knowing the affiliate credentials. You need to navigate to Affiliates> Affiliate manager section and there click the pencil icon next to the affiliate under whom you want to log in. In upper right cor...

How to make the affiliates to accept the new terms and conditions

Let's say your Terms and Conditions in your affiliate program are about to change and you want to make sure your affiliates accept them again. The solution would be as follows: First of all, send all your affiliates a message that the terms and conditions have changed and that in X days (e.g. 3), their accounts will be set to pending and it will be approved only if they accept the new terms and conditions at the following URL:http://URL_TO_PostAffiliatePro/affiliates/TermsAndConditions.php You...

Track subID dynamically

Several customers of ours asked: "How could our affiliates dynamically track their subID or their custom data dynamically when a customer clicks the affiliate's banner?" The answer is this: First of all the merchant (or network owner in case of Post Affiliate Network) must enable in Post Affiliate Pro at _Configuration > Tracking settings _the "_Create channels automatically_" option. Now, let's say the affiliate copies the banner code from the affiliate panel and place...

How to put the affiliate program into maintenance (under construction) mode

The solution goes like this: 1) Create an own 'signup page' theme at_ Configuration > Design > Signup page theme_ by clicking "_Edit theme_" on the currently active theme http://support.qualityunit.com/886156-Making-your-own-theme 1.1.) _Disabling the mini-site (information page)_ - in that own theme look up main_static_html_doc.stpl and in that template file find the <body> tag and right under that tag (so into a new line) put this: <h1>Under construction</h1>...

Pay commissions only for unique clicks

Post Affiliate Pro (network) tracks by default all clicks on affiliate links/banners. However, if you wish to pay a commisison only for unique clicks, then it is essential to set up a fraud protection against repeating clicks at _Configuration > Fraund protection > Clicks (tab)_ just like it is in the image below:

Date format in templates

If you wanted to change date format for some reason, it is possible to do it within templates. The system has its own format set, but your templates can use a different one. The date variable is{$date}. The output depends on your general settings. To change it you can use this format: {$date|date_format:'%d.%m.%Y'} where %d represents days, %m represents months and %Y represents year. You can read more about the format at Smart webpage: http://www.smarty.net/docsv2/en/language.modifier.date.form...

Replicated site at custom location and WordPress permalinks

Let's say you wish to replicate _http://yoursite.com_ WP page and that page uses permalinks. You want to have site replication links like e.g. _http://yoursite.com/referralid_ but you also want to have _http://yoursite.com_ available and usable just like before. How to achieve it?: - the best thing would be to have the files to be replicated in a different directory (different subdomain). But maybe it won't be necessary and the site replication may work even without that. So you may simply ref...

Change the default wallpaper of Blue Aero affiliate panel theme

_NOTE: Change of the default wallpaper is currently not possible on our__hosted accounts_ (http://www.postaffiliatepro.com/in-house-affiliate-program-hosting/) First of all you have to create a copy of the original Blue Aero affiliate panel theme, so that your changes do not get overwritten upon upgrade of Post Affiliate Pro.In order to create a copy of the Blue Aero affiliate panel theme navigate in the merchant panel to _Configuration > Design > Affiliate panel theme >_ click "_...

Overview

In this section we will show some interesting stuff that can be done with Post Affiliate Pro. Most of articles here will be presented as examples or case studies.

How to integrate Post Affiliate Pro with Google Analytics?

Some merchants wish to be able to track statistics in their Google Analytics account regarding affiliate-referred visits. In order to achieve that, the following has to be accomplished: * Use the Google Analytics URL builder (http://support.google.com/analytics/bin/answer.py?hl=en-GB&answer=1033867&topic=1032998&ctx=topic) to generate the URLs that lead to your e-commerce site so that they may be used as a "Destination URL" in thebanners (http://www.qualityunit.com/po...

How to re-send data from ASP

I was looking for a solution for a long time and finally I got it. The problem originates in need to resend data from an IPN processing script to another script. This is a main problem when integrating e.g. with PayPal. In PHP this is easy, as you can use cURL code. The problem however is with ASP code. It is not possible to use cURL in ASP as you know, so you cannot use this solution in case your IPN script is ASP. The solution is to use objHttp object in ASP (VB.NET):Dim objHttp: Set objHttp ...

How to highlight the selected menu in affiliate panel

When you are using "Classic Wide for affiliate panel" theme in affiliate panel and you want the selected menu item to be highlighted you can add the following code into your theme's pap4.css file: .MenuEntry-active {background:url('img/menu.entry.back-over.gif') repeat-y top left;} .MenuEntry-active .MenuEntryIn {background:url('img/menu.entry.top-over.gif') no-repeat top left;} .MenuEntry-active .MenuEntryIn2 {background:url('img/menu.entry.bottom-over.gif') no-repeat bottom left; _h...

Hide the "Download Our Signup & Login Form" section in the affiliate panel

In the affiliate panel at _Promotion > Advanced tools > Signup subaffiliates_ there is a section called "Download Our Signup & Login Form" If you wish to hide that section then you will have to follow the steps below: 1)in the merchant panel at "Configuration > Design > Affiliate panel theme" click 'Edit them' on the currently active theme (in case a dialog pops up claiming to create a new theme, thenread here (http://http://support.qualityunit.com/knowledg...

Import/upload custom transaction (update transactions)

You can use this for importing transactions from custom csv file or you can update existing transactions. (E.g. you can update status of existing transactions by transaction Id or by order Id)Create csv file For importing transactions you needto create a .csv style sheet which has to be in UTF-8 formating and also you should create it with a non-ritch text editor (e.g. PsPad) and use either a coma or semicolon separator. E.g. it could look like: affiliate id,campaign id, order id,commission,tot...

How to automatically log in as an affiliate

You can do it using API (http://support.qualityunit.com/knowledgebase/post-affiliate-pro/programmers-documentation/api.html): <?php$papURL = "http://URL_TO_PostAaffiliatePro"; //URL of Post Affiliate Pro installation without any trailing slash$mUsername = "merchant@username.com"; //replace it with your merchant username$mPassword = "123456"; //replace it with your merchant password //The API file can be downloaded in the merchant panel: Tools > Integration &...

How to add a special sale bonus to special affiliate

Lets say you have a close friend in your affiliate system and you want to pay him special commissions - not based on total cost. You can do this by the sale tracking code and some PHP coding. Or there is another case when you have a gallery shop, where you pay some commissions to the affiliates, but also to authors of the paintings... How to do it Let's say, you have an affiliate Phill, with referral ID of phil007 and affiliate ID of 53s5er28. You want to give himfor each sale5$ + his commissio...

Quick launch icons in Blue Aero theme

Did you know this menu supports drag and drop? Affiliates and merchants can modify it easily...Each affiliate will have different menu. All icons in windows are possible to be dragged or added to the menu. So, if you want to have some new icon in quick menu you can do it the following way: 1) Open the desired window and drag the icon found in its top-left corner to the quick launch bar 2)Open the desired window and right-click its top bar and choose "Add to Quick Launch" To del...

Invite affiliate to the campaign after signup

Some customers are interested in inviting affiliates into a campaign after signupautomatically. Here is the code that was originally posted at our forum: <?php require_once("../api/PapApi.class.php"); //---------------------------------------------- // get form data from signup page $data = (isset($_REQUEST['data']) && !empty($_REQUEST['data']))?$_REQUEST['data']:''; //---------------------------------------------- // create login session for merchant $session = new Gpf_...

Assign limited number or amount of commissions for each affiliate

Sometimes a merchant wants to assign limited number of commissions for each affiliate, so not to reward affiliate for each sale he refers. You would need to activate two features: Commission groups (http://support.qualityunit.com/knowledgebase/post-affiliate-pro/features-and-functions/commission-groups.html) and Performance rewards. (http://support.qualityunit.com/knowledgebase/post-affiliate-pro/features-and-functions/performance-rewards.html) Lets say, that you would like to give at most 5 co...

How to process IPN using Pearl

You just need to add following code into your IPN processing script: $req->uri("http://yoursite.com/affiliate/plugins/PayPal/paypal.php (http://www.workoutsoft.com/Affiliate/plugins/PayPal/paypal.php)"); $ua->request($req); Here is the full context of the script: #!/usr/bin/perl # read post from PayPal system and add cmd read( STDIN, $query, $ENV{CONTENT_LENGTH} ); $query .= &cmd=_notify-validate; # post back to PayPal system to validate data use LWP::UserAgent; us...

How to add monthly commission bonus

This scenario will show you a simple script that you can use for assigning special commission bonus to affiliates. Requirements You will need one php file into which you will add the code. If you want to do this automatically, you will need a cron job. Code <?php $array = array('11111111', '41802005', 'd71d2189'); // here you have to add all bonus affiliates IDs or refIDs for ($i = 0; $i < size($array); $i++) { echo '<img src="http://www.yoursite.com/pap_4/scripts/sale.php?Tot...

How to create PayPal non-hosted non-encrypted buttons?

Please note that your PayPal buttons can't be integrated if they are hosted so you have to follow this guide to create non-hosted, non-encrypted buttons which can be integrated. Step 1: Log into your PayPal account and navigate to Merchant Services > Buy Now Buttons Step 2: Fill the required fields with your own product name, currency, price etc. When you're finished, do no click on "Create Button", but instead click on "Step 2: Track inventory, profits & loss (optional)...

Register click commission only in case the sale was made

Sometimes you want to pay affiliates per click too. This is quite usual, but unusual is to make sure the click ended with successful sale. If you want such check you need to hack it a little bit... To explain the logic You want to register a click commission only when the customer will also order something. It is not possible to pay real click commission in this scenario, but we will add the "click" commission right in the sale script. The sale tracking script is registering the sale ...

How to add referral box into site

You might have wondered how to put a box on your site where your visitors can just put a referral ID of an affiliate so the affiliate will be credited even though the visitor did not came to your site via a banner or an affiliate link. Just put this code into any site with clicks tracking code: <form action="" method="GET"> Refer: <input type="text" name="a_aid"/> <input type="submit" value="Apply"/> </form> T...

Use of site replication for rss feed purpose

If you want to offer a data feed - rss feed for your affiliates, you can use the site replication feature for this purpose. How to activate and configure the site replication feature is describedhere (http://support.qualityunit.com/307164-Overview). After you did all of the steps from the previous guide, you can continue. Your rss feed looks like this (example): The code of the example rss feed: Replicate your rss feed Followthis (http://support.qualityunit.com/452871-Replicated-site-...

Offline promotion materials with Site Replication and Rebrand PDF

Let's imagine that you are selling mountain bikes and your affiliates attend many events where they would like to promote your products. They would like to have some printed material they could give to the potential customers but they want to be sure, that when the customer goes to your shop using the URL on this paper, that they will get a commissions. How to do this? 1. Create aReplicated site (http://support.qualityunit.com/856887-Site-Replication) for your affiliates. This site can show you...

Wordpress Plugin For Post Affiliate Pro

Navigate tohttp://support.qualityunit.com/829758-WordPress-integration-plugin (http://support.qualityunit.com/829758-WordPress-integration-plugin) if you are not automatically redirected there.

How to add a page into the mini-site

Adding new page to mini-site is as simple as editing existing one. Let's say we want to add new pageOur products, than will contain description of the productsin your affiliates can promote.Creating a new page we'll create new file products.php in the/affiliate/affiliatesdirectory. The contents of this file will be: <?php require_once '../scripts/bootstrap.php'; Gpf_ModuleBase::getStaticPageContent(new Pap_Signup(), 'products.stpl', 'main_static_html_doc.stpl'); ?> Next step is to add th...

How to add Live Agent button to the application

If you want to add a chat button from your Live Agent to your Post Affiliate Pro merchant panel, affiliate panel or signup panel then you have to follow these few steps (we will show the integration with merchant panel first): 1. Login to your Live Agent and get the button code Go to menu->Buttons and click on the button, which you want to add into your Post Affiliate Pro Copy the button code somewhere. 2. Now login to your Post Affiliate Pro merchant panel. Go to menu->Configuration-&...

How to change the information about affiliate manager

Actually there are 2 ways to reach the correct place where you can apply the desired changes concerning the Affiliate manager information. 1. So, the first one is to click your account name in the merchant panel: In Classic Theme _ In Blue Aero theme Then in the freshly open 'Edit user profile' window click the link which says "Change affiliate manager info visible in affiliate panel" and finally the Affiliate manager info opens up: After you made the desired changes, do not...

How to set up subaffiliate (multitier) commissions

To set up multitier commissions your affiliates can earn if their sub-affiliate refers any sales/leads you have to choose the type of commission first.You can find the Commissions settings in the details of eachcampaign (http://www.qualityunit.com/postaffiliatepro/introduction-videos/adding-and-changing-campaigns/). When you open the settings of some type of commissions, you can set the standard commission to be generated for the direct referrer (commission for the affiliate who referred the ...

How to assign a non-referred customer to an affiliate (force visitor id)

Sometimes the merchants want to make sure, that if a customer for the very first time in the past visited their site without any affiliate link, then the particular customer should be assigned to some kind of default affiliate (the merchant's default affiliate) so that no affiliate earns a commission for this particular customer in vain. This is possible only with the php API tracking. You can download the PapApi.class.php file directly from the merchant panel: _Tools > Integration > API ...

How to add newsletter functionality

Though Post Affiliate Pro does not have a newsletter functionality yet, you can add it with few simple steps (and one rather advanced in case you already have running affiliate program with hundreds off affiliates). 1 Adding the newsletter option. First define field Newsletter in Configuration > Affiliate signup > Fields . Remember the data field you've chosen (in this example we use the data10 field). Set it to either mandatory or optional. Then choose type CheckBox. You can choose ListB...

How to remove all statistics data

After some testing in your Post Affiliate Pro (PAP) there are a bunch of clicks, impressions and sales. If you want to start from scratch, but do not want to reinstall your PAP, so you do not loose your current settings (banners, campaigns, etc..), you will need to erase all statistics data. Through the merchant panel you can remove sales easily, also removing clicks won't be a problem, but impressions and statistics data can not be removed through the merchant panel. That is possible only by ma...

Different email templates for sale / actions

If you want to have different email per sale / action, you have to use if statements in sale notification mail template: Example: {if $actionName eq 'per Lead'} text for action per Lead {elseif $actionName eq 'per Signup'} text for action per Signup {else} Standard sale text {/if}

How to refer in the affiliate panel to a custom page or how to open an url as a custom URL page?

If you want to have a link in some screen of the affiliate panel which shall open the particular URL (e.g. www.google.com) in the Affiliate panel as if it was a custom URL page (but of course without creating any custom URL page), then you can use the following example: {literal} <a href='#Url-Page;{"url":"http://www.qualityunit.com","openType":"P"}'>Quality Unit</a> {/literal} In case you have aCustom page (http://support.qualityunit.com/02...

How to register separate products from sale

If you pay different commission for different products, you will probably need this modified sale tracking script:<script id="pap_x2s6df8d" src="http://www.yoursite.com/affiliate/scripts/salejs.php" type="text/javascript"></script><script type="text/javascript"><?phpfor ($j=0; $j<=$i; $j++){ // $i variable represents number of products(items) ( = number of loops) $pap_final_price[$j] = $order_item_price[$j] * $order_item_quantity[$j...

How to import/export data

You can easily export and import data about affiliates, transactions etc. All data would be stored in the CSV files. If you want to export or import data, go into Tools>Import/Export. Import When you want to import a CSV file, we recommend you to Export the same structure from your Post Affiliate Pro first (if you want to import commissions, then first export commissions from Tools > Import / Export) and edit your file to the right format - according to the Exported csv. We also recommen...

How to send customer info to referring affiliate in email template

If you want to send customer information such as name or email address to your affiliate, youcan add this info into Post Affiliate Pro's New sale/lead notification email, which is sentafter each successful sale (if set so). Please follow this guide: 1.) you need to insert additional line / lines of code into your sale tracking code: sale.setData1('variable_of_customer's email'); sale.setData2('variable_of_customer's first name'); sale.setData3('variable_of_customer's last name'); Basically,...