Data Portability Management

Avatar
Maxwell Anderson
Follow

NOTE: This documentation references many concepts addressed in the glossary of terms. Please visit this page before you continue.

Data portability management gives you the tools to request data feeds which output the consent audit logs. That way, you can determine a plan of action for complying with the regulations that apply to you.

Many data protection and privacy regulations can require you to export consumers’ personal data when consumers request it. If you have consumers or users who want to export the data that you’ve collected about them, review these procedures.

Request Data via API

Reference technical API documentation for details on requesting data via API.

Request Data via JavaScript Consent Tag

The JavaScript Consent Tag allows you to execute portability requests asynchronously without a browser refresh. The JavaScript Consent Tag can be called after the page is loaded to send any consumer consent information that should be tracked. Please reference the technical documentation for further details.

Note: The JavaScript Consent Tag requires the Salesforce Audience Studio JavaScript Control Tag to be deployed on the page. The JavaScript Consent Tag must be used as is: any edit or modification of the tag will not be supported by Salesforce Audience Studio and may result in compliance failure. Please consult with your legal team accordingly.

The JavaScript Consent Tag snippet can be retrieved by navigating to Manage>> Sites in the Salesforce Audience Studio UI and clicking the </> (Actions) button on the right.

The consent:portability method can be called to initiate a request to add a data subject to a portability feed. The function call should be executed as follows, with optional parameters and callback:

Krux('ns:mynamespace', 'consent:portability', parameters, callback);

Request Data in Audience Studio

Follow these steps to create a data portability request in your account.
  1. Click the Consumer Rights Management tile
  2. Click Raise a new request and select Data portability request
  3. Select the user identification type for your request
    1. List a single ID or set of IDs in the text box
    2. For multiple IDs, input one ID per row
  4. Enter the applicable user identifiers
  5. Click Submit

GDPRData1.png

GDPRData2.png

 

Requesting Data via File

If you choose not to integrate via other supported methods, you can request data via file. All requests collected through files process daily, so the system will not register the request until after daily jobs have processed. 

Location

Please upload files to the following location.

s3://krux-partners/client-{NAME}/uploads/consent-data/YYYY-MM-DD/

Format

Device Format:
idt^dt^idv^ACTION^PR^{FLAGS}^TS

Bridge Key Format:
idt^bk^idv^ACTION^PR^{FLAGS}^TS

Note: For the portability action, policy regime (pr), flags, and timestamp (ts) are optional. For more detail on the consent flags format, please refer to Consent Flags section of the Audience Studio Consumer Rights Management Concepts and Glossary document.

Examples of valid records for data portability requests:

device^kxcookie^abcdef123^portability^global^^1515471711277000

device^idfa^6D92078A-8246-4BA4-AE5B-76104861E7DC^portability^^^

bk^email_sha256^f660ab912ec121d1b1e928a0bb4bc61b15f5ad44d5efdc4e1c92a25e99b8e44a^portability^^^

Regardless of whether or not you submit data for the optional policy regime, flags, or timestamp, include all of the delimiters. Data will not process without all delimiters.

Compression

Audience Studio supports gzip and lzo compression types, but recommends lzo with an lzo index file. If you choose to use gzip, the maximum supported size is 1GB per file submitted. Alternatively, Audience Studio does support plain text files.

Data Request Impact

We deliver data feeds for the requested user within 14 days of the request. Portability data feeds will be dropped here:

s3://krux-partners/client-{NAME}/portability/requestID/YYYY-MM-DD/{data_source}/{bk}/{kuid}

requestID = the ID of the portability request 
data_source = source of logged data (eg: pixel.gif, event.gif)
bk = Base64 encoded Bridge Key (if request made at the bridge key level), otherwise this will contain the kuid
kuid = the device ID, (eg: KUID, AAID, IDFA, etc). 

Data will be segregated by user ID and data source, and based on the following sources:

  1. pixel.gif
  2. ad-impression.gif
  3. click
  4. event.gif
  5. segment.gif
  6. transaction.gif
  7. heartbeat.gif
  8. social.gif

Once the data portability is complete, we will drop a _SUCCESS file.

The file format and examples by data source are provided below.

Pixel:

