> ## Documentation Index
> Fetch the complete documentation index at: https://developers.criteo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing Campaigns

export const EndpointBadge = ({method = "GET", children}) => {
  const METHOD_STYLES = {
    GET: {
      bg: "mint-bg-[#2AB673]"
    },
    POST: {
      bg: "mint-bg-[#3064E3]"
    },
    PUT: {
      bg: "mint-bg-[#C28C30]"
    },
    PATCH: {
      bg: "mint-bg-[#DA622B]"
    },
    DELETE: {
      bg: "mint-bg-[#CB3A32]"
    },
    API: {
      bg: "mint-bg-black"
    }
  };
  const key = method.toUpperCase();
  const styles = METHOD_STYLES[key] ?? METHOD_STYLES.API;
  return <div className="relative mt-7">
      <span className={`absolute -top-2 -left-2 z-10 ${styles.bg} text-white px-2.5 py-0.5 rounded-full text-xs font-bold tracking-wide`}>
        {key}
      </span>
      {children}
    </div>;
};

A COA-Campaign is a course of action to advertise the products of your sellers.    

## Adding Campaigns

Campaigns are not added with the API. Instead, they are created, started and stopped by your Technical Solution engineer.    

## Managing Seller-Campaigns

A Seller-Campaign contains all the information relative to the advertisement of the products of a Seller in a Campaign. In particular it contains information about bid and status:

**`bid`**\
Bid specified for this Seller in this Campaign

**`suspendedSince`**\
Date and time since we stopped delivering adds for this Seller in this Campaign

**`suspensionReasons`**\
List of reasons why the campaign is suspended (possible values are: `NoMoreBudget`, `ManuallyStopped`, `NoBudgetDefined`, `NoCpcDefined`, `RemovedFromCatalog`)     Every Seller-Campaign is identified by:

**`sellerId`**\
SellerId of the seller associated to this Seller-Campaign

**`campaignId`**\
CampaignId of the COA-campaign associated to this Seller-Campaign

## Adding Seller-Campaigns

Seller-Campaigns get automatically created for every Campaign and every Seller in your feed.

* New Seller-Campaigns are created inactive by default (`suspendedSince` flag is set to the moment of creation)    

## Getting Seller-Campaigns

To see what Seller-Campaigns are available you can make following query:    

<EndpointBadge method="get">
  ```http theme={null}
  https://api.criteo.com/legacy/offsite-ads/seller-campaigns
  ```
</EndpointBadge>

<CodeGroup>
  ```json JSON theme={null}
  [{
      "id": "1.10001",
      "suspendedSince": "2018-07-30T18:00:13.333",
      "suspensionReasons": ["NoMoreBudget"],
      "sellerId": "1",
      "campaignId": 10001,
      "bid": null
  },{
      "id": "2.10001",
      "suspendedSince": "2018-09-03T09:00:23.8",
      "suspensionReasons": ["ManuallyStopped"],
      "sellerId": "2",
      "campaignId": 10001,
      "bid": null
  },{
      "id": "3.10001",
      "suspendedSince": "2018-09-03T09:00:23.8",
      "suspensionReasons": ["NoCpcDefined"], 
      "sellerId": "3",
      "campaignId": 10001,
      "bid": null
  }]
  ```
</CodeGroup>

   

## Starting Seller-Campaigns

In order to start delivering ads for a Seller in a Campaign, the Seller-Campaign needs to :

* be part of a running Campaign
* have a bid (see "[Setting the Bid for a given Seller-Campaign](/marketing-solutions/v2020.07/docs/managing-campaigns#setting-the-bids-of-seller-campaigns)" section)
* have an active budget (see "[Managing Budgets](/marketing-solutions/v2020.07/docs/managing-budgets)" section)

When a Seller-Campaign becomes inactive, the `suspendedSince` flag is null.    

## Stopping Seller-Campaigns

In order to stop delivering ads for a Seller in a Campaign, you can do one of the following actions :

* set the bid of the Seller-Campaign to null (see "[Setting the Bid for a given Seller-Campaign](/marketing-solutions/v2020.07/docs/managing-campaigns#setting-the-bids-of-seller-campaigns)" section)
* suspend the current budget (see "[Suspend a Budget](/marketing-solutions/v2020.07/docs/managing-budgets#suspending-budgets)" section)
* remove products of this Seller from the feed (if you have several COA-Campaigns, this will also stop the Seller in the other COA-Campaigns)

When a Seller-Campaign becomes inactive, the `suspendedSince` flag is set to the current date.    

## Setting the Bids of Seller-Campaigns

In order to have a Sellers active in the campaign, you have to specify the bids that will be used for these Sellers in the given Campaign.    

<EndpointBadge method="patch">
  ```http theme={null}
  https://api.criteo.com/legacy/offsite-ads/seller-campaigns
  ```
</EndpointBadge>

<CodeGroup>
  ```json JSON theme={null}
  [{
      "id": "1.10001",
      "bid": 0.3
  },{
      "id": "2.10001",
      "bid": 0.6
  },{
      "id": "3.10001",
      "bid": 0.5
  }]
  ```
</CodeGroup>

   

<Warning>
  **Note that the ID is defined by “seller ID” dot “campaign ID” (e.g 1.10001 for seller ID 1 and campaign 10001).**
</Warning>