The program object holds information for your programs. You can retrieve a program's object as well as list all program objects.
Attributes
Id integer
Id integerUnique identifier for the object referred to as the impact.com Program Id.
Name string
Name stringName of the program.
State enum
State enumState of the program.
| View possible enum values | |
|---|---|
ACTIVE | Program is currently active. |
AWAITING_REVIEW | Program is awaiting review by impact.com. |
CANCELLED | Program was cancelled before it began. |
CLOSED | Program was closed by impact.com. |
DEACTIVATED | Program was deactivated by an account user. |
DELINQUENT | Program is past due on payments to either impact.com or its partner(s). |
REJECTED | Program was rejected by impact.com. |
SETUP | Program is getting set up and will be available soon. |
SETUP_COMPLETE | Program is set up and is awaiting approval. |
Categories object
Categories objectCategories, subcategories, and additional categories that the program is contained in.
View child attributes
PrimaryCategory enum
PrimaryCategory enumProgram's primary impact.com marketplace category.
| View possible enum values |
|---|
Apparel, Shoes & Accessories |
Apps & Downloads |
Art & Entertainment |
Auto & Recreational Vehicles |
B2B, Services & Office Supplies |
Baby, Kids & Toys |
Charitable Organizations |
Computers & Electronics |
Dating & Romance |
Education |
Financial, Insurance & Legal Services |
Flowers, Gifts, Food & Drink |
Home & Garden |
Internet Services |
Marketplace |
Organic & Eco-Friendly |
Pharmacy, Health & Beauty |
Pets |
Special Occasions, Seasonal & Events |
Sports, Outdoor & Fitness |
Suscriptions & Services |
Travel |
PrimarySubCategories array
PrimarySubCategories arrayProgram's impact.com marketplace subcategories.
Apparel, Shoes & Accessories subcategories
| View possible enum values |
|---|
Bags & Accessories |
Jewelry & Watches |
Luxury |
Mens Apparel |
Shoes |
Specialty Sizes |
Apps & Downloads subcategories
| View possible enum values |
|---|
Apps |
Books & Newsstand |
Games |
Movie & TV |
Shopping |
Themes, Code, Graphics, Video & More |
Art & Entertainment subcategories
| View possible enum values |
|---|
Art & Craft Supplies |
Art & Photography |
Books & Magazines |
Collectibles & Hobbies |
Entertainment & Activities |
Movies & Music |
Tickets & Shows |
Auto & Recreational Vehicles subcategories
| View possible enum values |
|---|
Automobiles & Auto Services |
Parts & Accessories |
Recreational Vehicles |
B2B, Services & Office Supplies subcategories
| View possible enum values |
|---|
B2B |
Career |
Supplies & Furniture |
Baby, Kids & Toys subcategories
| View possible enum values |
|---|
Baby Essentials |
Baby & Kids Home |
Clothing & Accessories |
Educational |
Games/Toys |
Charitable Organizations subcategories
| View possible enum values |
|---|
Charitable Causes |
Disaster Relief |
Computers & Electronics subcategories
| View possible enum values |
|---|
Accessories & Peripherals |
Computers |
Consumer Electronics |
Gaming |
Mobile Services & Telecommunications |
Software |
Dating & Romance subcategories
| View possible enum values |
|---|
Online Dating |
Romance |
Education subcategories
| View possible enum values |
|---|
College |
Learning |
Textbooks & Supplies |
Financial, Insurance & Legal Services subcategories
| View possible enum values |
|---|
Credit Cards, Reporting & Repair |
Insurance |
Legal |
Loans & Financial Services |
Real Estate |
Tax |
Flowers, Gifts, Food & Drink subcategories
| View possible enum values |
|---|
Flowers |
Food & Drink |
Gifts & Stationary |
Gourmet |
Wine & Spirits |
Home & Garden subcategories
| View possible enum values |
|---|
Bed & Bath |
Furniture & Home Decor |
Home Improvement |
Household Essentials & Services |
Kitchen & Dining |
Patio & Garden |
Internet Services subcategories
| View possible enum values |
|---|
CDN Service |
Internet Service Provider |
Server Hosting |
Templates, Fonts, Add-ons & more |
Website Hosting |
Marketplace subcategories
| View possible enum values |
|---|
Auctions |
Creative Digital Assets |
Handmade Goods |
Organic & Eco-Friendly subcategories
| View possible enum values |
|---|
Apparel & Accessories |
Food & Gifts |
Health & Beauty |
Home & Garden |
Pets subcategories
| View possible enum values |
|---|
Pet Services |
Pet Supplies |
Pharmacy, Health & Beauty subcategories
| View possible enum values |
|---|
Cosmetics & Skin Care |
Diet & Nutrition |
First Aid & Pharmacy |
Fragrance |
Spa & Personal Grooming |
Vision |
Special Occasions, Seasonal & Events subcategories
| View possible enum values |
|---|
Fall |
Spring |
Summer |
Winter |
Party & Party Supplies |
Sports, Outdoor & Fitness subcategories
| View possible enum values |
|---|
Sports Apparel & Accessories |
Sports & Exercise Equipment |
Outdoors & Recreation |
Subscriptions & Services subcategories
| View possible enum values |
|---|
Apparel, Shoes & Accessories |
Bath & Beauty |
Food & Beverages |
Gifts & Services |
Home, Pet & Garden |
Images |
Sports & Outdoor |
Travel subcategories
| View possible enum values |
|---|
Accommodations |
Bath & Beauty |
Food & Beverages |
Gifts & Services |
Images |
Sports & Outdoor |
Transportation |
AdditionalCategory enum
AdditionalCategory enumAnother primary impact.com marketplace category that the program is listed in.
| View possible enum values | |
|---|---|
Apparel, Shoes & Accessories | |
Apps & Downloads | |
Art & Entertainment | |
Auto & Recreational Vehicles | |
B2B, Services & Office Supplies | |
Baby, Kids & Toys | |
Charitable Organizations | |
Dating & Romance | |
Computers & Electronics | |
Education | |
Financial, Insurance & Legal Services | |
Flowers, Gifts, Food & Drink | |
Home & Garden | |
Internet Services | |
Marketplace | |
Organic & Eco-Friendly | |
Pharmacy, Health & Beauty | |
Pets | |
Special Occasions, Seasonal & Events | |
Sports, Outdoor & Fitness | |
Suscriptions & Services | |
Travel | |
AdditionalSubCategories array
AdditionalSubCategories arrayArray of enums that represent a program's additional impact.com marketplace subcategories.
Apparel, Shoes & Accessories subcategories
| View possible enum values |
|---|
Bags & Accessories |
Jewelry & Watches |
Luxury |
Mens Apparel |
Shoes |
Specialty Sizes |
Apps & Downloads subcategories
| View possible enum values |
|---|
Apps |
Books & Newsstand |
Games |
Movie & TV |
Shopping |
Themes, Code, Graphics, Video & More |
Art & Entertainment subcategories
| View possible enum values |
|---|
Art & Craft Supplies |
Art & Photography |
Books & Magazines |
Collectibles & Hobbies |
Entertainment & Activities |
Movies & Music |
Tickets & Shows |
Auto & Recreational Vehicles subcategories
| View possible enum values |
|---|
Automobiles & Auto Services |
Parts & Accessories |
Recreational Vehicles |
B2B, Services & Office Supplies subcategories
| View possible enum values |
|---|
B2B |
Career |
Supplies & Furniture |
Baby, Kids & Toys subcategories
| View possible enum values |
|---|
Baby Essentials |
Baby & Kids Home |
Clothing & Accessories |
Educational |
Games/Toys |
Charitable Organizations subcategories
| View possible enum values |
|---|
Charitable Causes |
Disaster Relief |
Computers & Electronics subcategories
| View possible enum values |
|---|
Accessories & Peripherals |
Computers |
Consumer Electronics |
Gaming |
Mobile Services & Telecommunications |
Software |
Dating & Romance subcategories
| View possible enum values |
|---|
Online Dating |
Romance |
Education subcategories
| View possible enum values |
|---|
College |
Learning |
Textbooks & Supplies |
Financial, Insurance & Legal Services subcategories
| View possible enum values |
|---|
Credit Cards, Reporting & Repair |
Insurance |
Legal |
Loans & Financial Services |
Real Estate |
Tax |
Flowers, Gifts, Food & Drink subcategories
| View possible enum values |
|---|
Flowers |
Food & Drink |
Gifts & Stationary |
Gourmet |
Wine & Spirits |
Home & Garden subcategories
| View possible enum values |
|---|
Bed & Bath |
Furniture & Home Decor |
Home Improvement |
Household Essentials & Services |
Kitchen & Dining |
Patio & Garden |
Internet Services subcategories
| View possible enum values |
|---|
CDN Service |
Internet Service Provider |
Server Hosting |
Templates, Fonts, Add-ons & more |
Website Hosting |
Marketplace subcategories
| View possible enum values |
|---|
Auctions |
Creative Digital Assets |
Handmade Goods |
Organic & Eco-Friendly subcategories
| View possible enum values |
|---|
Apparel & Accessories |
Food & Gifts |
Health & Beauty |
Home & Garden |
Pets subcategories
| View possible enum values |
|---|
Pet Services |
Pet Supplies |
Pharmacy, Health & Beauty subcategories
| View possible enum values |
|---|
Cosmetics & Skin Care |
Diet & Nutrition |
First Aid & Pharmacy |
Fragrance |
Spa & Personal Grooming |
Vision |
Special Occasions, Seasonal & Events subcategories
| View possible enum values |
|---|
Fall |
Spring |
Summer |
Winter |
Party & Party Supplies |
Sports, Outdoor & Fitness subcategories
| View possible enum values |
|---|
Sports Apparel & Accessories |
Sports & Exercise Equipment |
Outdoors & Recreation |
Subscriptions & Services subcategories
| View possible enum values |
|---|
Apparel, Shoes & Accessories |
Bath & Beauty |
Food & Beverages |
Gifts & Services |
Home, Pet & Garden |
Images |
Sports & Outdoor |
Travel subcategories
| View possible enum values |
|---|
Accommodations |
Bath & Beauty |
Food & Beverages |
Gifts & Services |
Images |
Sports & Outdoor |
Transportation |
ShortDescription string
ShortDescription stringInitial description of the program when viewed in the marketplace. Max 100 characters.
LongDescription string
LongDescription stringDescription found on the program's marketplace brand card. Max 250 characters.
ListInMarketplace boolean
ListInMarketplace booleanWhether the program can be viewed in the marketplace or not.
DisplayServicingAgency boolean
DisplayServicingAgency booleanWhether partners can view the program's management agency. Will be false if the program is not managed by an agency.
Rating integer
Rating integerProgram's star rating.
SearchKeywords string
SearchKeywords stringComma-separated list of SEO keywords used to find the program in the marketplace.
ShippingRegions array
ShippingRegions arrayAn array of countries representing the global regions this program services.
View possible country values
| Possible enum values |
|---|
US |
UK |
CANADA |
AUSTRALIA |
GERMANY |
FRANCE |
AFGHANISTAN |
ALBANIA |
ALGERIA |
AMERICANSAMOA |
ANDORRA |
ANGOLA |
ANGUILLA |
ANTARCTICA |
ANTIGUABARBUDA |
ARGENTINA |
ARMENIA |
ARUBA |
AUSTRIA |
AZERBAIJAN |
BAHAMAS |
BAHRAIN |
BANGLADESH |
BARBADOS |
BELARUS |
BELGIUM |
BELIZE |
BENIN |
BERMUDA |
BHUTAN |
BOLIVIA |
BOSNIAHERZEGOVINA |
BOTSWANA |
BRAZIL |
BRITISHINDIANOCEANTERRITORY |
BRUNEIDARUSSALAM |
BULGARIA |
BURKINAFASO |
BURUNDI |
CAMBODIA |
CAMEROON |
CAPVERDE |
CAYMANISLANDS |
CENTRALAFRICANREPUBLIC |
CHAD |
CHILE |
CHINA |
CHRISTMASISLAND |
COCOSISLANDS |
COLOMBIA |
COMOROS |
CONGO |
DEMOCRATICREPUBLICCONGO |
COOKISLANDS |
COSTARICA |
IVORYCOAST |
CROATIA |
CUBA |
CYPRUS |
CZECHREPUBLIC |
DENMARK |
DIJIBOUTI |
DOMINICA |
DOMINICANREPUBLIC |
ECUADOR |
EGYPT |
ELSALVADOR |
EQUATORIALGUINEA |
ELSALVADOR |
ERITREA |
ESTONIA |
ETHIOPIA |
FALKLANDISLANDS |
FAROEISLANDS |
FIJI |
FINLAND |
FRENCHGUIANA |
FRENCHPOLYNESIA |
FRENCHSOUTHERNTERRITORIES |
GABON |
GAMBIA |
GEORGIA |
GHANA |
GIBRALTAR |
GREECE |
GREENLAND |
GRENADA |
GUADELOUPE |
GUAM |
GUATEMALA |
GUERNSEY |
GUINEA |
GUINEABISSAU |
GUYANA |
HAITI |
VATICAN |
HONDURAS |
HONGKONG |
HUNGARY |
ICELAND |
INDIA |
INDONESIA |
IRAN |
IRAQ |
IRELAND |
ISRAEL |
ITALY |
JAMAICA |
JAPAN |
JORDAN |
KAZAKHSTAN |
KENYA |
KIRIBATI |
SOUTHKOREA |
KUWAIT |
KYRGYZSTAN |
LAOS |
LATVIA |
LEBANON |
LESOTHO |
LIBERIA |
LIBYA |
LICHTENSTEIN |
LITHUANIA |
LUXEMBOURG |
MACAO |
MACEDONIA |
MADAGASCAR |
MALAWI |
MALAYSIA |
MALDIVES |
MALI |
MALTA |
MARSHALLISLANDS |
MARTINIQUE |
MAURITANIA |
MAURITIUS |
MAYOTTE |
MEXICO |
MICRONESIA |
MOLDOVA |
MONACO |
MONGOLIA |
MONTENEGRO |
MONTSERRAT |
MOROCCO |
MOZAMBIQUE |
MYANMAR |
NAMIBIA |
NAURU |
NEPAL |
NETHERLANDS |
NETHERLANDSANTILLES |
NEWCALEDONIA |
NEWZEALAND |
NICARAGUA |
NIGER |
NIGERIA |
NIUE |
NORFOLKISLAND |
NORTHKOREA |
NORTHERNMARIANAISLANDS |
NORWAY |
OMAN |
PAKISTAN |
PALAU |
PALESTINIANTERRITORY |
PANAMA |
PAPUANEWGUINEA |
PARAGUAY |
PERU |
PHILIPPINES |
PITCAIRN |
POLAND |
PORTUGAL |
PUERTORICO |
QATAR |
REUNION |
ROMANIA |
RUSSIA |
RWANDA |
SAINTHELENA |
SAINTKITTSNEVIS |
SAINTLUCIA |
SAINTPIERREMIQUELON |
SAINTVINCENTGRENADINES |
SAMOA |
SANMARINO |
SAOTOME |
SAUDIARABIA |
SENEGAL |
YOGOSLAVIA |
SEYCHELLES |
SIERRALEONE |
SINGAPORE |
SLOVAKIA |
SLOVENIA |
SOLOMONISLANDS |
SOMALIA |
SOUTHAFRICA |
SPAIN |
SRILANKA |
SUDAN |
SURINAME |
SVALBARDJANMAYEN |
SWAZILAND |
SWEDEN |
SWITZERLAND |
SYRIA |
TAIWAN |
TAJIKISTAN |
TANZANIA |
THAILAND |
TIMOR |
TOGO |
TOKELAU |
TONGA |
TRINIDADTOBAGO |
TUNISIA |
TURKEY |
TURKMENISTAN |
TURKSCAICOSISLANDS |
TUVALU |
UGANDA |
UKRAINE |
UAE |
URUGUAY |
UZBEKISTAN |
VANUATU |
VENEZUELA |
VIETNAM |
BRITISHVIRGINISLANDS |
USVIRGINISLANDS |
WALLISFUTUNA |
WESTERNSAHARA |
YEMEN |
ZAMBIA |
ZIMBABWE |
Resources object
Resources objectLinks that partners can select to learn more about the program or brand.
View child attributes
CompanyHomepage string
CompanyHomepage stringBrand's web homepage.
ExampleLandingPage string
ExampleLandingPage stringExample web page that the program's ad could send traffic to.
InformationPage string
InformationPage stringWeb page that partners can go to, to learn more about the program or brand.
AdditionalRelatedLinks array
AdditionalRelatedLinks arrayMore links partners can visit to learn about the program or brand.
View child attributes
LinkType enum
LinkType enumRelated link's link type.
| View possible enum values | |
|---|---|
URL | Selecting the related link will direct the partner to a webpage. |
PDF | Selecting the elated link will download a PDF. |
LinkDisplayName string
LinkDisplayName stringThe link's hyperlinked text. The partner will select this text to go to the linked web page or download the PDF.
LinkUrl string
LinkUrl stringThe URL path leading to the related link. This is the destination page or link to download the PDF.
CompanyContacts array
CompanyContacts arrayContact information that partners can use to contact the brand.
View child attributes
FirstName string
FirstName stringBrand representative's first name.
LastName string
LastName stringBrand representative's last name.
EmailAddress string
EmailAddress stringBrand representative's email address.
PhoneNumber string
PhoneNumber stringBrand representative's phone number.
GiftCardPayouts boolean
GiftCardPayouts booleanIf the program pays out on actions that were paid for with a gift card.
TrademarkBidding boolean
TrademarkBidding booleanIf the program allows partners to bid on using the brand's trademarked terms in marketing materials.
ThirdPartyImpressionPixel string
ThirdPartyImpressionPixel stringAny third-party tracking pixels used by the brand.
MobileReadyAds boolean
MobileReadyAds booleanIf the program's ads can be used on mobile browsers.
DisplayFutureAds boolean
DisplayFutureAds booleanIf partners can view ads that cannot yet be used.
PromoCodeTracking boolean
PromoCodeTracking booleanIf the program utilizes promo code tracking.
TrackingDomain string
TrackingDomain stringProgram's unique tracking link.
SiteDefinition string
SiteDefinition stringWhere the tracking domain points to.
ImpressionTracking boolean
ImpressionTracking booleanIf the program tracks ad impressions.
ViewThroughCrediting boolean
ViewThroughCrediting booleanIf the program tracks view-through conversions.
IdentityMatching enum
IdentityMatching enumHow the program matches traffic and conversion identities, usually across devices. Consumer data is hashed before it reaches impact.com.
| View possible enum values | |
|---|---|
NONE | impact.com will not use consumer data to match traffic to conversions. Not recommended. |
ACCOUNT | Utilize consumer data only within your account. |
IR_CONSORTIUM | Utilizes all consumer data across brands to match traffic and consumer identities. |
GatewayTrackingSettings object
GatewayTrackingSettings objectProgram's gateway tracking details.
View child attributes
DefaultLandingPage string
DefaultLandingPage stringDefault landing page of any given ad in the program.
MediaPartnerTrackingTemplate string
MediaPartnerTrackingTemplate stringParameters that are automatically appended to all landing pages for partners.
CampaignTrackingTemplate string
CampaignTrackingTemplate stringParameters that are automatically appended to all landing pages for a program.
SSLSupport boolean
SSLSupport booleanIf traffic will be directed to a secure version of the landing page. The landing page must support SSL for this to be true.
DeepLinking boolean
DeepLinking booleanIf the program allows partner deeplinking.
DeepLinkDomains string
DeepLinkDomains stringComma-separated list of the links partners can use to deeplink.
ThirdPartyGatewayUrl string
ThirdPartyGatewayUrl stringIf used, the third-party URL that traffic is directed through. Is empty if not used.
ThirdPartyGatewayQueryStringParameters string
ThirdPartyGatewayQueryStringParameters stringComma-separated list of parameters to be appended to the ThirdPartyGatewayUrl.
UniqueClickWindowLength enum
UniqueClickWindowLength enumMaximum amount of time between each click in a tracking session before it ends. Default is 30m.
| View possible enum values | |
|---|---|
1m | 1 minute. |
5m | 5 minutes. |
15m | 15 minutes. |
30m | 30 minutes. |
1h | 1 hour. |
6h | 6 hours. |
12h | 12 hours. |
24h | 24 hours. |
UniqueClickWindowType enum
UniqueClickWindowType enumWhether the click window is a fixed amount of time or if the time limit resets after each consecutive click.
| View possible enum values | |
|---|---|
FIXED | All clicks in a click window must occur within a fixed amount of time. |
ROLLING | The click window time limit resets after each consecutive click. |
DirectTrackingSettings object
DirectTrackingSettings objectProgram's direct tracking details.
View child attributes
UnidentifiedName string
UnidentifiedName stringName of the parameter used to segment and track unidentified traffic.
SessionWindowLength integer
SessionWindowLength integerAmount of time (in minutes) before an inactive session times out. Default time is 30 minutes.
Uri string
Uri stringThe program's direct URI.
{
"Id": "1000",
"Name": "Acme Campaign",
"State": "ACTIVE",
"Categories": {
"PrimaryCategory": "B2B, Services & Office Supplies",
"PrimarySubCategories": [
"B2B"
],
"AdditionalCategory": "",
"AdditionalSubCategories": []
},
"ShortDescription": "This is a short description.",
"LongDescription": "This is a long description. Find more words here.",
"ListInMarketplace": "true",
"DisplayServicingAgency": "false",
"Rating": "3",
"SearchKeywords": "Anvils",
"ShippingRegions": [
"United States"
],
"Resources": {
"CompanyHomepage": "www.acme.com",
"ExampleLandingPage": "",
"InformationPage": "",
"AdditionalRelatedLinks": []
},
"CompanyContacts": [
{
"FirstName": "Brand",
"LastName": "Man",
"EmailAddress": "[email protected]",
"PhoneNumber": "+1(805) 123-1234"
}
],
"GiftCardPayouts": "false",
"TrademarkBidding": "false",
"ThirdPartyImpressionPixel": "",
"MobileReadyAds": "false",
"DisplayFutureAds": "false",
"PromoCodeTracking": "true",
"TrackingDomain": "acme.sjv.io",
"SiteDefinition": "www.acme.com",
"ImpressionTracking": "false",
"ViewThroughCrediting": "false",
"IdentityMatching": "IR_CONSORTIUM",
"GatewayTrackingSettings": {
"DefaultLandingPage": "http://www.acme.com",
"MediaPartnerTrackingTemplate": "asd=1&foo=4&asf=2&clickid={clickid}",
"CampaignTrackingTemplate": "",
"SSLSupport": "true",
"DeepLinking": "true",
"DeepLinkDomains": "acme.com/store/forge/anvils/anvil2",
"ThirdPartyGatewayUrl": "",
"ThirdPartyGatewayQueryStringParameters": "",
"UniqueClickWindowLength": "30m",
"UniqueClickWindowType": "ROLLING"
},
"DirectTrackingSettings": {
"UnidentifiedName": "",
"SessionWindowLength": ""
},
"Uri": "/Advertisers/<AccountSID>/Campaigns/1000"
}