{"TS":"1518036361","XFF":"1.136.106.246","IP":"10.84.138.243","KUID":"LIDa_CtQ","DNT":"-","UA":"Carsales/131 CFNetwork/811.5.4 Darwin/16.6.0","REF":"-","HOST":"beacon.krxd.net","PATH":"/pixel.gif","QS":"?_kpid=b2bf9016-e00a-4906-9718-f27de8fee74e&_kuid=B89297C2-6C4E-4355-8376-7D5883FAFF67&_kpa_wt_cg_s=Used&_kpa_wt_z_vehcat=Used&_kpa_wt_z_price=159900&tech_os=10.3.2&_kcp_s=cs-ios&_kua_pp_id=426aab2a-e6e8-4606-9e55-8e0ad3728536&_kpa_wt_z_fuel=Petrol&_kcp_d=ios_mobile_sdk&_kpa_wt_z_sellerid=AGC-SELLER-12000&_kpa_wt_z_color=White&_kpa_wt_cg_n=All%20Cars&_kpa_wt_z_year=1988&_kpa_wt_z_det_sof=0&_kpa_wt_z_adid=OAG-AD-15635226&_kpa_wt_z_make=Porsche&_kpa_wt_z_pgtype=gallery&tech_device=iPhone&_kcp_sc=gallery&tech_manufacturer=Apple&_kpa_wt_z_model=911%20Carrera&tech_browser=ios_app&tech_browser_lang=en-AU&_kpa_wt_z_badge=Cabriolet","RESP":"204","RT":"34","NEWUSER":"0","NODE":"beacon-n027-pdx.krxd.net","V":"7"}

Ad Impression:

{"TS":"1518036181","XFF":"172.58.201.209","IP":"10.61.145.74","KUID":"Lx14QZg_","DNT":"-","UA":"Mozilla/5.0 (Linux; Android 7.0; LGMS210 Build/NRD90U; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/64.0.3282.137 Mobile Safari/537.36","REF":"-","HOST":"beacon.krxd.net","PATH":"/ad_impression.gif","QS":"?campaignid=20685259&advertiserid=8114900&placementid=213981894&adid=413039417&creativeid=97566238&siteid=4064657&kxbrand=7&url=%2F%2Fbeacon.krxd.net%2Fad_impression.gif&_kpid=7b3785dc-e5e8-4465-88e8-0bb2db048533&confid=r4kjtg8b5","RESP":"204","RT":"72","NEWUSER":"1","NODE":"beacon-n054-ash.krxd.net","V":"7"}

Click:

{"IP":"127.0.0.1","KCT_kxcampaignid":"20299543","KCT_kxsiteid":"1053227","TS":"1517958000165","KCT_kxadvertiserid":"3008831","UA":"Mozilla/5.0 (Linux; Android 6.0; Aquaris M10 FHD Build/MRA58K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/64.0.3282.137 Safari/537.36","KCT_clk":"http://www.citroen.es/vehiculos/citroen/nuevo-c3.html?dclid\u003dCN_J9JqyktkCFcwW0woddQgDgw","KUID":"LsUGEPR-","KCT_kxconfid":"rmwr3840s","KCT_kxplacementid":"204976476","KCT_kxadid":"404832720","XFF":"81.172.98.183, 157.52.69.23, 10.123.160.207","KCT_kxcreativeid":"0","REF":"https://cdn.elasticad.net/storage/template/placement320x50.html?siteid221771\u003dtrue"}

Event:

{"TS":"1518036181","XFF":"100.6.145.113","IP":"10.65.103.148","KUID":"Lx14Qph3","DNT":"-","UA":"Mozilla/5.0 (iPhone; CPU iPhone OS 10_3_3 like Mac OS X) AppleWebKit/603.3.8 (KHTML, like Gecko) Version/10.0 Mobile/14G60 Safari/602.1","REF":"-","HOST":"beacon.krxd.net","PATH":"/event.gif","QS":"?event_id=LwMuYlcD&bodystyle=COUPE&model=CIVIC%20SI%20COUPE&modelYear=2018&pageName=CIVIC%20SI%20COUPE%3AMODEL%20PAGE%3AOVERVIEW","RESP":"204","RT":"74","NEWUSER":"1","NODE":"beacon-n054-ash.krxd.net","V":"7"}

Segment:

{"TS":"1515712861","XFF":"107.23.68.6","IP":"10.67.128.205","KUID":"LudgMNz6","DNT":"-","UA":"Java/1.8.0_141","REF":"-","HOST":"beacon.krxd.net","PATH":"/segment.gif","QS":"?fpuid=80ff7089-d535-4f50-bc86-ff3e5a7d564a&_kpid=bc135346-2db7-45d7-a86d-a3ea84e4fffe&segs=sj0w2vv4l&action=add","RESP":"204","RT":"51","NEWUSER":"1","NODE":"beacon-n012-ash.krxd.net","V":"7"}

