Referencia de la API del punto final de EVENT

Caso de uso de servidor a servidor

La API EVENT permite el seguimiento de eventos en sus aplicaciones. Cuando su aplicación envía datos específicos del dispositivo a su servidor, que a su vez los transmite a los servidores de Singular, la plataforma procesa esta información para: Event Attribution, y App Revenue Metrics. Estos datos procesados rellenan automáticamente sus informes, registros de exportación y postbacks configurados, proporcionando análisis completos para sus campañas de marketing.

La API REST de Singular permite la integración directa de servidor a servidor como alternativa al SDK. Mientras que el SDK recopila automáticamente los datos del dispositivo y de la aplicación, el enfoque S2S requiere que usted:

Recopilar los datos necesarios de su aplicación
Reenvíe estos datos a su servidor
Actualizar/obtener detalles del dispositivo del gráfico del dispositivo
Enviar el evento a Singular a través de REST API

Puntos clave

Flexibilidad: Control total sobre la recopilación y transmisión de datos
Paridad de funciones: Soporta todas las funcionalidades del SDK cuando se proporcionan los datos adecuados
Ruta de integración: Cliente → Su servidor → API singular
Procesamiento en tiempo real: Una solicitud cada vez, sin procesamiento por lotes
Flujo de datos secuencial: Los eventos deben procesarse en orden cronológico
Deduplicación de datos: Singular no deduplica los datos recibidos. Se recomienda enviar una (1) solicitud con éxito y guardar los registros en caso de que deba repetirse una solicitud.
Validación de datos: Los datos a nivel de dispositivo son permanentes y no pueden borrarse una vez introducidos. Realice una validación exhaustiva de los datos antes de enviarlos a Singular para garantizar su exactitud.

Requisitos previos

Debe establecerse una sesión antes de recibir cualquier seguimiento de eventos.
Un orden de sesión no válido provocará incoherencias en los datos.

Cómo empezar

La documentación del endpoint EVENT proporciona:

Parámetros obligatorios
Parámetros opcionales
Ejemplos de solicitud
Códigos de respuesta y errores
Pruebas de eventos

Este enfoque del lado del servidor le ofrece un mayor control sobre su integración al tiempo que mantiene todas las capacidades del SDK.

Informes de Eventos

Singular puede recopilar datos sobre eventos dentro de la aplicación para ayudar a analizar el rendimiento de sus campañas de marketing. Los eventos pueden incluir cualquier interacción del usuario, desde inicios de sesión y registros hasta subidas de nivel en una aplicación de juegos.

Antes de implementar una integración SDK/S2S con Singular, debe tener una lista de los eventos que su organización desea rastrear (consulte Definición de eventos dentro de la aplicación).

El nombre del evento que incluya en la llamada es la forma en que se identificará el evento en los informes, exportaciones y devoluciones de Singular.

Notas:

Singular recomienda pasar eventos utilizando la convención de nomenclatura de eventos y atributos estándar de Singular. El uso de eventos estándar agiliza la asignación y la compatibilidad con los eventos estándar de sus socios en las integraciones.
Recomendamos encarecidamente pasar los nombres de eventos y otros atributos en inglés para que sean compatibles con cualquier socio de terceros y soluciones de análisis que desee utilizar.

Importante:

Los nombres de eventos están limitados a 32 caracteres ASCII. Para caracteres no ASCII, el límite es de 32 bytes una vez convertidos a UTF-8.
Los atributos y valores de los eventos están limitados a 500 caracteres ASCII.

Punto final de la API de eventos

Método HTTP y punto final de evento

GET https://s2s.singular.net/api/v1/evt

Parámetros obligatorios

En la siguiente tabla se enumeran los parámetros obligatorios que admite este punto final. Todos los parámetros enumerados son parámetros de consulta.

GET /api/v1/evt?param1=value1&param2=value2

Todos los parámetros obligatorios deben incluirse en las solicitudes de la API de eventos.
Los parámetros deben seguir el formato y los tipos de datos especificados

