Hierarchy

  • Operation
    • SponsoredProductsCampaignOperation

Constructors

Methods

  • Sets the campaign status to archived. Archived entities cannot be made active again. See developer notes for more information.

    Returns

    Parameters

    • campaignId: number

    Returns Promise<{ code: string } & { campaignId: undefined | number; description: undefined | string; details: undefined | string }>

  • Creates one or more campaigns. Successfully created campaigns will be assigned a unique campaignId.

    Returns

    Parameters

    • campaigns: ({ campaignType: undefined | "sponsoredProducts"; dailyBudget: number; name: string; startDate: string; state: "paused" | "enabled" | "archived"; targetingType: "auto" | "manual" } & { bidding: undefined | { adjustments: (({ predicate: "placementTop" | "placementProductPage"; }) & ({ percentage?: number | undefined; }))[] } & ({ strategy?: "manual" | "legacyForSales" | "autoForSales" | "ruleBased" | undefined; }) })[]

    Returns Promise<({ code: string } & { campaignId: undefined | number; description: undefined | string; details: undefined | string })[]>

  • Retrieves a campaign by campaignId. Note that this call returns the minimal set of campaign fields, but is more efficient than getCampaignEx

    Returns

    Parameters

    • campaignId: number

    Returns Promise<{ campaignId: number; campaignType: undefined | "sponsoredProducts"; dailyBudget: number; name: string; startDate: string; state: "paused" | "enabled" | "archived"; targetingType: "auto" | "manual" } & { bidding: undefined | { adjustments: (({ predicate: "placementTop" | "placementProductPage"; }) & ({ percentage?: number | undefined; }))[] } & ({ strategy?: "manual" | "legacyForSales" | "autoForSales" | "ruleBased" | undefined; }); endDate: undefined | string; portfolioId: undefined | number; premiumBidAdjustment: undefined | boolean }>

  • Retrieves a campaign and its extended fields by campaignId. Note that this call returns the complete set of campaign fields (including serving status and other read-only fields), but is less efficient than getCampaign

    Returns

    Parameters

    • campaignId: number

    Returns Promise<{ campaignId: number; campaignType: undefined | "sponsoredProducts"; dailyBudget: number; name: string; startDate: string; state: "paused" | "enabled" | "archived"; targetingType: "auto" | "manual" } & { bidding: undefined | { adjustments: (({ predicate: "placementTop" | "placementProductPage"; }) & ({ percentage?: number | undefined; }))[] } & ({ strategy?: "manual" | "legacyForSales" | "autoForSales" | "ruleBased" | undefined; }); endDate: undefined | string; portfolioId: undefined | number; premiumBidAdjustment: undefined | boolean } & { creationDate: undefined | Date; lastUpdatedDate: undefined | Date; placement: undefined | "Top of Search on-Amazon" | "Other on-Amazon"; servingStatus: undefined | "CAMPAIGN_ARCHIVED" | "CAMPAIGN_PAUSED" | "CAMPAIGN_STATUS_ENABLED" | "ADVERTISER_PAYMENT_FAILURE" | "CAMPAIGN_OUT_OF_BUDGET" | "ACCOUNT_OUT_OF_BUDGET" | "PORTFOLIO_ENDED" | "CAMPAIGN_INCOMPLETE" | "PENDING_START_DATE" | "ENDED" }>

  • Retrieves a list of Sponsored Products campaigns satisfying optional filtering criteria.

    Returns

    Parameters

    • Optional params: { count: undefined | number; startIndex: undefined | number } & { campaignIdFilter: undefined | number[]; name: undefined | string; stateFilter: undefined | "paused" | "enabled" | "archived" }

    Returns Promise<({ campaignId: number; campaignType: undefined | "sponsoredProducts"; dailyBudget: number; name: string; startDate: string; state: "paused" | "enabled" | "archived"; targetingType: "auto" | "manual" } & { bidding: undefined | { adjustments: (({ predicate: "placementTop" | "placementProductPage"; }) & ({ percentage?: number | undefined; }))[] } & ({ strategy?: "manual" | "legacyForSales" | "autoForSales" | "ruleBased" | undefined; }); endDate: undefined | string; portfolioId: undefined | number; premiumBidAdjustment: undefined | boolean })[]>

  • Retrieves a list of Sponsored Products campaigns with extended fields satisfying optional filtering criteria.

    Returns

    Parameters

    • Optional params: { count: undefined | number; startIndex: undefined | number } & { campaignIdFilter: undefined | number[]; name: undefined | string; stateFilter: undefined | "paused" | "enabled" | "archived" }

    Returns Promise<({ campaignId: number; campaignType: undefined | "sponsoredProducts"; dailyBudget: number; name: string; startDate: string; state: "paused" | "enabled" | "archived"; targetingType: "auto" | "manual" } & { bidding: undefined | { adjustments: (({ predicate: "placementTop" | "placementProductPage"; }) & ({ percentage?: number | undefined; }))[] } & ({ strategy?: "manual" | "legacyForSales" | "autoForSales" | "ruleBased" | undefined; }); endDate: undefined | string; portfolioId: undefined | number; premiumBidAdjustment: undefined | boolean } & { creationDate: undefined | Date; lastUpdatedDate: undefined | Date; placement: undefined | "Top of Search on-Amazon" | "Other on-Amazon"; servingStatus: undefined | "CAMPAIGN_ARCHIVED" | "CAMPAIGN_PAUSED" | "CAMPAIGN_STATUS_ENABLED" | "ADVERTISER_PAYMENT_FAILURE" | "CAMPAIGN_OUT_OF_BUDGET" | "ACCOUNT_OUT_OF_BUDGET" | "PORTFOLIO_ENDED" | "CAMPAIGN_INCOMPLETE" | "PENDING_START_DATE" | "ENDED" })[]>

  • Updates one or more campaigns.

    Returns

    Parameters

    • campaigns: ({ campaignId: number } & { bidding: undefined | { adjustments: (({ predicate: "placementTop" | "placementProductPage"; }) & ({ percentage?: number | undefined; }))[] } & ({ strategy?: "manual" | "legacyForSales" | "autoForSales" | "ruleBased" | undefined; }); dailyBudget: undefined | number; endDate: undefined | string; name: undefined | string; portfolioId: undefined | number; premiumBidAdjustment: undefined | boolean; startDate: undefined | string; state: undefined | "paused" | "enabled" | "archived" })[]

    Returns Promise<({ code: string } & { campaignId: undefined | number; description: undefined | string; details: undefined | string })[]>