--- title: Relevance-Aware Sponsored Product pin rules for search slug: q2pf0033 canonical_url: https://docs.coveo.com/en/q2pf0033/ collection: coveo-merchandising-hub source_format: adoc --- # Relevance-Aware Sponsored Product pin rules for search > **Important** > > Contact your Coveo representative to enable Relevance-Aware Sponsored Products in your [Coveo organization](https://docs.coveo.com/en/185/). In the [Search manager](https://docs.coveo.com/en/p63f0210/) of the [Coveo Merchandising Hub (CMH)](https://docs.coveo.com/en/o5290573/), merchandisers can define [pin ranking rules](https://docs.coveo.com/en/o5sf0402/) to make specific products appear in specific numbered positions in the search results for one or more specific [queries](https://docs.coveo.com/en/231/). _Relevance-Aware Sponsored Products_ is a CMH feature that lets merchandisers create a special type of pin rule that reserves one or more positions for sponsored products. ![Sponsored pin rule for search | Coveo](https://docs.coveo.com/en/assets/images/coveo-for-commerce/images/cmh/cmh-search-pin-rule-sponsored.png) A in the search results for a particular [query](https://docs.coveo.com/en/231/) can be viewed as a grid (or list) of products in numbered positions. These numbers correspond to their ranking when they're returned from the Coveo [index](https://docs.coveo.com/en/204/). A pin rule reserves a specific numbered position for a specific product or sponsored product, regardless of that product's actual ranking. However, pin rules with the same target can [conflict with one another](#pin-rule-conflicts), so merchandisers must not create multiple pin rules that target the same position for the same queries. **Example** The first four products returned pass:q,a[in the search results for the query `canoe`] are the following: [%header,cols="^1,^1,^1,^1"] |=== |1 |2 |3 |4 |`Orangecraft canoe` |`Bluewater canoe` |`Kayaker canoe` |`Ocarina canoe` |=== You create a pin rule to reserve position 2 for the product `Aqua Blue canoe`. The first four products in the search results are now the following: [%header,cols="^1,^1,^1,^1"] |=== |1 |2 (reserved) |3 |4 |`Orangecraft canoe` |`Aqua Blue canoe` |`Bluewater canoe` |`Kayaker canoe` |=== Sponsored products can be defined manually in the CMH, or they can be [sent by third-party retail-media networks](https://docs.coveo.com/en/q3gb2197/) at [query](https://docs.coveo.com/en/231/) time. When you preview the search results for a particular query in the CMH, numbered positions that have been reserved for sponsored products will be marked with [coin] in the upper-right corner. ## Prerequisites Before you create rules in the [Coveo Merchandising Hub (CMH)](https://docs.coveo.com/en/o5290573/): * [Create query pipelines](https://docs.coveo.com/en/o48e0216#storefront-associations-and-query-pipelines). * [Choose the correct property](https://docs.coveo.com/en/o6lb0453#property-and-locale-selectors) to ensure that your changes affect the intended queries. ## Pin rule conflicts Pin rules override the content that should otherwise appear at a specific position in the search results for a particular [query](https://docs.coveo.com/en/231/). This includes other [product pins](https://docs.coveo.com/en/o5sf0402/) or sponsored product pins that target the same position, so merchandisers must not create multiple pin rules that target the same position for the same query. Pin rule conflicts are resolved as follows: * If there's a conflict between product pins, priority is given to the most recent product pin rule. * If there's a conflict between a product pin and a sponsored product pin, the sponsored product pin always takes precedence. However, if there are no sponsored products to feature in the reserved position, then any product pin rules for that position apply as normal, with priority given to the most recent product pin rule. * If there's a conflict between sponsored product pins, priority is given to the most recent sponsored product pin rule. **Example** On March 1, you create a rule that pins the product "Eco-Bag" at position 2 for the [query](https://docs.coveo.com/en/231/) `drybag`. On March 5, you create a sponsored product pin rule that targets position 2. On March 10, you create another rule that pins the product "Limespace DryBag" at position 2 for the [queries](https://docs.coveo.com/en/231/) `drybag` and `bag`. Regardless of when these pin rules were created, the sponsored product pin rule takes precedence and reserves position 2 for a sponsored product. When a user searches for `drybag`, the sponsored product is pinned at position 2 on the search results page. If a sponsored product isn't defined, "Limespace DryBag" is pinned at position 2. ## Create sponsored product pin rules To create sponsored product pin rules . In the CMH, access the **Search** manager. . From the navigation tabs, select **ranking rules** and then click **Create ranking rule**. . Under **This rule will apply to**, define the scope of the rule. .. **Locale**: Select the [locale](https://docs.coveo.com/en/p4tf0351/) that the pin rule applies to. By default, a rule applies to all available [locales](https://docs.coveo.com/en/p4tf0351/). .. **Audiences**: Select the audience that the pin rule will target. You can choose between predefined audience profiles or create custom profiles. You can only select one audience profile per rule. > **Important** > > The **Audience** option is currently in early access. > Contact your Customer Success Manager (CSM) to enable this option. *** **All visitors**: By default, the rule applies to all [visitors](https://docs.coveo.com/en/nbub9475/). *** **Device & technology**: Target [visitors](https://docs.coveo.com/en/nbub9475/) visiting a [storefront](https://docs.coveo.com/en/p33g0410/) using a specific device type. The device type is determined by the information sent by the [visitor](https://docs.coveo.com/en/nbub9475/)'s browser, not by the device's screen size. Available options are: **** **Desktop**: Encompasses desktop computers and laptops. **** **Mobile**: Encompasses all mobile phones. **** **Tablet**: Encompasses all tablets. *** **Visitor type**: Target the [visitors](https://docs.coveo.com/en/nbub9475/) who are logged into the [storefront](https://docs.coveo.com/en/p33g0410/) or those who aren't. *** **Your audiences**: Create a custom audience profile that you can reuse in other rules sharing the same [property](https://docs.coveo.com/en/p4ue0547/). After a custom audience profile is created, it can't be changed once the rule is published. If all rules containing a custom audience profile are deleted, the custom audience profile will no longer be available as an option when creating new rules. **** **Visitor URL**: Target [visitors](https://docs.coveo.com/en/nbub9475/) based on the URL of the [storefront](https://docs.coveo.com/en/p33g0410/) page they're on. **** **Referrer URL**: Target [visitors](https://docs.coveo.com/en/nbub9475/) based on the URL they came from before landing on the [storefront](https://docs.coveo.com/en/p33g0410/). .. [.initial]**query**: sponsored product pin rules are only available when the rule is scoped to specific queries. If you choose **All queries**, the [.initial]**pin** option is hidden. To scope the rule to specific queries: ... Select **Specific queries**. ... Select an **Operator**. **** `Is`: This operator identifies queries that exactly match the specified value. For example, you can use it to create a rule that only targets the query `accessories`. **** `Contains`: This operator identifies [queries](https://docs.coveo.com/en/231/) where the specified value is found within the full value of the [query](https://docs.coveo.com/en/231/). For example, you can use it to create a rule that targets all [queries](https://docs.coveo.com/en/231/) containing the term `accessories`, including `Surf accessories` and `Parts & accessories`. ... Select one or more [.initial]**queries** that the pin rule applies to. ... Click **Done**. . Under **Choose an action**, select **Pin**. . Select **Sponsored** to use Relevance-Aware Sponsored Products. . Under **Position in results**, select one or more values from the dropdown menu. In the preview, the position will show the label **Sponsored** instead of a product, and icon:coin-filled[alt=coin-filled,width=16] will be visible in the upper-right corner. . (Optional) Enable the **Define manually** toggle to select [items](https://docs.coveo.com/en/pa8f6515/) from your [index](https://docs.coveo.com/en/204/) that you want to appear in the reserved positions. Manually defined products are added to the list of available candidates alongside any candidates [sent by a third-party retail-media network at [query](https://docs.coveo.com/en/q3gb2197/)(https://docs.coveo.com/en/231/) time]. If the API candidates can't fill every reserved position, the most relevant manually defined product that passes the filters fills the remaining spots. ** In the search box, search for and select one or more [items](https://docs.coveo.com/en/pa8f6515/) from your [index](https://docs.coveo.com/en/204/). . Click **Next: Review and publish**. . Review your rule configuration. > **Leading practices** > > Use the panel on the right to preview how the rule affects > the search results for a given [locale](https://docs.coveo.com/en/p4tf0351/). > > The preview is an approximate simulation that won't cover every scenario encountered in a live environment. . Click **Next: Publish**. . Under **Rule name**, enter a meaningful name for your rule. . Under **Choose when to publish**, select one of the following: ** To apply the rule immediately, select **Publish now**. ** To set a schedule for the rule, select **Set a schedule**, and then select the time frame in which the rule should apply. . Click **Publish now**. The rule now applies or will apply as scheduled. ## Modify sponsored product pin rules To modify sponsored product pin rules . In the CMH, access the **Search** manager. . From the navigation tabs, select **ranking rules**. . Locate the rule that you want to modify. . Click [dots], and then click **Modify**. . You can modify the rule's scope (**Locale**, **Audiences**, or [.initial]**query**) or its configuration by clicking **Edit** on the relevant card. These are the same settings covered in the [rule creation](#create-sponsored-product-pin-rules) section. > **Important** > > The **Audience** option is currently in early access. > Contact your Customer Success Manager (CSM) to enable this option. . When you've finished editing the rule, or to modify its publishing settings, click **Next: Publish**. . Update the publishing settings, if applicable, and then click **Publish now**. The modified rule now applies, or will apply as scheduled. ## Copy sponsored product pin rules To copy sponsored product pin rules . In the CMH, access the **Search** manager. . From the navigation tabs, select **ranking rules**. . Locate the rule that you want to copy. . Click [dots], and then click **Copy to...**. . In the **Copy rule** modal that opens, you can choose whether to copy the rule to other [properties](https://docs.coveo.com/en/p4ue0547/) or queries. ** To copy the rule to other [properties](https://docs.coveo.com/en/p4ue0547/): ... Select **Property** and click **Next**. ... Use the dropdown menu to select one or more [properties](https://docs.coveo.com/en/p4ue0547/). > **Important** > > If any of the queries that the rule is scoped to > don't exist in the target [property](https://docs.coveo.com/en/p4ue0547/), you'll see an error message and be unable to proceed with the copy. > > The error message will list the queries that are missing from the destination [property](https://docs.coveo.com/en/p4ue0547/). ... Click **Confirm copy**. ** To copy the rule to other queries (if applicable): ... Select [.initial]**query** and click **Next**. ... Use the dropdown menu to select one or more queries. ... Click **Confirm copy**. The rule is copied to the target [properties](https://docs.coveo.com/en/p4ue0547/) or queries. ## Delete sponsored product pin rules To delete sponsored product pin rules . In the CMH, access the **Search** manager. . From the navigation tabs, select **ranking rules**. . Locate the rule that you want to delete. . Click [dots], and then click **Delete**. . Click **Delete** again to confirm. The rule is deleted.