Skip to main content

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.

Your customers are already sharing products with friends. Product Referral makes that visible — track which products drive the most word-of-mouth, identify your top advocates, and attribute revenue back to the shares that generated it.
Install the tag directly on your product pages (recommended for most platforms). Works with any platform.
1

Install the tracking tag

Include the following JavaScript snippet at the bottom of the <body> tag on the product page. The request includes your unique partner code. This is the only required step — it enables URL-based product sharing and tracking.
<!-- Begin Mention Me Product Referral integration -->
<script type="text/javascript"
  src="https://tag-demo.mention-me.com/api/v2/product/YOUR_PARTNER_CODE?situation=product&implementation=sharelink&locale=en_GB&product_id=<CURRENT_PRODUCT_ID>">
</script>
<!-- End Mention Me Product Referral integration -->
Replace <CURRENT_PRODUCT_ID> with the product ID of the page where this is being shown. This can usually be accessed through a data layer.
The verb in the URL path (product) can also be written as tracking — both behave identically.
All parameter values must be URL-encoded — for example, @%40, spaces → %20.
2

Track conversions

By tracking conversions alongside product shares, you can measure the full impact of word-of-mouth on your sales. This allows you to see which shared products are driving revenue, identify your most influential advocates, and understand the complete customer journey from share to purchase.
If you haven’t yet integrated a referrer (conversion) tag, you’ll need to set one up to track conversions. Visit our referrer tag integration page for full setup instructions. When configuring your referrer tag, include the product parameters listed below to enable product-level conversion tracking from the start.
If you already have a referrer (conversion) tag integrated, you can enhance it with product data by adding the following parameters to your existing tag. This will associate product information with each conversion, enabling product-level reporting.Add these parameters to your existing referrer tag query string:
product_ids
string
Comma-separated list of product IDs included in the order.
product_skus
string
Comma-separated list of product SKUs included in the order.
product_names
string
Comma-separated list of product names included in the order.
product_prices
string
Comma-separated list of product prices included in the order.
product_quantities
string
Comma-separated list of product quantities included in the order.
For example, append these to your referrer tag URL: &product_ids=SKU001,SKU002&product_skus=ABC,DEF&product_names=Widget,Gadget&product_prices=9.99,19.99&product_quantities=1,2
3

Add a share button (optional)

If you want to display a share button on the product page, include the following <div> somewhere in the <body> tag, near the product name or description. This is a placeholder which will be populated by the JavaScript tag. If you skip this step, URL-based product sharing and tracking will still work.
<!-- Begin Mention Me Product link placeholder -->
<div id="mmWrapper"></div>
<!-- End Mention Me Product link placeholder -->
If your technical team is unable to add new elements into the page, we can help by setting up the tag to inject the content next to an existing element. Contact your Onboarding Team and let them know which element should be selected.You can optionally apply a class or style to the div if you wish to control the way the contents are styled.
If your checkout runs on a different subdomain to the product page (for example product pages on www.merchant.com but checkout on checkout.merchant.com), append the storage parameter to your tag URL. The default behaviour stores the referral identifiers in sessionStorage, which is per-origin and won’t survive the navigation. This option mirrors them to a cookie scoped to your registrable domain so the bootloader on checkout can read them.
<!-- Begin Mention Me Product Referral integration -->
<script type="text/javascript"
  src="https://tag-demo.mention-me.com/api/v2/product/YOUR_PARTNER_CODE?situation=product&implementation=sharelink&locale=en_GB&storage=session+cookie&product_id=<CURRENT_PRODUCT_ID>">
</script>
<!-- End Mention Me Product Referral integration -->
The cookie is scoped to your registrable domain (e.g. .merchant.com), set with Secure and SameSite=Lax, and expires after 30 days. Cookies cannot bridge a checkout that runs on an entirely different domain (e.g. www.merchant.com to pay.thirdparty.com). Only different subdomains of the same registrable domain are supported.
Setting this cookie is your responsibility under your own privacy policy and consumer-consent process. Only enable storage=session+cookie if you have the relevant consent in place on your domain.

Tag parameters

Mandatory

The following parameters are the minimum required to make the integration work.
locale
string
required
String representing the required locale. Used to show the right language and currency for the user. The format should be ISO 639-1 language code, an underscore (_), then the ISO 3166-1 alpha-2 country code. Default is en_GB. Example: en_GB
product_id
string
required
The unique product identifier from your system. This allows tracking which products are being recommended. Example: PROD-456
Add these data parameters to significantly improve performance.
product_sku
string
The product SKU (Stock Keeping Unit) from your system. This provides an additional identifier for tracking products. Example: SKU-789
product_name
string
The name of the product. Please URL encode. Example: Blue Widget
product_price
string
The price of the product. Example: 29.99
Pass these additional parameters to enhance tracking and personalisation.
firstname
string
The customer’s firstname. Please URL encode.
surname
string
The customer’s surname. Please URL encode.
fullname
string
The customer’s full name. Please URL encode.
email
string
The customer’s email address. Please URL encode.
customer_id
string
The unique customer identifier from your system.
phone_number
string
The customer’s phone number(s). Pass as many phone numbers as you have as a comma-separated list.
segment
string
String representing a customer segment (for example one of: men, women) used to pass segmentation data about your customer to us. Has a maximum of 50 characters.
Last modified on April 28, 2026