AzoogleAds Soap API With PHP4
I have been wanting to use the AzoogleAds SOAP API (Advanced Programing Interface) for some time now. Its one of those things that was "on the list" to get to eventually. Last week I got a wild hair and played around with it. I downloaded their PDF but kept getting all kinds of errors when trying to follow it. I pinged some of their developers and they told me to disregard the documentation and helped me get it working.
When I was searching the web I also noticed a lot of other people having the same problems I was so I thought I would post some very basic instructions to get it working.
The first thing you need to do is download the Nusoap library to proccess the SOAP stuff.
Unpack it somewhere on your server.
The first like of your code you will need to include where the nusoap file is like:
include_once "/home/websites/dev/lib/nusoap.php";
Each call to the API basically works like this.
- 1) Authenticate
- 2) Do what you want
- 3) Logout
In order to authenticate we make a call like this:
-
$host = "https://home.azoogleads.com/soap/azads2_server.php";
-
$soapclient = new nusoap_client($host);
-
-
$hash = $soapclient->call('authenticate',
-
array (
-
"affil_id" => $params['ID'],
-
"login" => $params['login'],
-
"passhash" => $params['password'],
-
)
The above code will give us our authentication "$hash" which we will need from now on in making requests to the API.
Next I want to make a call to the API that will give me all my revenue for today. So here is the code for that:
A couple things. As you can see you can start at a certain time and end at a certain time.
This outputs an array of data something like this (offer ids are changed to prevent saturation
):
Array
(
[0] => Array
(
[hits] => 822
[leads] => 63
[amount] => 567.000000
[sub] => d15
[offer_id] => 1000
)
[1] => Array
(
[hits] => 2
[leads] => 1
[amount] => 2.350000
[sub] => altd15
[offer_id] => 1000
)
[2] => Array
(
[hits] => 59
[leads] => 2
[amount] => 1.000000
[sub] => alt2d15
[offer_id] => 1000
)
[3] => Array
(
[hits] => 66
[leads] => 1
[amount] => 9.000000
[sub] => super
[offer_id] => 1000
)
)
There are all kinds of functions you can do... search offers... whatever. Check the official AzoogleAds docs (its in your account) for more specifics.
Now when we are all done we need to logout.
-
$msg = $soapclient->call('logout',
And we are done.
Here is my full script putting everything all together. All you should need to do is download the soap library and input your account information.
-
<?
-
################ EDIT THIS ###############
-
include_once "/path/to/nusoap.php";
-
-
$loginid='put your username here';
-
$password='put your password here';
-
$affid='put your 5 digit affiliate id here';
-
-
################ STOP EDITING ############
-
-
-
"AZOOGLE" => array ( 'login' => "$loginid", 'password' => "$password", 'ID' => "$affid"), // confirmed
-
);
-
-
$params = $login_info['AZOOGLE'];
-
-
$host = "https://home.azoogleads.com/soap/azads2_server.php";
-
$soapclient = new nusoap_client($host);
-
-
$hash = $soapclient->call('authenticate',
-
array (
-
"affil_id" => $params['ID'],
-
"login" => $params['login'],
-
"passhash" => $params['password'],
-
)
-
);
-
-
if (!$hash) {
-
}
-
-
echo "Connected to Azoogle ($hash)\n";
-
-
// now I have the connection ($hash)
-
// load the sub report
-
-
//array getSubHits(string login_hash, int affiliate_id, int offer_id, string start_date, string end_date, int traffic_type_id = null, boolean sales_only = null)
-
// I use affil_id instead of affiliate_id because 'authenticate' function returns the connection handle, so I assume the parameter name is right
-
-
-
$hits = $soapclient->call('getSubHits',
-
array (
-
"login_hash" => $hash,
-
"affiliate_id" => $params['ID'],
-
"offer_id" => ALL,
-
"traffic_type_id" => "",
-
"sales_only" => true
-
)
-
);
-
-
// yields empty response all the time
-
-
-
$msg = $soapclient->call('logout',
-
-
// prints 'Logged out successfully.'
-
echo $msg;
-
-
-
?>
So what can you do with this now? Well you can format the array and pass it to mail so it can email you updates throughout the day. You could get more advanced and set thresholds throughout the day...
If you want to get really badass you could tie it into the Adwords API and crank up or lower your spend on specific keywords based on trends.
APIS ROCK!
- 47 Comments. What say you?
- RSS
- Delicious
- StumbleUpon
- Furl
- Digg











PHP4? Don’t you think that’s a bit dangerous, now that it’s not even supported?
[Reply]
Looking good to use API,
but sometimes is hard to setup without pro help!
[Reply]
API == Application Programming Interface
API != Advanced Programming Interface
[Reply]
lol thats probably why I am not a programmer
[Reply]
i’m pretty messed up ryt now with API and have been really trying to learn a lot about it…
[Reply]
That hurt my brain a little bit! Too much to think about.
[Reply]
Shoe THANKS I just tested and it works perfectly.
I also was one of those who “some day” was going to do this.
[Reply]
What the hell are you talking about? That went way over my head!
[Reply]
Hmm interesting, I just signed up with azoogle last week so I’ll have to check this out
[Reply]
Thanks Jeremy, I started writing PHP web services this month with NuSoap so it’s great to see a real-world example.
[Reply]
I’m gonna go ahead and guess you’ve never done anything worthwhile in your life.
[Reply]
If you want forward compatibility I would definitely suggest staying away from php4 and nusoap. PHP5 has a soap library in core - http://www.php.net/manual/en/ref.soap.php.
[Reply]
confusing to say the least!
[Reply]
Yeah it looks confusing.
[Reply]
a nerd post, sweet!
[Reply]
Can you send me the script after you have dillsmack program it to adjust ad spend based on campaign performance? Thanks.
[Reply]
i joined azoogle ads..but no luck huhu
[Reply]
Thanks a lot for the code but I think it should also work for PHP5 as well…
@ v1nce - nusoap client library is easier to use and provide much easier coding to consume and provide web services than the PHP5’s built in soap library…
[Reply]
Never gone so much in detail into coding before. I guess I’ll just leave that to the pros.
[Reply]
Thanks for your time to put this one ur site….
[Reply]
Hahahahah….that’s a bit tough on the poor chap, ain’t it?
[Reply]
That’s why we love your site, Jeremy. Information like this is priceless. Noe let’s see how well you rank in Google for your keywords, so the whole world can find these instructions when they encounter similar issues with AzoogleAds Soap API.
[Reply]
#1 on Google for “azoogle ads soap api problems” - excellent!
[Reply]
im sure theres a 3rd party app already available to track your commissions daily
[Reply]
Azoogle is not good, they dont accept me
[Reply]
The API has been around for a while. It simply didn’t work for me either. I use .Net though. I’ll have to try it again now and hopefully do a write up for that programming language.
[Reply]
LOL Too funny…
You could consider your self a programmer because you do have experience with it. It’s just not your thing like you said, but that’s funny. I got a bit humor out of it :).
[Reply]
I am soooo glad I’m not a coder / developer. It all looks like greek to me!
[Reply]
A BIG nerd post too! Dunno how developers can live with all this code. Scary stuff.
[Reply]
haha.
[Reply]
Nerd posts help people out big time. I was looking for examples before and I found zilch! Thanks again shoe.
[Reply]
Yes, they are very bad at accepting new unproven people. Personally I kept sending them emails until I was accepted. I also named dropped Shoe’s real names and led them to believe we were friends. I didn’t lie about it, just led Azoogle to believe it. It all worked out and last year I brought in over $100,000 in revenue for them.
[Reply]
How can you be in PPC and not know a thing about programming?
[Reply]
No problem at all
[Reply]
APIs Rock indeed, thanks for the details Shoe.
[Reply]
I just joined them too, used Shoes affiliate Link.
[Reply]
Easy, just some PHP.
[Reply]
na, scripts written in php4 will still continue to run. nothing fancy with the code above too.
[Reply]
Where’d you get that assumption from? Am I missing something?
[Reply]
ehhggg, that’s too complicated to apply! How do you lean these stuff J ?
[Reply]
I agree with you PPC, its all code to me.
[Reply]
Thats simple, its a marketing position, no need for development.
[Reply]
cool working fine. Yes good to use API its rocks. Thanks again for such detail code.
[Reply]
Cool! I like to work with API’s. You can customize better the appearance, select only the information you want and extend and change the functionality of the standard features
. I pin this post in my reader in case I apply Azoogle.
[Reply]
Man, I hate azoogle…
[Reply]
[...] on: June 29th, 2008 Shoemoney, John, Chow, Ken McArthur, as well as the whole cast & crew of Top Affiliate Challenge and some [...]
[...] If you should pick one affiliate network, which one would it be? ShoeMoney: For me Azoogleads. Their reporting API is the best I have come across and they have the best offers for what we [...]