Parámetros obligatorios
Clave API
Parámetro	Descripción
`a`	`string` El parámetro a especifica la clave Singular SDK Key. Obtenga la clave SDK en la interfaz de Singular, en Herramientas de desarrollo del menú principal. Nota: No utilice la clave API de generación de informes, ya que se rechazarán los datos. Valor de ejemplo: `sdkKey_afdadsf7asf56`
Parámetros del identificador del dispositivo
Parámetro	Descripción
`idfa` Plataformas soportadas: iOS	`string` El parámetro idfa especifica el Identificador para Anunciantes (IDFA) que ayuda a los anunciantes a rastrear y atribuir las acciones de los usuarios (por ejemplo, clics en anuncios, instalaciones de aplicaciones) a campañas específicas, lo que permite una orientación precisa de los anuncios y la optimización de las campañas. A partir de iOS 14.5, los usuarios deben optar por el marco App Tracking Transparency (ATT) para que las aplicaciones puedan acceder al IDFA. Si los usuarios no optan por el IDFA, este no estará disponible, lo que limitará las capacidades de seguimiento. Si el IDFA no está disponible, omita el parámetro de la solicitud. No pase NULL o una cadena vacía en la petición. Cómo recuperar el Identificador IDFA Valor de ejemplo: `DFC5A647-9043-4699-B2A5-76F03A97064B`
Parámetro	Descripción
`idfv` Plataformas soportadas: iOS	`string` El parámetro idfv especifica el Identificador de Vendedores (IDFV), un identificador único asignado por Apple a un dispositivo, que es específico de un vendedor o desarrollador concreto. Permanece constante en todas las aplicaciones del mismo proveedor en un dispositivo determinado, lo que permite al proveedor realizar un seguimiento del comportamiento y las interacciones del usuario en todo su ecosistema de aplicaciones sin identificar al usuario personalmente. El IDFV es obligatorio en todas las solicitudes, independientemente del estado de ATT o de la presencia del IDFA. Cómo recuperar el identificador IDFV Valor de ejemplo: `21DB6612-09B3-4ECC-84AC-B353B0AF1334`
Parámetro	Descripción
`aifa` Plataformas soportadas: Android (Dispositivos Google Play)	`string` El parámetro aifa especifica el identificador de publicidad de Google (GAID), también conocido como AIFA en singular o Android Advertising ID (AAID). Este identificador es un identificador único y reajustable por el usuario asignado a los dispositivos Android. Ayuda a los anunciantes y a los desarrolladores de aplicaciones a rastrear y atribuir las acciones de los usuarios (por ejemplo, clics en anuncios, instalaciones de aplicaciones) en las aplicaciones a campañas específicas, lo que permite una orientación precisa de los anuncios y la optimización de las campañas, al tiempo que se mantiene la privacidad del usuario. Si la AIFA no está disponible, omita el parámetro de la solicitud. Solo se requiere en dispositivos Google Play. Omita el parámetro en dispositivos que no sean de Google Play. No pase NULL o una cadena vacía en la solicitud. Cómo recuperar el identificador AIFA Valor de ejemplo: `8ecd7512-2864-440c-93f3-a3cabe62525b`
Parámetro	Descripción
`asid` Plataformas soportadas: Android (Dispositivos Google Play)	`string` El parámetro asid especifica el Android App Set ID. El ASID permite a los desarrolladores realizar un seguimiento de los usuarios en sus propias aplicaciones respetando su privacidad. Es especialmente útil para el análisis y la prevención del fraude, pero no puede utilizarse con fines publicitarios, como anuncios personalizados o mediciones. El ASID es obligatorio en todas las solicitudes de dispositivos Google Play, independientemente de la presencia de GAID/AIFA. Omita el parámetro en dispositivos que no sean de Google Play. No pase NULL o una cadena vacía en la solicitud. Cómo recuperar el identificador ASID Valor de ejemplo: `edee92a2-7b2f-45f4-a509-840f170fc6d9`
Parámetro	Descripción
`amid` Plataformas soportadas: Android (Dispositivos Amazon sin Google Play Services)	`string` El parámetro amid especifica que el ID de publicidad es un identificador único y reajustable por el usuario que ayuda a proteger su privacidad. Si recopilas información sobre el comportamiento de un usuario para mostrar anuncios basados en intereses o para generar análisis, debes utilizar el ID de publicidad; no se puede utilizar ningún otro identificador o método de seguimiento. Los usuarios pueden restablecer el identificador de publicidad o excluirse totalmente de los anuncios basados en intereses. El AMID es obligatorio en todas las solicitudes de dispositivos de Amazon sin Google Play Services. Omita el parámetro si el AMID no está disponible. No pase NULL o una cadena vacía en la solicitud. Cómo recuperar el identificador AMID Valor de ejemplo: `df07c7dc-cea7-4a89-b328-810ff5acb15d`
Parámetro	Descripción
`oaid` Plataformas soportadas: Android (Dispositivos fabricados en China sin Google Play Services)	`string` El parámetro oaid especifica Open Advertising Identifier (OAID). El OAID es un identificador único y anónimo utilizado con fines publicitarios en dispositivos Android, especialmente los fabricados en China. Fue introducido por la Mobile Security Alliance (MSA) como alternativa al identificador de publicidad de Google (GAID) para dispositivos en los que los servicios de Google Play no están disponibles o no son compatibles, como en el mercado chino. El OAID se utiliza principalmente para la atribución de publicidad y el seguimiento de usuarios en entornos en los que los servicios de Google Play están restringidos, lo que permite a los anunciantes y desarrolladores rastrear el comportamiento de los usuarios manteniendo el anonimato. El OAID está disponible en la mayoría de los dispositivos Android fabricados en China, incluidos los de marcas como Huawei, Xiaomi y otras. Se puede acceder a él mediante el SDK MSA o Huawei Mobile Services (HMS). El OAID es necesario en los dispositivos Android fabricados en China sin Google Play Services. Omita el parámetro si el OAID no está disponible. No pase NULL o una cadena vacía en la solicitud. Cómo recuperar el identificador OAID Valor de ejemplo: `01234567-89abc-defe-dcba-987654321012`
Parámetro	Descripción
`andi` Plataformas soportadas: Android (Dispositivos sin Google Play)	`string` El parámetro andi especifica el ID de Android, que es un identificador único de 64 bits generado por el sistema operativo Android cuando se configura un dispositivo por primera vez. Está diseñado para ser persistente durante toda la vida útil del dispositivo, pero puede restablecerse en determinadas condiciones, como un restablecimiento de fábrica. El Android ID es único para cada dispositivo y, a partir de Android 8.0 (Oreo), tiene un alcance por app y por usuario. Esto significa que diferentes aplicaciones en el mismo dispositivo recibirán diferentes Android ID a menos que compartan la misma clave de firma. El Android ID permanece constante a menos que el dispositivo se restablezca de fábrica o si se desinstala y se vuelve a instalar una aplicación tras una actualización OTA (over-the-air). Está prohibido utilizar el ANDI en dispositivos Google Play. Utilice los identificadores AIFA y ASID mencionados anteriormente. El ANDI sólo puede enviarse a Singular si no se dispone de otros identificadores y la aplicación no está alojada en Google Play Store. Omita el parámetro si hay otros identificadores disponibles. No pase NULL o una cadena vacía en la solicitud. Cómo recuperar el identificador ANDI Valor de ejemplo: `fc8d449516de0dfb`
Parámetro	Descripción
`sdid` Plataformas soportadas: Web PC Xbox Playstation Nintendo MetaQuest CTV	`string` El parámetro sdid especifica el ID del Dispositivo Singular. Para los eventos Web, este valor se obtiene del Singular Web SDK Cómo recuperar el identificador Web SDID Para aplicaciones de PC y consola, este valor es un UUIDv4 generado por el cliente que representa una instalación de aplicación única. Valor de ejemplo: `40009df0-d618-4d81-9da1-cbb3337b8dec`
Parámetro	Descripción
`sing` Plataformas soportadas: Restringido para casos de uso especiales Póngase en contacto con su ingeniero de soluciones o CSM para obtener más información	`string` El parámetro sing está restringido a clientes Enterprise y especifica un identificador definido por el Cliente. Sólo se utiliza en usos especiales en los que el resto de identificadores no están disponibles. El ingeniero de soluciones de Singular debe habilitar este identificador para cada aplicación. Valor de ejemplo: `da534a95-1b1b-47d4-94b6-07955ec85177`
Parámetros del dispositivo
Parámetro	Descripción
`p`	`string` El parámetro p especifica la plataforma de la App. La siguiente lista contiene los valores permitidos del parámetro que distinguen entre mayúsculas y minúsculas : Android iOS Web PC Xbox Playstation Nintendo MetaQuest CTV Valor de ejemplo: `Android`
Parámetro	Descripción
`ip`	`string` El parámetro ip especifica la dirección IP pública (IPV4) del dispositivo. No se admite IPV6. Valor de ejemplo: `172.58.29.235`
Parámetro	Descripción
`ve`	`string` El parámetro ve especifica la versión del sistema operativo del dispositivo en el momento del evento. Valor de ejemplo: `9.2`
Parámetro	Descripción
`ma` Plataformas soportadas: Android iOS	`string` El parámetro ma especifica la Marca del hardware del dispositivo, normalmente el nombre de cara al consumidor. Este parámetro debe utilizarse con el parámetro model. Cómo recuperar la marca del dispositivo Ejemplos: `Samsung, LG, Apple`
Parámetro	Descripción
`mo` Plataformas soportadas: Android iOS	`string` El parámetro mo especifica el Modelo del hardware del dispositivo. Este parámetro debe utilizarse con el parámetro make. Cómo recuperar el modelo del dispositivo Ejemplos: `iPhone 4S, Galaxy SIII`
Parámetro	Descripción
`lc` Plataformas soportadas: Android iOS	`string` El parámetro lc especifica la etiqueta de configuración regional IETF para el dispositivo, utilizando un código de idioma y país de dos letras separado por un guión bajo. Cómo recuperar la configuración regional del dispositivo Valor de ejemplo: `en_US`
Parámetro	Descripción
`bd` Plataformas soportadas: Android iOS	`string` El parámetro bd especifica la Build del dispositivo, codificada mediante URL. Cómo recuperar la Build del dispositivo Valor de ejemplo: `Build%2F13D15`
Parámetros de aplicación
Parámetro	Descripción
`i`	`string` El parámetro i especifica el identificador de la aplicación. Este es el nombre del paquete para Android o el ID del paquete para iOS o de su aplicación. los valores de los parámetros distinguen entre mayúsculas y minúsculas : Package Name para Android ID de paquete para iOS ID de producto para Web Su identificador designado para PC, Xbox, Playstation, Nintendo, MetaQuest o CTV Valor de ejemplo: `com.singular.app`
Parámetro	Descripción
`att_authorization_status` Plataformas soportadas: iOS	`int` El parámetro att_authorization_status especifica el código de estado de App Tracking Transparency(ATT). A partir de iOS 14.5, se requiere el indicador App Tracking Transparency (ATT) para acceder al identificador IDFA. Nota: Incluso si no implementa el prompt ATT, requerimos que pase el estado de autorización ATT con el valor'0', indicando "indeterminado". Los valores soportados son: 0 - Indeterminado. 1 - Restringido, el usuario ha deshabilitado el seguimiento de la aplicación. 2 - Denegado, el usuario denegó la autorización. 3 - Autorizado, el usuario ha concedido la autorización. Ejemplos: `3`
Parámetros de evento
Parámetro	Descripción
`n`	`string` El parámetro n especifica el Nombre del evento que se está rastreando. Limitación: máximo 32 caracteres ASCII Se recomienda utilizar la convención de nomenclatura de eventos estándar de Singular. Valor de ejemplo: `sng_add_to_cart`

