Actions: KDP authors

What are Amazon Ads Actions for KDP authors?

KDP authors connect an Amazon Ads profile whose account subtype is KDP_AUTHOR. DataDoe reads the subtype from Amazon when the connection is added or reauthorized, and reads it again once it is more than a week old. An Ads-only account is not treated as an author account unless Amazon reports this subtype.

This page lists the Action types made for authors and the rules other Amazon Ads Actions follow for author accounts. See Actions for how to enable and run Actions, and for the other Amazon Ads Action types. To estimate author earnings from your ads, upload KDP royalty parameters.

You are responsible for the results of Actions you run. Review every payload before running an Action.

Which Action types are made for KDP authors?

A live Attribution tag Action turns measurement on for the Ads profile. A dry run does not call Amazon.

These Action types are available to all Organizations. You do not need to request beta access. They work for authors, sellers, and vendors with the required Amazon access. Enable the Action types you need in Settings > Actions (opens in a new tab). Live tag and tracking-link Actions also need Read and write access to the selected Seller or Vendor.

Find their access modes, item limits, results, and input schemas in the Actions explorer, under Attribution and Recommendations and insights.

• AMAZON_ADS_PROGRAM_ELIGIBILITY_FIND returns, for each ad program (SB, SD, MAAS, DTC, SPOT), whether the profile is eligible and why not. Sponsored Products is the baseline program and is not listed. Billing checks run by default; set programs.skipAllBillingChecks to true to skip them. Add products with adType (sp, sb, or sd) and up to 50 asins to check books as well. Eligibility does not guarantee delivery.
• AMAZON_ADS_ATTRIBUTION_PUBLISHERS_FIND lists Amazon Attribution publishers. It needs a profile with Amazon Attribution access. Other profiles, including KDP author profiles, get an Amazon authorization error. Use macroEnabled to choose the tag Action. Do not hard-code a publisher list.
• AMAZON_ADS_ATTRIBUTION_ADVERTISERS_FIND lists Attribution advertisers for the profile. A modern ad-console profile has one. An older DSP vendor profile can have more than one. Amazon plans to remove this endpoint.
• AMAZON_ADS_ATTRIBUTION_MACRO_TAGS_FIND returns macro tags for publishers with macroEnabled true. Leave the macros in the tag. The publisher replaces them. One tag can be reused for that advertiser's campaigns on that publisher.
• AMAZON_ADS_ATTRIBUTION_NON_MACRO_TAG_TEMPLATES_FIND returns templates for publishers without macros. Replace the campaign, ad group, and creative placeholders before use, or use AMAZON_ADS_ATTRIBUTION_TAGS_GENERATE. A filled tag belongs to one landing page.
• AMAZON_ADS_ATTRIBUTION_REPORTS_FIND reads a PERFORMANCE or PRODUCTS report in the same request. It is not an asynchronous Ads report. Prefer the Attribution tables for routine analysis. PERFORMANCE can be grouped by campaign, ad group, or creative. PRODUCTS stays at ad group and product level for the last 90 days. Request brb_bonus_amount only on a PERFORMANCE report grouped by campaign or ad group.
• AMAZON_ADS_ATTRIBUTION_TAGS_GENERATE builds a tracking link for one publisher and an Amazon product or Brand Store page. MACRO keeps the publisher macros. NON_MACRO fills the campaign, ad group, and creative IDs. DataDoe percent-encodes those IDs in the URL, so a space stays part of the link. The tag parameters are the IDs you entered. It does not publish the link to an ad account.
• AMAZON_ADS_SB_HEADLINE_RECOMMENDATIONS_FIND asks Amazon for headline ideas for up to 10 ASINs per item. Titles of collection ads are limited to 32 characters, so check the length before you use one.
• AMAZON_ADS_SB_INSIGHTS_FIND rates planned keywords and bids for Sponsored Brands ad groups before launch: search term impression share and rank, and LOW_KEYWORD_TRAFFIC or LOW_BID alerts. It does not report campaign performance; use data tables for that.

Read Actions cost 0.5 AI Tokens for up to 100 items, then 0.25 AI Tokens for each additional 100 items. Write Actions cost 3 AI Tokens for up to 100 items, then 1 AI Token for each additional 100 items. Group items into one Action. Each separate Action pays the starting price again. A dry run does not spend AI Tokens. When a FIND Action's entity is in the DataDoe data scheme, use an Export or a BigQuery query. Use FIND only when you need live Amazon data that the warehouse does not have yet. One standard Export costs 2 AI Tokens. One integrated BigQuery query costs 0.2 AI Tokens. Compare the total cost of repeated FIND Actions with one Export or query. Program eligibility, Attribution publishers, Attribution advertisers, and Attribution reports are for data the warehouse already stores or will store. Use the report Action for a live read. Headline and insights FIND Actions are live checks and are not a substitute for campaign reporting. The Attribution tag and link Actions are writes because a live run turns measurement on.

How do other Amazon Ads Actions work for KDP author accounts?

For KDP author accounts, existing Ads Actions apply these rules:

• AMAZON_ADS_CAMPAIGNS_ADD for SPONSORED_BRANDS does not send goal or smartDefault, because Amazon sets them for authors. smartDefault: "TARGETING" is rejected. brandId must be an author brand: use AMAZON_ADS_BRANDS_FIND with brandTypeFilter: "bookAuthor" and send its brandEntityId.
• AMAZON_ADS_BRANDS_FIND without brandTypeFilter returns author brands.
• AMAZON_ADS_ADS_ADD for a Sponsored Brands product collection needs at least 3 unique product ASINs and a headline of at most 32 characters, and does not accept customImages. Amazon creates these ads as Manual Collection ads.
• AMAZON_ADS_CAMPAIGNS_REMOVE and the other remove Actions archive entities; archiving cannot be undone.
• Search term text in targets is not a target ID; use AMAZON_ADS_TARGETS_FIND to look up IDs.
• Bid, keyword, and budget recommendations and budget rules optimize Amazon's reported ad sales, not author royalties.