Segment es una plataforma de infraestructura de datos de clientes (CDI ) que ayuda a las empresas a recopilar, limpiar y enrutar los datos de sus clientes a varios destinos. Al igual que mParticle, Segment proporciona una única API para recopilar datos de múltiples fuentes, incluidos sitios web, aplicaciones móviles, servidores y servicios en la nube.

Cómo empezar

Configuración adicional

pod "Analytics"
pod "Analytics-iAds-Attribution"

#import <Analytics-iAds-Attribution/SEGADTracker.h>

// Initialize the configuration as you would normally.
SEGAnalyticsConfiguration *configuration = [SEGAnalyticsConfiguration 
   configurationWithWriteKey:@"YOUR_WRITE_KEY"];
...

// Configure the client with the iAD middleware to attach iAd properties.
configuration.middlewares = @[ [SEGADTracker middleware] ];
[SEGAnalytics setupWithConfiguration:configuration];

import Analytics-iAds-Attribution

// Initialize the configuration as you would normally.
var configuration = SEGAnalyticsConfiguration(writeKey: "WriteKey")
...

// Configure the client with the iAD middleware to attach iAd properties.
configuration.middlewares = [SEGADTracker.middleware()]
    
SEGAnalytics.setup(with: configuration)

[analytics track:@"Application Installed",
    properties: nil,
    options: @{
      @"context" : @{
        @"campaign" : @{
          @"provider" : @"Apple",
          @"click_date" : attributionInfo[@"iad-click-date"],
          @"conversion_date" : attributionInfo[@"iad-conversion-date"],
          @"source" : @"iAd",
          @"name" : attributionInfo[@"iad-campaign-name"],
          @"content" : attributionInfo[@"iad-keyword"],
          @"ad_creative" : attributionInfo[@"iad-org-name"],
          @"ad_group" : attributionInfo[@"iad-adgroup-name"],
          @"id" : attributionInfo[@"iad-campaign-id"],
          @"ad_group_id" : attributionInfo[@"iad-adgroup-id"]
        }
      }
    }];

Atribución de instalación

Habilite el seguimiento automático de los eventos del ciclo de vida (Aplicación abierta, Aplicación instalada, Aplicación actualizada) mediante parámetros de configuración de inicialización(iOS, Android) para realizar un seguimiento de las instalaciones y las sesiones en Singular. La "sesión" de Singular será enviada automáticamente por la integración siempre que incluya los eventos anteriores.

Seguimiento de eventos personalizados

Si no está familiarizado con las especificaciones de Segment, eche un vistazo para entender lo que hace el método Track.

Utilice la función de seguimiento de Segment para que los eventos se traduzcan y se envíen a Singular:

[[SEGAnalytics sharedAnalytics] track:@"simple event"];

Analytics.with(this).track("event_name");

Segment incluye todas las propiedades del evento como parámetros de devolución de llamada en el evento Singular.

Los eventos estarán disponibles en informes y exportaciones a nivel de usuario.

Notas:

• Recomendamos encarecidamente pasar los nombres y atributos de los eventos en inglés para garantizar la compatibilidad con socios y soluciones de análisis de terceros si tiene previsto utilizarlos.
• Los nombres de eventos están limitados a 32 caracteres ASCII. Las cadenas en caracteres no ASCII deben ser inferiores a 32 bytes una vez convertidas a UTF-8.
• Los atributos y valores están limitados a 500 caracteres ASCII.

Seguimiento de ingresos

Singular recibirá el seguimiento de ingresos cuando se envíe un evento que contenga la propiedad de ingresos (incluido el valor cero). Opcionalmente puede pasar la moneda (como un código de moneda ISO 4217 ). La moneda por defecto es USD.

[[SEGAnalytics sharedAnalytics] track:@"segment revenue event" properties:@{@"currency": @"USD", @"revenue":@20}];

Analytics.with(this).track("purchase", new Properties().putRevenue(2.5).putValue("currency","USD"));

ID de usuario personalizado

Puede enviar su ID de usuario de segmento a Singular utilizando el método de identificación de segmento.

• El ID de usuario puede ser cualquier identificador y no debe exponer PII (Personally Identifiable Information). Por ejemplo, no debe utilizar la dirección de correo electrónico, el nombre de usuario o el número de teléfono del usuario. Singular recomienda utilizar un valor hash único sólo para sus datos de origen.
• El valor de ID de usuario que se pasa a Singular también debe ser el mismo ID de usuario interno que se captura en todas las plataformas (Web/Móvil/PC/Consola/Offline).
• Singular incluirá el ID de usuario en las exportaciones a nivel de usuario, ETL y devoluciones internas de BI (si está configurado). El ID de usuario es un dato de origen y Singular no lo comparte con terceros.
• El valor del ID de usuario, una vez establecido, persistirá hasta que se desactive mediante el método de restablecimiento de segmento o hasta que se desinstale la aplicación. Cerrar o reiniciar la aplicación no anula el ID de usuario.

Siga estos pasos para configurar: iOS, Android.

[[SEGAnalytics sharedAnalytics] identify:@"segment custom user id"];

Analytics.with(context).identify("myUserId");

Para desactivar el ID de usuario personalizado, utilice el método de restablecimiento.

[[SEGAnalytics sharedAnalytics] reset];