Offer Tags
Who is this for: Partners who want to control how their offers are sequenced and delivered on MomentPerks and Perkswall.
Outcome: Assign tags to your offers from the Partner Dashboard so that offers matching your payload values move ahead in the delivery order.
Overview
Offer tags are short labels you assign to individual offers from the Partner Dashboard. Tags let you categorize offers and directly influence how they are sequenced and delivered on MomentPerks and Perkswall.
Tags change the order in which offers are delivered. When a value in your request payload matches one of an offer's tags, that offer moves ahead of offers with no match. Adding or removing tags changes delivery as soon as you save.
Tags do not make an offer eligible or ineligible. To control which offers can appear at a position, use Sequence Rulessequence rules.
Managing Offer Tags
Access offer tags from the Offers page in your dashboard. Tags can be added to any Network or Direct offer.
Finding the Tag Input
- Log in to the MomentScience dashboard.
- From the sidebar, click Offers.
- Locate the offer you want to tag in the list.
- Click the โฎ (three-dot) menu on the offer row.
- Select Manage, then choose Tags.
Adding and Tags
- Click inside the Tags field.
- Type a tag name, then press Enter or type a comma to add it.
- Repeat for each additional tag. An offer can carry multiple tags.
Tags are saved in lowercase, and spaces become hyphens (Summer Sale is saved as summer-sale). Payload values are normalized the same way before matching, so a tag only needs to match the spelling of the value you pass.
Removing Tags
- Open the Tags field by clicking the โฎ menu on the offer row, then selecting Manage > Tags.
- Click ร on any tag to remove it from the offer.
Saving Your Changes
Click Save Tags, then confirm in the dialog that opens. Saving replaces the offer's whole tag list, and delivery uses the new tags straight away.
If you close the Tags window before saving, your changes are discarded.
Users with the Analyst role cannot add or remove tags. The Tags option does not appear in their offer menu.
How Tags Affect Offer Sequencing
Tags on an offer change where that offer appears in the delivery order, on both MomentPerks and Perkswall.
When a MomentPerks or Perkswall request is processed:
- MomentScience collects terms from the request: the values in the tags attribute (an array or a comma-separated string) and the value of every other custom text attribute you pass. Reserved attributes such as email, zipcode, country, pub_user_id, theme_id and amount are ignored.
- Terms are lowercased, and spaces and the _ character become hyphens.
- Each offer gets a score equal to the number of its tags that exactly match a term.
- Offers with a score above zero are delivered first, highest score first. Offers with no match follow in the normal order.
For example, passing "category": "vehicles" or "tags": "vehicles,travel" moves offers tagged vehicles ahead. Tags you add or remove in the Partner Dashboard take effect as soon as the offer is saved.
Sequence rules apply to MomentPerks only and are picked by placement. MomentScience uses the rules attached to the placement passed in the request. When a placement marked as Custom Attribute matches a value in the payload, its rules take priority over the rules for the placement value. For details, see Sequence Rules๏ปฟ. To assign sequence rules to a placement, see Managing Placements๏ปฟ.
If you have questions about offer tags or need help configuring tag-based sequencing for your account, contact us at [email protected].