Cuerpo de la petición

No proporcione un cuerpo de petición cuando llame a este método. La petición debe enviarse utilizando el método GET con parámetros de consulta.

Ejemplos de solicitud

Los siguientes ejemplos de código pueden no representar todos los parámetros soportados. Cuando implemente la petición asegúrese de incluir todos los parámetros requeridos como se indica arriba, y valide que se están pasando los valores correctos antes de enviar datos desde una instancia de producción. Se recomienda utilizar un único parámetro `i` (identificador de aplicación) para el desarrollo y las pruebas.

PYTHON

import requests

params = {
    'a': 'sdk_key_here',
    'p': 'Android',
    'i': 'com.singular.app',
    'ip': '10.1.2.3',
    've': '9.2',
    'ma': 'samsung',
    'mo': 'SM-G935F',
    'lc': 'en_US',
    'bd': 'Build/13D15',
    'aifa': '8ecd7512-2864-440c-93f3-a3cabe62525b',
    'asid': 'edee92a2-7b2f-45f4-a509-840f170fc6d9',
    'n': 'sng_add_to_cart'
}

response = requests.get('https://s2s.singular.net/api/v1/evt', params=params)
print(response.json())

CURL

curl -G "https://s2s.singular.net/api/v1/evt" \
  --data-urlencode "a=sdk_key_here" \
  --data-urlencode "p=Android" \
  --data-urlencode "i=com.singular.app" \
  --data-urlencode "ip=10.1.2.3" \
  --data-urlencode "ve=9.2" \
  --data-urlencode "ma=samsung" \
  --data-urlencode "mo=SM-G935F" \
  --data-urlencode "lc=en_US" \
  --data-urlencode "bd=Build/13D15" \
  --data-urlencode "aifa=8ecd7512-2864-440c-93f3-a3cabe62525b" \
  --data-urlencode "asid=edee92a2-7b2f-45f4-a509-840f170fc6d9" \
  --data-urlencode "n=sng_add_to_cart"

