Publicaciones de BI internas: Preguntas frecuentes y solución de problemas

Singular puede enviar notificaciones en tiempo real a su plataforma de BI sobre las instalaciones de aplicaciones, las reconexiones, los eventos dentro de la aplicación y cualquier otro evento. Estas notificaciones, conocidas como postbacks (o callbacks) internos de BI, pueden configurarse a través de la página de configuración de socios.

Resolución de problemas

He configurado las devoluciones internas de BI. ¿Cómo puedo comprobar si se están enviando correctamente?

Para ver un registro de los postbacks enviados por Singular:

  1. En Singular, vaya a Atribución > Exportar registros y seleccione el intervalo de fechas correspondiente y el tipo de registro Postbacks.
  2. En la lista de campos que se incluirán en el registro, asegúrese de seleccionar Response HTTP Code y Response HTTP Body.
  3. En el archivo de descarga, compruebe si los postbacks se enviaron correctamente y, en caso contrario, vea si puede identificar el motivo:
    • El campo Código HTTP de respuesta le indica si la devolución se envió correctamente. Un código 200 significa éxito; otros valores significan que hubo un error. Cuando hay un error en el envío, Singular reintenta el postback 5 veces más, en intervalos de 1, 5, 15, 30 y 60 minutos.
    • El campo Cuerpo HTTP de la respuesta puede incluir detalles adicionales sobre el error.

Si hay algún problema, compruebe su configuración y póngase en contacto con el servicio de asistencia de Singular.

Nota: Singular no controla cómo se procesan los datos en su plataforma. Los datos que ve en los registros son los mismos que Singular envió como postbacks a su BI.

PREGUNTAS FRECUENTES

¿Qué debo tener en cuenta antes de configurar los postbacks internos de BI?

Su sistema debe ser capaz de recibir postbacks (también conocidos como callbacks) e ingerir los datos correctamente. Asegúrese de que un miembro del equipo técnico participa en la planificación.

Nota: Existen otras formas de obtener datos de atribución a nivel de usuario de Singular:

