Da zum Webservice des Affiliate-Netzwerks Webgains keine einfache Anleitung verfügbar ist (oder ich sie zumindest nicht finden kann), möchte ich an dieser Stelle ein kleines PHP-Beispiel der Abfrage der vom Webservice bereitgestellten Daten anbringen.

Es handelt sich um einen SOAP-Webservice, für den PHP einen Client mitbringt, sofern das Modul aktiviert wurde. Dieser Client wird mit den Webservice-Einstellungen erstellt:

// create a new soap client
$webgainsClient = new SoapClient (
    NULL,
    array (
        "location"   => "http://ws.webgains.com/aws.php",
        "uri"        => "urn:http://ws.webgains.com/aws.php",
        "style"      => SOAP_RPC,
        "use"        => SOAP_ENCODED,
        'exceptions' => 0
    )
); 

An den Client können dann die im Webservice angegebenen Anfragen übermittelt werden, beispielhaft hier die getEarnings-Methode, die als Parameter Start- und Enddatum, die Kampagnen-ID (diese Kampagnen-ID findet man hier) und die Logindaten erwartet:

// configuration
define ('LOGIN_MAIL',     'test@test.de');
define ('LOGIN_PASSWORD', 'passwort');
define ('CAMPAIGNID',     12345);
 
$dateStart = date('Y-m-d', time()-7*86400).' 00:00:00';
$dateEnd   = date('Y-m-d H:i:s');
 
 
// send earnings request
 
$earningsResult = $webgainsClient->getEarnings($dateStart, $dateEnd, CAMPAIGNID, LOGIN_MAIL, LOGIN_PASSWORD);

Durch das Ergebnis des Aufrufs kann dann iteriert und auf die Eigenschaften jedes Datensatzes (hier $item->commission) zugegriffen werden:

if (is_soap_fault($earningsResult)) {
   // error handling
} else {
    foreach ($earningsResult as $item) {
        echo "<br />".$item->commission;
    }
}

Natürlich können pro Scriptaufruf auch mehrere Anfragen an den Webgains Webservice gestellt werden. Eine mögliche Verwendung für den Service könnte etwa ein RSS-Feed sein, der bei neuen Provisionen Bescheid gibt, oder ein Affiliate-Dashboard, auf dem die Zahlen mehrerer Netzwerke zusammen dargestellt werden.

Referenzen:

• Webgains: http://www.webgains.de
• Webservice-URL: http://ws.webgains.com/aws.php
• PHP SOAP-Client: http://php.net/manual/de/book.soap.php

Gesamtes Script:

 
// configuration
define ('LOGIN_MAIL',     'test@test.de');
define ('LOGIN_PASSWORD', 'passwort');
define ('CAMPAIGNID',     12345);
 
$dateStart = date('Y-m-d', time()-7*86400).' 00:00:00';
$dateEnd   = date('Y-m-d H:i:s');
 
// create a new soap client
$webgainsClient = new SoapClient (
    NULL,
    array (
        "location"   => "http://ws.webgains.com/aws.php",
        "uri"        => "urn:http://ws.webgains.com/aws.php",
        "style"      => SOAP_RPC,
        "use"        => SOAP_ENCODED,
        'exceptions' => 0
    )
);
 
// send earnings request
 
$earningsResult = $webgainsClient->getEarnings($dateStart, $dateEnd, CAMPAIGNID, LOGIN_MAIL, LOGIN_PASSWORD);
 
if (is_soap_fault($earningsResult)) {
   // error handling
} else {
    foreach ($earningsResult as $item) {
         echo "<br />".$item->commission;
    }
}
 

Affiliate, Technik, Webgains, Webservice | Kommentare und Trackbacks sind derzeit nicht erlaubt