x x Usage
* The Redirect API is called via a Server Coded request upon a
visitor's arrival to one or more pages of a given website, and returns
the Bizographics of the user in 150 milliseconds or less. * The Profile API is used for ad servers that use pixels. * This is a variation on the Profile API. Instead
of sending back data, this sends a redirect to a client site. The API
will send back Bizographic data as a query string. See Taxonomy API
for full list. You must append your URL with the Bizographic data.
Once the URL has been appended, you can then rename the Bizographic code
as convenient. Your server can then target the user based on either
the original Bizographic code, or your renamed key-values. Redirect Profile Request Format * http://api.bizographics.com/v2/profile.redirect?api_key=XXXX&callback_url=http%3A%2F%2Fwww.bizo.com%2F%3Fa%3D1 Redirect Profile Response Format
* The response will be a HTTP 302 response, with a Location of the
URLDecoded callback_url parameter with any segments appended. * The param name will be the group (e.g. seniority) and the param value will be the"code" (e.g. executive). * There will be multiple values for the categories that support them (e.g.functional_area=X&functional_area=Y). * Please refer to the Taxonomy API section for a full list of the callback values. As an example, if your callback_url was http%3A%2F%2Fwww.bizo.com%2F%3Fa%3D1, the resulting URL might be http://www.bizo.com/?a=1&seniority=executive&industry=finance&industry=finance_investment_banking Custom Response Formatting It is possible to modify the format of the resulting redirect query string using the following parameters:
Note on encoded values All values passed into the url should be url encoded and will be url decoded when redirected to. If you want the redirected value to be url encoded then you should url encode the value twice before passing it into the url. Example A partner wants to load a pixel like: http://a.partner.com/seg?add=information_technology,software,high_net_worth,xlarge... Request to the API would look like: http://api.bizographics.com/v2/profile.redirect? api_key=XXXX &callback_url=http%3A%2F%2Fa.partner.com%2Fseg%3Fadd%3D &company_size_prefix= &functional_area_prefix= &company_size_prefix= &seniority_prefix= &group_prefix= &delimiter=, Redirect Profile URL Limits
* The resulting Location string will be truncated to a maximum of
2,000 characters. Redirect Profile Errors * If the profile is not provided, or if any other error occurs the response will be a 204. Domain Restrictions Network IP Ranges
|
|
|
|
Documentation > 1. Profile API >
a. Profile Redirect API |