Update Bid modifier

PATCH /bid-modifiers/{id}
Copied
Arrow
                https://api.ocamba.com/v2/adex/bid-modifiers/{id}

Updates the specific Bid modifier by setting the values of the parameters passed. Any parameters not provided will be left unchanged

path Parameters
Arrow
Name
Description
idstringrequired
Unique identifier for the object defined as a path parameter.


Example: 12345
Request Body Schema
Arrow
Name
Description
descriptionstring
Description of a bid modifier. Maximum of 2000 characters.


Example: My first bid modifier
max_valuefloat
Maximum value of the bid modifier. Minimum value is 0, maximum value is 100.


Example: 11.03
namestringrequired
Name of the bid modifier. Maximum of 100 characters.


Example: DemoBidModifiers
percent_valuefloatrequired
Percentage value of the bid modifier. Minimum value is -100, maximum value is 1000.


Example: 12.55
targetingbid-modifier-targetingrequired
Bid targeting object.
Bid Modifier Targeting
Name
Description
browsersobject

Name
Description
items[ object ]
Array of browser items, maximum length limited by subscription plan.
categoriesobject

Name
Description
items[ string ]
Array of strings containing category ids. Maximum length limited by subscription plan.
opstring
String describing operation.


Example: in

Possible values: in
containersobject

Name
Description
items[ string ]
Array of strings containing containers ids. Maximum length limited by subscription plan.
opstring
String describing operation.


Example: in

Possible values: in
countriesobject

Name
Description
items[ string ]
Array of strings containing 2 letter country codes. Maximum length limited by subscription plan.
opstring
String describing operation.


Example: in

Possible values: in
device_manufacturersobject

Name
Description
items[ string ]
Array of strings containing device manufacturer ids. Maximum length limited by subscription plan.
opstring
String describing operation.


Example: in

Possible values: in
device_trackingnumber (integer)
Is device tracking enabled. Possible values are 0 and 1.


Example: 1
device_typesobject

Name
Description
items[ string ]
Array of strings containing device types. Maximum length limited by subscription plan.
opstring
String describing operation.


Example: in

Possible values: in
has_user_datanumber (integer)
Is user data enabled. Possible values are 0 and 1.


Example: 1
ipobject

Name
Description
items[ string ]
Array of ips, each element must be a valid ipv4, ipv6 or cidr format for both v4 and v6, maximum length limited by subscription plan. Required if lists is not present.


Example: 123.523.123.4,123.523.123.4/12,2001:0db8:85a3:33a1:ff12:8a2e:0370:7334/23,2301:01b8:f5a3:43a1:afc2:8c2e:0370:7334
lists[ string ]
Array of list ids created by the Ocamba platform. Lists must be of type ip, maximum length limited by subscription plan. Required if items is not present.
opstring



Example: in

Possible values: in | nin
is_webviewnumber (integer)
Describes status of the webview. Possible values are 0 and 1.


Example: 1
languagesobject

Name
Description
items[ string ]
Array of unique strings. Each element must be a valid 2-letter language code supported by Ocamba platform, maximum number of items limited by subscription plan.
opstring



Example: in

Possible values: in
osobject

Name
Description
items[ object ]
Array of os items, maximum length limited by subscription plan.
pagesobject

Name
Description
items[ string ]
Array of strings, each element must be a valid url or hostname. Maximum length limited by subscription plan.
opstring
String describing operation.


Example: in

Possible values: in
regionsobject

Name
Description
items[ string ]
Array of strings containing region ids supported by Ocamba. Maximum length limited by subscription plan.
opstring
String describing operation.


Example: in

Possible values: in
subidsobject

Name
Description
items[ string ]
Array of strings containing subids. Subid must not contain whitespace (space, tab, newline, etc.). Maximum length limited by subscription plan.
opstring
String describing operation.


Example: in

Possible values: in
tagsobject

Name
Description
items[ string ]
Array of strings containing tag ids. Maximum length limited by subscription plan. This field is deprecated and will be removed in future. Please use container as a replacement.
opstring
String describing operation.


Example: in

Possible values: in
timeobject

Name
Description
items[ string ]
Array of strings containing time in format of cron expression. Maximum length limited by subscription plan.
opstring
String describing operation.


Example: in

Possible values: in
zonesobject

Name
Description
items[ string ]
Array of strings containing zone ids. Maximum length limited by subscription plan.
opstring
String describing operation.


Example: in

Possible values: in
valuefloatrequired
Value of the bid modifier. Minimum value is -100, maximum value is 100.


Example: 87.32
Response status codes
Arrow
204 - No Content
Arrow

note
1 At least one of the updatable fields should be sent via HTTP body in order to change the current state of the bid modifier.
2 We recommend using containers instead of tags, as tags are deprecated. If both parameters are sent, containers will take priority.
tip
1 If you don't know the bid modifier id, list the bid modifiers to find it.

Request examples
Copied
Arrow
200 Arrow
  • 200
{
    "max_value": "10.0000",
    "name": "DemoModifier",
    "value": "2.00",
    "targeting": {
      "countries": {
        "items": [
          "AF", "DE", "RS"
        ],
        "op" : "in"
      }
    }
}