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 Segmento 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.

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). Puede pasar opcionalmente 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 Segment identify.

• 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 de un 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 para: iOS, Android.

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

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

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

[[SEGAnalytics sharedAnalytics] reset];