What triggers initiate a sponsored listing campaign?

Unlocking Auction Potential with Topsort's API Triggers

The triggers within Topsort's API serve as the connection points between promoted products and auction requests. Here's an overview of the available trigger types:

  1. Categories Trigger: Connects campaign products to specific categories, enhancing their visibility.

    Using the fromProduct value, product IDs are listed within trigger objects with type "categories."
    When an auction request includes a category ID in its options, all campaign products within that category join the auction.

  2. Category Trigger: Associates products with designated category IDs, ensuring optimal participation in auctions.

    Utilizing the categoryId value, category IDs are listed within trigger objects with type "category."
    When an auction request includes a category ID, all products from campaigns associated with that category participate in the auction.

  3. Keyword Trigger: Links campaign products with relevant keywords, maximizing exposure in search queries.

    Employing the matchType value, keywords are listed within trigger objects with type "keyword."
    When an auction request includes a keyword in the searchQuery field, all products from campaigns linked to that keyword join the auction.

  4. Product Trigger: Ties products to specific IDs, facilitating targeted participation in auctions.

    Using the productId value, product IDs are listed within trigger objects with type "product."
    When an auction request includes product IDs, all products from campaigns with those products as triggers participate in the auction.

Campaigns can employ multiple trigger types for enhanced flexibility. Each trigger condition met ensures campaign participation in auctions. Choose triggers wisely to optimize sponsored listing campaigns and effectively reach your audience.


Ultimately, the choice of triggers depends on the unique use case and available parameters when displaying listings on your website's pages. By selecting the appropriate trigger types, you can effectively initiate sponsored listing campaigns and reach your target audience.