The affiliate area is where your affiliates log into their account and view their referral stats, generate affiliate links, and view their earnings.
Arabianaffiliates will automatically create a page called Affiliate Area when it is first installed on the site, and it will also populate this page with the proper shortcode, which is [affiliate_area].
If Arabianaffiliates did not automatically create the page, or you simply wish to name it something different, create a standard Page in WordPress and place the [affiliate_area] shortcode in the main content.
Version 1.1 of Arabianaffiliates introduced the [affiliate_login] shortcode. This shortcode allows you to place a login form on any page.
If you’d like to redirect your affiliates after they login, use the redirect parameter of the shortcode:
Note:you can only see this form if you are logged out
If you wish to track referrals for successful conversions of custom success pages, the [affiliate_conversion_script] shortcode allows you to track affiliate referral links and generate referrals on successful conversions by placing it on your “success” page.
When a visitor comes to your site via an affiliate link and successfully makes it through your checkout, signup form, or any other conversion process, this shortcode will generate a referral record for the affiliate whose link was clicked.
[affiliate_conversion_script] should be placed on your success page (the page visitors land on after completing their purchase or signup). The shortcode accepts several parameters that allow you to define the various values for the referral generated:
amount – The purchase amount that the referral should be based on. This is the total purchase amount, not the total referral amount. The referral amount will be calculated based off of the referral rate for the affiliate.
description – A description logged with the referral.
context – A context for the referral. You will want to use this if you have multiple purchase or signup forms.
reference – A unique reference variable for the affiliate. This could be the user ID of the new user (if they are signing up for your site) or a transaction ID.
status – The status to give the referral. By default, referrals created with this short code will be set to “pending”. Valid options are: “pending”, “unpaid”, “paid”, and “rejected”.
An example using all of the parameters above:
[affiliate_conversion_script amount=”10″ description=”My Description” context=”Contact Form” reference=”1234″ status=”pending”]
Important information for using this shortcode — please read:
Usage: The [affiliate_conversion_script] shortcode can be used on multiple success pages, but a referral cannot be generated again until cookies are cleared/expired.
Formatting: Ensure you leave spaces between the script parameters as seen in the above example, otherwise you will have blank entries, including a zero amount when the referral is created.
Coupons: The [affiliate_conversion_script] shortcode does not support coupon usage of any type; for example, if your customers are using discount/coupon codes to purchase products, this will not have any effect on the referral amount awarded to the affiliate, when using this shortcode. The referral amount will only be calculated based on the amount entered inside the [affiliate_conversion_script] shortcode (see the amount parameter above for more information). If you would like discounts and coupons to affect affiliate referral amounts, please consider using one of our supported integrations.
v1.1 of Arabianaffiliates introduced the [affiliate_registration] shortcode. This shortcode allows you to place a registration form on any page.
In order for the registration form to appear on the page, Allow affiliate registration must be enabled from Affiliates → Settings → Misc.
If you’d like to redirect your affiliates after they register, use the redirect parameter of the shortcode:
Note: you can only see this form if you are logged out
The [affiliate_referral_url] shortcode can be used to output the referral URL of the currently logged in affiliate.
If you wish to provide a custom URL, you can do that by passing the URL into the shortcode:
Pretty Affiliate URLs
If you have enabled “Pretty Affiliate URLs” from the Affiliates → Settings page then the shortcode will inherit pretty URLs so there’s no need to add anything to the shortcode. However, if you’d like to override this you can use the pretty parameter:
Pretty URLs enabled:
Pretty URLs disabled:
By default the shortcode will also inherit the “Default Referral Format” option from the Affiliates → Settings page. This will either be ID or username. If you’d like to override this in the shortcode you can use the format parameter:
Referral Format set to ID:
Referral Format set to username:
Combining shortcode parameters
You can combine shortcode parameters for fine-tuned control:
Referral Format set to username with pretty URLs enabled:
[affiliate_referral_url format=”username” pretty=”yes”]
Referral Format set to ID with pretty URLs enabled with a custom URL
[affiliate_referral_url format=”id” pretty=”yes” url=”http://yoursite.com/landing-page”]
The [affiliate_creative] shortcode allows you to show a specific creative from Affiliates → Creatives on any page.
[affiliate_creative id=”123″] where 123 is the creative ID. This shortcode (including the ID) is shown on the Affiliates → Creatives page so you can easily copy and paste.
The [affiliate_content] shortcode allows you to restrict content of a post or page to logged-in affiliates. This is useful for showing banners, links, assets, etc., that you only want visible by your affiliates.
The [non_affiliate_content] shortcode allows you to show content only to non-affiliates.
v1.2 of Arabianaffiliates introduced the [affiliate_creatives] shortcode. This shortcode allows you to show all the creatives from Affiliates → Creatives.