HTTP

GET /api/v1/evt
    ?a=sdk_key_here
    &p=Android
    &i=com.singular.app
    &ip=10.1.2.3
    &ve=9.2
    &ma=samsung
    &mo=SM-G935F
    &lc=en_US
    &bd=Build%2F13D15
    &aifa=8ecd7512-2864-440c-93f3-a3cabe62525b
    &asid=edee92a2-7b2f-45f4-a509-840f170fc6d9
    &n=sng_add_to_cart HTTP/1.1
Host: s2s.singular.net
Accept: application/json

JAVA Ejemplo

// Base URL

String baseUrl = "https://s2s.singular.net/api/v1/evt";

// Parameters

Map < String, String > params = new HashMap < > ();
params.put("a", "sdk_key_here");
params.put("p", "Android");
params.put("i", "com.singular.app");
params.put("ip", "10.1.2.3");
params.put("ve", "9.2");
params.put("ma", "samsung");
params.put("mo", "SM-G935F");
params.put("lc", "en_US");
params.put("bd", "Build/13D15");
params.put("aifa", "8ecd7512-2864-440c-93f3-a3cabe62525b");
params.put("asid", "edee92a2-7b2f-45f4-a509-840f170fc6d9");
params.put("n", "sng_add_to_cart");

// Build URL with encoded parameters

