Help Center > Manage Your Account > AdSpeed API

Publisher

Documentation for API methods to manage a publisher account.

API Version

1.2.7 (build 20110606). Documentation was last modified on Sun, 29 Jan 12 20:25:55 -0500. Since the API methods and response format can change from one version to another, you should check this page frequently for updates.

API Methods - Publisher

AS.Publisher.getStats

Returns stats for the whole publisher account. Limit 50 calls/day
Parameters
  • metric (Required)
    The type of metric can be "impressions", "clicks" or "revenue"
  • period (Required)
    The breakdown period can be "hourly", "daily", or "monthly"
Sample Request
Sample Response
<StatRows generated="Sun, 29 Jan 12 20:25:55 -0500" title="Report: Monthly  for [Publisher] demo">
  <StatRow>
    <Monthly>January 2012</Monthly>
    <Unique_Impression>9,323</Unique_Impression>
    <Gross_Impression>18,809</Gross_Impression>
    <Unique_over_Gross_Impression>49.57%</Unique_over_Gross_Impression>
  </StatRow>
  <StatRow>
    <Monthly>December 2011</Monthly>
    <Unique_Impression>10,583</Unique_Impression>
    <Gross_Impression>21,148</Gross_Impression>
    <Unique_over_Gross_Impression>50.04%</Unique_over_Gross_Impression>
  </StatRow>
  <StatRow>
    <Monthly>November 2011</Monthly>
    <Unique_Impression>9,696</Unique_Impression>
    <Gross_Impression>19,342</Gross_Impression>
    <Unique_over_Gross_Impression>50.13%</Unique_over_Gross_Impression>
  </StatRow>
  <StatRow>
    <Monthly>October 2011</Monthly>
    <Unique_Impression>9,669</Unique_Impression>
    <Gross_Impression>19,176</Gross_Impression>
    <Unique_over_Gross_Impression>50.42%</Unique_over_Gross_Impression>
  </StatRow>
  <StatRow>
    <Monthly>September 2011</Monthly>
    <Unique_Impression>10,064</Unique_Impression>
    <Gross_Impression>19,947</Gross_Impression>
    <Unique_over_Gross_Impression>50.45%</Unique_over_Gross_Impression>
  </StatRow>
  <StatRow>
    <Monthly>August 2011</Monthly>
    <Unique_Impression>10,388</Unique_Impression>
    <Gross_Impression>20,633</Gross_Impression>
    <Unique_over_Gross_Impression>50.35%</Unique_over_Gross_Impression>
  </StatRow>
  <StatRow>
    <Monthly>July 2011</Monthly>
    <Unique_Impression>9,982</Unique_Impression>
    <Gross_Impression>20,011</Gross_Impression>
    <Unique_over_Gross_Impression>49.88%</Unique_over_Gross_Impression>
  </StatRow>
  <StatRow>
    <Monthly>June 2011</Monthly>
    <Unique_Impression>9,428</Unique_Impression>
    <Gross_Impression>19,119</Gross_Impression>
    <Unique_over_Gross_Impression>49.31%</Unique_over_Gross_Impression>
  </StatRow>
  <StatRow>
    <Monthly>May 2011</Monthly>
    <Unique_Impression>10,608</Unique_Impression>
    <Gross_Impression>20,848</Gross_Impression>
    <Unique_over_Gross_Impression>50.88%</Unique_over_Gross_Impression>
  </StatRow>
  <StatRow>
    <Monthly>April 2011</Monthly>
    <Unique_Impression>10,217</Unique_Impression>
    <Gross_Impression>20,415</Gross_Impression>
    <Unique_over_Gross_Impression>50.05%</Unique_over_Gross_Impression>
  </StatRow>
  <StatRow>
    <Monthly>March 2011</Monthly>
    <Unique_Impression>10,123</Unique_Impression>
    <Gross_Impression>20,165</Gross_Impression>
    <Unique_over_Gross_Impression>50.20%</Unique_over_Gross_Impression>
  </StatRow>
  <StatRow>
    <Monthly>February 2011</Monthly>
    <Unique_Impression>9,110</Unique_Impression>
    <Gross_Impression>18,121</Gross_Impression>
    <Unique_over_Gross_Impression>50.27%</Unique_over_Gross_Impression>
  </StatRow>
  <StatRow>
    <Monthly>Total</Monthly>
    <Unique_Impression>119,191</Unique_Impression>
    <Gross_Impression>237,734</Gross_Impression>
    <Unique_over_Gross_Impression>50.14%</Unique_over_Gross_Impression>
  </StatRow>
  <StatRow>
    <Monthly>Average</Monthly>
    <Unique_Impression>9,933</Unique_Impression>
    <Gross_Impression>19,811</Gross_Impression>
    <Unique_over_Gross_Impression>50.14%</Unique_over_Gross_Impression>
  </StatRow>
