Skip to main content

cmeta for gift cards

Know which campaign, channel, or customer each redeemed gift card belongs to — by tagging the reward links you share.

Gift cards travel to recipients as reward links, and the link is where your custom attributes ride. Append cmeta_* parameters (and the five standard utm_* parameters) to the URL you share; when the recipient opens the link and reveals the card, Paylode captures them and ties them to that view and claim.

Where to pass them​

Attributes are not set when you generate the link — generateRewardLink takes only the denomination, currency, and expiry. Instead, append them to the shared URL itself, the same way you'd tag any campaign link:

https://rewards.paylode.com/<link>?cmeta_recipient_id=42931&utm_campaign=summer-thanks
  • Name your own attributes with the cmeta_ prefix — letters, digits, hyphens, underscores; values under 255 characters, URL-encoded.
  • The five utm_ names (utm_source, utm_medium, utm_campaign, utm_term, utm_content) are captured as-is.
  • Anything else on the URL is ignored for attribution.

Because you control the URL per recipient, this is how you distinguish one send from another: a different cmeta_recipient_id per email, a different utm_campaign per promotion.

caution

The link is still a bearer secret — tagging doesn't change that. Add your parameters when you send it, and keep the full tagged URL out of logs and public places just as you would the bare link. See Reward link for the security guidance.

Where they come back​

Captured attributes are recorded against the link's views and its claim, with the platform's usual read-back rule: cmeta_ prefixes are stripped (cmeta_recipient_id → recipient_id) and utm_* names stay unchanged. That's what lets you reconcile a revealed card back to the exact send in your own records.