Track Conversions with Poltio SDK

Required

Step 1: Basic Setup

To start tracking conversions, include the following single line of code in all your product detail pages and checkout success pages:

<script id="poltiosdk" defer src="https://sdk.poltio.com/poltio.js"></script>
Poltio SDK Script Example

Once you've added this code, configure your checkout success URL in the Poltio Platform.

Poltio Platform Configuration
Optional & RecommendedEnhance tracking efficiency across all platforms

Step 1a: Custom Domain

For comprehensive tracking across all platforms, including mobile and environments with stricter privacy settings, configure a custom domain. This allows you to use first-party cookies by setting up a subdomain of your primary site.

Visit the Custom Domain Documentation to learn how to set up a custom domain.

After setting up a custom domain, replace the script URL in your pages with the following:

<script id="poltiosdk" defer src="https://poltio.yourdomain.com/poltio.js"></script>
Optional & RecommendedTrack not only quantities but also values

Step 2: Measuring Cart Totals

To track the cart value, add the following snippet to your checkout page using Google Tag Manager or directly in your code.

If you're already using the Meta/Facebook Conversion Pixel, you can reuse your existing code by replacing fbq with window.poltio.push.

Example code for tracking cart totals:

<script>
    window.poltio.push('track', 'Purchase', {currency: "USD", value: 30.00});
</script>
Important: Ensure the following script is included in the <head> section of your page
<script id="poltiosdk" defer src="https://poltio.yourdomain.com/poltio.js"></script>
OptionalTrack detailed product information

Step 2a: Detailed Tracking with Items

For more detailed tracking, you can send product details (SKUs) using the window.poltio.push('track') function. Here's an example:

<script>
    window.poltio.push('track', 'Purchase', {
        value: 4.99,
        poltio_account_id: 5,
        contents: [
            { id: "testProduct1", quantity: 1, value: 2.99 },
            { id: "testProduct2", quantity: 2, value: 1.00 }
        ],
        currency: "USD",
        order_id: "testOrder1"
    });
</script>

Parameters:

  • value: (Required) The total monetary value of the purchase.
  • poltio_account_id: (Required) A unique identifier of your Poltio account.
  • contents: (Optional) An array of objects containing product details:
    • id: Product identifier.
    • quantity: Quantity of the product.
    • value: Monetary value of the product.
  • currency: (Optional) The currency of the transaction.
  • order_id: (Optional) A unique identifier for the order.

Your Poltio account's unique identifier is the Account ID in the menu at Poltio Platform.

Single Page Application (SPA) Example

If your website is a Single Page Application (SPA) or does not have a specific checkout success page, you can track conversions using action buttons. Follow these steps:

Step 1: Include the Poltio SDK Script

Add the following script to the <head> section of your page:

<script id="poltiosdk" defer src="https://sdk.poltio.com/poltio.js"></script>

Step 2: Add Tracking to Action Buttons

Use the following code for buttons or links that trigger a purchase event:

Button Example:

<button onclick="window.poltio.push('track', 'Purchase', {currency: 'TRY', value: 80.00})">
    Complete Purchase
</button>

Link Example:

<a href="javascript:window.poltio.push('track', 'Purchase', {currency: 'TRY', value: 80.00})">
    Complete Purchase
</a>

By following these steps, you can easily track user interactions and conversions on your website using the Poltio SDK.