Sequence Rules

who is this for partners and integration engineers who need fine grained control over which offers appear in specific positions within a moments response outcome create whitelist and blacklist sequence rules scoped to individual placements to ensure the right offers appear at each position in the offer sequence overview sequence rules let you control which offers appear at each position in a moments response using whitelists and blacklists, you can define exactly which offers, offer types, goal types, or offer groups are eligible to serve at positions 1 through 5 in the offer sequence rules are scoped to individual placements a rule assigned to one placement has no effect on any other placement, and rules from different placements are never combined in a single request core concepts positions moments responses return up to five offers in order sequence rules target one or more of these positions to control what appears there when creating a rule, you choose how positions are targeted all positions the rule applies uniformly across positions 1 through 5 selected positions the rule applies only to the positions you choose (any combination of 1–5) rule types each rule is either an inclusion (whitelist) or an exclusion (blacklist) when both inclusion and exclusion rules apply to the same placement, exclusion rules are evaluated first filters filters define which offers a rule targets each rule can use one or more of the following filter dimensions you can combine multiple filter dimensions in a single rule how they combine depends on the filter logic you select offer tags are one of the available filter dimensions tags are assigned to offers directly from the partner dashboard for instructions on managing offer tags, see offer tags docid\ ovthqd0uv 2teip4d1csj filter logic when a rule includes more than one filter dimension, filter logic controls whether an offer must match any one criterion or all of them weightage weightage is a numeric value (≥ 0) that sets the relative priority of a rule when multiple rules are assigned to the same placement higher weightage rules are evaluated first within the same priority tier how rules are applied priority ordering when multiple rules apply to a placement, momentscience evaluates them in a fixed order exclusion (blacklist) rules are applied before inclusion (whitelist) rules all positions rules take priority over rules targeting multiple selected positions multi position rules take priority over rules targeting a single position within each tier, rules are ranked by weightage (highest first) multiple rules on a placement when a placement has more than one sequence rule assigned, an offer must satisfy all active rules to be eligible the resulting offer set is the intersection of what each individual rule permits for example, if rule a allows only cpa offers and rule b allows only offers in group x, the eligible set contains only cpa offers that are also in group x placement scoping sequence rules are scoped to the placement they are assigned to a rule on one placement never affects any other placement how rules resolve depends on whether a placement value is included in the request for details on configuring placements and assigning rules to them, see managing placements docid\ qf0xncd7wss1uwlajwial your sequence rules dashboard if sequence rules are enabled on your account, you can access them from your dashboard at tools > sequence rules https //app momentscience com/account/tools/sequence rules this page is read only use it to see every active sequence rule on your account and understand how offer sequencing is configured across your placements you can check which positions each rule targets, what filters are applied, and which specific offers are eligible at each position you can view your sequence rules here, but you cannot create or edit them directly to add, modify, or disable a rule, contact your account manager viewing offers per rule each row in the table includes a view icon (eye icon) clicking it opens a panel that shows the specific offers eligible at each position based on that rule's filter configuration use this to confirm that the correct offers are being targeted for each position in your moments unit no rules configured if no rules have been set up for your account, the page will show a message indicating that there's no sequence rules have been configured for this account yet contact your account manager to get started users with manager or analyst roles cannot see this section in the dashboard examples example 1 whitelist cpa offers at position 1 configure position 1 to serve only cpa goal type offers, leaving positions 2–5 unrestricted positions selected, position 1 only rule type inclusion filter goal type = cpa result position 1 serves only cpa offers all other positions are unaffected example 2 block network offers at positions 2 and 3 prevent third party network offers from appearing at the second and third positions in the sequence positions selected, positions 2 and 3 rule type exclusion filter offer type = network result positions 2 and 3 never serve network offers all other offer types remain eligible at those positions example 3 serve cpc offers or offer group a at all positions (or logic) restrict all five positions to a combination of goal type and offer group, accepting a match on either criterion positions all positions rule type inclusion filter logic or filters goal type = cpc · offer groups = group a result all five positions serve offers that are cpc, in group a, or both offers matching neither filter are excluded example 4 serve only cpa offers in offer group b at position 3 (and logic) pin position 3 to a precise intersection of goal type and offer group both conditions must be true positions selected, position 3 only rule type inclusion filter logic and filters goal type = cpa · offer groups = group b result position 3 serves only offers that are both cpa and in group b an offer that is cpa but not in group b, or in group b but not cpa, is excluded assigning rules to placements sequence rules are created at the account level and then assigned to individual placements to assign a rule to a placement, navigate to tools > placements https //app momentscience com/account/tools/placements and use the select sequence rule(s) dropdown on any placement row for full details on creating placements, configuring a default, and managing rule assignments, see managing placements docid\ qf0xncd7wss1uwlajwial if you need help configuring sequence rules or enabling the feature for your account, contact us at help\@momentscience com mailto\ help\@momentscience com