publisher/creative/coupon
The coupon creative resource allows a publisher to pull coupon creatives for the advertisers they're working with.
GET | ||||
---|---|---|---|---|
Request Parameters | ||||
Parameter | Description | Possible Values | Default | Required? |
id | A comma-separated list of ids to filter by. | * 123,456,789 | N/A | No |
programId | A comma-separated list of program ids to filter by. | * 123,456,789 | N/A | No |
category | A comma-separated list of advertiser category ids to search for. Use the advertiser category resource to retrieve these ids. Previously, this was used an as advertiser category, but this concept was deprecated in favor of creative promotions that allow several promotions per creative. |
* 123,456,789 | N/A | No |
websiteId | A single website id used for website tracking. Adding this will add this parameter to your tracking link. | * 123,456,789 | N/A | No |
sid | A single SID parameter used for publisher tracking. Adding this will add this parameter to your tracking link. | * Any generic string | N/A | No |
encrypted | A single boolean value that indicates whether the tracking link should be encrypted. Adding this will encrypt your tracking link. | 1, 0 | Un-encrypted | No |
format | The format the response will be returned in. | json, xml, csv, or rss | N/A | Yes |
startDate | A valid date string in the ISO 8601 date format; any timestamp information that is present will be ignored. |
yyyy-mm-dd | N/A | No |
endDate | A valid date string in the ISO 8601 date format; any timestamp information that is present will be ignored. |
yyyy-mm-dd | N/A | No |
status | The status to filter by. | active, scheduled | N/A | No |
refurl | This field associates the traffic and conversions with the specified URL to later be populated in your and your joined advertisers' reporting. NOTE: By providing this data, it will be exposed to your joined advertisers. |
Any URL, ideally including the http(s) scheme. * https://www.google.com |
N/A | No |
Response Fields | ||||
Field | Description | Notes | ||
id | Advertiser's creative ID | |||
name | The name of the creative | |||
coupon | The actual coupon code | Exclusive coupon codes ending in an asterisk will treat the asterisk as a wildcard for attribution purposes. | ||
code | The actual code for the creative | |||
description | A description of the creative | |||
exclusive | Whether or not the coupon is exclusive | Either "yes" or "no" | ||
start_date | The first day the creative will be valid | |||
end_date | The last day the creative will be valid | |||
status | The status of the creative | One of: active, scheduled | ||
program_id | The id of the program that the creative belongs to | |||
program_name | The name of the program the creative belongs to | |||
category_name | The name of the category assigned to the creative | |||
category_names[n] | A collection of category names assigned to the creative |
* Values shown are placeholder values. Please replace with actual data.