Audience

New DataX external parameters have been created for our /Audience, /Segment and /Attribute APIs to support new GDPR regulations for European Union consent.

Parameter Names

  • gdpr - use to pass EU user consent:

    • true - Europe audience data. Data provider indicates that the data is subject to GDPR regulations.

    • false - Rest of the world. Data provider indicates that the data is not subject to GDPR regulations.

    • empty - DataX will handle the jurisdiction flag as ‘true’ and process data applying GDPR regulations.

  • euconsent - use to include user consent attributes (using IAB Purpose bit descriptions):

    • Storage and Access of Information - the storage of information, or access to information that is already stored, on user device such as accessing advertising identifiers and/or other device identifiers, and/or using cookies or similar technologies.

    • Personalization - the collection and processing of information about user of a site to subsequently personalise advertising for them in other contexts, i.e., on other sites or apps, over time. Typically, the content of the site or app is used to make inferences about user interests, which inform future selections.

Note

  • The gdpr value must be included (with a value of either true or false) at the time of the of the audience post.

  • The euconsent parameter MUST contain the following values (storage and access of information, personalisation) when gdpr is set to true and gdpr_mode is oath_is_controller, otherwise DataX could ignore all records.

  • euconsent parameter values are ONLY applied when gdpr_mode is set to oath_is_controller.

Additional information is available on Controller vs Processor.

Audience POST Request Example:

--xyz
Content-Type: application/json;charset=UTF-8
Content-Disposition: form-data; name="metadata"
{
        "description" : "user qualifications – daily bucket 05/19/2013",
        "extensions" : { "urnType" : "Audience Data Type Goes Here" },
}

--xyz

Content-Type: application/octet-stream;charset=UTF-8
Content-Disposition: form-data; name="data"

< bz2 compressed data >

--xyz

Content-Type: application/octet-stream;charset=UTF-8
Content-Disposition: form-data; name="gdpr"

true or false

--xyz

Content-Type: application/octet-stream;charset=UTF-8
Content-Disposition: form-data; name="euconsent"

storage and Access of Information, personalisation