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. 1) Authenticate
2. 2) Do what you want
3. 3) Logout

In order to authenticate we make a call like this:

[php]
$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'],
)
[/php]

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:

[php]
$today=date(“Y-m-d”);
$money = $soapclient->call(‘getSubHits’,
array (
“login_hash” => $hash,
“affiliate_id” => $params['ID'],
“offer_id” => ALL,
“start_date” => date(“$today”),
“end_date” => date(“$today”),
“traffic_type_id” => “”,
“sales_only” => true
)
);
print_r($money);
[/php]

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.

[php]

$msg = $soapclient->call(‘logout’,
array (“login_hash”=>$hash));
[/php]

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.

[php]
################ 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 ############

$today=date("Y-m-d");

$login_info = array (
"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) {
die(‘no connection to Azoogle’);
}

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,
“start_date” => date(“$today”),
“end_date” => date(“$today”),
“traffic_type_id” => “”,
“sales_only” => true
)
);

// yields empty response all the time

print_r($hits);

$msg = $soapclient->call(‘logout’,
array (“login_hash”=>$hash));

// prints ‘Logged out successfully.’
echo $msg;

?>
[/php]

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!

About the author...

Jeremy Schoemaker – who has written 2415 posts on ShoeMoney.com.

Hi I am Jeremy Schoemaker and ShoeMoney.com is my blog. 99% of the post here are done by me but you will see others occasionally make guest posts. This blog is fun to write but for my day job I run several online companies.

Images provided by ShutterStock

Mark recommends you read these posts also:

1. My Basic 3 Pronged Approach To Website Analytics
2. Things Internet Marketers Can Learn From The Pickup Artist
3. If I could – starting over