Update Existing Ad Group- Creative association

Update click URLs and 3p trackers for creatives previously added to ad group, by specifying the request parameters.
Note: This API supports batch operations with a max batch size of 5. For bulk operation, the advertiserId must be the same across all requests in the payload

📘
URL: PUT/api/v1/adGroupCreativeAssociations

Request Parameters

Parameter	Notes	Type	Required	Possible Values
advertiserId	The ID of the advertiser	integer	Y	Unique numeric identifier
adGroupId	The ID of the ad group	integer	Y	Unique numeric identifier
creativeId	The ID of the creative to be added to the ad group Note: To be eligible for the rollback badge, creatives must be created after 06/30/2025. Creatives created before 06/30/2025 are not eligible for rollback badging	String	Y	Unique numeric identifier
urlTracker	Specifies the tracking and click-through URLs for each supported ad unit Note: To ensure complete ad delivery on all ad units, ensure that clickUrl* is provided for all ad units (marquee, skyline, gallery, brandbox and tile ) while associating a creative. The urlTracker objects are detailed here	String	N
badgeSettings	List of badge configurations. Each object can have: type (Enum: ROLLBACK, EXPRESSDELIVERY) enabled (default: true) Note: Badges can be enabled only for eligible creatives. Refer to the eligibleBadges field in the List Creatives API response to determine which badges are applicable for each creative" The badgeSettings objects are detailed here _	Array	N	Enum Values: ROLLBACK, EXPRESS_DELIVERY
showPrice	When true, the item’s price appears in the creative. Default is false if the field is omitted. Note: You may set showPrice: true for eligible creatives, only when exactly one item is associated with the creative.	Boolean	N	true false(default)
associatedItems	List of item IDs to be associated with the creative. Max size: 5 The items should be part of the campaign's featured itemset.	Array	N	valid itemId

urlTracker Objects

Parameter	Notes	Type	Required	Possible Values
adUnit	Available ad units Note: Use this field to configure landing pages and trackers for all supported ad units within a creative.	string	Y	Values allowed when mediaType = BANNER for corresponding Campaign: SKYLINE MARQUEE GALLERY BRANDBOX TILE
clickUrlDesktopMWeb	Click URL for Desktop & mWeb associated with specified adUnit. URLs must be hosted on Walmart.com. (e.g. search page, browse page, item page, category page and brand page)	string	Y
clickUrlApp	Click URL for App associated with the specified adUnit. Direct links must be hosted on Walmart.com. (e.g. search page, browse page, item page, category page and brand page)	string	Y
dcmClickUrlDesktopMWeb	DCM click tracker for Desktop & mWeb	string	N
dcmClickUrlApp	DCM click tracker for App Note: If this field is omitted, the system will automatically use the value provided in dcmClickUrlDesktopMWeb.	string	N
dcmImprUrlDesktopMWeb	DCM impression tracker for Desktop & mWeb	string	N
dcmImprUrlApp	DCM impression tracker for App	string	N
iasImprUrlDesktopMWeb	IAS impression tracker for Desktop & mWeb	string	N
iasImprUrlApp	IAS impression tracker for App	string	N
dvImprUrlDesktopMWeb	DV impression tracker for Desktop & mWeb	string	N
dvImprUrlApp	DV impression tracker for App	string	N
iasDesktopMWebTag	IAS IVT/ Viewability tracking on Desktop & mWeb	string	N
dvDesktopMWebTag	DV IVT/ Viewability tracking on Desktop & mWeb	string	N

badgeSettings Objects

Each object represent the each badge setting. Optional field, badgeSettings type array, mandatorily specify associatedItems if enabled is set to true.

Parameters	Notes	Type	Required	Possible Values
enabled	Specifies whether the badge is enabled or disabled	boolean	N	default: true
type	Type of Badge	string	Y	Enum values: ROLLBACK, EXPRESS_DELIVERY

👉
General guidelines

