Advanced Settings
Managing Placements
21 min
overview placements give you a way to organize and control how momentscience delivers offers across different pages or surfaces in your integration by passing a placement value in your moments payload, you can map specific themes and sequence rules to each location, so the checkout page, homepage, and mobile app can each show offers tailored to that context, all from a single account when a placement matches a configured entry in your dashboard, momentscience applies the themes and sequence rules you have assigned to it when no placement is passed, the placement you have marked as default is used instead the placement parameter is required in all moments sdk and api requests for a full list of payload parameters, see docid\ yz38zu4 miummwtnnsg98 how placements works the placement parameter include placement in every request to identify which page or surface the offer unit is appearing on the value you pass is matched against your configured placements to determine which themes and sequence rules apply // moments api { "api key" "your api key", "placement" "checkout confirmation", "pub user id" "user 123" } auto created placements when a placement value arrives in a request that has not been manually configured, momentscience automatically creates a placement entry for it in your dashboard, no pre registration is needed before going live the placement name defaults to the raw value passed in the payload automatically created placements behave identically to manually created ones you can assign themes, sequence rules, and a default status to them at any time parameter formatting momentscience normalizes placement values to a consistent format on both save and matching all characters are converted to lowercase underscores and spaces are converted to hyphens matching is case insensitive and ignores formatting differences this means home page , home page , home page , and home page all resolve to the same placement home page you do not need to align the exact formatting between what your integration passes and what is stored in the dashboard, the normalization is applied automatically on both sides true 330,331 left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type if your integration passes homepage desktop and homepagedesktop separately, they normalize to different values ( homepage desktop and homepagedesktop ) and are treated as distinct placements managing placements access the manage placements page from your dashboard under https //app momentscience com/account/tools/placements the https //app momentscience com/account/tools/placements displays your active placements in a table with columns for placement name, moment themes, sequence rules, and last updated date users with manager or analyst roles cannot access the placements section, it is not visible to them in the dashboard adding a placement manually click add placement on the manage placements page enter a placement parameter (required), this is the unique identifier matched against the placement value in your moments payload (e g , checkout confirmation ) it is normalized to lowercase and hyphenated on save enter a placement name (optional), a human readable label for the placement in your dashboard (e g , "checkout confirmation page") select moment themes (optional), one or more themes to serve on this placement select sequence rules (optional), one or more rules to apply to offer sequencing on this placement click save editing a placement click the edit control on any active placement row to update its name, themes, or sequence rules save applies all changes for that row at once, theme selections, weights, and rule assignments are all saved in a single action archiving and unarchiving to deactivate a placement, click archive on its row archived placements no longer influence offer serving, requests matching an archived placement slug fall back to the default placement if you need to reactivate an archived placement or reuse its slug, contact your account manager default placement one placement is always marked as the default when a moments request arrives with no placement value (or null ), the default placement's themes and sequence rules are used how the default is assigned the first placement you add is automatically set as default when you have two or more placements, a radio button on each row lets you change which one is default exactly one placement can be default at a time if you archive the current default, the most recently created remaining placement becomes the new default automatically assigning themes weight each placement can have one or more moment themes assigned to it when multiple themes are assigned, momentscience distributes serving across them using the weight you configure per theme assigning and removing themes in the placement row, open the select moment theme(s) dropdown each theme shows a checkbox to select or deselect it selected themes appear at the top of the list with their current weight theme weights and a/b distribution each theme assigned to a placement has a weight value weights determine the relative share of serving traffic each theme receives true 330,331 left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type the default weight for any newly assigned theme is 1 leaving all themes at weight 1 gives each theme equal opportunity theme priority when theme id is passed in payload if your integration passes a theme id directly in the moments payload alongside a placement , the explicitly passed theme id takes priority over the themes configured on the placement this lets you override the placement's theme assignment on a per request basis when needed if the theme id passed does not exist or has been archived, momentscience falls back to the publisher's default theme assigning sequence rules each placement can have one or more sequence rules assigned to it sequence rules control which offers are eligible and in what order they appear for that placement single vs multiple rules one rule assigned that rule is applied in full multiple rules assigned the rules are combined, only offers that satisfy all assigned rules are eligible the resulting offer set reflects the intersection of all rules on the placement open the select sequence rule(s) dropdown on the placement row to add or remove rules when multiple rules are selected, each rule is honored based on its own settings, contact your account manager if you need help configuring individual rule behavior placement scoped rules sequence rules are scoped to the placement they are assigned to a rule on one placement does not affect any other placement, and no account level rule aggregation occurs this means requests that match a placement use only that placement's assigned rules if a placement has no rules assigned, offers are returned without sequencing constraints if no placement is passed and a default placement is configured, the default placement's rules apply if no placement is passed and no default placement exists, no sequence rules are applied serving behavior when a moments request arrives, momentscience resolves the placement and applies themes and sequence rules in the following order theme resolution if theme id is passed in the payload, use that theme (if valid and not archived) if the placement has one or more themes assigned, select a theme based on weights if the placement has no themes, or the passed theme id does not exist, use the publisher's default theme sequence rule resolution if the request includes a placement value that matches an active placement, apply only that placement's sequence rules if no placement is passed but a default placement is configured, apply the default placement's sequence rules if no placement is passed and no default placement exists, serve offers without sequencing constraints no placement passed when placement is absent or null in the request if a default placement is configured its themes and sequence rules are used if no placements exist at all standard account level behavior applies (default theme, no sequence rule constraints) if you encounter any issues or need support during integration, contact us at mailto\ help\@momentscience com