Flujo de solicitudes GDPR

Los tipos de solicitud GDPR, Acceso, Portabilidad, Eliminación y Rectificación, tienen el mismo flujo:

1. Usuario de la aplicación envía una solicitud.
2. El propietario de la aplicación genera la solicitud de GDPR (ver más abajo) y la envía a AppsFlyer.
3. AppsFlyer recibe la solicitud y responde con un "201 OK" para las solicitudes válidas.
4. Para acceso y portabilidad: Las solicitudes se completan en un plazo de 8 días.
   Nota: Este período de 8 días comienza cuando el propietario de la aplicación envía su solicitud. El estado de la solicitud cambia a “En Progreso” de pendiente y se completará dentro de 6 días adicionales, totalizando 8 días.
   Para la eliminación y rectificación:
   • Durante las siguientes 48 horas, la solicitud se pone en cola y queda en estado pendiente. El usuario de la aplicación puede cancelar la solicitud. 
   • Después de 48 horas, el estado de la solicitud cambia a in_progress. AppsFlyer envía un postback de cambio de estado. En este punto,no se puede cancelar la solicitud.

   • En un plazo de 10 días (ver la nota más abajo), AppsFlyer tramita la solicitud y el estado de la solicitud cambia a completed. AppsFlyer envía un postback de cambio de estado.

     • En el caso de eliminación o rectificación, se eliminan los datos del usuario de la aplicación.
     • En el caso de portabilidad o acceso, se puede acceder a los datos del usuario de la aplicación en el dashboard de AppsFlyer, en GDPR o a través de la API de solicitudes (ver más abajo).

     Nota: Este período de 10 días comienza cuando el propietario de la aplicación envía su solicitud. Después de 48 horas, el estado de la solicitud cambia a En progreso y se completará en 8 días adicionales, hasta un total de 10 días.

Formato de solicitudes GDPR

Se puede presentar una API de solicitudes GDPR por medio de HTTP POST al punto de conexión:

https://hq1.appsflyer.com/api/gdpr/v1/opendsr_requests

Para la autorización de la API, usa el mismo token de API V2 que para Pull API. Un usuario administrador puede recuperar el token desde la página del token de la API en el dashboard. Agrega el token en el encabezado de la solicitud de la siguiente manera: 'Authorization': 'Bearer %AuthTokenV2%'

Parámetros

Objetos subject_identities

Ejemplo: Solicitud de eliminación de GDPR

Ejemplo de una solicitud de eliminación para las plataformas android, ios, web y windowsphone:

curl --location --request POST 'https://hq1.appsflyer.com/api/gdpr/v1/opendsr_requests' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer %AuthTokenv2% \
--data-raw '{
 "subject_request_id":"f4e5a271-f25e-4107-b681-************",
 "subject_request_type":"erasure",
 "submitted_time":"2020-07-05T10:00:00Z",
 "platform": "android",
 "subject_identities":[
  {
   "identity_type":"android_advertising_id",
   "identity_value":"55*****-****-****-************",
   "identity_format":"raw"
  }
 ],
 "api_version":"0.1",
 "property_id":"com.*********.*******.********",
 "status_callback_urls":[
  "https://examplecontroller.com/opengdpr_callbacks"
 ]
}'
 

Ejemplo de una solicitud de eliminación para las plataformas CTV, PC y Console:

curl --location --request POST 'https://hq1.appsflyer.com/api/gdpr/v1/opendsr_requests' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer %AuthTokenv2%' \
--data-raw '
{"requester": "test@email.com",
"subject_request_id":"valid-uuid4-string",
"subject_request_type":"erasure",
"submitted_time":"2020-07-05T10:00:00Z",
"subject_identities":[
 {
  "identity_type":"appsflyer_id",
  "identity_value":"valid-appsflyer-id-string",
  "identity_format":"raw"
 }
],
"api_version":"0.1",
"property_id":"app-id",
"platform": "roku",
"status_callback_urls":[
 "https://examplecontroller.com/opengdpr_callbacks"
 ]
}'

Ejemplo de código de solicitud de borrado GDPR

/*
usando el paquete okhttp instalado desde maven
https://mvnrepository.com/artifact/com.squareup.okhttp3/okhttp
 */

import okhttp3.*;
import java.io.IOException;