Transaction:

{"TS":"1518036208","XFF":"107.21.39.59","IP":"10.155.186.211","KUID":"Lx14asGr","DNT":"-","UA":"HasOffers Mobile AppTracking v1.0","REF":"-","HOST":"beacon.krxd.net","PATH":"/transaction.gif","QS":"?_kpid=3d8e4b51-b537-4841-9086-4f59862457c6&_kuid=48aa1359-c4e9-4be1-b58b-28cf218cb084&mergedOriginCode=4477519&mergedDestinationCode=4280404&carrierCodes=NK&device.device.type=app&SiteBrand=expedia&checkInDate=2018-02-19&checkOutDate=1970-01-01&pageInfo.language=en&rewardsStatus.membershipTier=GOLD&loggedUser=1&siteName=Expedia+-+Android&context.marketingAttribution.restrictedLastTouch=&currencyCode=USD&checkout.cartTotal.amount=36.29&bookingDateInUTC=2018-02-07&siteId=1&lob.domain=flight_confirmation&pointofsales=US","RESP":"204","RT":"34","NEWUSER":"1","NODE":"beacon-n054-ash.krxd.net","V":"7"}

Heartbeat:

{"TS":"1518036181","XFF":"107.193.71.57","IP":"10.138.160.235","KUID":"Lx14Qe8U","DNT":"-","UA":"Roku/DVP-8.0 (388.00E04156A)","REF":"-","HOST":"beacon.krxd.net","PATH":"/heartbeat.gif","QS":"?_kpa_video_season=Season%200&_kpid=7156d277-5d35-4c9c-8fb7-f454c47dbfe1&_kuid=0f1123fd-d8ae-50c0-a65a-358c25242efe&_kpa_video_episode=Episode%200&tech_browser=roku_app&_kpa_video_analytics_lf_vs_sf=Longform&_kpa_video_pplid=200872&_kcp_d=LMP_Roku&_kpa_video_analytics_clip_title=LMP%3AKillerMom%3AKillerMom&_kpa_video_series_type=Show&_kpa_video_analytics_series_name=LMP%3AKillerMom&_kua_user_ip_address=192.168.1.107&_kpa_video_duration=84&_kcp_s=LMP_Roku&tech_os=roku&_kpa_video_chapter=Chapter%205&","RESP":"204","RT":"56","NEWUSER":"1","NODE":"beacon-n054-ash.krxd.net","V":"7"}

Social:

{"TS":"1518036447","XFF":"191.217.91.19","IP":"10.11.210.91","KUID":"Lq5fbRVM","DNT":"-","UA":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.36 Edge/16.16299","REF":"http://kogut.oglobo.globo.com/noticias-da-tv/novelas/ultimas-noticias.html","HOST":"beacon.krxd.net","PATH":"/social.gif","QS":"?_kpid=5007d44e-09d1-49b7-8c99-6b1cc38c3cbc&_kcp_s=Infoglobo&_ksoc_t=twttr&_ksoc_e=tweet&_ksoc_url=https%3A%2F%2Fplatform.twitter.com%2Fwidgets%2Ftweet_button.02a1dca8703a0f5962a962619634825b.pt.html%23dnt%3Dfalse%26id%3Dtwitter-widget-0%26lang%3Dpt%26original_referer%3Dhttp%253A%252F%252Fkogut.oglobo.globo.com%252Fnoticias-da-tv%252Fnovelas%252Fultimas-noticias.html%26related%3DPatriciaKogut%26size%3Dm%26text%3D%2527O%2520outro%2520lado%2520do%2520para%25C3%25ADso%2527%253A%2520Adriana%2520far%25C3%25A1%2520bi%25C3%25B3psia%2520e%2520ficar%25C3%25A1%2520arrasada%26time%3D1518036407166%26type%3Dshare%26url%3Dhttp%253A%252F%252Fkogut.oglobo.globo.com%252Fnoticias-da-tv%252Fnovelas%252Fnoticia%252F2018%252F02%252Fo-outro-lado-do-paraiso-adriana-fara-biopsia-e-ficara-arrasada.html%26via%3DPatriciaKogut&_kpa_title=Not%C3%ADcias%20das%20novelas%20-%20Patr%C3%ADcia%20Kogut%20%7C%20Jornal%20O%20Globo","RESP":"204","RT":"44","NEWUSER":"0","NODE":"beacon-n054-ash.krxd.net","V":"7"}

Have more questions? Submit a request

0 Comments

Article is closed for comments.