GET /programapplications/program/{id} /adspace/{id}/trackingcategories

Updated on
 
Returns the tracking categories, that specified advertiser program applies for a specified publisher's AdSpace. The return type trackingCategoryItem contains its ID, name and commissions (both fixed and percentual) that apply to this tracking category. See exact trackingCategoryItem definition in the Publisher API WSDL/XSD.
Default tracking category will always have ID zero.
This resource requires program ID and AdSpace ID as URL path parameters, which you can get from the program applications resource. Connectid, nonce, date and signature are required for authentication. See Authentication documentation for REST and SOAP. Passing authentication information as query parameters for REST is also supported.
 
This method does not use paging, all items will be returned in one page.

Resource URL

XML:   https://api.zanox.com/xml/2011-03-01/programapplications/program/{programid}/adspace/{adspaceid}/trackingcategories
JSON: https://api.zanox.com/json/2011-03-01/programapplications/program/{programid}/adspace/{adspaceid}/trackingcategories

Parameters

programid
required

URL path parameter. The ID of the advertiser program.

Value Type: Integer
Example Value: 1234

adspaceid
required

URL path parameter. The ID of the publisher AdSpace.

Value Type: Integer
Example Value: 1234

Example Request

REST authentication information must be included in request headers or added as query parameters

Get tracking categories for program 1234 and adspace 4321.

https://api.zanox.com/xml/2011-03-01/programapplications/program/1234/adspace/4321/trackingcategories

 

Example Response

 The default tracking category will be returned:

<GetTrackingCategoriesResponse xmlns="http://api.zanox.com/namespace/2011-03-01/">
<page>0</page>
<items>1</items>
<total>1</total>
<trackingCategoryItem>
  <trackingCategoryItem id="0">
   <name>default</name>
   <program id="1234">MyProgram</program>
   <adspace id="4321">MyAdSpace</adspace>
   <transactionType>sales</transactionType>
   <description>default</description>
   <saleFixed>0.0</saleFixed>
   <salePercent>8.0</salePercent>
  </trackingCategoryItem>
</trackingCategoryItem>
</GetTrackingCategoriesResponse>

 

Resource Information

Rate Limited? No
Authentication Requires signature. See
REST Authentication
SOAP Authentication
Response Formats json, xml
HTTP Methods GET
Resource family Tracking categories
Response Object trackingCategoryItem
API Version 2011-03-01