|
merchant
|
Tracking SDK
|
1.0
|
iOS
|
TradeTracker SDK provides functionalities to track statistics of app install, usage, leads and sales generated from the app.
Downloading the SDK
Download the SDK from following link: TradeTracker iOS Swift 2.2 SDK or TradeTracker iOS Swift 3.0 SDK
Importing the SDK
Add TradeTracker.framework to your Xcode project folder. Drag and drop TradeTacker.framework to your project workspace. Make sure that framework is added in embedded frameworks section in Xcode App Target -> General section.
Integrating with your app
Import TrackeTracker.framework in AppDelegate as shown in the snippets below.
Swift:
import TradeTracker
Objective C:
@import TradeTracker;
Initialize SDK in application:didFinishLaunchingWithOptions: method.
Swift:
func application(application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) ->
Bool {
TradeTrackerManager.startTradeTrackerManagerWithAppID("SomeAppID"
)
return true
}
Objective C:
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
[TradeTrackerManager startTradeTrackerManagerWithAppID:@"SomeAppID"];
return YES;
}
While integrating with Objective-C project you have to make sure that In Build settings->Build Options->‘Embedded Content contains Swift’ option is set as ‘Yes’.
Add a Run script in App TargetBuild Phases after embedded frameworks. Copy following code to to Run script
Strip framework:
bash "${BUILT_PRODUCTS_DIR}/${FRAMEWORKS_FOLDER_PATH}/TradeTracker.framework/strip-frameworks.sh"
Now you have successfully integrated SDK to your App.
Logging
You can enable the SDK logging to see the logs generated by the SDK during debugging. But remember to disable the logging before releasing the app.
Swift:
TradeTrackerManager.logLevel = TradeTrackerLogLevel.Verbose
Objective C:
[TradeTrackerManager setLogLevel:TradeTrackerLogLevelVerbose];
Tracking
Tracking of Install
Swift
TradeTrackerManager.trackInstall()
Objective C
[TradeTrackerManager trackInstall];
Tracking of app start
Swift
TradeTrackerManager.trackStart()
Objective C
[TradeTrackerManager trackStart];
Tracking of custom leads
To manually trigger a lead you can use the following call:
Swift
TradeTrackerManager.trackCustomLead(descrMerchant: merchant, descrAffiliate: affiliate, email: email, pid: pid, tid: tid)
Objective C
[TradeTrackerManager trackCustomLeadWithDescrMerchant:merchant descrAffiliate:affiliate email:email pid:pid tid:tid];
Tracking of custom sales (in app purchases)
To manually trigger a sale you can use the following calls:
Swift
TradeTrackerManager.trackCustomSale(amount: amount, descrMerchant:merchant, descrAffiliate: affiliate, email: email, pid: pid, tid: tid)
Objective C
[TradeTrackerManager trackCustomSaleWithAmount:amount descrMerchant:merchant descrAffiliate:affiliate email:email pid:pid tid:tid];
In addition to the above parameters in the table, you may use the amount as DecimalNumber (e.g. 123.45).
Shortlink to this article: https://sc.tradetracker.net/implementation/overview?f[id]=62
|
05-Mar-2019 11:37:30 |
|
merchant
|
VirtueMart (Joomla)
|
2.0.0 and higher
|
Standard implementation
|
 VIRTUEMART 2.0.0 AND HIGHER (JOOMLA) TRADETRACKER CONVERSION IMPLEMENTATION
