Sub-ID management with GPP

From Wiki.zanox.com

What does GPP stand for?

GPP is short for general purpose tracking parameters and consists of a series of alpha numeric parameters available for publishers. When a potential customer clicks a publisher's ad media link and GPP parameters are filled in, then the values are stored in the zanox tracking system.

In case the customer generates a conversion the stored GPP values are then retrieved from the zanox tracking system and placed in the statistics for the publisher to see. GPP is basically a container which publishers can use to place their own tracking information (e.g. Sub IDs) onto conversions. In the medium term GPP will replace the current parameter used to do this, SIDE.

Parameter naming convention

GPP is comprised of 10 individual parameters which are consecutively numbered according to the following naming convention:

zpar0, zpar1, zpar2, … zpar9

The parameters zpar0 to zpar4 can be freely used by publishers for any purpose. The parameters zpar5 to zpar9 are reserved by zanox for internal use. For instance, parameter zpar9 is used by the zanox Application Store. Publishers can access the zanox-internal parameters via the user interface (see Accessing GPP via the user interface) and select the parameters they want to display in the statistical reports.

Parameter format and size

Use one of the following formats to pass a GPP in the tracking code:

zparx=[[value]]
zparx=value

Replace x with the number of the parameter you would like to use and replace value with any alphanumeric string of characters that you wish to pass to the tracking system.

The overall volume of all used parameters must not exceed 4k. Also, please keep in mind that the number of characters you can pass in the URL may be limited. zanox therefore strongly recommends not to use more than 1024 characters for the total of GPP you are using in one request.

Supported zanox technologies

The following applications and technologies support GPP:

PPC (click application)
TPV (True Post View application)
GAP (Global Alliance Partner technology)

NOTE: Please note that TPV only supports the GPP zpar0.

Implementing GPP in the tracking code

You can implement GPP in your tracking code in the following ways:

Example for PPC:

http://ad.zanox.com/ppc/?1234c5678&zpar0=[[value]]&zpar1=[[value]]

Example for TPV:

http://ad.zanox.com/tpv/?1234c5678&zpar0=[[value]]

Support for GAP

GPP zpar0 can be used as parameter in GAP requests. In order to implement GPP in GAP requests please place the parameters in your ad media links as shown above and let your account manager know how you would like it to appear in your GAP pixel. An example of the beginning-end process is outlined below:

Implementation of GPP in the tracking code

Click code:

http://ad.zanox.com/ppc/?1234c5678T&zpar0=[[helloGPPSubID=12345]]

Transaction code:

http://ad.zanox.com/ppx/?1234c5678&product=[[1]]&totalprice=[[12,5]]

Provided publisher conversion pixel

http://www.ihre-domain.com/site21/?##zpar0##&conversion=##totalprice##

Resulting GAP request

http://www.ihre-domain.com/site21/?helloGPPSubID=12345&totalprice=12,5

Activating GPP

GPP does not require any activation via the user interface. Publishers may use the parameters at any time by following the instructions outlined in this article.

NOTE: For migration purposes you may use both GPP and the SIDE parameter simultaneously.

Accessing GPP via the user interface

In the zanox user interface publishers can access GPP via:

New Statistics (BETA)
Web Services

Publisher statistics

Go to New Statistics (BETA) / Leads Details or New Statistics (BETA) / Sales Details. Use the tab Formatting to individually select those GPP you want to display in your statistical reports.

NOTE: Please note that this view also enables you to select the zanox-internal parameters zpar5 to zpar9.

The selected parameters are displayed as individual columns in the statistics table.

Web Services

GPP - like any other parameter - can be accessed via zanox Web Services. Check out the following links for more information on zanox Web Services:

Documentation download

 Download this article as PDF file.

Sub-ID management with GPP

From Wiki.zanox.com

Contents