You must specify both clickUrlDesktopMWeb and clickUrlApp for each ad unit; missing URLs may prevent the ad from serving.
If dcmClickUrlApp is omitted, the system will automatically use the value provided in dcmClickUrlDesktopMWeb.
Supported ad units for this API are: SKYLINE, MARQUEE, GALLERY, BRANDBOX, TILE
Refer to the adUnits field in the List Creative API response to determine which creatives are compatible with these ad unit groups. The List Creative API uses more specific identifiers for (e.g., skylineAppV2, galleryDesktop), but for this API, you should use the high-level types: SKYLINE, MARQUEE, GALLERY, BRANDBOX, TILE
The clickUrl* fields provided for a given high-level ad unit (e.g., SKYLINE) will apply to all versions of that ad unit, including skyline, skylineV2, and skylineV3.
When using associatedItems to link an item to a creative, the item must be part of the campaign’s featured itemset (promoted items)
If a creative already has an associated item (defined while building the creative), it can only be added to an ad group if that SKU’s item is included in the campaign’s featured itemset (promoted items)

👉
Rules for Badges, showPrice, items, and clickUrl

Badge activation

Badges can be enabled only for eligible creatives. Refer to the eligibleBadges field in the List Creatives API response to determine which badges are applicable for each creative.
if badgeSettings is omitted or is an empty array → badges disabled for the creative
badgeSettings present without an enabled field → enabled defaults to true
When a badge is enabled, the clickUrl for DesktopMWeb and App must be same

showPrice

showPrice can be set to true only when

exactly 1 item is associated to the creative
if the creative is created after 06/30/2025

Item limits

Up to 5 items can be associated to a creative
Retrieve valid itemId values from itemId in POST /api/v1/items/list

clickUrl if badge or price is enabled

1 item linked → clickUrl must point to that item’s product detail page (PDP).
2–5 items linked → clickUrl must point to a shelf page generated from the creative’s featured item set.

If you want to set your creative’s landing page to a Brand Shop or Shelf page, use the advertisingUrl value returned from the POST /api/v1/brand-landing-pages/list endpoint.

Sample Request - Update creative association

curl --location --request PUT 'https://developer.api.us.walmart.com/api-proxy/service/display/api/v1/api/v1/adGroupCreativeAssociations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <auth_token>' \
--header 'WM_SEC.AUTH_SIGNATURE: ***********' \
--header 'WM_CONSUMER.ID: abcde-v123-fa2r-a1fs-asd45f6qef' \
--header 'WM_SEC.KEY_VERSION: 1' \
--header 'WM_CONSUMER.intimestamp: 1565309779' \
--data '[
{ "advertiserId" : 1, "adGroupId" : 1, "creativeId" : "abcd-1234", "urlTracker" : [ { "adUnit" : "MARQUEE", "clickUrlDesktopMWeb" : "https://www.test.com/search?q=test+url+desktop+mweb", "clickUrlApp" : "https://www.test.com/search?q=test+url+desktop+app", "dcmClickUrlDesktopMWeb" : "https://test.net", "dcmImprUrlDesktopMWeb" : "https://test.com/abd.jpeg", "dcmImprUrlApp" : "https://test.com/def.jpeg", "iasImprUrlDesktopMWeb" : "https://test.com/def.jpeg", "iasImprUrlApp" : "https://test.com/def.jpeg", "dvImprUrlDesktopMWeb" : "https://test.com/def.jpeg", "dvImprUrlApp": "https://test.com/def.jpeg", "iasDesktopMWebTag": "https://test.com/def.jpeg", "dvDesktopMWebTag": "https://test.com/def.jpeg" }, { "adUnit" : "GALLERY", "clickUrlDesktopMWeb" : "https://www.test.com/search?q=test+url+desktop+mweb", "clickUrlApp" : "https://www.test.com/search?q=test+url+desktop+app", "dcmClickUrlDesktopMWeb" : "https://test.net", "dcmImprUrlDesktopMWeb" : "https://test.com/abd.jpeg", "dcmImprUrlApp" : "https://test.com/def.jpeg", "iasImprUrlDesktopMWeb" : "https://test.com/def.jpeg", "iasImprUrlApp" : "https://test.com/def.jpeg", "dvImprUrlDesktopMWeb" : "https://test.com/def.jpeg", "dvImprUrlApp": "https://test.com/def.jpeg", "iasDesktopMWebTag": "https://test.com/def.jpeg", "dvDesktopMWebTag": "https://test.com/def.jpeg" }, { "adUnit": "SKYLINE", "clickUrlDesktopMWeb": "https://www.test.com/search?q=test+url+desktop+mweb", "clickUrlApp": "https://www.test.com/search?q=test+url+desktop+app", "dcmClickUrlDesktopMWeb": "https://test.net", "dcmImprUrlDesktopMWeb": "https://test.com/abd.jpeg", "dcmImprUrlApp": "https://test.com/def.jpeg", "iasImprUrlDesktopMWeb": "https://test.com/def.jpeg", "iasImprUrlApp": "https://test.com/def.jpeg", "dvImprUrlDesktopMWeb": "https://test.com/def.jpeg", "dvImprUrlApp": "https://test.com/def.jpeg", "iasDesktopMWebTag": "https://test.com/def.jpeg", "dvDesktopMWebTag": "https://test.com/def.jpeg" }, { "adUnit": "BRANDBOX", "clickUrlDesktopMWeb": "https://www.test.com/search?q=test+url+desktop+mweb", "clickUrlApp": "https://www.test.com/search?q=test+url+desktop+app", "dcmClickUrlDesktopMWeb": "https://test.net", "dcmImprUrlDesktopMWeb": "https://test.com/abd.jpeg", "dcmImprUrlApp": "https://test.com/def.jpeg", "iasImprUrlDesktopMWeb": "https://test.com/def.jpeg", "iasImprUrlApp": "https://test.com/def.jpeg", "dvImprUrlDesktopMWeb": "https://test.com/def.jpeg", "dvImprUrlApp": "https://test.com/def.jpeg", "iasDesktopMWebTag": "https://test.com/def.jpeg", "dvDesktopMWebTag": "https://test.com/def.jpeg" }, { "adUnit": TILE, "clickUrlDesktopMWeb": "https://www.test.com/search?q=test+url+desktop+mweb", "clickUrlApp": "https://www.test.com/search?q=test+url+desktop+app", "dcmClickUrlDesktopMWeb": "https://test.net", "dcmClickUrlApp": "https://test.net", "dcmImprUrlDesktopMWeb": "https://test.com/abd.jpeg", "dcmImprUrlApp": "https://test.com/def.jpeg", "iasImprUrlDesktopMWeb": "https://test.com/def.jpeg", "iasImprUrlApp": "https://test.com/def.jpeg", "dvImprUrlDesktopMWeb": "https://test.com/def.jpeg", "dvImprUrlApp": "https://test.com/def.jpeg", "iasDesktopMWebTag": "https://test.com/def.jpeg", "dvDesktopMWebTag": "https://test.com/def.jpeg" } ], "badgeSettings": [ { "enabled": true, "type": "ROLLBACK" } ], "showPrice": false, "associatedItems": ["12345","3456"] }
]'

