Anura Docs

Additional Data Integration

Additional Data gives Anura users the ability to pass in select points of data with their Script or Direct requests, essentially turning Anura into "your database for transactional data".

Data Structure

Additional Data is passed to Anura using JSON encoded array strings. The following example illustrates how to build a simple JSON encoded array string using PHP.

Data Array

PHP
<?php
// create an array of data
$data = array(
    1 => "9868061c",
    2 => "a4ab95",
    5 => "d021ed96d184"
);
// output the json encoded array string
echo json_encode($data);
?>

The following string, from the output of the PHP code above, is an example of the JSON encoded array string that should be submitted to Anura using the additional parameter.

JSON Encoded Array String

{"1":"9868061c","2":"a4ab95","5":"d021ed96d184"}

Array Values

Data array values may only be strings or numbers of less than or equal to 128 characters. Values greater than 128 characters will be ignored and will not be stored.

Array Keys

It is important to declare the keys in your data array as numbers, starting with 1 and incrementing until your instance's Additional Data limit, so that your data points can be mapped to an Additional Data Definition, or self-mapped label, from within the Anura Dashboard. Once created, Additional Data Definitions are inserted into the column headers of Raw Data Reports containing Additional Data. It is also important to pass points of Additional Data using the same key position across requests for Raw Data report consistency.

Additional Data Definitions

The Anura Dashboard provides a method of declaring self-mapped labels for your Additional Data array keys, allowing you to have descriptive column headers when viewing your data in a Raw Data Report. The following string illustrates a mapping of Additional Data array keys from our examples used above.

{"Offer ID":"9868061c","Transaction ID":"a4ab95","Click ID":"d021ed96d184"}

When using our "one line" Script implementation, or Direct GET requests, be sure to URL encode your JSON encoded array string so it is passed to Anura correctly.

Additional Data Definitions are not required when viewing Additional Data. A default value of Additional Data XX will be returned when no key definition has been defined.

Every Anura instance comes with 10 available points of additional data. However, if you require more than 10 points of additional data, the default limit can be raised. Contact your Anura Account Executive for more information.

We recommend you do not send personally identifiable information when using Additional Data.