Marketing API Version 1.21.0

This release adds updates to the existing schema to support smart targeting for Promoted Listings Advanced (PLA) campaigns, as well as adds new error messages for this functionality.

Changed Functionality

Using the createCampaign method, sellers can now create smart targeting PLA campaigns by setting the campaignTargetingType to SMART and specifying the max cost per click they are willing to pay through the maxCpc field. Smart targeting campaigns are easy to set up and automatically optimize ad campaign settings and handle the bidding and targeting for the seller.

Sellers can update the maxCpc of their smart targeting campaign through the updateBiddingStrategy method.

Schema Changes

The following fields have been added to the createCampaign, getCampaign, getCampaignByName, and getCampaigns methods:

campaignTargetingType

bidPreferences

maxCPC

The following fields have been added to the updateBiddingStrategy method:

bidPreferences

maxCPC

New Error Codes

The following error code has been added to the createAdGroup, getAdGroups, getAdGroup, updateAdGroup, suggestBids, suggestKeywords, createKeyword, bulkCreateKeyword, updateKeyword, bulkUpdateKeyword, createNegativeKeyword, bulkCreateNegativeKeyword, updateNegativeKeyword, bulkUpdateNegativeKeyword methods:

Error Code | Description
35129 | This method is not supported for campaigns with smart targeting type

The following error codes have been added to the bulkCreateAdsByListingId method:

Error Code | Description
35064 | This operation is only supported for key based campaigns
35068 | You have exceeded the maximum number of listing Ids. Only {maxSupportedNumber} listings are supported per call
36412 | Campaigns where the 'campaignTargetingType' is 'SMART' do not support ad groups. Please remove the {adGroupFieldName} and try again.

The following error code has been added to the createAdsByListingId, getAds, bulkUpdateAdsByListingId, bulkCreateAdsByListingId, bulkUpdateAdsStatusByListingId methods:

Error Code | Description
36412 | Campaigns where the 'campaignTargetingType' is 'SMART' do not support ad groups. Please remove the {adGroupFieldName} and try again.

The following error codes have been added to the createCampaign method:

Error Code | Description
35124 | The 'maxCpc' {maxCpc} is not valid. Minimum value: {minMaxCpc} , Maximum value:{maxMaxCpc}.
35127 | 'maxCPC' is only supported for CPC funding model campaigns with on-site channels and smart targeting type.
35128 | 'campaignTargetingType' is only supported for CPC funding model campaigns with on-site channels.

The following error codes have been added to the updateBiddingStrategy method:

Error Code | Description
35124 | The 'maxCpc' {maxCpc} is not valid. Minimum value: {minMaxCpc} , Maximum value:{maxMaxCpc}.
35126 | The 'biddingStrategy' isn't applicable for campaigns with smart targeting type.
35127 | 'maxCPC' is only supported for CPC funding model campaigns with on-site channels and smart targeting type.