</StatRows>

AS.Publisher.getVisitorStats

Returns visitor profile stats for the whole publisher account. Limit 50 calls/day
Parameters
  • metric (Required)
    The type of metric can be "countries", "continents", "areas", "regions", "languages", "timezones"
  • range (Required)
    The range can be "alltime"
Sample Request
Sample Response
<StatRows generated="Sun, 29 Jan 12 20:25:56 -0500" title="Geographical report for [Publisher] demo" range="Alltime" metric="countries">
  <StatRow>
    <Rank>1</Rank>
    <Country>United States</Country>
    <Flag/>
    <Percentage>70.54%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>2</Rank>
    <Country>United Kingdom</Country>
    <Flag/>
    <Percentage>15.98%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>3</Rank>
    <Country>Canada</Country>
    <Flag/>
    <Percentage>1.24%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>3</Rank>
    <Country>India</Country>
    <Flag/>
    <Percentage>1.24%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>5</Rank>
    <Country>Philippines</Country>
    <Flag/>
    <Percentage>1.04%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>6</Rank>
    <Country>Germany</Country>
    <Flag/>
    <Percentage>0.83%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>7</Rank>
    <Country>Australia</Country>
    <Flag/>
    <Percentage>0.52%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>7</Rank>
    <Country>Japan</Country>
    <Flag/>
    <Percentage>0.52%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>7</Rank>
    <Country>France</Country>
    <Flag/>
    <Percentage>0.52%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>10</Rank>
    <Country>Netherlands</Country>
    <Flag/>
    <Percentage>0.41%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>10</Rank>
    <Country>Spain</Country>
    <Flag/>
    <Percentage>0.41%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>10</Rank>
    <Country>Italy</Country>
    <Flag/>
    <Percentage>0.41%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>10</Rank>
    <Country>Taiwan</Country>
    <Flag/>
    <Percentage>0.41%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>10</Rank>
    <Country>Switzerland</Country>
    <Flag/>
    <Percentage>0.41%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>15</Rank>
    <Country>Greece</Country>
    <Flag/>
    <Percentage>0.31%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>15</Rank>
    <Country>Poland</Country>
    <Flag/>
    <Percentage>0.31%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>15</Rank>
    <Country>China</Country>
    <Flag/>
    <Percentage>0.31%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>15</Rank>
    <Country>Bangladesh</Country>
    <Flag/>
    <Percentage>0.31%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>15</Rank>
    <Country>Hong Kong</Country>
    <Flag/>
    <Percentage>0.31%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>15</Rank>
    <Country>Czech Republic</Country>
    <Flag/>
    <Percentage>0.31%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>15</Rank>
    <Country>South Korea</Country>
    <Flag/>
    <Percentage>0.31%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>15</Rank>
    <Country>Sweden</Country>
    <Flag/>
    <Percentage>0.31%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>23</Rank>
    <Country>Thailand</Country>
    <Flag/>
    <Percentage>0.21%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>23</Rank>
    <Country>Finland</Country>
    <Flag/>
    <Percentage>0.21%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>23</Rank>
    <Country>Israel</Country>
    <Flag/>
    <Percentage>0.21%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>23</Rank>
    <Country>Russian Federation</Country>
    <Flag/>
    <Percentage>0.21%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>23</Rank>
    <Country>Belgium</Country>
    <Flag/>
    <Percentage>0.21%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>23</Rank>
    <Country>Egypt</Country>
    <Flag/>
    <Percentage>0.21%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>23</Rank>
    <Country>Pakistan</Country>
    <Flag/>
    <Percentage>0.21%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>30</Rank>
    <Country>Tanzania</Country>
    <Flag/>
    <Percentage>0.10%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>30</Rank>
    <Country>Brazil</Country>
    <Flag/>
    <Percentage>0.10%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>30</Rank>
    <Country>Ireland</Country>
    <Flag/>
    <Percentage>0.10%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>30</Rank>
    <Country>Kuwait</Country>
    <Flag/>
    <Percentage>0.10%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>30</Rank>
    <Country>South Africa</Country>
    <Flag/>
    <Percentage>0.10%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>30</Rank>
    <Country>Iran</Country>
    <Flag/>
    <Percentage>0.10%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>30</Rank>
    <Country>Nigeria</Country>
    <Flag/>
    <Percentage>0.10%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>30</Rank>
    <Country>Denmark</Country>
    <Flag/>
    <Percentage>0.10%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>30</Rank>
    <Country>Kenya</Country>
    <Flag/>
    <Percentage>0.10%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>30</Rank>
    <Country>Ukraine</Country>
    <Flag/>
    <Percentage>0.10%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>30</Rank>
    <Country>Latvia</Country>
    <Flag/>
    <Percentage>0.10%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>30</Rank>
    <Country>Ghana</Country>
    <Flag/>
    <Percentage>0.10%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>30</Rank>
    <Country>Nicaragua</Country>
    <Flag/>
    <Percentage>0.10%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>30</Rank>
    <Country>Croatia</Country>
    <Flag/>
    <Percentage>0.10%


