vendorCouponReport: {
    definitions: {
        AsinDetails: {
            description: "Contains details about an asin.";
            examples: readonly [
                {
                    asin: "B08XJWMYR5";
                    discountAmount: 10;
                    discountType: "PERCENT_OFF_LIST_PRICE";
                },
                {
                    asin: "B07Z7XTQKZ";
                    discountAmount: 4.99;
                    discountType: "AMOUNT_OFF_LIST_PRICE";
                },
            ];
            properties: {
                asin: {
                    description: "Asin of the product.";
                    examples: readonly ["B08XJWMYR5"];
                    type: "string";
                };
                discountAmount: {
                    description: "Discount amount the customer receives on the product. Reflects a percentage when discountType is PERCENT_OFF_LIST_PRICE and a currency value when discountType is AMOUNT_OFF_LIST_PRICE.";
                    examples: readonly [10];
                    minimum: 0;
                    type: "number";
                };
                discountType: {
                    description: "Whether the discount is given as a fixed amount or a percentage off the list price.";
                    enum: readonly ["PERCENT_OFF_LIST_PRICE", "AMOUNT_OFF_LIST_PRICE"];
                    type: "string";
                };
            };
            required: readonly ["asin", "discountType", "discountAmount"];
            type: "object";
        };
        CouponDetails: {
            description: "Contains details about a coupon.";
            examples: readonly [
                {
                    asins: readonly [
                        {
                            asin: "B08XJWMYR5";
                            discountAmount: 10;
                            discountType: "PERCENT_OFF_LIST_PRICE";
                        },
                        {
                            asin: "B07Z7XTQKZ";
                            discountAmount: 5;
                            discountType: "AMOUNT_OFF_LIST_PRICE";
                        },
                    ];
                    budget: 10000;
                    budgetPercentageUsed: 0.4;
                    budgetRemaining: 9957.71;
                    budgetSpent: 42.29;
                    clips: 13;
                    couponId: "A2NW32V27GZS2T";
                    customerSegment: "All (Default)";
                    endDateTime: "2021-11-29T23:59:59Z";
                    isOncePerCustomer: true;
                    name: "Product $40 Off";
                    redemptions: 1;
                    startDateTime: "2021-11-26T05:59:59Z";
                    totalDiscount: 40;
                    websiteMessage: "Save on BrandX Product";
                },
            ];
            properties: {
                asins: {
                    description: "Discount details of the products associated with the coupon.";
                    items: { $ref: "#/definitions/AsinDetails" };
                    type: "array";
                };
                budget: {
                    description: "Budget allocated to the coupon. Currency value. Only present when campaign budgetType is PER_INDIVIDUAL_COUPON.";
                    examples: readonly [10000];
                    minimum: 0;
                    type: "number";
                };
                budgetPercentageUsed: {
                    description: "Percentage of the allocated budget that has been spent, equal to the budgetSpent divided by budget or campaign totalBudget as appropriate.";
                    examples: readonly [0.4];
                    maximum: 100;
                    minimum: 0;
                    type: "number";
                };
                budgetRemaining: {
                    description: "Budget remaining for the coupon, equal to budget minus budgetSpent. Currency value. Only present when campaign budgetType is PER_INDIVIDUAL_COUPON. Represents a gross value, including purchases that were returned or cancelled.";
                    examples: readonly [9957.71];
                    minimum: 0;
                    type: "number";
                };
                budgetSpent: {
                    description: "Total amount spent by the vendor on the coupon, including clip fees and redemption fees. Currency value. Represents a gross value, including purchases that were returned or cancelled.";
                    examples: readonly [42.29];
                    minimum: 0;
                    type: "number";
                };
                clips: {
                    description: "Number of times the coupon has been applied on the product page.";
                    examples: readonly [13];
                    minimum: 0;
                    type: "integer";
                };
                couponId: {
                    description: "Unique identifier of the coupon.";
                    examples: readonly ["A2NW32V27GZS2T"];
                    type: "string";
                };
                customerSegment: {
                    description: "The customer segment that the coupon is available to.";
                    examples: readonly ["All (Default)", "Amazon Prime", "Amazon Student"];
                    type: "string";
                };
                endDateTime: {
                    description: "Coupon end date-time in UTC.";
                    examples: readonly ["2021-11-29T23:59:59Z"];
                    format: "date-time";
                    type: "string";
                };
                isOncePerCustomer: {
                    description: "Whether or not the coupon can only be redeemed once per customer account.";
                    type: "boolean";
                };
                name: {
                    description: "The name given to the coupon.";
                    examples: readonly ["Product $40 Off"];
                    type: "string";
                };
                redemptions: {
                    description: "Number of times the coupon has been used for a purchase. Represents a gross value, including purchases that were returned or cancelled.";
                    examples: readonly [1];
                    minimum: 0;
                    type: "integer";
                };
                startDateTime: {
                    description: "Coupon start date-time in UTC.";
                    examples: readonly ["2021-11-26T05:59:59Z"];
                    format: "date-time";
                    type: "string";
                };
                totalDiscount: {
                    description: "Total amount saved by customers redeeming the coupon. Currency value. Represents a gross value, including purchases that were returned or cancelled.";
                    examples: readonly [40];
                    minimum: 0;
                    type: "number";
                };
                websiteMessage: {
                    description: "Message displayed with the coupon on the product page.";
                    examples: readonly ["Save on BrandX Product"];
                    type: "string";
                };
            };
            required: readonly [
                "couponId",
                "startDateTime",
                "endDateTime",
                "isOncePerCustomer",
                "customerSegment",
                "clips",
                "redemptions",
                "totalDiscount",
                "budgetSpent",
                "budgetPercentageUsed",
                "asins",
            ];
            type: "object";
        };
        DetailsByCampaign: {
            description: "Contains details about a campaign and every included coupon.";
            examples: readonly [
                {
                    budgetType: "PER_INDIVIDUAL_COUPON";
                    campaignId: "AMZHYHN65T7OH";
                    campaignName: "Thanksgiving 2021";
                    coupons: readonly [
                        {
                            asins: readonly [
                                {
                                    asin: "B08XJWMYR5";
                                    discountAmount: 10;
                                    discountType: "PERCENT_OFF_LIST_PRICE";
                                },
                                {
                                    asin: "B07Z7XTQKZ";
                                    discountAmount: 4.99;
                                    discountType: "AMOUNT_OFF_LIST_PRICE";
                                },
                            ];
                            budget: 10000;
                            budgetPercentageUsed: 0.4;
                            budgetRemaining: 9957.71;
                            budgetSpent: 42.29;
                            clips: 13;
                            couponId: "A2NW32V27GZS2T";
                            customerSegment: "All (Default)";
                            endDateTime: "2021-11-29T23:59:59Z";
                            isOncePerCustomer: true;
                            name: "Product $40 Off";
                            redemptions: 1;
                            startDateTime: "2021-11-26T05:59:59Z";
                            totalDiscount: 40;
                            websiteMessage: "Save on BrandX Product";
                        },
                    ];
                    creationDateTime: "2021-11-01T12:34:56Z";
                    currencyCode: "USD";
                    isSubscribeAndSave: false;
                    lastUpdatedDateTime: "2021-12-16T09:44:35Z";
                    marketplaceId: "ATVPDKIKX0DER";
                    totalClips: 13;
                    totalRedemptions: 1;
                    vendorCode: "ABCDE";
                },
                {
                    budgetType: "SHARED_BUDGET";
                    campaignId: "AMZHYHN65T7OH";
                    campaignName: "Thanksgiving 2021";
                    coupons: readonly [
                        {
                            asins: readonly [
                                {
                                    asin: "B07KKXTNK1";
                                    discountAmount: 25;
                                    discountType: "PERCENT_OFF_LIST_PRICE";
                                },
                            ];
                            budgetPercentageUsed: 0.8;
                            budgetSpent: 40.7;
                            clips: 21;
                            couponId: "A2NW32V27GZS2T";
                            customerSegment: "All (Default)";
                            endDateTime: "2021-11-29T23:59:59Z";
                            isOncePerCustomer: false;
                            name: "B07KKXTNK1 $20, 11.26-11.29";
                            redemptions: 8;
                            startDateTime: "2021-11-26T05:59:59Z";
                            totalDiscount: 36.49;
                            websiteMessage: "Save on BrandY Product";
                        },
                        {
                            asins: readonly [
                                {
                                    asin: "B08W3JHG19";
                                    discountAmount: 10;
                                    discountType: "PERCENT_OFF_LIST_PRICE";
                                },
                            ];
                            budgetPercentageUsed: 1.7;
                            budgetSpent: 87.15;
                            clips: 59;
                            couponId: "A2NW32V27GZS2T";
                            couponVendorCode: "ABCDE";
                            customerSegment: "All (Default)";
                            endDateTime: "2021-11-29T23:59:59Z";
                            isOncePerCustomer: false;
                            name: "B08W3JHG19 $20, 11.26-11.29";
                            redemptions: 28;
                            startDateTime: "2021-11-26T05:59:59Z";
                            totalDiscount: 74.88;
                            websiteMessage: "Save on BrandZ Product";
                        },
                    ];
                    creationDateTime: "2021-11-01T12:34:56Z";
                    currencyCode: "USD";
                    isSubscribeAndSave: false;
                    lastUpdatedDateTime: "2021-12-16T09:44:35Z";
                    marketplaceId: "ATVPDKIKX0DER";
                    totalBudget: 5000;
                    totalBudgetRemaining: 4872.15;
                    totalBudgetSpent: 127.85;
                    totalClips: 80;
                    totalRedemptions: 36;
                    vendorCode: "ABCDE";
                },
            ];
            properties: {
                budgetType: {
                    description: "Whether the budget is allocated independently for each coupon or shared among all coupons.";
                    enum: readonly ["PER_INDIVIDUAL_COUPON", "SHARED_BUDGET"];
                    type: "string";
                };
                campaignId: {
                    description: "Unique identifier of the campaign.";
                    examples: readonly ["AMZHYHN65T7OH"];
                    type: "string";
                };
                campaignName: {
                    description: "Name given to the campaign.";
                    examples: readonly ["Thanksgiving 2021"];
                    type: "string";
                };
                coupons: {
                    description: "A list of included coupons and their details.";
                    items: { $ref: "#/definitions/CouponDetails" };
                    type: "array";
                };
                creationDateTime: {
                    description: "Campaign creation date-time in UTC.";
                    examples: readonly ["2021-11-01T12:34:56Z"];
                    format: "date-time";
                    type: "string";
                };
                currencyCode: {
                    description: "ISO 4217 currency code of all currency values in the campaign.";
                    examples: readonly ["USD"];
                    type: "string";
                };
                isSubscribeAndSave: {
                    description: "Whether or not the campaign is a Subscribe and Save offer.";
                    type: "boolean";
                };
                lastUpdatedDateTime: {
                    description: "The latest date-time the campaign data in this report was updated. May be up to 24 hours before the current date-time.";
                    examples: readonly ["2021-12-16T09:44:35Z"];
                    format: "date-time";
                    type: "string";
                };
                marketplaceId: {
                    description: "The marketplace the campaign is running in.";
                    examples: readonly ["ATVPDKIKX0DER"];
                    type: "string";
                };
                totalBudget: {
                    description: "Total budget allocated to the campaign. Currency value. Only present when budgetType is SHARED_BUDGET.";
                    examples: readonly [5000];
                    minimum: 0;
                    type: "number";
                };
                totalBudgetRemaining: {
                    description: "The budget remaining for the campaign, equal to totalBudget minus totalBudgetSpent. Currency value. Only present when budgetType is SHARED_BUDGET.";
                    examples: readonly [4872.15];
                    minimum: 0;
                    type: "number";
                };
                totalBudgetSpent: {
                    description: "Total amount spent by the vendor on the campaign, including clip fees and redemption fees, equal to the sum of all coupon budgetSpent. Currency value. Only present when budgetType is SHARED_BUDGET.";
                    examples: readonly [127.85];
                    minimum: 0;
                    type: "number";
                };
                totalClips: {
                    description: "Total number of times a coupon in the campaign has been applied on the product page, equal to the sum of all coupon clips.";
                    examples: readonly [80];
                    minimum: 0;
                    type: "integer";
                };
                totalRedemptions: {
                    description: "Total number of times a coupon in the campaign has been used for a purchase, equal to the sum of all coupon redemptions.";
                    examples: readonly [36];
                    minimum: 0;
                    type: "integer";
                };
                vendorCode: {
                    description: "The vendor code associated with the campaign.";
                    examples: readonly ["ABCDE"];
                    type: "string";
                };
            };
            required: readonly [
                "campaignId",
                "campaignName",
                "vendorCode",
                "marketplaceId",
                "creationDateTime",
                "lastUpdatedDateTime",
                "isSubscribeAndSave",
                "budgetType",
                "totalClips",
                "totalRedemptions",
                "coupons",
            ];
            type: "object";
        };
    };
    description: "This report contains data to help vendors optimize their coupons and adjust their advertising strategies. This report supports start dates up to two years before the current date.";
    examples: readonly [
        {
            campaigns: readonly [
                {
                    budgetType: "PER_INDIVIDUAL_COUPON";
                    campaignId: "AMZHYHN65T7OH";
                    campaignName: "Thanksgiving 2021";
                    coupons: readonly [
                        {
                            asins: readonly [
                                {
                                    asin: "B08XJWMYR5";
                                    discountAmount: 10;
                                    discountType: "PERCENT_OFF_LIST_PRICE";
                                },
                                {
                                    asin: "B07Z7XTQKZ";
                                    discountAmount: 4.99;
                                    discountType: "AMOUNT_OFF_LIST_PRICE";
                                },
                            ];
                            budget: 10000;
                            budgetPercentageUsed: 0.4;
                            budgetRemaining: 9957.71;
                            budgetSpent: 42.29;
                            clips: 13;
                            couponId: "A2NW32V27GZS2T";
                            customerSegment: "All (Default)";
                            endDateTime: "2021-11-29T23:59:59Z";
                            isOncePerCustomer: true;
                            name: "Product $40 Off";
                            redemptions: 1;
                            startDateTime: "2021-11-26T05:59:59Z";
                            totalDiscount: 40;
                            websiteMessage: "Save on BrandX Product";
                        },
                    ];
                    creationDateTime: "2021-11-01T12:34:56Z";
                    currencyCode: "USD";
                    isSubscribeAndSave: false;
                    lastUpdatedDateTime: "2021-12-16T09:44:35Z";
                    marketplaceId: "ATVPDKIKX0DER";
                    totalClips: 13;
                    totalRedemptions: 1;
                    vendorCode: "ABCDE";
                },
            ];
            reportSpecification: {
                marketplaceIds: readonly ["ATVPDKIKX0DER"];
                reportOptions: {
                    campaignStartDateFrom: "2021-11-01T15:33:26Z";
                    campaignStartDateTo: "2021-11-30T15:33:26Z";
                };
                reportType: "GET_COUPON_PERFORMANCE_REPORT";
            };
        },
    ];
    properties: {
        campaigns: {
            description: "List of included campaigns.";
            items: { $ref: "#/definitions/DetailsByCampaign" };
            type: "array";
        };
        reportSpecification: {
            description: "Summarizes the original report request.";
            examples: readonly [
                {
                    marketplaceIds: readonly ["ATVPDKIKX0DER"];
                    reportOptions: {
                        campaignStartDateFrom: "2021-11-01T15:33:26Z";
                        campaignStartDateTo: "2021-11-30T15:33:26Z";
                    };
                    reportType: "GET_COUPON_PERFORMANCE_REPORT";
                },
            ];
            properties: {
                marketplaceIds: {
                    description: "Marketplace IDs as specified in the report request.";
                    examples: readonly [readonly ["ATVPDKIKX0DER"]];
                    items: {
                        description: "The marketplace ID.";
                        examples: readonly ["ATVPDKIKX0DER"];
                        type: "string";
                    };
                    type: "array";
                };
                reportOptions: {
                    description: "Report options specifying parameters campaignStartDateFrom and campaignStartDateTo.";
                    properties: {
                        campaignStartDateFrom: {
                            description: "The start of a date-time range in UTC used for selecting coupons to report on. All coupons with a start date-time that falls within the range will be included.";
                            examples: readonly ["2021-11-01T15:33:26Z"];
                            format: "date-time";
                            type: "string";
                        };
                        campaignStartDateTo: {
                            description: "The end of a date-time range in UTC used for selecting coupons to report on. All coupons with a start date-time that falls within the range will be included.";
                            examples: readonly ["2021-11-30T15:33:26Z"];
                            format: "date-time";
                            type: "string";
                        };
                    };
                    required: readonly ["campaignStartDateFrom", "campaignStartDateTo"];
                    type: "object";
                };
                reportType: {
                    description: "The report type.";
                    examples: readonly ["GET_COUPON_PERFORMANCE_REPORT"];
                    type: "string";
                };
            };
            required: readonly ["reportType", "reportOptions", "marketplaceIds"];
            type: "object";
        };
    };
    required: readonly ["reportSpecification", "campaigns"];
    type: "object";
} = ...

