General solution integration
The general method of integration is putting an invisible JavaScript code or image anywhere in the “thank you for order” or order confirmation page that is displayed to the customer after the payment is processed.
Post Affiliate Pro is compatible with nearly ALL merchant accounts, payment gateways, shopping carts and membership systems.
What integration means
Integration is a way to connect the affiliate system to your current website, shopping cart or payment gateway in a way that affiliate system will be notified about purchases. When notified, affiliate system registers the sale, finds referring affiliate (if any) and creates appropriate commission for him.
The general method of integration is putting an invisible JavaScript code or image anywhere in the “thank you for order” or order confirmation page that is displayed to the customer after the payment is processed.
1. JavaScript integration code
JavaScript version of integration code is generally recommended, because it allows using advanced tracking techniques.
Open your order confirmation or “thank you for order” page template, and put the following code somewhere into the page where the parameters in setTotalCost(), setOrderID() and setProductID() should be replaced with correct values.
<script id="pap_x2s6df8d" src="https://URL_TO_PostAffiliatePro/scripts/trackjs.js" type="text/javascript"></script> <script type="text/javascript">
PostAffTracker.setAccountId('Account_ID'); var sale = PostAffTracker.createSale(); sale.setTotalCost('120.50'); sale.setOrderID('ORD_12345XYZ'); sale.setProductID('test product');
PostAffTracker.register();
</script>
Total Cost (mandatory for % commissions) – price of the product.
Order ID (optional) – can be your unique generated order ID to cross-check the sale.
Product ID (optional) – the ID of the product bought.
All fields are optional, but without Total Cost system will be not able to compute percentage commissions.Also, Product ID is required if you want to recognize campaign by product.
If you need to set total sale cost and order id, but you don’t have access to their values in your “Thank you” page, the situation is more complicated. There is no general solution for this. If you know that you can register sale in some other place, where those values (total cost and order id) are available, you can put the tracking code there. Otherwise, consult us for advice and finding possible solution.
2. Hidden Image integration code
Image version of integration code can be used if for some reason you cannot or don’t want to use JavaScript tracking.
<img src="https://URL_TO_PostAffiliatePro/scripts/sale.php?TotalCost=120.50&OrderID=ORD_12345XYZ&ProductID=test_product" width="1" height="1" />
The parameters TotalCost, OrderID and ProductID have the same sense as in JavaScript code.
These two methods (JavaScript and Hidden Image) do the same, JavaScript version has slightly better reliability because of more advanced techniques tha can be used.
This is all that is required. Now whenever there’s sale, the sale tracking script sale.php is called, and it will generate commission for the affiliate.