We are moving to the zanox developer portal!

Posted by Simas Aleksiejunas in Announcement , October 17th, 2013

zanox developer portal

We have been sending links to documentation in the developer portal for a while now, but it is time to make it official. The new zanox developer portal – https://developer.zanox.com is live and available for everyone. It will step-by-step phase out the current http://wiki.zanox.com and this blog, offering not only cleaner design and better documentation, but also community features, like an integrated developer blog and forum (which is coming soon) for news and your questions. The developer portal will be the central location to find help for zanox developer solutions, including Mobile SDKs, APIs, Media Container technology, MasterTag, AppStore and zanox Connect.
As of now, we have vastly improved Publisher API and Authentication (zanox OAuth) documentation, and we’re working hard to bring other product pages up to standard too. There are many features still planned for the developer portal, so stay tuned for more!
In the meanwhile, this blog will remain open as an archive for older posts, but all future updates will be posted on the developer portal only.

Retrieving all available programs via the Publisher API 2011

Posted by Simas Aleksiejunas in HowTo , May 15th, 2013

The end of last year marked the end-of-life and end of support for the 2009 version of the zanox Publisher API. Applications and tools, based on this API had to be migrated to use the newer – the 2011 version. Some helper tools that we have built for you at zanox will not be migrated, however, as we have made same data and functionality available in the newer version of the API.

One of such tools is the program catalog downloader, available under http://ui2.zanox.com/zxapp_programcatalog/download. As the name suggests, it lets you download the list of all programs (with descriptions), available at zanox. In this beginner-level How-To, I will demonstrate how to retrieve the same information from the 2011 Publisher API, with just a couple of clicks, even if you have never used the API before.

Step 1: get your API credentials
To do that, just login into zanox marketplace and under “Links & Tools” click  on the Web Services API > Getting Started.

On the Getting Started page, you will see your Connect ID and Secret Key, those are your API credentials. To retrieve the program list, you will only need your Connect ID.

Step 2: retrieve the program list
Insert your Connect ID into the following link (remove the curly brackets) and use it to retrieve the program list.
http://api.zanox.com/xml/2011-03-01/programs?connectid={Your Connect ID}&items=50&page=0

The result will be the first 50 programs and program details from the zanox program list in XML. 50 is the maximum number of items that our API can return in one page. The response will also include the total number of items:

<SearchProgramsResponse xmlns="http://api.zanox.com/namespace/2011-03-01/">

First page number is zero. To see the next result page use the page query parameter in the URL, as highlighted below:

http://api.zanox.com/xml/2011-03-01/programs?connectid={Your Connect ID}&items=50&page=1

You will have to write a small script to iterate through pages to retrieve the full list of programs. The results are available in XML or JSON. The response type is in the URL as highlighted below. This example would return JSON:

http://api.zanox.com/json/2011-03-01/programs?connectid={Your Connect ID}&items=50&page=1

So there you have it!

Issues with the Publisher API Java Client

Posted by Simas Aleksiejunas in Miscellaneous , May 13th, 2013

Our Java API client library is currently experiencing SSL connection problems and is not usable for SOAP protocol. The problem is unfortunately more complex than simply an expired certificate. Our team is working hard to prepare an updated version of the client and we will put it online as soon as it is ready. We will be updating this post with the latest information. We apologise for the inconvenience.

Please note, that the API itself and clients in other programming languages are not affected.

(13/05)Update 1: If you are using the client to retrieve own data (with own API credentials), you can work around this problem by switching to one of the REST protocols – JSON or XML. This will be transparent for your application. To do this, provide “xml” or “json” as a constructor parameter:

ApiInterface api = new ApiClient("xml").getService();
ApiInterface api = new ApiClient("json").getService();

Please note that you will not be able to use the zanox authentication methods such as GetSession or GetOfflineSession via REST.

(13/05)Update 2: We have a beta version of the updated Java client library for you – fresh from the IDEs of our developers. The SSL bug has been fixed and all methods can again be used via SOAP. If your application requires GetSession, GetOfflineSession and PromoteSession methods, we recommend you to give this version a go. Please note, this library is a fresh beta, so if the old library with REST enabled suffices for your application, we do not recommend to switch to this version. A fully tested version will be released after it passes our internal QA processes.