Seeing as Virtuemart (Joomla) uses php you can download the redirect file here download index.php please add your domainName to line 6 like after downloading the index redirect file, like:
$domainName = 'yourdomainWithoutWWW.com';
After adding your domain to the index file, it should be uploaded to a folder in the root of your website. The folder must be named a word that best represents your webshop's content.
For more information regarding setting up the redirect we refer you to setting up the redirect guidelines.
VIRTUEMART CONVERSION IMPLEMENTATION
We have created a general TradeTracker conversion handler file for Virtuemart 2.0.0 and higher (Joomla) that also must be placed on your server.
Download: tradetracker.php No modifications must be made to this file.
Upload tradetracker.php to your server in folder /components/com_virtuemart/views/cart/tmpl/
After that open and edit the order_done.php file (also located in /components/com_virtuemart/views/cart/tmpl/ )
Within the order_done.php file locate the following line of code:
[marker]echo $this->html;[/marker]
Below that line copy and paste the following code:
$tt_campaignID = '[marker]CAMPAIGN_ID[/marker]';
$tt_productID = '[marker]PRODUCT_ID[/marker]';
$tt_trackingGroupID = '[marker][/marker]';
$tt_scriptTag = include_once 'tradetracker.php';
echo $tt_scriptTag;
After these steps are executed, the campaign is ready to be tested.
Make sure you use the TradeTracker Tracking Test URL before doing the test. If you don’t have the test URL, please ask your account manager to provide it to you.
Please keep in mind that although we do our very best to cover a wide variety of different implementations and web shop systems, programming languages and conversion registration methods for different situations, we want to state here that they are all merely examples and are not guaranteed to work for your specific situation or specific conversion or tracking needs. The reason for this is that the implementation descriptions provided are based on default system configurations and do not take system configuration settings, customisations and usage of plug-ins into account. Besides that there are also a lot of other variables that can have impact on the correct working of our tracking and conversion registration which we just can't know upfront. In case you do encounter or experience issues when implementing our tracking, please report this to your account manager and describe (in detail) the steps you took and if it's possible, provide the code and/or files you are using for your implementation to the account manager.
Shortlink to this article: https://sc.tradetracker.net/implementation/overview?f[id]=28
|
12-Dec-2014 14:28:51 |
|
merchant
|
Weebly Webshop
|
NA
|
Standard implementation
|
WEEBLY WEBSHOP TRADETRACKER CONVERSION IMPLEMENTATION
The code below must use your campaign ID and product ID that you received from us.
The code must be pasted as custom tracking code by navigating to:
STORE >> ADVANCED >> Add custom tracking code and add it to the Receipt page input field and Save it
COPY THIS CODE (if needed replace CAMPAIGN_ID and PRODUCT_ID with your own ID's)
<script type="text/javascript">
var ttConversionOptions = ttConversionOptions || [];
ttConversionOptions.push({
type: 'sales',
campaignID: '[marker]CAMPAIGN_ID[/marker]',
productID: '[marker]PRODUCT_ID[/marker]',
transactionID: '{txid}',
transactionAmount: {total} - {tax} - {shipping},
quantity: '1',
descrMerchant: '',
descrAffiliate: '',
currency: ''
});
</script>
<noscript>
<img src="//ts.tradetracker.net/?cid=[marker]CAMPAIGN_ID[/marker]&pid=[marker]PRODUCT_ID[/marker]&tid={txid}&tam={total}&event=sales" alt="" />
</noscript>
<script type="text/javascript">
(function(ttConversionOptions) {
var campaignID = 'campaignID' in ttConversionOptions ? ttConversionOptions.campaignID : ('length' in ttConversionOptions && ttConversionOptions.length ? ttConversionOptions[0].campaignID : null);
var tt = document.createElement('script'); tt.type = 'text/javascript'; tt.async = true; tt.src = '//tm.tradetracker.net/conversion?s=' + encodeURIComponent(campaignID) + '&t=m';
var s = document.getElementsByTagName('script'); s = s[s.length - 1]; s.parentNode.insertBefore(tt, s);
})(ttConversionOptions);
</script>
STEP-BY-STEP GUIDE
Login to your Weebly account and click edit for the site you want to add our conversion script.
Navigate to STORE >> ADVANCED >> Add custom tracking code:
Paste our conversion code to the Receipt page input field:
Click Update Changes.
The implementation can be tested.
Shortlink to this article: https://sc.tradetracker.net/implementation/overview?f[id]=37
|
14-Mar-2019 15:51:22 |
|
merchant
|
WP WooCommerce extension
|
1.x
|
Generic
|
Please note that Version 2.x is available now.
To ensure a seamless experience, make sure to implement the most recent version via the following guide: Version 2.x
 In order to get the TradeTracker implementation up and running seamlessy with WooCommerce, you may add the TradeTracker WooCommerce Extension manually to your WP installation.
The zip-file in question may be found within your merchant dashboard under the "Support" heading at the top of the page:
Once you have downloaded the zip file, upload it to your Wordpress Plugins section by clicking the "Add new" button:
In the subsequent screen, click the "Upload Plugin" button and upload the above downloaded zip file:
This is also they way-of-working in case you're updating an existing TradeTracker WooCommerce plugin with a new version.
After a successful upload, head over to your plugins section and activate the plugin if not already done by clicking the "Activate" link:
After the plugin has successfully been activated, click "Settings":
On the subsequent page, enter your "Campaign ID" and "Product ID" as received from TradeTracker.
Optionally, you may enter a "Tracking Group ID" but only if explicitly instructed by TradeTracker to enter a value for it. If not, you may leave it blank.
Save these settings and you're good to go!
Now, please test the implementation together with your account manager.
Shortlink to this article: https://sc.tradetracker.net/implementation/overview?f[id]=72
|
06-Dec-2021 16:46:35 |
|
merchant
|
xt:Commerce
|
4
|
Standard implementation
|
 XT:COMMERCE 4 VEYTON TRADETRACKER CONVERSION IMPLEMENTATION
SETTING UP THE REDIRECT
Seeing as XT:Commerce uses php you can download the redirect file here download index.php After downloading, please add your domainName to line 6.
For more information regarding setting up the redirect we refer you to setting up the redirect guidelines. When the redirect is working, follow the instruction for setting up the conversion registration below.
Log in to your FTP account and open and edit the file xtCore/pages/page_action/checkout.success.php
At the bottom of the file you will find a php closing tag ( ?> ) above this closing tag the code that is found here must be added:
// TradeTracker conversion script
$campaignID = '[marker]CAMPAIGN_ID[/marker]';
$productID = '[marker]PRODUCT_ID[/marker]';
$orderID = !empty($success_order->oID) ? htmlspecialchars($success_order->oID) : '';
$orderAmount = empty($success_order->order_total['total']['plain']) ? 0.00 : (float) $success_order->order_total['total']['plain'] / 1.2; // The 1.2 is your VAT ratio.
$trackingCode = "<script type=\"text/javascript\">
var ttConversionOptions = ttConversionOptions || [];
ttConversionOptions.push({
type: 'sales',
campaignID: '$campaignID',
productID: '$productID',
transactionID: '$orderID',
transactionAmount: '$orderAmount',
quantity: '1',
descrMerchant: '$descrMerchant',
descrAffiliate: '',
currency: '',
trackingGroupID: '[marker][/marker]'
});
</script>
<noscript>
<img src=\"//ts.tradetracker.net/?cid=$campaignID&pid=$productID&tid=$orderID&tam=$orderAmount&qty=1&event=sales\" alt=\"\" />
</noscript>
<script type=\"text/javascript\">
(function(ttConversionOptions) {
var campaignID = 'campaignID' in ttConversionOptions ? ttConversionOptions.campaignID : ('length' in ttConversionOptions && ttConversionOptions.length ? ttConversionOptions[0].campaignID : null);
var tt = document.createElement('script'); tt.type = 'text/javascript'; tt.async = true; tt.src = '//tm.tradetracker.net/conversion?s=' + encodeURIComponent(campaignID) + '&t=m';
var s = document.getElementsByTagName('script'); s = s[s.length - 1]; s.parentNode.insertBefore(tt, s);
})(ttConversionOptions);
</script>";
define('TRADETRACKER_TRACKING_CODE', $trackingCode);
Save and/or upload the file to your server.
Navigate to: /templates/YOUR_THEME_SKIN_DIRECTORY/xtCore/pages/checkout/subpage_success.html
Open and edit the file subpage_success.html and at the top of this file add
{txt key=TRADETRACKER_TRACKING_CODE}
Save and/or upload the file to your server.
If your redirect is working the implementation can be tested.
Please keep in mind that although we do our very best to cover a wide variety of different implementations and web shop systems, programming languages and conversion registration methods for different situations, we want to state here that they are all merely examples and are not guaranteed to work for your specific situation or specific conversion or tracking needs. The reason for this is that the implementation descriptions provided are based on default system configurations and do not take system configuration settings, customisations and usage of plug-ins into account. Besides that there are also a lot of other variables that can have impact on the correct working of our tracking and conversion registration which we just can't know upfront. In case you do encounter or experience issues when implementing our tracking, please report this to your account manager and describe (in detail) the steps you took and if it's possible, provide the code and/or files you are using for your implementation to the account manager.
Shortlink to this article: https://sc.tradetracker.net/implementation/overview?f[id]=39
|
14-Mar-2019 15:52:04 |
|
merchant
|
xt:Commerce
|
3
|
Overview
|
XT:COMMERCE 3 TRADETRACKER CONVERSION IMPLEMENTATION
SETTING UP THE REDIRECT
Seeing as XT:Commerce uses php you can download the redirect file here download index.php After downloading, please add your domainName to line 6.
For more information regarding setting up the redirect we refer you to setting up the redirect guidelines. When the redirect is working, follow the instruction for setting up the conversion registration below.
We have created a general TradeTracker conversion handler file for xt:Commerce 3 that must be placed on your server. No modifications must be made to this file.
Download the tradetracker.php file for xt:Commerce here
Log in to your FTP account and upload the tradetracker.php file to the /includes/ folder of your xt:Commerce installment.
Open and edit the file checkout_success.php that is located in the root of your XT:Commerce installation. Within checkout_success.php locate the following line of code:
$main_content = $smarty->fetch(CURRENT_TEMPLATE.'/module/checkout_success.html');
ABOVE this line place the following code:
// Begin Tradetracker xt:Commerce code
$tt_campaignID = '[marker]CAMPAIGN_ID[/marker]';
$tt_productID = '[marker]PRODUCT_ID[/marker]';
$tt_imageTag = include './includes/tradetracker.php';
$smarty->assign('tt_imageTag', $tt_imageTag);
// End TradeTracker xt:Commerce code
Save and/or upload the file to your server.
Locate your checkout_success.html template file. This file is part of the theme your are using. and normally would be found at the following location:
/templates/{TEMPLATE_NAME}/module/checkout_success.html
Open and edit the file checkout_success.html and at the bottom of this file add the following code:
<!-- TradeTracker conversion tracking start -->
{$tt_imageTag}
<!-- TradeTracker conversion tracking end -->
Save and/or upload the file to your server.
If your redirect is working the implementation can be tested.
Please keep in mind that although we do our very best to cover a wide variety of different implementations and web shop systems, programming languages and conversion registration methods for different situations, we want to state here that they are all merely examples and are not guaranteed to work for your specific situation or specific conversion or tracking needs. The reason for this is that the implementation descriptions provided are based on default system configurations and do not take system configuration settings, customisations and usage of plug-ins into account. Besides that there are also a lot of other variables that can have impact on the correct working of our tracking and conversion registration which we just can't know upfront. In case you do encounter or experience issues when implementing our tracking, please report this to your account manager and describe (in detail) the steps you took and if it's possible, provide the code and/or files you are using for your implementation to the account manager.
Shortlink to this article: https://sc.tradetracker.net/implementation/overview?f[id]=14
|
28-Jan-2016 14:51:14 |
