Configuración de KARTE
KARTE es un socio de analytics integrado con Adjust. Nuestra integración permite que KARTE reciba los datos medidos en Adjust por medio de callbacks automatizados. Puedes utilizar estos datos junto con las herramientas de los socios para fines analíticos.
En este artículo, puedes obtener información sobre cómo configurar la medición con KARTE para tu aplicación. Esto incluye la activación de la integración y la elección de los datos que Adjust puede enviar a KARTE.
Antes de comenzar
Requisitos
- Permisos de administrador, editor o editor personalizado en Adjust.
- Versión 4.0.0 o posterior del SDK de Adjust para asignar los parámetros de SDK a los parámetros de KARTE. Sigue las guías disponibles en los siguientes links para utilizar esta función.
iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
Credenciales
API KEY
- Si necesitas ayuda para encontrar tus credenciales, comunícate con tu representante de KARTE.
Selecciona KARTE y la aplicación en Campaign Lab
- En la sección Campaign Lab, selecciona Socios.
- Selecciona Nuevo socio > KARTE. Selecciona Siguiente para pasar a la siguiente pantalla.
- En la pantalla Selección de aplicación, elige la aplicación para la que desees crear el link y habilita la integración a fin de enviar los datos a KARTE.
- Selecciona Siguiente.
Habilita el uso compartido de datos
Habilita el uso compartido de datos para activar la integración con KARTE. Sigue estos pasos para habilitar el uso compartido de datos:
- Escribe tus API KEY.
Cuando habilites el envío de datos a KARTE, nuestro sistema enviará automáticamente los siguientes datos a KARTE de forma predeterminada:
- Instalación
- Reinstalar
- Reinstalación de reatribución
- Reatribución
- Evento
Configura tus opciones de envío de datos
Si trabajas con una aplicación multiplataforma que tiene habilitado el uso compartido de datos para varias plataformas, puedes hacer lo siguiente:
- Separar las opciones de uso compartido de datos a nivel de plataforma seleccionando Utilizar configuración específica para la plataforma.
- Utilizar las mismas opciones de uso compartido de datos para varias plataformas seleccionando Usar configuración global.
En el apartado ¿Qué se enviará de forma predeterminada?, revisa las actividades que nuestro sistema enviará a KARTE de forma predeterminada:
- Instalación
- Reinstalar
- Reinstalación de reatribución
- Reatribución
- Evento
Envía datos adicionales
Elige la cantidad y el tipo de datos que desees compartir con KARTE por medio de callbacks. KARTE puede utilizar esta información para optimizar rendimiento.
Para enviar datos adicionales, puedes revisar y personalizar las siguientes opciones:
Desinstalaciones o reinstalaciones
El envío de las desinstalaciones o reinstalaciones permite que KARTE reciba los datos de desinstalaciones y/o reinstalaciones de tu aplicación medidos por Adjust.
Para las aplicaciones de iOS, es posible que se registre un número reducido de desinstalaciones o reinstalaciones. Para obtener más información, consulta el artículo sobre medición de desinstalaciones y reinstalaciones.
Ingresos in-app (de compras in-app)
El envío de ingresos in-app permite que KARTE reciba los montos de los ingresos junto con tus datos de eventos de ingresos. Debes mapear eventos que generen ingresos para enviar estos datos.
Mapea eventos
Asigna los eventos que desees compartir a los valores que KARTE pueda recibir. Los datos de los eventos que no estén mapeados no se compartirán con KARTE.
Cómo mapear los eventos individuales
Si tienes una aplicación multiplataforma, puedes compartir diferentes eventos por plataforma con KARTE. Esto te permite hacer lo siguiente:
- Configurar eventos individuales para administrar las estrategias de tus campañas en cada plataforma.
- Personalizar el uso compartido de datos por plataforma.
En la sección Mapear eventos, sigue estos pasos para elegir los eventos in-app que desees enviar directamente a KARTE.
Selecciona Mapear evento.
En la lista de eventos de Adjust, elige el evento de Adjust que desees compartir con KARTE.
En la opción Evento de socio, debes seleccionar el evento de KARTE que corresponda con el evento de Adjust.
En el caso de las aplicaciones de una sola plataforma y las aplicaciones multiplataforma que tienen habilitado el uso compartido de datos para una sola plataforma, únicamente debes mapear los eventos para esa plataforma. En el caso de las aplicaciones multiplataforma que tienen habilitado el uso compartido de datos para varias plataformas, puedes hacer lo siguiente:
- Selecciona Utilizar mapeo específico para la plataforma si deseas mapear eventos independientes a nivel de plataforma, o si no deseas mapear ningún evento para determinadas plataformas.
- Selecciona Utilizar mapeo global si deseas mapear los mismos eventos para todas las plataformas.
En la lista de eventos de socio, elige o escribe el nombre del evento personalizado al que desees asignar el evento de Adjust.
Selecciona Aplicar.
Al hacer esto, KARTE recibirá los datos de eventos in-app de todos tus eventos vinculados.
Mapear todos los eventos
Si KARTE admite el mapeo automático de todos los eventos, en la opción Mapear eventos, selecciona Mapear todos los eventos. Esto te permite ahorrar tiempo al no tener que mapear los eventos de forma individual.
Cuando hagas esto, KARTE recibirá los datos de eventos in-app de todos tus eventos vinculados.
Mapea parámetros
Por lo general, debes mapear parámetros para enviar datos personalizados a KARTE.
Los parámetros de socios (disponibles a partir de la versión 4.0 del SDK de Adjust) permiten que Adjust recopile puntos de datos personalizados de tu aplicación y los envíe directamente hacia KARTE. Esto permite que KARTE reciba los detalles de eventos personalizados de todos tus eventos vinculados.
Antes de agregar nuevos parámetros de socios al SDK de Adjust, asegúrate de que no haya ningún parámetro de socio preexistente que cumpla con tus requisitos.
Para enviar los parámetros de socios a KARTE, sigue estos pasos.
Configura los parámetros de socios en el SDK de Adjust.
- En la sección Antes de comenzar puedes encontrar los links de todas las plataformas de desarrollo de SDK.
En la sección Configura tus opciones de envío de datos, selecciona Parámetros.
En la sección Mapear parámetros, puedes especificar cómo deseas enviar a la red los parámetros de socios definidos en el SDK:
- Selecciona Mapear parámetro.
- En el campo Parámetro de SDK, escribe el nombre del parámetro del SDK que desees compartir con la red.
- En el campo Parámetro de socio, escribe el parámetro de la red que corresponda con el parámetro del SDK.
Si configuras los parámetros de socios en el SDK de Adjust sin configurar el uso compartido de parámetros en el Dashboard, nuestro sistema reenviará los parámetros con el nombre que tengan en el SDK de Adjust.
Habilita a KARTE para tu aplicación
En la sección Revisión de la configuración, puedes revisar tus opciones. También puedes regresar y hacer cambios en los siguientes elementos:
- La aplicación que seleccionaste
- Opciones de uso compartido de datos
Selecciona Habilitar socio a fin de habilitar a KARTE para tu aplicación. Los socios de analytics no utilizan links para las campañas. Cuando lo habilites, nuestra integración enviará los datos de atribución y eventos in-app por medio de callbacks automatizados.
Instrucciones de configuración específicas para los socios
Parámetros predefinidos
Karte te permite enviar un conjunto de parámetros predefinidos. Si adjuntas cualquiera de estos parámetros a un evento en tu SDK de Adjust, el parámetro se reenviará a Karte. Puedes obtener más información acerca del proceso para adjuntar parámetros de socios en el archivo readme del SDK específico para el SDK o los SDK con los que trabajes. A continuación, te presentamos una lista de los parámetros definidos que acepta Karte:
Parameter key> Valor
- visitor_id> obligatorio para enviar callbacks a Karte.
Para enviar callbacks de eventos a Karte, debes implementar visitor_id como parámetro de sesión y parámetro de socio de evento en el SDK de Adjust. Debes tener activada la opción de Reenvío de parámetros en el Dashboard de Adjust.
Si deseas ver los detalles, consulta también la página de asistencia de Karte(JP).
Lista de todos los parámetros reenviados a KARTE
KARTE requiere que Adjust envíe los siguientes parámetros (data points) con tus callbacks:
| Placeholder | Información |
{adid} | ID del dispositivo de Adjust (todas las plataformas) |
{android_id} | ID de Android (solo Android) |
{api_level} | Nivel de API (únicamente para Android) |
{city} | Ciudad del dispositivo |
{click_attribution_window} | Configuración de la ventana de atribución para el matching de dispositivos (horas) |
{cost_amount} | Costo del engagement del usuario (disponible únicamente para el tracking del gasto publicitario) |
{cost_currency} | Código ISO 4217 de la moneda de los datos de costo (disponible únicamente para el tracking del gasto publicitario) |
{cost_type} | Modelo de precios de la campaña (disponible únicamente para el tracking del gasto publicitario) |
{country_subdivision} | Subdivisión del país del dispositivo, p. ej., estado |
{country} | Código de país de dos caracteres del dispositivo |
{currency} | Código ISO 4217 de la moneda original enviado desde el SDK de Adjust |
{deeplink} | URL de deep link anexada a la URL de clic |
{device_name} | Número de modelo del dispositivo |
{device_type} | Tipo de dispositivo |
{environment} | Configuración actual del entorno del SDK de Adjust |
{fire_adid} | Identificador de publicidad de Fire OS |
{gps_adid_md5} | Hash MD5 hexadecimal en minúsculas del ID de publicidad de Google Play Store |
{gps_adid} | ID de publicidad de Google Play Store |
{idfa} | ID para anunciantes (solo iOS) |
{idfv} | ID de iOS en mayúsculas para los proveedores |
{impression_attribution_window} | Configuración de la ventana de atribución para el matching de impresiones (horas) |
{inactive_user_definition} | Período de inactividad requerido para la reatribución (horas) |
{ip_address} | Dirección IP del dispositivo |
{isp} | Proveedor de internet del dispositivo |
{language} | Código de idioma de dos caracteres del dispositivo |
{last_time_spent} | Duración de la última sesión del usuario, en segundos |
{lifetime_session_count} | Número de sesiones registradas durante todo el ciclo de vida del usuario |
{match_type} | Método de atribución |
{nonce} | Cadena alfanumérica aleatoria en minúsculas (única para cada callback) |
{os_name} | Sistema operativo del dispositivo |
{os_version} | Número de versión del sistema operativo |
{partner_parameters} | Parámetros de socios personalizados recopilados por el SDK de Adjust o por la solicitud S2S, y transmitidos hacia los proveedores externos por medio de postbacks |
{postal_code} | Código postal del dispositivo de la dirección IP |
{random_user_id} | ID de usuario aleatorio (por dispositivo) |
{random} | Número aleatorio (único para cada callback) |
{reattribution_attribution_window} | Configuración de la ventana de atribución para la reatribución (horas) |
{reftag} | Etiqueta de referencia de dispositivo aleatorio |
{reporting_cost} | Costo del engagement del usuario convertido a la moneda de los informes de tu aplicación y como se muestra en los informes del Dashboard de Adjust (disponible únicamente para el tracking del gasto publicitario) |
{reporting_currency} | Código ISO 4217 de la moneda de los informes del Dashboard |
{reporting_revenue} | Ingresos, como aparecen en los informes del Dashboard de Adjust, en unidades de moneda enteras |
{revenue_float} | Ingresos, como se enviaron desde el SDK de Adjust, en unidades de moneda enteras |
{revenue} | Ingresos, como se enviaron desde el SDK de Adjust, en centavos |
{session_count} | Número de sesiones registradas por la versión actual del SDK de Adjust |
{time_spent} | Duración de la sesión actual del usuario, en segundos |
{timezone} | Zona horaria del dispositivo |
{tracking_enabled} | 1 si el tracking está habilitado, 0 si no lo está |
{tracking_limited} | 1 si el tracking está limitado, 0 si no lo está |
{user_agent} | Agente de usuario sin procesar entrante |
{activity_kind} | Tipo de actividad del usuario |
{adgroup_name} | Nombre del grupo de anuncios como aparece en el tracker |
{app_id} | ID de la tienda de aplicaciones o de Google Play Store |
{app_name_dashboard} | Nombre de la aplicación en el Dashboard de Adjust |
{app_version_raw} | Número de versión de la aplicación (Android), número de versión del paquete (iOS) |
{app_version_short} | Número de versión de la aplicación (Android), número de versión del paquete (iOS) |
{app_version} | Número de versión de la aplicación (Android), número de versión del paquete (iOS) |
{attribution_updated_at} | Marca de tiempo de la atribución actualizada |
{campaign_name} | Nombre de la campaña como aparece en el tracker |
{click_time} | Marca de tiempo del clic atribuido |
{connection_type} | Tipo de conexión a internet |
{conversion_duration} | Tiempo transcurrido entre el clic y la instalación o la reatribución, en segundos |
{created_at} | Marca de tiempo de la actividad |
{creative_name} | Nombre del elemento creativo como aparece en el tracker |
{engagement_time} | Marca de tiempo del engagement |
{impression_based} | 1 si el engagement está basado en impresiones, 0 si no lo está |
{impression_time} | Marca de tiempo de la impresión atribuida |
{install_begin_time} | Marca de tiempo del momento en el que comenzó la descarga de la aplicación (únicamente para Android y Google Play Store) |
{install_finish_time} | Marca de tiempo del momento en el que se completó la descarga de la aplicación |
{installed_at} | Marca de tiempo de la instalación (es decir, la primera vez que se abre la aplicación) |
{is_organic} | 1 si el tráfico es orgánico, 0 si no es orgánico |
{last_session_time} | Marca de tiempo de la última sesión |
{network_name} | Nombre de la red como aparece en el tracker |
{reattributed_at} | Marca de tiempo de la reatribución |
{referral_time} | Marca de tiempo del momento en el que el usuario llegó a la página de la aplicación en Play Store (únicamente para Android y Google Play Store) |
{reinstalled_at} | Marca de tiempo de la reinstalación |
{store} | Tienda objetivo del clic |
{time_to_reinstall} | Tiempo transcurrido entre la desinstalación más reciente de la aplicación y la reinstalación subsecuente, en segundos |
{time_to_uninstall} | Tiempo transcurrido entre la instalación de la aplicación (o la reinstalación más reciente) y la desinstalación subsecuente, en segundos |
{tracker_name} | Nombre del tracker actual |
{uninstalled_at} | Marca de tiempo de la desinstalación (cálculo basado en el horario de la última sesión) |
{google_ads_creative_id} | ID del elemento creativo de Google Ads |