add

Maximum of 1 mobile adjustment per campaign or ad group.

Maximum of 1 video extension adjustment per campaign or ad group.

Maximum of 1 smart ad adjustment per campaign or ad group.

Maximum of 12 gender and age adjustments per campaign or ad group.

Maximum of 100 target audience adjustments per campaign or ad group.

Mobile adjustments can't be created for campaigns and ad groups for mobile app advertising.

Adjustments for computers, tablets, and Smart TVs can only be created for groups of display, Text & Image, and dynamic ads, and for groups of smart banners.

Video extension adjustments can only be created for campaigns and groups of Text & Image ads.

Smart ad adjustments can only be created for campaigns and groups of smart banners.

Group-level adjustments can only be created for unified performance groups.

To learn more about matching the types of bid adjustments to the types of campaigns and ad groups, see Acceptable types of bid adjustments by type of campaign and group.

Request structure in JSON format:

{
  "method": "add",
  "params": { /* params */
    "BidModifiers": [{  /* BidModifierAddItem */
      "MobileAdjustment": {  /* MobileAdjustmentAdd */
        "BidModifier": (int), /* required */
        "OperatingSystemType": ( "IOS" | "ANDROID" )
      },
      "TabletAdjustment": {  /* MobileAdjustmentAdd */
        "BidModifier": (int), /* required */
        "OperatingSystemType": ( "IOS" | "ANDROID" )
      },
      "DesktopAdjustment": {  /* DesktopAdjustmentAdd */
        "BidModifier": (int) /* required */
      },
      "DesktopOnlyAdjustment": {  /* DesktopAdjustmentAdd */
        "BidModifier": (int) /* required */
      },
      "DemographicsAdjustments": [{  /* DemographicsAdjustmentAdd */
        "Gender": ( "GENDER_MALE" | "GENDER_FEMALE" ),
        "Age": ( "AGE_0_17" | "AGE_18_24" | "AGE_25_34" | "AGE_35_44" | "AGE_45" | "AGE_45_54" | "AGE_55" ),
        "BidModifier": (int) /* required */
      }, ... ],
      "RetargetingAdjustments": [{  /* RetargetingAdjustmentAdd */
        "RetargetingConditionId": (long), /* required */
        "BidModifier": (int) /* required */
      }, ... ],
      "RegionalAdjustments": [{    /* RegionalAdjustmentAdd */
        "RegionId": (long), /* required */
        "BidModifier": (int) /* required */
      }, ... ],
      "VideoAdjustment": { /* VideoAdjustmentAdd */
        "BidModifier": (int) /* required */
      },
      "SmartAdAdjustment" : { /* SmartAdAdjustmentAdd */
        "BidModifier": (int) /* required */
      },
      "SerpLayoutAdjustments": [{  /* SerpLayoutAdjustmentAdd */
        "SerpLayout": ( "ALONE" | "SUGGEST" ), /* required */
        "BidModifier": (int) /* required */
      }, ... ],
      "IncomeGradeAdjustments": [{  /* IncomeGradeAdjustmentAdd */
        "Grade": ( "VERY_HIGH" | "HIGH" | "ABOVE_AVERAGE" ), /* required */
        "BidModifier": (int) /* required */
      }, ... ],
      "AdGroupAdjustment" : {
        "BidModifier" : (int) /* required */
      }
      "CampaignId": (long),
      "AdGroupId": (long)
    }, ... ] /* required */
  }
}

Response structure in JSON format:

{
  "result": { /* result */
    "AddResults": [{  /* MultiIdsActionResult */
      "Ids": [(long), ... ],
      "Warnings": [{  /* ExceptionNotification */
        "Code": (int), /* required */
        "Message": (string), /* required */
        "Details": (string)
      }, ... ],
      "Errors": [{  /* ExceptionNotification */
        "Code": (int), /* required */
        "Message": (string), /* required */
        "Details": (string)
      }, ... ]
    }, ... ]
  }
}

Request example

{
  "method": "add",
  "params": {
    "BidModifiers": [
      { // 1. Two bid adjustments, for gender and age
        "CampaignId": 10001,
        "DemographicsAdjustments": [
          {
            "Gender": "GENDER_MALE",
            "Age": "AGE_25_34",
            "BidModifier": 101
          },
          {
            "Age": "AGE_45_54",
            "BidModifier": 140
          }
        ]
      },
      { // 2. Bid adjustments for overlapping audience segments   
        "CampaignId": 10002,
        "DemographicsAdjustments": [
          {
            "Gender": "GENDER_MALE",
            "Age": "AGE_25_34",
            "BidModifier": 120
          },
          {
            "Age": "AGE_25_34",
            "BidModifier": 170
          }
        ]
      }, 
      { // 3.// 3. Unacceptable coefficient value
        "CampaignId": 10003,
        "DemographicsAdjustments": [
          {
            "Gender": "GENDER_MALE",
            "Age": "AGE_25_34",
            "BidModifier": 120
          },
          {
            "Gender": "GENDER_FEMALE",
            "Age": "AGE_35_44",
            "BidModifier": 10000
          }
        ]
      },
      { // 4. Bid adjustment for target audience created at an ad group level
        "AdGroupId": 500001,
        "RetargetingAdjustments": [
          {
            "RetargetingConditionId": 2004,
            "BidModifier": 201
          }
        ]
      }
    ]
  }
}

Response example

{
  "result" : {
    "AddResults" : [
      { // 1. Created two bid adjustments, for gender and age
        "Ids": [ 1003, 1004 ]
      },
      { // 2. Overlapping segments. No bid adjustments created
        "Errors": [
          {
            "Code": 6000,
            "Message": "Inconsistent object state",
            "Details": "Overlapping bid adjustment criteria in the set"
          }
        ]
      },
      { // 3. Unacceptable value. No bid adjustments created
        "Errors": [
          {
            "Code": 5005,
            "Message": "Field value is unacceptable",
            "Details": "The coefficient can't be greater than 1300"
          }
        ]
      },
      { // 4. Bid adjustment for target audience created at an ad group level
        "Ids": [ 1005 ]
      }
    ]
  }
}