Documentation Index
Fetch the complete documentation index at: https://docs.mention-me.com/llms.txt
Use this file to discover all available pages before exploring further.
Frequently Asked Questions
How do you protect customer data?
How do you protect customer data?
We use SSL for all JavaScript requests to protect customer personal data.
Will the Mention Me tags slow down my site?
Will the Mention Me tags slow down my site?
What happens if your service is unavailable?
What happens if your service is unavailable?
Why do I get a 403 when loading the tags?
Why do I get a 403 when loading the tags?
How can I encrypt my data? Do I need an encryption key?
How can I encrypt my data? Do I need an encryption key?
Our data is already passed via HTTPS. This means the data you’re passing to us will already be encrypted and only visible to you, the user and us. Third parties will not be able to get hold of this information.If you wish to send users to a landing page and would like to include the users’ email address in the link so that they’re shown a personalised link (but do not wish to expose the email address in the link), you can follow our instructions on how to use encrypted parameters to transmit personal data.
Common tag integration errors
Most integration problems come down to how the tag URL is built. Run through the checklist below before raising a ticket — each of these has caught out many integrators.Referrer tag
Parameter values are not URL-encoded
Parameter values are not URL-encoded
All parameter values must be URL-encoded. Common offenders are
@ in email addresses (must be %40), spaces in names (must be %20), and + or / in custom fields. An un-encoded & inside a value will look like the start of the next parameter and corrupt everything that follows it.order_subtotal includes VAT or delivery
order_subtotal includes VAT or delivery
order_subtotal must be the order subtotal excluding VAT/taxes and delivery. Passing the gross total inflates reward calculations and distorts reporting. If you cannot strip VAT on your side, let your Client Success Manager know so we can handle it.Placeholder values have been left in the tag
Placeholder values have been left in the tag
If the tag still contains literal
<INSERT_EMAIL>, <INSERT_ORDER_NUMBER> or similar placeholders, your templating engine has not rendered the real values into the URL. Nothing will match a real customer.tag-demo has been left in the live tag
tag-demo has been left in the live tag
The demo host is
tag-demo.mention-me.com and is for pre-launch testing only. When you go live, the host must be tag.mention-me.com. Forgetting to swap it means live customers hit the demo environment and no real referrals are recorded.firstname or surname is missing
firstname or surname is missing
firstname and surname are mandatory on the referrer tag. Without them we cannot personalise sharing (which dramatically reduces conversion) and in most configurations the tag will refuse to serve.locale is missing or invalid
locale is missing or invalid
The
locale parameter must be in the form xx_YY (ISO 639-1 language, underscore, ISO 3166-1 alpha-2 country), e.g. en_GB. An unknown locale will result in either the default campaign being served or nothing at all.Partner code is missing or hard-coded incorrectly
Partner code is missing or hard-coded incorrectly
The partner-code placeholder in the URL path must be replaced with the partner code issued to your account. If it is missing, mistyped, or copied from another environment, the request will return a 404.
Hardcoded customer or order data
Hardcoded customer or order data
The values passed on the tag must reflect the current customer and their current order. Copying the tag snippet verbatim (with someone else’s email or order number) will attribute activity to the wrong customer.
order_currency is missing or not ISO 4217
order_currency is missing or not ISO 4217
order_currency must be a three-character ISO 4217 code such as GBP, EUR, or USD. Values like £ or pounds will be rejected.order_number is reused across orders
order_number is reused across orders
order_number should be unique per order. Duplicate order numbers cause downstream deduplication and make the order look like a refund or replay of an earlier one.Multiple tags fire but share the same wrapper
Multiple tags fire but share the same wrapper
Tag fires before the DOM is ready in SPAs
Tag fires before the DOM is ready in SPAs
In React, Angular, Vue, or other SPA frameworks, inject the tag after the page content has rendered, and clear
window.MentionMeFiredTags if you need the tag to re-fire on client-side navigations. See the SPA implementation notes for more detail.Referee tag
Locale is missing on the referee tag
Locale is missing on the referee tag
The referee tag must be passed a valid
locale — without one, the “Been referred by a friend?” link will not appear. Check the value is being set for the country your customer is browsing from.mmWrapper div is missing from the page
mmWrapper div is missing from the page
The referee tag populates a placeholder
<div id="mmWrapper"></div> somewhere in the page <body>. If the div is missing, the link or embedded form has nowhere to render. You can also see Mention Me Tag failed to insert into wrapper in the console in this case — see the error codes.