Update Ad Item

Update an existing ad item in an ad group using PUT operation.

🌐

URL: PUT/api/v1/adItems

Request Parameters

ParameterNotesTypeRequiredPossible Values
campaignIdID of the campaign where the ad group belongsintegerYUnique numeric identifier
adGroupIdID of the ad group that is part of the campaignintegerYUnique numeric identifier
itemIdID of the product that is being added to ad groupstringYString identifier
bidMaximum cost per click for the item in an auto bidding campaign. Note: Bids on keywords in keyword-bid campaign supersede the item bid you set for items in keyword-bid campaigndoubleNBid values can be:
  • In dollars
  • Minimum bid amount is:
    • $0.20 for auto-bid campaigns
    • $0.30 for keyword-bid campaigns
    • $1 for Sponsored Brands campaigns
    • $0.80 for Sponsored Videos campaigns – This is an upcoming change and will be released soon.
  • Bid amount will be restricted to first two decimal places for advertisers. Any decimal digit beyond the first 2 digits will be truncated without rounding off.
Note: Bid is not required for TROAS campaigns. Passing bid for TROAS campaigns will be ignored by the system.
statusSpecified status of ad itemstringYStatus values can be: enabled, disabled, deleted
Note: You cannot delete an item from a campaign that has gone live

Sample Request

curl -X PUT \ 'https://developer.api.stg.walmart.com/api- proxy/service/WPA/Api/v1/api/v1/adItems' \
--header 'Authorization: Bearer <auth_token>'\ --header 'accept: application/json' \
--header 'WM_SEC.AUTH_SIGNATURE: ***************' \
--header 'WM_SEC.KEY_VERSION: 1' \
--header 'WM_CONSUMER.ID: adfwe-v23-faasd2r-afs-asdfqeff'\
--header 'WM_CONSUMER.intimestamp: 1565309779' \
--header 'Content-Type: application/json' \
--data ' { "campaignId": 600001, "adGroupId": 600003, "itemId": "45673892", "bid": .6, "status": "enabled" }'

Response

ElementDescriptionType
codeThe response code can have following values: success, failurestring
detailsDetails of the error if value of response code is failurestring
adItemIdID of the ad iteminteger

Sample Response

[ { "code": "success", "adItemId": "600002", "details": "" }, { "code": "failure", "adItemId": "0", "details": "Bid should be higher than: 5.0" }