My favorites | English | Sign in

Faster apps faster - GWT 2.0 with Speed Tracer New!

FAQ - Reporting

How do I know how many AdSense API referrals I've had and what my AdSense API referral earnings are?

When you log into your Google AdSense account your AdSense API referral earnings will be displayed in the Referrals section on the overview screen. The information displayed on the overview screen is a bit different from other referral programs, as described below.


For AdSense API referrals, "clicks" correspond to the number of new publisher accounts created. "CTR" (Click through rate) has no meaning with the AdSense API and this column should be ignored. "Sign-ups" will always be zero -- AdSense API sign-ups are reported as clicks. There are three possible types of "conversions": a $5 conversion when a publisher reaches $5 in earnings, a $250 conversion when a publisher reaches $100 in earnings, and a $2000 bonus conversion that a developer is eligible for once a year when 25 publishers each reach $100 in earnings. All three types are counted as a single conversion and are tracked collectively in the Conversions column. In the above example, the developer has had five $5 conversions and one $250 conversion. For more information on AdSense API referrals, see the referral bonuses page.

How do I read the earnings report for my API earnings?



The AdSense API earnings report shows aggregated earnings for all ads that contained your developer id which appeared on your publishers' pages. The report is very similar to the earnings report that you see for the regular AdSense program, with one difference. The API report shows ad unit impressions, ad unit CTR (click through rate), and ad unit eCPM instead of impressions, CTR, and eCPM. An "ad unit" is the ad or group of ads that a single AdSense JavaScript code snippet generate. Often an ad unit contains three to five ads.

For each line of this chart, two equations are relevant, one relates impressions and CTR and another relates impressions and eCPM. The relationship between clicks and CTR is defined by

Ad unit CTR = ((Ad unit impressions) / (Clicks)) * 100

The relationship between impressions and eCPM is defined by

Ad unit eCPM = (Earnings) / ((Ad unit impressions) / 1000))

Remember that all numbers are rounded to two decimal places.

Something to keep in mind when looking at eCPM on this report is that the eCPM is post-revenue share. If this developer is keeping 30%, the "total" eCPM is actually $1.10. The aggregate eCPM for this developer's publishers from the API is $0.77, reflecting the 70% of the revenue they are getting.