public class GdprSendRequest {
 public static void main(String[] args){

  OkHttpClient client = new OkHttpClient();
  RequestBody body = RequestBody.create(null, "" +
  "{\r\n\"subject_request_id\": \"\"," +
  "\r\n\"subject_request_type\": \"erasure\"," +
  "\r\n\"platform\": \"android\"," +
  "\r\n\"submitted_time\": \"2018-11-02T15:00:00Z\"," +
  "\r\n\"subject_identities\": [\r\n" +
  "{\r\n\"identity_type\": \"android_advertising_id\"," +
  "\r\n\"identity_value\": \"\"," +
  "\r\n\"identity_format\": \"raw\"\r\n}" +
   "\r\n]," +
   "\r\n\"property_id\": \"com.example.application\"}");

  Request request = new Request.Builder()
  .url("https://hq1.appsflyer.com/api/gdpr/v1/opendsr_requests/opendsr_requests")
  .post(body)
  .addHeader("Content-Type", "application/json")
  .addHeader("Accept", "application/json")
  .addHeader("Authorization: Bearer", "")
  .build();

  try {
   Response response = client.newCall(request).execute();
   System.out.println(response.code());
   System.out.println(response.body().string());
   System.exit(0);
  } catch (IOException e) {
   e.printStackTrace();
   System.exit(1);
  }
 }
}

""" usando el paquete requests de Python,
instálalo con pip install requests """

import requests
import json
headers = {
 "Content-Type": "application/json",
 "Accept": "application/json",
 "Authorization: Bearer": ""
}

body = {
 "subject_request_id": "",
 "subject_request_type": "erasure",
 "submitted_time": "2018-10-02T15:00:00Z",
 "platform": "android",
 "subject_identities": [
  { "identity_type": "android_advertising_id",
   "identity_value": "",
   "identity_format": "raw" }
  ],
 "property_id": "com.example.application"
}
body = json.dumps(body)
res = requests.request("POST",
"https://hq1.appsflyer.com/api/gdpr/v1/opendsr_requests",
headers=headers, data=body, params=params)
print(res.text)
 

/* usando el paquete request de npm,
instálalo con npm install request */

var request = require("request");
var options = { method: 'POST',
 url: 'https://hq1.appsflyer.com/api/gdpr/v1/opendsr_requests',
 headers:
 { Accept: 'application/json',
  'Content-Type': 'application/json',
  'Authorization: Bearer': '' },
 body:
 { subject_request_id: '',
  subject_request_type: 'erasure',
  submitted_time: '2018-10-02T15:00:00Z',
  platform: 'android',
  subject_identities:
  [ { identity_type: 'android_advertising_id',
   identity_value: '',
   identity_format: 'raw' } ],
 property_id: 'com.example.application'
 },
 json: true };
request(options, function (error, response, body) {
 if (error) throw new Error(error);

 console.log(body);
});