Sample Request - Update creative Association and enable badge

curl --location --request PUT 'https://developer.api.us.walmart.com/api-proxy/service/display/api/v1/api/v1/adGroupCreativeAssociations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <auth_token>' \
--header 'WM_SEC.AUTH_SIGNATURE: ***********' \
--header 'WM_CONSUMER.ID: abcde-v123-fa2r-a1fs-asd45f6qef' \
--header 'WM_SEC.KEY_VERSION: 1' \
--header 'WM_CONSUMER.intimestamp: 1565309779' \
--data '[ { "advertiserId" : 1, "adGroupId" : 1, "creativeId" : "abcd-1234", "urlTracker" : [ { "adUnit" : "MARQUEE", "clickUrlDesktopMWeb" : "https://www.test.com/search?q=test+url+desktop+mweb", "clickUrlApp" : "https://www.test.com/search?q=test+url+desktop+app", "dcmClickUrlDesktopMWeb" : "https://test.net", "dcmImprUrlDesktopMWeb" : "https://test.com/abd.jpeg", "dcmImprUrlApp" : "https://test.com/def.jpeg", "iasImprUrlDesktopMWeb" : "https://test.com/def.jpeg", "iasImprUrlApp" : "https://test.com/def.jpeg", "dvImprUrlDesktopMWeb" : "https://test.com/def.jpeg", "dvImprUrlApp": "https://test.com/def.jpeg", "iasDesktopMWebTag": "https://test.com/def.jpeg", "dvDesktopMWebTag": "https://test.com/def.jpeg" }, { "adUnit" : "GALLERY", "clickUrlDesktopMWeb" : "https://www.test.com/search?q=test+url+desktop+mweb", "clickUrlApp" : "https://www.test.com/search?q=test+url+desktop+app", "dcmClickUrlDesktopMWeb" : "https://test.net", "dcmImprUrlDesktopMWeb" : "https://test.com/abd.jpeg", "dcmImprUrlApp" : "https://test.com/def.jpeg", "iasImprUrlDesktopMWeb" : "https://test.com/def.jpeg", "iasImprUrlApp" : "https://test.com/def.jpeg", "dvImprUrlDesktopMWeb" : "https://test.com/def.jpeg", "dvImprUrlApp": "https://test.com/def.jpeg", "iasDesktopMWebTag": "https://test.com/def.jpeg", "dvDesktopMWebTag": "https://test.com/def.jpeg" }, { "adUnit": "SKYLINE", "clickUrlDesktopMWeb": "https://www.test.com/search?q=test+url+desktop+mweb", "clickUrlApp": "https://www.test.com/search?q=test+url+desktop+app", "dcmClickUrlDesktopMWeb": "https://test.net", "dcmImprUrlDesktopMWeb": "https://test.com/abd.jpeg", "dcmImprUrlApp": "https://test.com/def.jpeg", "iasImprUrlDesktopMWeb": "https://test.com/def.jpeg", "iasImprUrlApp": "https://test.com/def.jpeg", "dvImprUrlDesktopMWeb": "https://test.com/def.jpeg", "dvImprUrlApp": "https://test.com/def.jpeg", "iasDesktopMWebTag": "https://test.com/def.jpeg", "dvDesktopMWebTag": "https://test.com/def.jpeg" }, { "adUnit": "BRANDBOX", "clickUrlDesktopMWeb": "https://www.test.com/search?q=test+url+desktop+mweb", "clickUrlApp": "https://www.test.com/search?q=test+url+desktop+app", "dcmClickUrlDesktopMWeb": "https://test.net", "dcmImprUrlDesktopMWeb": "https://test.com/abd.jpeg", "dcmImprUrlApp": "https://test.com/def.jpeg", "iasImprUrlDesktopMWeb": "https://test.com/def.jpeg", "iasImprUrlApp": "https://test.com/def.jpeg", "dvImprUrlDesktopMWeb": "https://test.com/def.jpeg", "dvImprUrlApp": "https://test.com/def.jpeg", "iasDesktopMWebTag": "https://test.com/def.jpeg", "dvDesktopMWebTag": "https://test.com/def.jpeg" }, { "adUnit": TILE, "clickUrlDesktopMWeb": "https://www.test.com/search?q=test+url+desktop+mweb", "clickUrlApp": "https://www.test.com/search?q=test+url+desktop+app", "dcmClickUrlDesktopMWeb": "https://test.net", "dcmClickUrlApp": "https://test.net", "dcmImprUrlDesktopMWeb": "https://test.com/abd.jpeg", "dcmImprUrlApp": "https://test.com/def.jpeg", "iasImprUrlDesktopMWeb": "https://test.com/def.jpeg", "iasImprUrlApp": "https://test.com/def.jpeg", "dvImprUrlDesktopMWeb": "https://test.com/def.jpeg", "dvImprUrlApp": "https://test.com/def.jpeg", "iasDesktopMWebTag": "https://test.com/def.jpeg", "dvDesktopMWebTag": "https://test.com/def.jpeg" } ], "badgeSettings": [ { "enabled": true, "type": "ROLLBACK" }, { "enabled": true, "type": "EXPRESS_DELIVERY" } ], "showPrice": true, "associatedItems": ["12345"] }
]'

