Create Bid modifier

Create Bid modifier

POST https://api.ocamba.com/v2/adex/bid-modifiers
Creates a new Bid modifier object

Request schema

body
curl -X POST \
 "https://api.ocamba.com/v2/adex/bid-modifiers" \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
  "id": "100123",
  "name": "DemoBidModifiers",
  "description": "My first bid modifier",
  "pricing_model": "cpc",
  "ignore_bid_strategy": 1,
  "percent_value": 12.55,
  "value": 87.32,
  "max_value": 11.03,
  "targeting": {
    "countries": {
      "items": [
        "AF"
      ],
      "op": "in"
    },
    "regions": {
      "items": [
        "114223412"
      ],
      "op": "in"
    },
    "os": {
      "items": [
        {
          "id": "12"
        }
      ]
    },
    "browsers": {
      "items": [
        {
          "id": "10"
        }
      ]
    },
    "subids": {
      "items": [
        "sub_id"
      ],
      "op": "in"
    },
    "categories": {
      "items": [
        "IAB1"
      ],
      "op": "in"
    },
    "containers": {
      "items": [
        "1010"
      ],
      "op": "in"
    },
    "ip": {
      "items": [
        "192.168.0.1"
      ],
      "op": "in"
    },
    "zones": {
      "items": [
        "1003444"
      ],
      "op": "in"
    },
    "pages": {
      "items": [
        "google.com"
      ],
      "op": "in"
    },
    "device_types": {
      "items": [
        "mobile"
      ],
      "op": "in"
    },
    "device_manufacturers": {
      "items": [
        "4"
      ],
      "op": "in"
    },
    "time": {
      "items": [
        "12,13 * 2,3,4 * 0,4,5"
      ],
      "op": "in"
    },
    "languages": {
      "items": [
        "sr"
      ],
      "op": "in"
    },
    "device_tracking": 1,
    "is_webview": 1,
    "has_user_data": 1
  }
}'
const url = 'https://api.ocamba.com/v2/adex/bid-modifiers';
const options = {
  method: 'POST',
  headers: {
    Authorization: "Bearer {TOKEN}",
    'Content-Type': "application/json"
  },
  body: JSON.stringify(
    {
      "id": "100123",
      "name": "DemoBidModifiers",
      "description": "My first bid modifier",
      "pricing_model": "cpc",
      "ignore_bid_strategy": 1,
      "percent_value": 12.55,
      "value": 87.32,
      "max_value": 11.03,
      "targeting": {
        "countries": {
          "items": [
            "AF"
          ],
          "op": "in"
        },
        "regions": {
          "items": [
            "114223412"
          ],
          "op": "in"
        },
        "os": {
          "items": [
            {
              "id": "12"
            }
          ]
        },
        "browsers": {
          "items": [
            {
              "id": "10"
            }
          ]
        },
        "subids": {
          "items": [
            "sub_id"
          ],
          "op": "in"
        },
        "categories": {
          "items": [
            "IAB1"
          ],
          "op": "in"
        },
        "containers": {
          "items": [
            "1010"
          ],
          "op": "in"
        },
        "ip": {
          "items": [
            "192.168.0.1"
          ],
          "op": "in"
        },
        "zones": {
          "items": [
            "1003444"
          ],
          "op": "in"
        },
        "pages": {
          "items": [
            "google.com"
          ],
          "op": "in"
        },
        "device_types": {
          "items": [
            "mobile"
          ],
          "op": "in"
        },
        "device_manufacturers": {
          "items": [
            "4"
          ],
          "op": "in"
        },
        "time": {
          "items": [
            "12,13 * 2,3,4 * 0,4,5"
          ],
          "op": "in"
        },
        "languages": {
          "items": [
            "sr"
          ],
          "op": "in"
        },
        "device_tracking": 1,
        "is_webview": 1,
        "has_user_data": 1
      }
    }
  )
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
$ch = curl_init("https://api.ocamba.com/v2/adex/bid-modifiers");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "Authorization: Bearer {TOKEN}",
  "Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(
  [
    "id" => "100123",
    "name" => "DemoBidModifiers",
    "description" => "My first bid modifier",
    "pricing_model" => "cpc",
    "ignore_bid_strategy" => 1,
    "percent_value" => 12.55,
    "value" => 87.32,
    "max_value" => 11.03,
    "targeting" => [
      "countries" => [
        "items" => [
          "AF"
        ],
        "op" => "in"
      ],
      "regions" => [
        "items" => [
          "114223412"
        ],
        "op" => "in"
      ],
      "os" => [
        "items" => [
          [
            "id" => "12"
          ]
        ]
      ],
      "browsers" => [
        "items" => [
          [
            "id" => "10"
          ]
        ]
      ],
      "subids" => [
        "items" => [
          "sub_id"
        ],
        "op" => "in"
      ],
      "categories" => [
        "items" => [
          "IAB1"
        ],
        "op" => "in"
      ],
      "containers" => [
        "items" => [
          "1010"
        ],
        "op" => "in"
      ],
      "ip" => [
        "items" => [
          "192.168.0.1"
        ],
        "op" => "in"
      ],
      "zones" => [
        "items" => [
          "1003444"
        ],
        "op" => "in"
      ],
      "pages" => [
        "items" => [
          "google.com"
        ],
        "op" => "in"
      ],
      "device_types" => [
        "items" => [
          "mobile"
        ],
        "op" => "in"
      ],
      "device_manufacturers" => [
        "items" => [
          "4"
        ],
        "op" => "in"
      ],
      "time" => [
        "items" => [
          "12,13 * 2,3,4 * 0,4,5"
        ],
        "op" => "in"
      ],
      "languages" => [
        "items" => [
          "sr"
        ],
        "op" => "in"
      ],
      "device_tracking" => 1,
      "is_webview" => 1,
      "has_user_data" => 1
    ]
  ]
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

Responses

201 Created

{
  "id": "100123",
  "company_id": "2321414",
  "name": "DemoBidModifiers",
  "description": "My first bid modifier",
  "pricing_model": "cpc",
  "ignore_bid_strategy": 1,
  "percent_value": 12.55,
  "value": 87.32,
  "max_value": 11.03,
  "targeting": {
    "countries": {
      "items": [
        "AF"
      ],
      "op": "in"
    },
    "regions": {
      "items": [
        "114223412"
      ],
      "op": "in"
    },
    "os": {
      "items": [
        {
          "id": "12"
        }
      ]
    },
    "browsers": {
      "items": [
        {
          "id": "10"
        }
      ]
    },
    "subids": {
      "items": [
        "sub_id"
      ],
      "op": "in"
    },
    "categories": {
      "items": [
        "IAB1"
      ],
      "op": "in"
    },
    "containers": {
      "items": [
        "1010"
      ],
      "op": "in"
    },
    "ip": {
      "items": [
        "192.168.0.1"
      ],
      "op": "in"
    },
    "zones": {
      "items": [
        "1003444"
      ],
      "op": "in"
    },
    "pages": {
      "items": [
        "google.com"
      ],
      "op": "in"
    },
    "device_types": {
      "items": [
        "mobile"
      ],
      "op": "in"
    },
    "device_manufacturers": {
      "items": [
        "4"
      ],
      "op": "in"
    },
    "time": {
      "items": [
        "12,13 * 2,3,4 * 0,4,5"
      ],
      "op": "in"
    },
    "languages": {
      "items": [
        "sr"
      ],
      "op": "in"
    },
    "device_tracking": 1,
    "is_webview": 1,
    "has_user_data": 1,
    "create_time": "2023-07-04 07:12:47",
    "update_time": "2023-07-28 12:18:06"
  }
}
Responses

Tip
Fields percent_value and value are mutually exclusive.
Note
We recommend using containers instead of tags, as tags are deprecated. If both parameters are sent, containers will take priority.