Type declaration

  • Readonlydefinitions: {
        AsinDetails: {
            description: "Contains details about an asin.";
            examples: readonly [
                {
                    asin: "B08XJWMYR5";
                    discountAmount: 10;
                    discountType: "PERCENT_OFF_LIST_PRICE";
                },
                {
                    asin: "B07Z7XTQKZ";
                    discountAmount: 4.99;
                    discountType: "AMOUNT_OFF_LIST_PRICE";
                },
            ];
            properties: {
                asin: {
                    description: "Asin of the product.";
                    examples: readonly ["B08XJWMYR5"];
                    type: "string";
                };
                discountAmount: {
                    description: "Discount amount the customer receives on the product. Reflects a percentage when discountType is PERCENT_OFF_LIST_PRICE and a currency value when discountType is AMOUNT_OFF_LIST_PRICE.";
                    examples: readonly [10];
                    minimum: 0;
                    type: "number";
                };
                discountType: {
                    description: "Whether the discount is given as a fixed amount or a percentage off the list price.";
                    enum: readonly ["PERCENT_OFF_LIST_PRICE", "AMOUNT_OFF_LIST_PRICE"];
                    type: "string";
                };
            };
            required: readonly ["asin", "discountType", "discountAmount"];
            type: "object";
        };
        CouponDetails: {
            description: "Contains details about a coupon.";
            examples: readonly [
                {
                    asins: readonly [
                        {
                            asin: "B08XJWMYR5";
                            discountAmount: 10;
                            discountType: "PERCENT_OFF_LIST_PRICE";
                        },
                        {
                            asin: "B07Z7XTQKZ";
                            discountAmount: 5;
                            discountType: "AMOUNT_OFF_LIST_PRICE";
                        },
                    ];
                    budget: 10000;
                    budgetPercentageUsed: 0.4;
                    budgetRemaining: 9957.71;
                    budgetSpent: 42.29;
                    clips: 13;
                    couponId: "A2NW32V27GZS2T";
                    customerSegment: "All (Default)";
                    endDateTime: "2021-11-29T23:59:59Z";
                    isOncePerCustomer: true;
                    name: "Product $40 Off";
                    redemptions: 1;
                    startDateTime: "2021-11-26T05:59:59Z";
                    totalDiscount: 40;
                    websiteMessage: "Save on BrandX Product";
                },
            ];
            properties: {
                asins: {
                    description: "Discount details of the products associated with the coupon.";
                    items: { $ref: "#/definitions/AsinDetails" };
                    type: "array";
                };
                budget: {
                    description: "Budget allocated to the coupon. Currency value. Only present when campaign budgetType is PER_INDIVIDUAL_COUPON.";
                    examples: readonly [10000];
                    minimum: 0;
                    type: "number";
                };
                budgetPercentageUsed: {
                    description: "Percentage of the allocated budget that has been spent, equal to the budgetSpent divided by budget or campaign totalBudget as appropriate.";
                    examples: readonly [0.4];
                    maximum: 100;
                    minimum: 0;
                    type: "number";
                };
                budgetRemaining: {
                    description: "Budget remaining for the coupon, equal to budget minus budgetSpent. Currency value. Only present when campaign budgetType is PER_INDIVIDUAL_COUPON. Represents a gross value, including purchases that were returned or cancelled.";
                    examples: readonly [9957.71];
                    minimum: 0;
                    type: "number";
                };
                budgetSpent: {
                    description: "Total amount spent by the vendor on the coupon, including clip fees and redemption fees. Currency value. Represents a gross value, including purchases that were returned or cancelled.";
                    examples: readonly [42.29];
                    minimum: 0;
                    type: "number";
                };
                clips: {
                    description: "Number of times the coupon has been applied on the product page.";
                    examples: readonly [13];
                    minimum: 0;
                    type: "integer";
                };
                couponId: {
                    description: "Unique identifier of the coupon.";
                    examples: readonly ["A2NW32V27GZS2T"];
                    type: "string";
                };
                customerSegment: {
                    description: "The customer segment that the coupon is available to.";
                    examples: readonly ["All (Default)", "Amazon Prime", "Amazon Student"];
                    type: "string";
                };
                endDateTime: {
                    description: "Coupon end date-time in UTC.";
                    examples: readonly ["2021-11-29T23:59:59Z"];
                    format: "date-time";
                    type: "string";
                };
                isOncePerCustomer: {
                    description: "Whether or not the coupon can only be redeemed once per customer account.";
                    type: "boolean";
                };
                name: {
                    description: "The name given to the coupon.";
                    examples: readonly ["Product $40 Off"];
                    type: "string";
                };
                redemptions: {
                    description: "Number of times the coupon has been used for a purchase. Represents a gross value, including purchases that were returned or cancelled.";
                    examples: readonly [1];
                    minimum: 0;
                    type: "integer";
                };
                startDateTime: {
                    description: "Coupon start date-time in UTC.";
                    examples: readonly ["2021-11-26T05:59:59Z"];
                    format: "date-time";
                    type: "string";
                };
                totalDiscount: {
                    description: "Total amount saved by customers redeeming the coupon. Currency value. Represents a gross value, including purchases that were returned or cancelled.";
                    examples: readonly [40];
                    minimum: 0;
                    type: "number";
                };
                websiteMessage: {
                    description: "Message displayed with the coupon on the product page.";
                    examples: readonly ["Save on BrandX Product"];
                    type: "string";
                };
            };
            required: readonly [
                "couponId",
                "startDateTime",
                "endDateTime",
                "isOncePerCustomer",
                "customerSegment",
                "clips",
                "redemptions",
                "totalDiscount",
                "budgetSpent",
                "budgetPercentageUsed",
                "asins",
            ];
            type: "object";
        };
        DetailsByCampaign: {
            description: "Contains details about a campaign and every included coupon.";
            examples: readonly [
                {
                    budgetType: "PER_INDIVIDUAL_COUPON";
                    campaignId: "AMZHYHN65T7OH";
                    campaignName: "Thanksgiving 2021";
                    coupons: readonly [
                        {
                            asins: readonly [
                                {
                                    asin: "B08XJWMYR5";
                                    discountAmount: 10;
                                    discountType: "PERCENT_OFF_LIST_PRICE";
                                },
                                {
                                    asin: "B07Z7XTQKZ";
                                    discountAmount: 4.99;
                                    discountType: "AMOUNT_OFF_LIST_PRICE";
                                },
                            ];
                            budget: 10000;
                            budgetPercentageUsed: 0.4;
                            budgetRemaining: 9957.71;
                            budgetSpent: 42.29;
                            clips: 13;
                            couponId: "A2NW32V27GZS2T";
                            customerSegment: "All (Default)";
                            endDateTime: "2021-11-29T23:59:59Z";
                            isOncePerCustomer: true;
                            name: "Product $40 Off";
                            redemptions: 1;
                            startDateTime: "2021-11-26T05:59:59Z";
                            totalDiscount: 40;
                            websiteMessage: "Save on BrandX Product";
                        },
                    ];
                    creationDateTime: "2021-11-01T12:34:56Z";
                    currencyCode: "USD";
                    isSubscribeAndSave: false;
                    lastUpdatedDateTime: "2021-12-16T09:44:35Z";
                    marketplaceId: "ATVPDKIKX0DER";
                    totalClips: 13;
                    totalRedemptions: 1;
                    vendorCode: "ABCDE";
                },
                {
                    budgetType: "SHARED_BUDGET";
                    campaignId: "AMZHYHN65T7OH";
                    campaignName: "Thanksgiving 2021";
                    coupons: readonly [
                        {
                            asins: readonly [
                                {
                                    asin: "B07KKXTNK1";
                                    discountAmount: 25;
                                    discountType: "PERCENT_OFF_LIST_PRICE";
                                },
                            ];
                            budgetPercentageUsed: 0.8;
                            budgetSpent: 40.7;
                            clips: 21;
                            couponId: "A2NW32V27GZS2T";
                            customerSegment: "All (Default)";
                            endDateTime: "2021-11-29T23:59:59Z";
                            isOncePerCustomer: false;
                            name: "B07KKXTNK1 $20, 11.26-11.29";
                            redemptions: 8;
                            startDateTime: "2021-11-26T05:59:59Z";
                            totalDiscount: 36.49;
                            websiteMessage: "Save on BrandY Product";
                        },
                        {
                            asins: readonly [
                                {
                                    asin: "B08W3JHG19";
                                    discountAmount: 10;
                                    discountType: "PERCENT_OFF_LIST_PRICE";
                                },
                            ];
                            budgetPercentageUsed: 1.7;
                            budgetSpent: 87.15;
                            clips: 59;
                            couponId: "A2NW32V27GZS2T";
                            couponVendorCode: "ABCDE";
                            customerSegment: "All (Default)";
                            endDateTime: "2021-11-29T23:59:59Z";
                            isOncePerCustomer: false;
                            name: "B08W3JHG19 $20, 11.26-11.29";
                            redemptions: 28;
                            startDateTime: "2021-11-26T05:59:59Z";
                            totalDiscount: 74.88;
                            websiteMessage: "Save on BrandZ Product";
                        },
                    ];
                    creationDateTime: "2021-11-01T12:34:56Z";
                    currencyCode: "USD";
                    isSubscribeAndSave: false;
                    lastUpdatedDateTime: "2021-12-16T09:44:35Z";
                    marketplaceId: "ATVPDKIKX0DER";
                    totalBudget: 5000;
                    totalBudgetRemaining: 4872.15;
                    totalBudgetSpent: 127.85;
                    totalClips: 80;
                    totalRedemptions: 36;
                    vendorCode: "ABCDE";
                },
            ];
            properties: {
                budgetType: {
                    description: "Whether the budget is allocated independently for each coupon or shared among all coupons.";
                    enum: readonly ["PER_INDIVIDUAL_COUPON", "SHARED_BUDGET"];
                    type: "string";
                };
                campaignId: {
                    description: "Unique identifier of the campaign.";
                    examples: readonly ["AMZHYHN65T7OH"];
                    type: "string";
                };
                campaignName: {
                    description: "Name given to the campaign.";
                    examples: readonly ["Thanksgiving 2021"];
                    type: "string";
                };
                coupons: {
                    description: "A list of included coupons and their details.";
                    items: { $ref: "#/definitions/CouponDetails" };
                    type: "array";
                };
                creationDateTime: {
                    description: "Campaign creation date-time in UTC.";
                    examples: readonly ["2021-11-01T12:34:56Z"];
                    format: "date-time";
                    type: "string";
                };
                currencyCode: {
                    description: "ISO 4217 currency code of all currency values in the campaign.";
                    examples: readonly ["USD"];
                    type: "string";
                };
                isSubscribeAndSave: {
                    description: "Whether or not the campaign is a Subscribe and Save offer.";
                    type: "boolean";
                };
                lastUpdatedDateTime: {
                    description: "The latest date-time the campaign data in this report was updated. May be up to 24 hours before the current date-time.";
                    examples: readonly ["2021-12-16T09:44:35Z"];
                    format: "date-time";
                    type: "string";
                };
                marketplaceId: {
                    description: "The marketplace the campaign is running in.";
                    examples: readonly ["ATVPDKIKX0DER"];
                    type: "string";
                };
                totalBudget: {
                    description: "Total budget allocated to the campaign. Currency value. Only present when budgetType is SHARED_BUDGET.";
                    examples: readonly [5000];
                    minimum: 0;
                    type: "number";
                };
                totalBudgetRemaining: {
                    description: "The budget remaining for the campaign, equal to totalBudget minus totalBudgetSpent. Currency value. Only present when budgetType is SHARED_BUDGET.";
                    examples: readonly [4872.15];
                    minimum: 0;
                    type: "number";
                };
                totalBudgetSpent: {
                    description: "Total amount spent by the vendor on the campaign, including clip fees and redemption fees, equal to the sum of all coupon budgetSpent. Currency value. Only present when budgetType is SHARED_BUDGET.";
                    examples: readonly [127.85];
                    minimum: 0;
                    type: "number";
                };
                totalClips: {
                    description: "Total number of times a coupon in the campaign has been applied on the product page, equal to the sum of all coupon clips.";
                    examples: readonly [80];
                    minimum: 0;
                    type: "integer";
                };
                totalRedemptions: {
                    description: "Total number of times a coupon in the campaign has been used for a purchase, equal to the sum of all coupon redemptions.";
                    examples: readonly [36];
                    minimum: 0;
                    type: "integer";
                };
                vendorCode: {
                    description: "The vendor code associated with the campaign.";
                    examples: readonly ["ABCDE"];
                    type: "string";
                };
            };
            required: readonly [
                "campaignId",
                "campaignName",
                "vendorCode",
                "marketplaceId",
                "creationDateTime",
                "lastUpdatedDateTime",
                "isSubscribeAndSave",
                "budgetType",
                "totalClips",
                "totalRedemptions",
                "coupons",
            ];
            type: "object";
        };
    }
  • Readonlydescription: "This report contains data to help vendors optimize their coupons and adjust their advertising strategies. This report supports start dates up to two years before the current date."
  • Readonlyexamples: readonly [
        {
            campaigns: readonly [
                {
                    budgetType: "PER_INDIVIDUAL_COUPON";
                    campaignId: "AMZHYHN65T7OH";
                    campaignName: "Thanksgiving 2021";
                    coupons: readonly [
                        {
                            asins: readonly [
                                {
                                    asin: "B08XJWMYR5";
                                    discountAmount: 10;
                                    discountType: "PERCENT_OFF_LIST_PRICE";
                                },
                                {
                                    asin: "B07Z7XTQKZ";
                                    discountAmount: 4.99;
                                    discountType: "AMOUNT_OFF_LIST_PRICE";
                                },
                            ];
                            budget: 10000;
                            budgetPercentageUsed: 0.4;
                            budgetRemaining: 9957.71;
                            budgetSpent: 42.29;
                            clips: 13;
                            couponId: "A2NW32V27GZS2T";
                            customerSegment: "All (Default)";
                            endDateTime: "2021-11-29T23:59:59Z";
                            isOncePerCustomer: true;
                            name: "Product $40 Off";
                            redemptions: 1;
                            startDateTime: "2021-11-26T05:59:59Z";
                            totalDiscount: 40;
                            websiteMessage: "Save on BrandX Product";
                        },
                    ];
                    creationDateTime: "2021-11-01T12:34:56Z";
                    currencyCode: "USD";
                    isSubscribeAndSave: false;
                    lastUpdatedDateTime: "2021-12-16T09:44:35Z";
                    marketplaceId: "ATVPDKIKX0DER";
                    totalClips: 13;
                    totalRedemptions: 1;
                    vendorCode: "ABCDE";
                },
            ];
            reportSpecification: {
                marketplaceIds: readonly ["ATVPDKIKX0DER"];
                reportOptions: {
                    campaignStartDateFrom: "2021-11-01T15:33:26Z";
                    campaignStartDateTo: "2021-11-30T15:33:26Z";
                };
                reportType: "GET_COUPON_PERFORMANCE_REPORT";
            };
        },
    ]
  • Readonlyproperties: {
        campaigns: {
            description: "List of included campaigns.";
            items: { $ref: "#/definitions/DetailsByCampaign" };
            type: "array";
        };
        reportSpecification: {
            description: "Summarizes the original report request.";
            examples: readonly [
                {
                    marketplaceIds: readonly ["ATVPDKIKX0DER"];
                    reportOptions: {
                        campaignStartDateFrom: "2021-11-01T15:33:26Z";
                        campaignStartDateTo: "2021-11-30T15:33:26Z";
                    };
                    reportType: "GET_COUPON_PERFORMANCE_REPORT";
                },
            ];
            properties: {
                marketplaceIds: {
                    description: "Marketplace IDs as specified in the report request.";
                    examples: readonly [readonly ["ATVPDKIKX0DER"]];
                    items: {
                        description: "The marketplace ID.";
                        examples: readonly ["ATVPDKIKX0DER"];
                        type: "string";
                    };
                    type: "array";
                };
                reportOptions: {
                    description: "Report options specifying parameters campaignStartDateFrom and campaignStartDateTo.";
                    properties: {
                        campaignStartDateFrom: {
                            description: "The start of a date-time range in UTC used for selecting coupons to report on. All coupons with a start date-time that falls within the range will be included.";
                            examples: readonly ["2021-11-01T15:33:26Z"];
                            format: "date-time";
                            type: "string";
                        };
                        campaignStartDateTo: {
                            description: "The end of a date-time range in UTC used for selecting coupons to report on. All coupons with a start date-time that falls within the range will be included.";
                            examples: readonly ["2021-11-30T15:33:26Z"];
                            format: "date-time";
                            type: "string";
                        };
                    };
                    required: readonly ["campaignStartDateFrom", "campaignStartDateTo"];
                    type: "object";
                };
                reportType: {
                    description: "The report type.";
                    examples: readonly ["GET_COUPON_PERFORMANCE_REPORT"];
                    type: "string";
                };
            };
            required: readonly ["reportType", "reportOptions", "marketplaceIds"];
            type: "object";
        };
    }
  • Readonlyrequired: readonly ["reportSpecification", "campaigns"]
  • Readonlytype: "object"