Targeting Recommendations

Warning

Sponsored Display is not available for Sandbox endpoint

class ad_api.api.sd.TargetsRecommendations(account='default', marketplace: Marketplaces = Marketplaces.EU, credentials=None, proxies=None, verify=True, timeout=None, debug=False, access_token=None)

Amazon Advertising API for Sponsored Display

Documentation: https://advertising.amazon.com/API/docs/en-us/sponsored-display/3-0/openapi#/Targeting%20Recommendations

This API enables programmatic access for campaign creation, management, and reporting for Sponsored Display campaigns. For more information on the functionality, see the Sponsored Display Support Center . For API onboarding information, see the account setup topic.

This specification is available for download from the Advertising API developer portal.

Endpoint available

Method	Endpoint	Description
POST	/sd/targets/recommendations	Returns a set of bid recommendations for targeting clauses

list_targets_recommendations(self, **kwargs) → ApiResponse:

Note that version application/vnd.sdtargetingrecommendations.v3.1+json is now supported. Provides a list of products to target based on the list of input ASINs. Allow 1 week for our systems to process data for any new ASINs listed on Amazon before using this service. Currently the API will return up to 100 recommended products and categories. The currently available tactic identifiers are:

Tactic Name	Type	Description
T00020	Product Targeting	Products: Choose individual products to show your ads in placements related to those products.
T00030	Audience Targeting	Audiences: Select individual audiences to show your ads

body: SDTargetingRecommendationsRequestV31 | REQUIRED {‘description’: ‘Request for targeting recommendations.}’

‘tactic*’: SDTacticV31string, {‘description’: ‘The advertising tactic associated with the campaign.’, ‘Enum’: ‘[ T00020, T00030 ]’}

‘products’: SDGoalProduct, {‘description’: ‘A list of products for which to get targeting recommendations. minItems: 1, maxItems: 10000’}

‘SDGoalProduct*’, {‘description’: ‘A product an advertisers wants to advertise. Recommendations will be made for specified goal products.}

‘asin*’: SDASINstring, REQUIRED {‘description’: ‘Amazon Standard Identification Number. pattern: [a-zA-Z0-9]{10}. example: B00PN11UNW}

‘typeFilter’: SDRecommendationTypeV31string, {‘description’: ‘Signifies a type of recommendation’, ‘Enum’: ‘[ PRODUCT, CATEGORY ]’}

Returns:

ApiResponse