Sample Request (Batch Operation)

curl --location --request PUT 'https://developer.api.us.walmart.com/api-proxy/service/display/api/v1/api/v1/adGroupCreativeAssociations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <auth_token>' \
--header 'WM_SEC.AUTH_SIGNATURE: ***********' \
--header 'WM_CONSUMER.ID: abcde-v123-fa2r-a1fs-asd45f6qef' \
--header 'WM_SEC.KEY_VERSION: 1' \
--header 'WM_CONSUMER.intimestamp: 1565309779' \
--data '[ { "advertiserId": 1, "adGroupId": 1, "creativeId": "abcd-1234", "urlTracker": [ { "adUnit": "MARQUEE", "clickUrlDesktopMWeb": "https://www.test.com/search?q=test+url+desktop+mweb", "clickUrlApp": "https://www.test.com/search?q=test+url+desktop+app", "dcmClickUrlDesktopMWeb": "https://test.net", "dcmImprUrlDesktopMWeb": "https://test.com/abd.jpeg", "dcmImprUrlApp": "https://test.com/def.jpeg", "iasImprUrlDesktopMWeb": "https://test.com/def.jpeg", "iasImprUrlApp": "https://test.com/def.jpeg", "dvImprUrlDesktopMWeb": "https://test.com/def.jpeg", "dvImprUrlApp": "https://test.com/def.jpeg", "iasDesktopMWebTag": "https://test.com/def.jpeg", "dvDesktopMWebTag": "https://test.com/def.jpeg" }, { "adUnit": "GALLERY", "clickUrlDesktopMWeb": "https://www.test.com/search?q=test+url+desktop+mweb", "clickUrlApp": "https://www.test.com/search?q=test+url+desktop+app", "dcmClickUrlDesktopMWeb": "https://test.net", "dcmImprUrlDesktopMWeb": "https://test.com/abd.jpeg", "dcmImprUrlApp": "https://test.com/def.jpeg", "iasImprUrlDesktopMWeb": "https://test.com/def.jpeg", "iasImprUrlApp": "https://test.com/def.jpeg", "dvImprUrlDesktopMWeb": "https://test.com/def.jpeg", "dvImprUrlApp": "https://test.com/def.jpeg", "iasDesktopMWebTag": "https://test.com/def.jpeg", "dvDesktopMWebTag": "https://test.com/def.jpeg" }, { "adUnit": "SKYLINE", "clickUrlDesktopMWeb": "https://www.test.com/search?q=test+url+desktop+mweb", "clickUrlApp": "https://www.test.com/search?q=test+url+desktop+app", "dcmClickUrlDesktopMWeb": "https://test.net", "dcmImprUrlDesktopMWeb": "https://test.com/abd.jpeg", "dcmImprUrlApp": "https://test.com/def.jpeg", "iasImprUrlDesktopMWeb": "https://test.com/def.jpeg", "iasImprUrlApp": "https://test.com/def.jpeg", "dvImprUrlDesktopMWeb": "https://test.com/def.jpeg", "dvImprUrlApp": "https://test.com/def.jpeg", "iasDesktopMWebTag": "https://test.com/def.jpeg", "dvDesktopMWebTag": "https://test.com/def.jpeg" }, { "adUnit": "BRANDBOX", "clickUrlDesktopMWeb": "https://www.test.com/search?q=test+url+desktop+mweb", "clickUrlApp": "https://www.test.com/search?q=test+url+desktop+app", "dcmClickUrlDesktopMWeb": "https://test.net", "dcmImprUrlDesktopMWeb": "https://test.com/abd.jpeg", "dcmImprUrlApp": "https://test.com/def.jpeg", "iasImprUrlDesktopMWeb": "https://test.com/def.jpeg", "iasImprUrlApp": "https://test.com/def.jpeg", "dvImprUrlDesktopMWeb": "https://test.com/def.jpeg", "dvImprUrlApp": "https://test.com/def.jpeg", "iasDesktopMWebTag": "https://test.com/def.jpeg", "dvDesktopMWebTag": "https://test.com/def.jpeg" }, { "adUnit": TILE, "clickUrlDesktopMWeb": "https://www.test.com/search?q=test+url+desktop+mweb", "clickUrlApp": "https://www.test.com/search?q=test+url+desktop+app", "dcmClickUrlDesktopMWeb": "https://test.net", "dcmClickUrlApp": "https://test.net", "dcmImprUrlDesktopMWeb": "https://test.com/abd.jpeg", "dcmImprUrlApp": "https://test.com/def.jpeg", "iasImprUrlDesktopMWeb": "https://test.com/def.jpeg", "iasImprUrlApp": "https://test.com/def.jpeg", "dvImprUrlDesktopMWeb": "https://test.com/def.jpeg", "dvImprUrlApp": "https://test.com/def.jpeg", "iasDesktopMWebTag": "https://test.com/def.jpeg", "dvDesktopMWebTag": "https://test.com/def.jpeg" } ], "badgeSettings": [ { "enabled": false, "type": "ROLLBACK" } ], "showPrice": false, "associatedItems": [ "12345", "65341" ] }, { "advertiserId": 1, "adGroupId": 2, "creativeId": "abcd-1234", "urlTracker": [ { "adUnit": "MARQUEE", "clickUrlDesktopMWeb": "https://www.test.com/search?q=test+url+desktop+mweb", "clickUrlApp": "https://www.test.com/search?q=test+url+desktop+app", "dcmClickUrlDesktopMWeb": "https://test.net", "dcmImprUrlDesktopMWeb": "https://test.com/abd.jpeg", "dcmImprUrlApp": "https://test.com/def.jpeg", "iasImprUrlDesktopMWeb": "https://test.com/def.jpeg", "iasImprUrlApp": "https://test.com/def.jpeg", "dvImprUrlDesktopMWeb": "https://test.com/def.jpeg", "dvImprUrlApp": "https://test.com/def.jpeg", "iasDesktopMWebTag": "https://test.com/def.jpeg", "dvDesktopMWebTag": "https://test.com/def.jpeg" }, { "adUnit": "GALLERY", "clickUrlDesktopMWeb": "https://www.test.com/search?q=test+url+desktop+mweb", "clickUrlApp": "https://www.test.com/search?q=test+url+desktop+app", "dcmClickUrlDesktopMWeb": "https://test.net", "dcmImprUrlDesktopMWeb": "https://test.com/abd.jpeg", "dcmImprUrlApp": "https://test.com/def.jpeg", "iasImprUrlDesktopMWeb": "https://test.com/def.jpeg", "iasImprUrlApp": "https://test.com/def.jpeg", "dvImprUrlDesktopMWeb": "https://test.com/def.jpeg", "dvImprUrlApp": "https://test.com/def.jpeg", "iasDesktopMWebTag": "https://test.com/def.jpeg", "dvDesktopMWebTag": "https://test.com/def.jpeg" }, { "adUnit": "SKYLINE", "clickUrlDesktopMWeb": "https://www.test.com/search?q=test+url+desktop+mweb", "clickUrlApp": "https://www.test.com/search?q=test+url+desktop+app", "dcmClickUrlDesktopMWeb": "https://test.net", "dcmImprUrlDesktopMWeb": "https://test.com/abd.jpeg", "dcmImprUrlApp": "https://test.com/def.jpeg", "iasImprUrlDesktopMWeb": "https://test.com/def.jpeg", "iasImprUrlApp": "https://test.com/def.jpeg", "dvImprUrlDesktopMWeb": "https://test.com/def.jpeg", "dvImprUrlApp": "https://test.com/def.jpeg", "iasDesktopMWebTag": "https://test.com/def.jpeg", "dvDesktopMWebTag": "https://test.com/def.jpeg" }, { "adUnit": "BRANDBOX", "clickUrlDesktopMWeb": "https://www.test.com/search?q=test+url+desktop+mweb", "clickUrlApp": "https://www.test.com/search?q=test+url+desktop+app", "dcmClickUrlDesktopMWeb": "https://test.net", "dcmImprUrlDesktopMWeb": "https://test.com/abd.jpeg", "dcmImprUrlApp": "https://test.com/def.jpeg", "iasImprUrlDesktopMWeb": "https://test.com/def.jpeg", "iasImprUrlApp": "https://test.com/def.jpeg", "dvImprUrlDesktopMWeb": "https://test.com/def.jpeg", "dvImprUrlApp": "https://test.com/def.jpeg", "iasDesktopMWebTag": "https://test.com/def.jpeg", "dvDesktopMWebTag": "https://test.com/def.jpeg" }, { "adUnit": TILE, "clickUrlDesktopMWeb": "https://www.test.com/search?q=test+url+desktop+mweb", "clickUrlApp": "https://www.test.com/search?q=test+url+desktop+app", "dcmClickUrlDesktopMWeb": "https://test.net", "dcmClickUrlApp": "https://test.net", "dcmImprUrlDesktopMWeb": "https://test.com/abd.jpeg", "dcmImprUrlApp": "https://test.com/def.jpeg", "iasImprUrlDesktopMWeb": "https://test.com/def.jpeg", "iasImprUrlApp": "https://test.com/def.jpeg", "dvImprUrlDesktopMWeb": "https://test.com/def.jpeg", "dvImprUrlApp": "https://test.com/def.jpeg", "iasDesktopMWebTag": "https://test.com/def.jpeg", "dvDesktopMWebTag": "https://test.com/def.jpeg" } ], "badgeSettings": [ { "enabled": true, "type": "EXPRESS_DELIVERY" } ], "showPrice": false, "associatedItems": [ "12345" ] }
]'