</Percentage>
  </StatRow>
  <StatRow>
    <Rank>30</Rank>
    <Country>Mexico</Country>
    <Flag/>
    <Percentage>0.10%


</Percentage>
  </StatRow>
</StatRows>
Print

Other Articles in AdSpeed API

Documentation about building applications with AdSpeed API
Search Help Center
There was a problem with your submission. Please correct the following items:

    Cannot find an answer for your question? Ask our Customer Care team

    Related Articles

    Have questions? Contact Us

    Testimonials for our Ad Servers

    • I am extremely pleased with AdSpeed. Their technology has made our business shine with improved profits, mostly due to their unique ad server and amazing support. There is no other company I would even consider to compare to AdSpeed.

      Markus S.
      CEO, Dream Ware Enterprise

    • That was fast and works exactly right! Thanks again for your superb support!

      Dr Tom Bailey
      Aquarium Fish

    Help Center


    i

    Blog

    February 04, 2012

    How does video ad serving work? - Video advertising has proven itself as an effective advertising platform since the first television advertisement in 1941. As more and more viewers watch television programs, music videos, Internet shows, and viral clips on the Internet, advertisers gain interest in the market.

    read more
    December 22, 2011

    Happy Holidays! - Our 11th year in the ad serving business is winding down with more than 30 billions ads served to satisfaction. Online advertising continues to be the leading edge of technology and marketing.

    read more

    Ad Serving

    Ad Serving is the process of placing advertisements on web sites, mobile devices, and applications.

    Ad Servers

    Ad Servers are technology companies with software and infrastructure to enable publishers and advertisers to select and display the most suitable, most profitable, most targeted ads to their audience. Ad servers monitor and report ad views, ad clicks and performance of advertising campaigns.

    © 2012 AdSpeed® Ad Server. All rights reserved.
    Ad Serving | Ad Servers | Ad Tracking