StringBuilder urlBuilder = new StringBuilder(baseUrl);
urlBuilder.append('?');

for (Map.Entry < String, String > entry: params.entrySet()) {
    if (urlBuilder.length() > baseUrl.length() + 1) {
        urlBuilder.append('&');
    }
    urlBuilder.append(URLEncoder.encode(entry.getKey(), StandardCharsets.UTF_8))
        .append('=')
        .append(URLEncoder.encode(entry.getValue(), StandardCharsets.UTF_8));
}

// Create connection

URL url = new URL(urlBuilder.toString());
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("GET");
conn.setRequestProperty("Accept", "application/json");

// Get response

int responseCode = conn.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(conn.getInputStream())
);

String inputLine;
StringBuilder response = new StringBuilder();
while ((inputLine = in .readLine()) != null) {
    response.append(inputLine);
} in .close();

// Check application-level status

System.out.println("HTTP Status Code: " + responseCode);
System.out.println("Response: " + response.toString());

// Disconnect

conn.disconnect();

Parámetros opcionales

En la siguiente tabla se enumeran los parámetros opcionales que admite este endpoint. Todos los parámetros enumerados son parámetros de consulta.

Parámetros opcionales
Parámetros de marca de tiempo
Parámetro	Descripción
`utime`	`int` El parámetro utime especifica la hora del evento en tiempo UNIX de 10 dígitos. Valor de ejemplo: `1483228800`
Parámetro	Descripción
`umilisec`	`int` El parámetro umilisec especifica el Tiempo del evento en milisegundos 13 dígitos de tiempo UNIX. Valor de ejemplo: `1483228800000`
Parámetros de Dispositivo y Red
Parámetro	Descripción
`global_properties`	`JSON URL-encoded string` El parámetro global_properties acepta un objeto JSON codificado en URL que contiene hasta 5 pares clave-valor. Cada clave y valor puede tener una longitud máxima de 200 caracteres. `{"key1":"value1","key2":"value2"}` El objeto JSON debe ser Convertido a una cadena JSON y codificado con URL. Valor de ejemplo: `%7B%22key1%22%3A%22value1%22%2C%22key2%22%3A%22value2%22%7D`
Parámetro	Descripción
`use_ip`	`string` El parámetro use_ip indica a Singular que extraiga la dirección IP de la solicitud HTTP en lugar del parámetro 'ip'. Pase'true' para utilizar esta función. El uso de este parámetro impide que Singular geolocalice el dispositivo basándose en la dirección IP. Puede proporcionar el código de país de dos letras del usuario en el parámetro opcional 'country'. Este parámetro es mutuamente excluyente con el parámetro 'ip'. NO lo utilice con el parámetro "ip". Para evitar que se rechacen los datos, debe proporcionar el parámetro "ip" o el parámetro "use_ip" en la solicitud. Valor de ejemplo: `true`
Parámetro	Descripción
`country`	`string` El parámetro country debe contener el código de país de dos letras ISO 3166-1 alpha-2 del usuario en el momento de la ejecución del evento. Este parámetro sólo es necesario cuando El parámetro "ip" no está disponible Si el parámetro 'ip' está disponible, el país se determinará automáticamente a partir de la dirección IP, y el parámetro 'country' no es necesario. Valor de ejemplo: `US`
Parámetros de evento
Parámetro	Descripción
`e`	`JSON URL-encoded string` El parámetro e especifica atributos de evento personalizados en formato JSON. `{ "sng_attr_content_id":5581, "sng_attr_content":"XBox", "sng_attr_content_type":"electronics" }` Se recomienda encarecidamente utilizar la convención de nomenclatura de atributos de eventos estándar de Singular. Valor de ejemplo: `%7B%22sng_attr_content_id%22%3A5581%2C sng_attr_content%22%3A%22XBox%22%2C%22 sng_attr_content_type%22%3A%22electronics%22%7D`
Parámetros de ingresos
Parámetro	Descripción
`is_revenue_event`	`string` El parámetro is_revenue_event especifica si el evento es un evento de ingresos. Puede omitirlo si el nombre del evento es __iap__ o si se proporciona un importe distinto de cero. Valor de ejemplo: `true`
Parámetro	Descripción
`amt`	`double` El parámetro amt especifica el importe en divisa. Debe utilizarse junto con el parámetro 'cur'. Valor de ejemplo: `2.51`
Parámetro	Descripción
`cur`	`string` El parámetro cur especifica el código de moneda ISO 4217 de tres letras en mayúsculas. Debe utilizarse junto con el parámetro "amt". Valor de ejemplo: `USD`
Parámetro	Descripción
`purchase_receipt` Plataformas soportadas: Android iOS	`string` El parámetro purchase_receipt especifica el recibo recibido de una compra. Consulte las instrucciones a continuación sobre cómo recuperarlo desde Android, iOS Cómo recuperar el recibo de compra de Android. Cómo recuperar el recibo de compra de iOS. Ejemplo (iOS): `MIISqwYJKoZI...cNqts0jvcNvPcK7y uj0KhJ9nTTQ54kDKfReihzc6aw==` Ejemplo (Android): `%7B%22orderId%22%3A%22GPA.1234%22%2C%22packageName%22%3A%22com.example%22%2C%22productId%22%3A%22com.example.product%22%2C%22purchaseTime%22%3A1417113074914%2C%22purchaseState%22%3A0%2C%22purchaseToken%22%3A%22hakfcimbk...%20pM%22%7D`
Parámetro	Descripción
`receipt_signature` Plataformas soportadas: Android	`string` El parámetro receipt_signature especifica la firma utilizada para firmar el recibo de compra Valor de ejemplo: `TyVJfHg8OAoW7W4wuJt...5agEDMnNXvhfrw==`
Parámetro	Descripción
`purchase_product_id`	`string` El parámetro purchase_product_id especifica el identificador SKU del producto Valor de ejemplo: `com.example.product`
Parámetro	Descripción
`purchase_transaction_id`	`string` El parámetro purchase_transaction_id especifica el identificador de la transacción Ejemplo (iOS): `380000123004321` Ejemplo (Android): `GPA.1234-1234-1234-12345`
Privacidad de datos
Parámetro	Descripción
`data_sharing_options`	`JSON URL-encoded string` El parámetro data_sharing_options especifica el consentimiento del usuario final para compartir información. Si se establece, este valor debe persistir y pasarse en cada solicitud posterior de "SESSION" y "EVENT" para el usuario. Para indicar que el usuario ha dado su consentimiento (opted-in) para compartir su información pase 'false': `{"limit_data_sharing":false}` Si el usuario se negó, introduzca "true": `{"limit_data_sharing":true}` El valor debe ser una cadena JSON codificada en URL. Valor de ejemplo: `%7B%22limit_data_sharing%22%3Atrue%7D`
Soporte entre dispositivos
Parámetro	Descripción
`custom_user_id`	`string` El parámetro custom_user_id especifica su ID de usuario interno. Valor de ejemplo: `123456789abcd`
Soporte SkAdNetwork iOS
Parámetro	Descripción
`skan_conversion_value` Plataformas soportadas: iOS	`int` El parámetro skan_conversion_value especifica el último valor de conversión de SKAdNetwork en el momento de esta notificación de evento(más información sobre la implementación de SKAdNetwork). Valor de ejemplo: `7`
Parámetro	Descripción
`skan_first_call_timestamp` Plataformas soportadas: iOS	`int` El parámetro skan_first_call_timestamp especifica la marca de tiempo Unix de la primera llamada a la API SkAdNetwork subyacente(más información sobre la implementación de SKAdNetwork). Valor de ejemplo: `1483228800`
Parámetro	Descripción
`skan_last_call_timestamp` Plataformas soportadas: iOS	`int` El parámetro skan_last_call_timestamp especifica la marca de tiempo Unix de la última llamada a la API SkAdNetwork subyacente en el momento de esta notificación de evento(más información sobre la implementación de SKAdNetwork). Valor de ejemplo: `1483228800`

