Marketing API Version 1.18.0

This release adds updates to the existing schema and a new method to support Offsite Ads campaigns, as well as adds new error messages for this new functionality.

Changed Functionality:

Using the createCampaign method, sellers can now create an Offsite Ads campaign by setting the new channels array to OFF_SITE in the request. An Offsite Ads campaign allows sellers to create their own advertising campaign and promote their listings on leading external channels.

Sellers can also now use the createReportTask method to monitor their Offsite ads campaigns by passing the channels array with the value of OFF_SITE.

Schema changes

The createCampaign, createReportTask, getCampaign, and getCampaigns methods now include the channels array and the new enumerated value of ChannelEnum.

New Method

The following method has been added as a part of the campaign resource to support Offsite Ads campaigns:

suggestBudget: This method allows sellers to retrieve the suggested budget for an Offsite Ads campaign.

New Error Messages

The following error messages have been added to the createReportTask method:

Error/Warning Code | Description
35125 | The 'channel' is invalid. Valid values are: {supportedChannels}
35126 | Multiple channels are not supported. Please use one of the following channels: {supportedChannels}
35127 | The 'channels' are not supported for the 'fundingModel' {fundingModel}
25128 | The 'dimensionKey' {dimensionKey} is not valid for the 'channels' {supportedChannels}
35129 | The 'metricKey' {metricKey} is not valid for the 'channels' {supportedChannels}
35131 | The 'annotationKey' {annotationKey} is not supported for the 'channels' {supportedChannels}

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

Error/Warning Code | Description
35094 | Maximum number of campaigns allowed with the 'channels' value {channel} is exceeded.
35095 | 'marketplaceId' {marketplaceId} is not supported. Offsite Ads is supported only on these marketplaces: {supportedMarketplaces}.
36406 | The 'channels' value {channel} can only be used with the {funding_model} fundingModel.
36407 | The 'channels' value is invalid.

The following error message has been added to the updateCampaignBudget method:

Error/Warning Code | Description
36408 | The seller must accept the new pricing policy before the campaign can be updated.

The following error message has been added to the updateCampaignIdentification method:

Error/Warning Code | Description
36408 | The seller must accept the new pricing policy before the campaign can be updated