Response

Element	Description	Type
code	The response code can have following values: success failure Click here for more information about Status Codes and Errors	string
details	Details will populate success or error message depending upon value of code	string
adGroupId	ID of the ad group being updated	integer
creativeId	ID of the creative	string

Sample Response - Update creative association

[ { "code": "success", "details": [ "CREATIVE_AD_GROUP_ASSOCIATION_MARQUEE_UPDATE_SUCCESS", "CREATIVE_AD_GROUP_ASSOCIATION_GALLARY_UPDATE_SUCCESS", "CREATIVE_AD_GROUP_ASSOCIATION_BRANDBOX_UPDATE_SUCCESS", "CREATIVE_AD_GROUP_ASSOCIATION_SKYLINE_UPDATE_SUCCESS", "CREATIVE_AD_GROUP_ASSOCIATION_TILE_UPDATE_SUCCESS"], "adGroupId": 1, "creativeId": "abcd-1234" }
]

Sample Response - Update creative Association and enable badge

[ { "code": "success", "details": [ "CREATIVE_AD_GROUP_ASSOCIATION_MARQUEE_UPDATE_SUCCESS", "CREATIVE_AD_GROUP_ASSOCIATION_GALLARY_UPDATE_SUCCESS", "CREATIVE_AD_GROUP_ASSOCIATION_BRANDBOX_UPDATE_SUCCESS", "CREATIVE_AD_GROUP_ASSOCIATION_SKYLINE_UPDATE_SUCCESS", "CREATIVE_AD_GROUP_ASSOCIATION_TILE_UPDATE_SUCCESS"], "adGroupId": 1, "creativeId": "abcd-1234" }
]

