Automated Tracking

This feature allows multiple tracking actions to be managed through a single configuration. Based on predefined conditions such as matching website paths, hostnames, or referral sources, the SDK automatically triggers the appropriate functions.

With this approach, tracking behavior can be controlled and customized without repeated setup, making it easier to manage and scale tracking across different scenarios.

Get Started

To start automated tracking with Offer18's web SDK, one needs to add a script tag in the website.

Placement : Header (All Pages)

<script src="https://web-resources.offer18.net/sdk/web/WebSDK.js"></script>

---

TrackClick

To track clicks using the automated SDK script, add the following code to your website.

Placement : Header (All Pages)

<script>
	window.Offer18SDK.init({
		automatedTracking: true,
		opeations: [{
			triggerFunction: "trackClick",
			triggerconditios: [
				{
					mode: "<condition-mode>", // contain or equal
					type: "<condition-type>", // path / hostname / referral
					value: "<condition-value>"
				}
			],
			triggerConfig: {
				trackingURL: "https://example.com?c/o=xxx&m=000&a=000",
				keymapping: ['<OFFER18-PARAMETER>:<YOUR-PARAMETER>', '<OFFER18-PARAMETER>:<YOUR-PARAMETER>', ...]
			}
		}]
	})
</script>

---

TrackImpression

To track impressions using the automated SDK script, add the following code to your website.

Placement : Header (All Pages)

<script>
	window.Offer18SDK.init({
		automatedTracking: true,
		opeations: [{
			triggerFunction: "trackImpression",
			triggerconditios: [
				{
					mode: "<condition-mode>", // contain or equal
					type: "<condition-type>", // path / hostname / referral
					value: "<condition-value>"
				}
			],
			triggerConfig: {
				impressionURL: "https://example.com?i/o=xxx&m=000&a=000",
				keymapping: ['<OFFER18-PARAMETER>:<YOUR-PARAMETER>', '<OFFER18-PARAMETER>:<YOUR-PARAMETER>', ...]
			}
		}]
	})
</script>

---

TrackConversion

Users must add the following code snippet into all landing pages except Order confirmation / Order Success (Thank you) page.

Placement : Header (All Pages)

<script>
	window.Offer18WebSDK.init({
		automatedTracking: true,
		operations: [
			{
				triggerFunction: "initializeConversion",
				triggerConditions: [
					{
						mode: "<condition-mode>", // contain or equal
						type: "<condition-type>", // path / hostname / referral
						value: "<condition-value>"
					}
				],
				triggerConfig: {
					clickIdParameter: "<YOUR-CLICK-ID-PARAMETER>",
				}
			}
		]
	})
</script>

After that add the following code in thankyou/order-confirmation page to your website.

Placement : Thank you page/Order Success Page (One Page)

<script>
	window.Offer18WebSDK.init({
		automatedTracking: true,
		operations: [
			{
				triggerFunction: "trackConversion",
				triggerConditions: [
					{
						mode: "<condition-mode>", // contain or equal
						type: "<condition-type>", // path / hostname / referral
						value: "<condition-value>"
					}
				],
				triggerConfig: {
					domain: '',
					accountId: '',
					offerId: '',
					coupon: '',
					postbackType: '', // 'iframe' or 'pixel'
					isGlobalPixel: false, // true or false
					allowMultiConversion: false, // true or false
					conversionData: {
						event: '', // Event Name (Please specify the event)
						payout: '', // Payout Amount (Please specify the payout amount)
						sale: '', // Sale Amount (Please specify the sale amount)
						currency: '',
						adv_sub1: '',
						adv_sub2: '',
						adv_sub3: '',
						adv_sub4: '',
						adv_sub5: '',
					}
				}
			}
		]
	});
</script>

Debug Mode

To enable debug mode in an SDK, one can add the following code inside your script:

<script>
    window.Offer18WebSDK.activateDebugMode();
</script>

Enabling debug mode allows user to get more detailed information about the working of the SDK, including any errors or debugging messages.

Example Code

<script>
    window.Offer18SDK.init({
        automatedTracking: true,
        opeations: [{
            triggerFunction: "trackClick",
            triggerconditios: [
                { mode: "equal", type: "hostname", value: "websiteurl.com" }
            ],
            triggerConfig: {
                trackingURL: "https://example.o18.click/c?o=0000000&m=0000",
                keymapping: ['a:utm_source']
            }
        },
        {
            triggerFunction: "trackImpression",
            triggerconditios: [
                { mode: "equal", type: "hostname", value: "websiteurl.com" }
            ],
            triggerConfig: {
                impressionURL: "https://example.o18.click/i?o=0000000&m=0000",
                keymapping: ['a:utm_source']
            }
        },
        {
            triggerFunction: "initializeConversion",
            triggerconditios: [
                { mode: "equal", type: "hostname", value: "websiteurl.com" }
            ],
            triggerConfig: {
                clickIdParameter: "tid",
            }
        },
        {
            triggerFunction: "trackConversion",
            triggerConditions: [
                { mode: "equal", type: "hostname", value: "websiteurl.com" },
                { mode: "contain", type: "path", value: "thank-you" }
            ],
            triggerConfig: {
                domain: 'example.o18.link',
                accountId: '0000',
                offerId: '00000000',
            }
        }
        ]
    });
</script>