Skip to main content

Buyer

This guide will walk you through the process of setting up Audiences programmatically in Walr.

Prerequisites​

  • A valid bearer token for your customer in the request authorization header. You can find more on how to obtain this here.

Overview​

The Buyer API is crafted to facilitate the creation and management of projects and their associated audiences within a business framework. This API allows users to seamlessly create, organize, and manipulate project data, providing a robust mechanism for handling multiple audiences under a single project umbrella.

Projects​

A project in the context of the Buyer API serves as a container for multiple audiences, functioning as an organizational hub where related audience data can be grouped and managed collectively. Each project is equipped with several metadata fields to provide context and track the creation and management details. An example of a typical project structure is shown below:

[
  {
    "name": "My project",
    "description": "My description",
    "createdByName": "John Test",
    "createdUtc": "2024-04-06T14:19:08.657Z",
    "audiences": []
  }
]

Audiences​

Each audience within a project specifies the target market, denoted by country and language, and sets specific quotas and targets for that market. This allows for precise control over market research activities and audience engagement, tailored to the needs of specific demographic or geographic segments.

The Buyer API provides the functionality to not only create and manage these individual audiences but also to apply actions across all audiences within a project, thus enhancing efficiency and scalability in project and audience management tasks.

This structured approach to project and audience management ensures that users can effectively organize their market research efforts and implement strategic actions across multiple audiences simultaneously, all through a unified interface provided by the Buyer API.