Ad Service Manager (ASM) Integration

Particular Audience's Retail Media offers a flexible and robust interface for on-site sponsored products and display advertising, suitable for any e-commerce platform or application. Our platform also integrates with third-party Ad Service Managers (ASMs) and Demand Side Platforms (DSPs), enabling suppliers to create and manage their campaigns efficiently in external interfaces, ensuring a convenient and streamlined approach to digital advertising and media placement.

Getting Started with Integration

The integration process with PA's Retail Media platform is designed to be straightforward. We begin by setting up an integration Application, and then provide access to specific Retailers and Suppliers at that application level.

Application Setup and Authentication

• Application Configuration: Particular Audience sets up an Application that includes generating an Application ID and a secret key.

• Authentication: Authenticate using the Application ID and secret key through the Application Authentication API to obtain an Access Token. For detailed instructions, refer to the Application Authentication API documentation.

Managing Retailers and Suppliers

important

Organizations are set up in two layers. The Organization is the top-level entity, but each Organization then has Business Units. For example, if a Retailer has multiple websites, each website will be an independent Business Unit. Similarly, a Supplier will also have an Organization, and one or multiple Business Units.

note

Users are setup at the organization level, but the placements and the campaigns are set up at the business unit level.

• Retailer Information: Each application is linked to one or more retailer organization(s). The Retailer API provides detailed information about linked retailers. Please refer to the Retailer API documentation for detailed instructions on how to retrieve the Retailer information.

• Supplier Management: Supplier organizations are linked to retailer organizations. The Supplier API is used to obtain details about linked Suppliers. Please refer to the Supplier API documentation for detailed instructions on how to retrieve the active list of Supplier details.

  important

  Only the suppliers that are related to the retailer organization and also activated for the application will be returned.

User Management

Manage User creation and updates for Retailers and Suppliers through our User APIs:

• List Users

• Create/Update User

Placement Management (Ad Inventory)

Placement management is conducted via DiscoveryOS. Retailers can enable Placements (Slots) for specific Route and Widget locations onsite. Retailers can define Ad Set Type and Ad Set Strategy, which are then used for Ad Set creation. Please refer to Retail Media Placements documentation on how to create placements.

Available Placements can be retrieved by using the Placement API. For detailed instruction on how to retrieve the available Placements, please refer to the Placement API documentation.

Wallet/Fund Management

The Wallet APIs facilitate the management of funds for Suppliers.

• View Fund

• Add Fund

Campaign Management

The Campaign APIs create and update campaigns, and ad sets:

• List Campaigns

• Create/Update Campaign

• Play/Pause Campaign

• Update Campaign Budget

• Campaign AdSets API

• Update AdSet Status API

• Update AdSet Collection API

• Update AdSet Banner API

AdSet Collection Management

The AdSet Collection APIs facilitate the creation and management of the product collection for AdSets:

• Available Collections

• Products in Collections