(download link removed, see the next update)

  • Removed all references to the Publisher API 2009 and zanox Connect 2009/2010 as all are discontinued

  • Switched to use zanox Connect 2011 (originally was 2010)

  • GetOfflineSession return type renamed and includes additional parameter “connectSessionToken” which will always be null for external developers

(16/05)Update 3: Based on your feedback, we have fixed quirks in the beta API client which caused exception when using dateType enum in REST getLeads/getSales methods and missing enumerator values in all method responses. You can download the updated version here: ApiClient_2011-03-01_1.03

Please note, that if you’re using this release, you can also go back to using the old trusted SOAP protocol, i.e. instantiate the client without constructor parameters:
ApiInterface api = new ApiClient().getService();

Spring cleaning at zanox: EOL for Data API 2009 and 2010

Posted by Simas Aleksiejunas in Announcement, APIs , March 19th, 2013

Spring is somewhat late in Germany – our HQ in Berlin is still covered in snow – but our DevOps are nevertheless in an energizing cleaning mood. Three years ago, zanox quietly launched an open beta of the Data API - an API which allows you to download click, lead and sale exports of the last 30 days. The 2009 version was extended by the 2010 and 2011 versions, which, among other small improvements, added custom reports and the REST interface respectively. We are currently running all three versions together. After the roll-out of the 2011 version, traffic on previous versions started reducing and as of today, the absolute majority of our customers have switched to the latest version.

Today we are announcing shutoff of the 2009 and 2010 Data API versions. On the 8th of April, we will be switching the default Data API endpoint https://data.zanox.com/soap and the default WSDL https://data.zanox.com/wsdl over to the 2011 version. The 2009 and 2010 endpoints and WSDLs will remain available under their fully-qualified URLs for one more week:

2009: WSDL https://data.zanox.com/wsdl/2009-11-01, Endpoint https://data.zanox.com/soap/2009-11-01
2010: WSDL https://data.zanox.com/wsdl/2010-08-12, Endpoint https://data.zanox.com/soap/2010-08-12
The fully-qualified WSDL and endpoint URLs for the latest version will not change.
2011: WSDL https://data.zanox.com/wsdl/2011-05-01, Endpoint https://data.zanox.com/soap/2011-05-01

On April 15, the 2009 and 2010 versions of Data API will be taken offline.

If you are one of the few, still using the 2009 or 2010 versions, you will have to migrate your client to use the latest version. The good news is that differences between versions are minor (WSDL cleanup and some new optional parameters), so migration should be quick and painless. For full Data API 2011 documentation please visit our wiki. Documentation contains a complete list of interface changes from 2009 to 2011 version, which is a good starting point for migration. If you need the Data API 2009 documentation for comparison, you can find it here.

Publisher API 2011 Release – Q & A

Posted by Pepe in APIs , May 18th, 2011

I’d like to take this opportunity to answer a few questions which have come up repeatedly since the 2011 release of the Publisher API.

Feel free to add your own questions in the comments, or better yet, join our mailing list, which is the main forum for communication regarding zanox Web Services.

How does the new incentives resource work?

There are two types of incentives: exclusive and non-exclusive.