Prueba de eventos

Tras la integración de servidor a servidor, es esencial verificar que Singular recibe datos antes de poner en marcha una instancia de producción. Consulte nuestra guía de pruebas para obtener más detalles. A grandes rasgos, deben seguirse los siguientes pasos:

Obtenga el ID de publicidad de su dispositivo de prueba y añádalo a la consola de Singular SDK.
Abra la consola de Singular SDK y añada el identificador del dispositivo para empezar a capturar datos.
Anule el identificador de la App con un identificador de App de desarrollo(com.singular.app.dev) para mantener los datos y eventos de prueba separados de los datos de producción.
Cree o abra la aplicación desde un estado finalizado
Compruebe que la apertura de la aplicación se envía al servidor con todos los puntos de datos de Singular necesarios.
Compruebe que el servidor envía la notificación de sesión al punto final"launch" de Singular con todos los datos necesarios.
Después de unos segundos, el evento de sesión debe aparecer en la consola de Singular SDK.
Proceda a activar un evento en la aplicación.
Compruebe que el evento se envía al servidor con todos los datos necesarios de Singular.
Compruebe que su servidor envía la notificación de evento al punto final'evt' de Singular con todos los datos necesarios.
Después de unos segundos, el evento debería aparecer en la consola de Singular SDK.
Repita la prueba para validar que todos los eventos se envían según lo previsto y con los valores esperados.

Verificaciones importantes

Confirme que el Evento de Sesión se produce al Abrir la Aplicación o en Primer Plano y antes de que se reciba el Evento.
Confirme que los puntos de datos requeridos por el Evento, coinciden con los puntos de datos de la Sesión.

Si usted ve sus Eventos en la Consola SDK, ¡usted ha completado una prueba de extremo a extremo del manejo de Eventos!