¿Cómo configuro los postbacks internos de BI?
  1. Inicie sesión en su cuenta de Singular, vaya a Atribución > Configuración de socios y seleccione el socio de BI interno.
  2. En la ventana de configuración, asegúrese de proporcionar una URL de postback (por ejemplo, https://my_company_name.com/bi/event_endpoint?app=12) . Aquí es donde Singular enviará el postback a través de una solicitud POST.
  3. Configure las demás opciones de postback del mismo modo que lo haría para un postback de socio (consulte Cómo configurar un socio de atribución).

Tenga en cuenta que algunas redes tienen limitaciones especiales para compartir datos.

¿Cómo se envían las devoluciones? ¿Con qué frecuencia reintenta Singular el envío si se ha producido un problema?
  • Singular realiza una petición HTTP POST con la carga útil de datos en formato JSON (véase la estructura más abajo).
  • Si Singular recibe un código de respuesta HTTPS entre 500 y 599, reintenta el envío del postback (hay un máximo de 5 reintentos).
  • Los reintentos se intentan después de 1, 5, 15, 30 y 60 minutos desde el intento de envío original.
  • Para obtener una lista actualizada de las direcciones IP desde las que se envían los postbacks, consulte Direcciones IP del servidor de postbacks.
¿Cuál es la estructura de un postback Singular?

Singular envía los postbacks como un objeto JSON con los siguientes campos:

Clave Valor  
app_name Display Name of application string
longname Long name (bundle ID) of application string
platform iOS or Android string
event_name Name of the event. Some events sent in postbacks are auto-tracked or generated events. These events include installs, sessions, uninstalls, reinstalls, and revenue events. See Auto-Tracked Events. string
idfa Unhashed iOS advertising identifier of device string
idfv Unhashed iOS identifier for vendor string
aifa Unhashed Android advertising identifier of device string
android_id Unhashed Android ID. Available only if aifa (android advertising ID) is not available string
singular_id Deprecated - Used when LAT is enabled for iOS devices. Use IDFV. Singular internal ID string
event_utc_timestamp Event UNIX Timestamp number
click_utc_timestamp Click UNIX Timestamp number
install_utc_timestamp Install UNIX Timestamp number
is_organic 1 if event is Organic, 0 if attributed number
is_viewthrough 1 if attributed event is a view-through conversion, 0 otherwise number
network Name of network to which install is attributed, when available string
network_tiktok_restricted For view-through campaigns, subject to restrictions based on TikTok Ads' terms of service string
campaign Campaign name as specified in Attribution Tracking Tags string
campaign_group Campaign Group Name (available for certain Self-Attributing Partners) string
campaign_tiktok_restricted For view-through campaigns, subject to restrictions based on TikTok Ads' terms of service string
tracker_campaign_name Campaign Name as passed by the network. Available if passed in click in the pcn string
tracker_campaign_id Campaign ID as passed by the network. Available if passed in click in the pcid string
tracker_sub_ campaign_name Sub-campaign name as passed by the network. Available if passed in click in the pscn string
tracker_sub_ campaign_id Sub-campaign ID as passed by the network. Available if passed in click in the pscid string
tracker_creative_name Campaign creative name as passed by the network. Available if passed in click in the pcrn string
tracker_creative_id Campaign creative ID as passed by the network. Available if passed in click in the pcrid string
tracker_publisher_id Publisher ID as passed by the network. Available if passed in the click in ps string
tracker_publisher_ sub_id Publisher SUB ID as passed by the network. Available if passed in the click in pssn string
tracker_publisher_ site_name Publisher name as passed by the network. Available if passed in click in the psn string
tracker_publisher_ site_id Publisher ID as passed by the network. Available if passed in click in the psid string
tracker_publisher_ sub_site_name Sub-publisher name as passed by the network. Available if passed in click in the pssn string
tracker_publisher_ sub_site_id Sub-publisher ID as passed by the network. Available if passed in click in the pssid string
tracker_name Campaign name as specified in Attribution Tracking Tags string
partner_campaign Deprecated - Use tracker_campaign_name or tracker_campaign_id Campaign ID or Name as passed by the network. Available if passed in click string
partner_sub_campaign Deprecated - Use tracker_sub_campaign_name or tracker_sub_campaign_id Sub Campaign Name or ID as passed by the network. Available if passed in click string
partner_site Deprecated - Use tracker_publisher_site_name or tracker_publisher_site_id Source site or application for click. Available if passed in click string
partner_sub_site Deprecated - Use tracker_publisher_sub_site_name or tracker_publisher_sub_site_id Source sub site or application for click. Available if passed in click string
creative Creative Name or ID. Available only if provided in click string
site Source site & Sub Site for click. Available if passed in click string
user_id Custom user ID. Available if passed by the SDK string
singular_click_id Singular assigned click ID string
is_reengagement Will return '1' if attributed to a re-engagement campaign, '0' if not number
click_ip IP of the device at the time of the clicked ad string
os_version OS version of the device at the time of the clicked ad string
app_version App version of the device at the time of the install/event number
country Country from which user installed string
city City from which user installed string
limit_ad_tracking Do not track flag is set active will return '1', all other conditions will return '0' number
device_model Device model string
device_brand Device Brand string
match_type Whether the attribution is deterministic (device ID matching), probabilistic (Android only), or none (null value indicates an organic install). string
amount Revenue event postbacks only - The transaction amount in dollars and cents number
currency Revenue event postbacks only - The three-letter ISO 4217 currency code for the transaction string
is_first_event Returns '1' for first occurrence of an event (revenue or custom), '0' for every subsequent event from the same device ID number
fb_campaign_id Numeric Facebook Campaign ID. Subject to restrictions based on Facebook's terms of service number
fb_campaign_name Facebook Campaign name. Subject to restrictions based on Facebook's terms of service string
fb_adset_id Numeric Facebook Ad Set ID. Subject to restrictions based on Facebook's terms of service number
fb_adset_name Facebook Ad Set name. Subject to restrictions based on Facebook's terms of service string
fb_ad_id Numeric Facebook Ad ID. Subject to restrictions based on Facebook's terms of service number
fb_ad_name Facebook Ad name. Subject to restrictions based on Facebook's terms of service string
twitter_campaign_name Twitter Campaign Name. Subject to restrictions based on Twitter's terms of service string
twitter_campaign_id Twitter alphanumeric Campaign ID. Subject to restrictions based on Twitter's terms of service string
twitter_line_id Twitter alphanumeric Line Item ID. Subject to restrictions based on Twitter's terms of service string
fraud_status Fraud decision for installation. Available only when fraud postbacks are enabled. Possible values are "valid"/"suspicious"/"rejected" string
fraud_reason Name of rule that decided the fraud status (for example, the name of the rule that rejected the install). Available only when fraud postbacks are enabled. string
¿Cuáles son los diferentes eventos de ingresos(__IAP__, __REVENUE__, __ADMON_USER_LEVEL_REVENUE__)? ¿Para cuál o cuáles debo configurar los postbacks?
#

En el menú desplegable Eventos en la aplicación (SDK ), verá varios eventos diferentes relacionados con los ingresos, algunos de los cuales se solapan.

Para evitar que se envíen devoluciones duplicadas para el mismo evento dentro de la aplicación, siga las instrucciones que se indican a continuación.

Nombre del evento de ingresos
Descripción

__IAP__

An event triggered by any in-app purchases that have not been given a custom name in the SDK/S2S implementation.

(Custom revenue events)

In-app purchase events that have been given custom names in the SDK/S2S implementation also appear in the list.
__ADMON_ USER_LEVEL_REVENUE__ An event triggered by revenue gained from ad monetization (if you have set up ad revenue attribution using the method of sending SDK events).
__REVENUE__

An event triggered by any revenue coming into the app (including __IAP__, purchase events with custom names, and ad revenue events). See warning below.

Qué hacer si sólo tiene ingresos por comprasdentro de la aplicación:

  • Configure asignaciones para __IAP__ y cualquier evento de compra personalizado.
  • O, alternativamente, utilice __REVENUE__, que engloba todos sus eventos de compra dentro de la aplicación.

Qué hacer si tienes ingresos por compras dentro de la aplicación e ingresos por publicidad:

  • Configure asignaciones para __IAP__, cualquier evento de compra personalizado y __ADMON_USER_LEVEL_REVENUE__.
  • No recomendamos utilizar el evento general __REVENUE__ en este caso, ya que incluye tanto eventos de compras como de ingresos publicitarios, y asignar ambos tipos de ingresos al mismo evento de ingresos en el lado de la red puede causar problemas.
  • En su lugar, asigna los eventos de compra dentro de la aplicación al evento de compra de la red, y el evento __ADMON_USER_LEVEL_REVENUE__ al evento de ingresos por publicidad de la red.
  • Si no estás seguro de qué eventos utilizar por parte de la red, ponte en contacto con ella para obtener más información.

Advertencia: Si tu configuración actual para un socio envía devoluciones de correo __REVENUE__ y empiezas a tenereventos de ingresos por publicidad además de eventos de compras dentro de la aplicación, esto puede causar problemas si la red del socio no está configurada para recibir eventos de ingresos por publicidad o necesita que se asignen a un evento independiente. Consulta con la red si debes enviar devoluciones de ingresos publicitarios y cómo debes hacerlo.