This article will review:
Frequently asked questions (FAQ's) for Partnerize Shopify integrations
Index
Overview
This guide will cover the most common FAQ's for Partnerize Shopify integrations.
FAQ's
Below are answers to the most commonly asked questions regarding the implementation of the Partnerize Shopify integrations.
Q). Does the Partnerize Shopify App support headless Shopify solutions where the frontend is custom-built?
A: Yes, absolutely. For headless Shopify setups, the Partnerize App integrates with your Shopify backend for server-to-server tracking via webhooks. To capture the Partnerize "clickref" and allocate sales to referring partners, an additional JavaScript code (the Partnerize Tag) needs to be implemented directly onto your custom frontend webpages
Q). Why am I receiving an error when saving the details in the Shopify plugin?
A: Are you using the right keys?
Here is the mapping of the keys from the Partnerize console to the Shopify plugin
- User Key : (Settings > Your Account > User application key) (first key)
- API Key : (Settings > Your Account > User API key) (second key)
A: Are you using the right Brand id and Campaign id?
Please find the information here:
- Brand ID : (Settings > Brand and Program > Advertiser ID)
- Campaign ID : (Campaign drop down > Settings > ID at top left)
A: If you are doing an optimisation, have you asked the Partnerize to enable the features for you?
The tag will only be generated if the tag feature is enabled by Partnerize for your network.
A: Does the user making the changes have Advertiser level admin access?
The user whose API keys are used should have admin access on the Brand.
Q). Why are some values missing or mapped incorrectly?
A: We automatically map standard Shopify values to Partnerize, as detailed in our Shopify Tracking Parameters guide. If you need to capture additional data points beyond these, a post-sale modification will be required. Please contact our support team to discuss options and feasibility.
Q). Why is my order value not matching the value in Partnerize?
A: We take the net value of the order excluding any taxes, discounts and shipping costs. The discount is subtracted proportionately from the item values in case there are multiple items in the cart. Below is an example
If the cart looks like below
Item1 value : 40
Item2 value : 60
Taxes : 18
Shipping : 15
Voucher discount : 10
Below is how the partnerize will calculate the values
Total item value in the cart : 40 + 60 = 100
Total item value minus discount = 100 - 10 = 90
Item1 value = 40 - discount(proportionately) = 40 - 10*(40/100) = 36
Item2 value = 60 - discount(proportionately) = 60 - 10*(60/100) = 54
So, the total value of the conversion will be 90 in Partnerize.
Q - Why is the "clickref" parameter blank in conversion calls?
A - If you're using a Headless Shopify Storefront (meaning your customer-facing website is custom-built outside of Shopify), the "clickref" parameter will be blank because an additional Partnerize Tag needs to be implemented directly on your website pages. For full implementation details please refer to Shopify Implementation Steps
Q - How should tracking be structured for a brand with separate Shopify instances for different regions?
When a brand maintains separate Shopify instances for different regions, it is recommended to install the Partnerize app on each instance. If multiple campaigns must run on a single Shopify instance, a Master Campaign ID can be used to manage them under one app install, with parameters like country determining which specific campaign receives credit.
Q - Which specific Shopify credentials are required to configure the Partnerize app?
To authenticate the store, developers must provide the User API Key, User Application Key, Advertiser ID (Brand ID), and the specific Campaign ID. These keys ensure secure data transmission from the Shopify backend to the Partnerize platform.
We get these by logging into the platform and going under settings > Your account > halfway down the page there is eye icons that will show the keys. Do not share your keys via email.
Q - What parameters does Shopify integration support in the conversion call?
The parameters are not customizable; they will always be the same.
They are - Campaign, conversionref, country, currency, Shopify order id, shopify variant, quantity, sku, customertype, voucher, value, category.
Q - Is it possible to run both Google Tag Manager and the Partnerize Shopify app simultaneously?
Yes, possible, requires a significant technical lift from the brand.
Q- Can transaction validations for returned or refunded items be automated within Shopify?
Yes, the Partnerize Shopify application automatically processes transaction validations for returned items via a webhook fired from Shopify whenever an order status changes to REFUND. This ensures commissions on returned items are automatically updated to rejected.