Sample Response(Batch Operation)

[ { "code": "success", "details": [ "CREATIVE_AD_GROUP_ASSOCIATION_MARQUEE_UPDATE_SUCCESS", "CREATIVE_AD_GROUP_ASSOCIATION_GALLARY_UPDATE_SUCCESS", "CREATIVE_AD_GROUP_ASSOCIATION_BRANDBOX_UPDATE_SUCCESS", "CREATIVE_AD_GROUP_ASSOCIATION_SKYLINE_UPDATE_SUCCESS", "CREATIVE_AD_GROUP_ASSOCIATION_TILE_UPDATE_SUCCESS"], "adGroupId": 1, "creativeId": "abcd-1234" }, { "code": "success", "details": [ "CREATIVE_AD_GROUP_ASSOCIATION_MARQUEE_UPDATE_SUCCESS", "CREATIVE_AD_GROUP_ASSOCIATION_GALLARY_UPDATE_SUCCESS", "CREATIVE_AD_GROUP_ASSOCIATION_BRANDBOX_UPDATE_SUCCESS", "CREATIVE_AD_GROUP_ASSOCIATION_SKYLINE_UPDATE_SUCCESS", "CREATIVE_AD_GROUP_ASSOCIATION_TILE_UPDATE_SUCCESS"], "adGroupId": 2, "creativeId": "abcd-1234" }
]

Update Existing Ad Group- Creative association

📘
URL: PUT/api/v1/adGroupCreativeAssociations

Request Parameters

urlTracker Objects

badgeSettings Objects

👉
General guidelines

👉
Rules for Badges, showPrice, items, and clickUrl

Sample Request - Update creative association

Sample Request - Update creative Association and enable badge

Sample Request (Batch Operation)

Response

Sample Response - Update creative association

Sample Response - Update creative Association and enable badge

Sample Response(Batch Operation)

📘URL: PUT/api/v1/adGroupCreativeAssociations

Request Parameters

urlTracker Objects

badgeSettings Objects

👉General guidelines

👉Rules for Badges, showPrice, items, and clickUrl

Sample Request - Update creative association

Sample Request - Update creative Association and enable badge

Sample Request (Batch Operation)

Response

Sample Response - Update creative association

Sample Response - Update creative Association and enable badge

Sample Response(Batch Operation)

📘
URL: PUT/api/v1/adGroupCreativeAssociations

👉
General guidelines

👉
Rules for Badges, showPrice, items, and clickUrl