Non-exclusive incentives are visible to all zanox publishers, whether or not they have applied to the program offering the incentive. If you do a simple “get all” (i.e. http://api.zanox.com/xml/2011-03-01/incentives?connectid=__YOUR_CONNECT_ID__), tracking links will be returned as follows:

  • if the incentive is for a program you belong to, you get a tracking link for the ad space(s) you used to apply;

  • some zanox programs participate in a public ad media pool; if the incentive is in one of these programs, you get a tracking link for each of your ad spaces; and

  • if you are not applied to the program and the program does not participate in the ad media pool, you get the incentive without a tracking link.

If you restrict your query to a specific ad space (i.e. http://api.zanox.com/xml/2011-03-01/incentives?&adspace=__YOUR_AD_SPACE__&connectid=__YOUR_CONNECT_ID__), you will only see incentives for the programs you have applied to, and for those participating in the public ad media pool.

Exclusive incentives are a completely different set of incentives, and are only visible to publishers who have been explicitly granted permission to use an incentive by its program. If you are interested in using exclusive incentives, please contact your Account Manager.

For more information, please see http://wiki.zanox.com/en/REST_V2011-03-01_Incentives.

Where are the program commission models?

Commissions were removed from the ProgramItem in the 2011 Publisher API. Our next release will feature a more comprehensive solution to commissions, including publisher-specific commissions.

For now, you can continue using the 2009 version, which will be available until 2012-03-01 per our migration strategy. You can make this call via a direct URL, e.g. http://api.zanox.com/xml/2009-07-01/programs/program/123?connectid=__YOUR_CONNECT_ID__

What happened to “GetProgramsByAdspsace”?

GetProgramsByAdspace has been replaced by the  concept of “program applications”. The “status” field allows you to query program applications by status, whereas GetProgramsByAdspace only returned your active (“confirmed”) program memberships. Other possible values for “status” are “open”, “rejected”, “deferred”, “waiting”, etc.

For instance, the following screenshot of the zanox API Explorer shows all unsuccessful program applications for ad space “1373732” (advertisers don’t seem to like “pepeciardelli.com” very much!):

For more information, please see http://wiki.zanox.com/en/REST_V2011-03-01_ProgramApplications.

Neues aus dem zanox Application Store: Handys ohne Vertrag

Posted by Francesco in Application Store , December 16th, 2010

Heute wollen wir Euch eine neue App vorstellen: Handys ohne Vertrag!

Immer mehr Nutzer in Deutschland kaufen Ihr Handy nicht mehr im Bundle mit einem Handy Vertrag. Diese App hilft bei der Suche nach dem passenden Handy.

Alle in der App aufgeführten Handys sind ohne Vertrag und ohne Simlock, so dass sie mit jedem Vertrag egal ob normaler Handyvertrag, Prepaid Karte oder Handyflat nutzbar sind.

Mit der App erhält man ein Werbemittel, das die Preise der Handys/Smartphones bei verschiedenen zanox Merchants vergleicht.

Das Werbemittel gibt es als Wide Skyscraper (160×600) bzw. als Medium Rectangle (300×250) .
Willst Du die Anwendung gleich ausprobieren? Hier gehts zur App.

Vodafone WordPress Plugin

Posted by Francesco in Application Store , November 1st, 2010

Vodafone just launched its second Application. After the success of the product widget Vodafone created now a wordpress plugin that publishers can easily install. 
The plugin detects if words on the text match with Vodafone product data and automatically offers user more details on the product. In this way publishers can focus in writing articles while the application places the proper tracking link.

Here you are a screenshot on how it will look like:

The application can be downloaded here

Loved.by – Transforms Links automatically into Tracking Links

Posted by Francesco in Application Store , October 21st, 2010

Loved.by just launched its service in the zanox Application Store. It is a simply javascript for blogs and websites that let you focus on your own content.

When you share links to products you love in your blog or website this Javascript automatically identifies those links which point to partner shops and transforms these to tracking links in the moment they are clicked.

You no more need to search and select tracking links while writing a blog post or adding content to your website as you can simply paste the product link and let the Loved.by Javascript transform it to a tracking link.

Loved.by is configured with revenue sharing, with 75% of the revenues are credited to the publisher and 25% to Loved.by.

The Javascript is very easy to install, you can download it here from the zanox Application Store.

Moodmixer’s Orion widget: Sex sells!

Posted by Francesco in APIs, Application Store , June 28th, 2010

Moodmixer did it again! After launching a serier of multi advertiser widget are now creating dedicated product widgets for our advertisers. The latest is launched this week.

This Orion widget is an extreme eyecatcher for your users. You can configure the default search criteria and let user just “flip” the catalouge or let them search for the products that match their interests ;-)

Here you are a screenshot:

Do you want to give it a try? Get the widget in the zanox Application Store.

Rotato: product rotating widgets

Posted by Francesco in APIs, Application Store , June 16th, 2010

Rotato is a product adserving widget generator. Publisher can create 2 different types of product rotating adservers:

  • one with Manual targeting

  • one with Automatic targeting

In the first scenario Publishers are allowed to select specific products from their active partnerships while in the second they can specify the search criteria to let the widget find and display always up-to-date products using the zanox API.

The manual targeting requires more maintenance but allows on the other side more control to the publisher and let them posssibly optimise the displayed products by click trough rate.

Finally publishers can always choose between 2 different css with product preview or simple product list or eventually provide their own css to the widget.

Below you find a couple of screenshot to show the look and feel once using the provided css:


You can get the application in the zanox Application Store here.