Implementing bluebarry's conversion tracking script
This guide will show you how to track your conversions and send purchase data to bluebarry, making sure all your conversions are properly visualized in bluebarry’s dashboard.
Jump to a topic 👇🏻
Option 1: Copy your script from your bluebarry account
You can find your personal conversion tracking script within your bluebarry account, on the “integrations” page.
Option 2: Copy the script below
💡 If you copy the script below, please make sure to add your Tenant ID to the script (“TENANT ID HERE”)
You can find your Tenant ID on the “integrations” page in your bluebarry account.
<script>
window.barry = window.barry || {};
window.barry.tenantId = "TENTANT ID HERE";
var conversionScript = document.createElement('script');
conversionScript.src = "https://bluebarrycdn.blob.core.windows.net/advisor/conversion.js";
conversionScript.async = true;
document.head.appendChild(conversionScript);
window.addEventListener('message', function (event) {
if (event.data && event.data.event === 'bluebarry_session') {
setTimeout(function() {
barry.trackConversion({
value: 300, // the total value of the order
currencyIso: "EUR", // the currency of the order
conversionId: "1234567890", // your internal ID of the order
items: [ // can be any number of items
{
itemId: "ARTIKEL 1", // your internal ID/name of the product
quantity: 2, // quantity
value: 150, // value per product
},
],
});
}, 10);
}
});
</script>
Step 2: Add the Tracking Script
💡 If you’re unsure how to add a script to the <head> element of your page’s HTML or how to retrieve the purchase properties from your eCommerce platform, consult your web development agency.
Add this script to the <head> section of the page where your purchases are registered. This is often a confirmation page that users are redirected to after payment.
Step 3: Replace placeholder values
Replace the placeholder values with your actual order data:
- value: The total value of the order
- currency: The currency of the order (e.g. “EUR”)
- conversionID: Your internal ID of the order
In the items array, add an entry for each purchased product:
- itemID: Your internal product’s unique identifier
- quantity: How many items of that specific product
- value: The value of that item
Make sure to also replace TENANT_ID_HERE with your actual credentials.
💡 Again, if you’re unsure how to retrieve tracking values from your eCommerce platform, make sure to consult your web developer.
After following the steps above, you are now able to see the conversions, purchases and purchase values in your bluebarry dashboard.
Important Notes
- Add this script only to the page that is registering the purchase events.
- The script must run after the order details are available
- Test the implementation with a test purchase to ensure proper tracking