using System;
 using RestSharp;
 namespace CS
 {
  class Gdpr
  {
   static void Main(string[] args)
   {
 		var url = "https://hq1.appsflyer.com/api/gdpr/v1/opendsr_requests";
   var client = new RestClient(url);
   var request = new RestRequest(Method.POST);
   request.AddHeader("Content-Type", "application/json");
   request.AddHeader("Accept", "application/json");
   request.AddHeader("Authorization: Bearer", "")
   var body = "{\r\n\"subject_request_id\": \"\"," +
    "\r\n \"subject_request_type\": \"erasure\"," +
    "\r\n \"submitted_time\": \"2018-11-02T15:00:00Z\"," +
    "\r\n \"platform\": \"android\"," +
    "\r\n \"subject_identities\": [\r\n" +
    "{ \r\n \"identity_type\": \"android_advertising_id\"," +
    "\r\n \"identity_value\": \"\"," +
    "\r\n \"identity_format\": \"raw\"\r\n }" +
    "\r\n ]," +
    "\r\n \"property_id\": \"com.example.application\"}";

    request.AddParameter("undefined", body,ParameterType.RequestBody);
    IRestResponse response = client.Execute(request);
    // gestiona la respuesta leyendo response.StatusCode
    Console.WriteLine(response.Content);
   }
  }

Cada solicitud de GDPR enviada puede consultarse más adelante para conocer su estado, especificando el subject_request_id. Existen cuatro tipos de estado admitidos:

1. pending - Se ha recibido una solicitud correcta y actualmente está en la cola
2. in_progress - Actualmente se está procesando una solicitud
3. completed - Se ha completado una solicitud
4. canceled - Se ha cancelado una solicitud

Formato de solicitud de estado

Se puede presentar una solicitud de estado por medio de HTTP GET al punto de conexión

https://hq1.appsflyer.com/api/gdpr/v1/opendsr_requests/<req_id>

Ejemplo de respuesta de estado

HTTP/1.1 200 OK
Content-Type: application/json
X-OpenGDPR-Processor Domain: example processor.com
X-OpenGDPR-Signature:
kiGlog3PdQx+FQmB8wYwFC1fekbJG7Dm9WdqgmXc9uKkFRSM4uPzylLi7j083461xLZ+mUloo3tpsmyIZpt5eMfgo7ejXPh6lqB4ZgCnN6+1b6Q3NoNcn/+11UOrvmDj772wvg6uIAFzsSVSjMQxRs8LAmHqFO4cF2pbuoPuK2diHOixxLj6+t97q0nZM7u3wmgkwF9EHIo3C6G1SI04/odvyY/VdMZgj3H1fLnz+X5rc42/wU4974u3iBrKgUnv0fcB4YB+L6Q3GsMbmYzuAbe0HpVA17ud/bVoyQZAkrW2yoSy1x4Ts6XKba6pLifIHf446Bubsf5r7x1kg6Eo7B8zur666NyWOYrglkOzU4IYO8ifJFRZZXazOgk7ggn9obEd78GBc3kjKKZdwaCrLx7WV5y9TMDCf+2FILOJM/MwTUy1dLZiaFHhGdzld2AjbjK1CfVzyPssch0iQYYtbR49GhumvkYl11S4oDfu0c3t/xUCZWg0hoR3XL3B7NjcrlrQinB1KbyTNZccKR0F4Lk9fDgwTVkrAg152UqPyzXxpdzXjfkDkSEgAevXQwVJWBNf18bMIEgdH2usF/XauQoyrne7rcMIWBISPgtBPj3mhcrwscjGVsxqJva8KCVCKD/4Axmo9DISib5/7A6uczJxQG2Bcrdj++vQqK2succ=
{
 "controller_id":"example_controller_id",
 "expected_completion_time":"2018-11-01T15:00:01Z",
 "subject_request_id":"a7551968-d5d6-44b2-9831-815ac9017798",
 "request_status":"pending",
}

Postbacks de estado

Como se describe arriba en el GDPR Request Flow, cuando cambia el estado de una solicitud de GDPR, de pending a in_progress y luego a completed, AppsFlyer envía un postback de GDPR a los endpoints solicitantes especificados con la propiedad status_callback_urls.

Ejemplo de postback de estado:

POST /opengdpr_callbacks HTTP/1.1
Host: examplecontroller.com
Content-Type: application/json
X-OpenGDPR-Processor Domain: gdpr.appsflyer.com
X-OpenGDPR-Signature: kiGlog3PdQx+FQmB8wYwFC1fekbJG7Dm9WdqgmXc9uKkFRSM4uPzylLi7j083461xLZ+mUloo3tpsmyIZpt5eMfgo7ejXPh6lqB4ZgCnN6+1b6Q3NoNcn/+11UOrvmDj772wvg6uIAFzsSVSjMQxRs8LAmHqFO4cF2pbuoPuK2diHOixxLj6+t97q0nZM7u3wmgkwF9EHIo3C6G1SI04/odvyY/VdMZgj3H1fLnz+X5rc42/wU4974u3iBrKgUnv0fcB4YB+L6Q3GsMbmYzuAbe0HpVA17ud/bVoyQZAkrW2yoSy1x4Ts6XKba6pLifIHf446Bubsf5r7x1kg6Eo7B8zur666NyWOYrglkOzU4IYO8ifJFRZZXazOgk7ggn9obEd78GBc3kjKKZdwaCrLx7WV5y9TMDCf+2FILOJM/MwTUy1dLZiaFHhGdzld2AjbjK1CfVzyPssch0iQYYtbR49GhumvkYl11S4oDfu0c3t/xUCZWg0hoR3XL3B7NjcrlrQinB1KbyTNZccKR0F4Lk9fDgwTVkrAg152UqPyzXxpdzXjfkDkSEgAevXQwVJWBNf18bMIEgdH2usF/XauQoyrne7rcMIWBISPgtBPj3mhcrwscjGVsxqJva8KCVCKD/4Axmo9DISib5/7A6uczJxQG2Bcrdj++vQqK2succ=

{
"controller_id":"example controller id at the processor",
"expected_completion_time":"2018-11-01T15:00:01Z",
"status_callback_url":"https://examplecontroller.com/opengdpr_callbacks",
"Subject_request_id":"a7551968-d5d6-44b2-9831-815ac9017798",
"Request_status":"pending"
}

Una vez que se haya completado una Solicitud de acceso o una Solicitud de portabilidad, puedes descargar el reporte mediante HTTP GET en el siguiente endpoint:

https://hq1.appsflyer.com/api/gdpr/v1/download/[REQUEST_ID]

El reporte generado estará disponible durante 14 días a partir de la finalización.

Para conocer los formatos admitidos por AppsFlyer, se puede enviar una solicitud de descubrimiento mediante HTTP GET al siguiente punto de conexión:

https://hq1.appsflyer.com/api/gdpr/v1/discovery

Ejemplo de respuesta de descubrimiento

HTTP/1.1 200 OK
Content-Type: application/json
{
 "api_version": "0.1",
 "supported_identities": [
 {
  "identity_type": "android_advertising_id",
  "identity_format": "raw"
 },
 ],
 "supported_subject_request_types": [
 "erasure", "access", "portability", "rectification"
 ],
 "processor_certificate": "https://exampleprocessor.com/cert.pem"
}

Es posible cancelar una solicitud GDPR en función de su subject_request_id, pero solo durante la fase pending.

Para enviar una solicitud HTTP DELETE con subject_request_id:

https://hq1.appsflyer.com/api/gdpr/v1/opendsr_requests/<req_id>

Respuesta de cancelación

Cuando se recibe una solicitud de cancelación GDPR, AppsFlyer devuelve una respuesta HTTP con el código de estado 202 y varios parámetros más.

Una vez que se produce la cancelación de la solicitud, AppsFlyer envía un postback con el estado canceled .

Esta API de AppsFlyer es una API de prueba para la API de solicitudes GDPR de AppsFlyer.

¿Cómo funciona?

La API de prueba funciona de la siguiente manera:

1. Una vez presentada una solicitud GDPR, inmediatamente se le asigna el estado "Pendiente". A los fines de la prueba, el estado cambia cada 30 segundos.

2. Si se insertó un punto de conexión para un postback de estado en la solicitud GDPR, se envía un primer postback inmediatamente después de la solicitud, y dos postbacks de estado más con intervalos de 30 segundos.

Punto de conexión de prueba de solicitud GDPR: POST

https://hq1.appsflyer.com/api/gdpr/v1/stub

Punto de conexión de prueba de solicitud de estado: GET

https://hq1.appsflyer.com/api/gdpr/v1/stub/:requestId

Punto de conexión de prueba de solicitud de descubrimiento: GET

https://hq1.appsflyer.com/api/gdpr/v1/stub/discovery

Punto de conexión de prueba de solicitud de cancelación: DELETE

https://hq1.appsflyer.com/api/gdpr/v1/stub/:requestId

Punto de conexión de prueba del certificado: GET

https://hq1.appsflyer.com/api/gdpr/v1/stubcertificate

Punto de conexión de prueba de reportes de acceso/portabilidad: GET

https://hq1.appsflyer.com/api/gdpr/v1/stub/download/:requestId

Un usuario administrador puede acceder a las solicitudes de RGPD enviadas en el Panel de control de registros.

En el caso de las solicitudes de acceso y portabilidad finalizadas, también es posible descargar el reporte desde este panel de control.

Para acceder al panel de control de registros:

1. En la barra superior, abre el menú de la cuenta (menú desplegable de la dirección de correo electrónico) > E-GDPR log.
2. Se abrirá la siguiente ventana:

Los mensajes de error y códigos de retorno HTTP de la API de GDPR se detallan en esta sección. 

Códigos de retorno de la API de GDPR

Código de retorno HTTP 400: solicitud incorrecta

Los mensajes que tienen el código de retorno 400 contienen un JSON con el mensaje y código de error.

{ "error": { "code":400, "af_gdpr_code": "%AF error code%", "message":"%error message text%" } }

Mensajes de solicitud incorrectos, código de retorno 400