O Segment é uma plataforma de infraestrutura de dados de clientes (CDI) que ajuda as empresas a recolher, limpar e encaminhar os dados dos seus clientes para vários destinos. Semelhante ao mParticle, o Segment fornece uma única API para recolher dados de várias fontes, incluindo sites, aplicações móveis, servidores e serviços na nuvem.

Primeiros passos

Configuração 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"]
        }
      }
    }];

Atribuição de instalação

Habilite o rastreamento automático de eventos de ciclo de vida (Aplicativo aberto, Aplicativo instalado, Aplicativo atualizado) usando parâmetros de configuração de inicialização(iOS, Android) para rastrear instalações e sessões no Singular. A "sessão" do Singular será enviada automaticamente pela integração, desde que você inclua os eventos acima.

Rastreamento de evento personalizado

Se você não estiver familiarizado com as especificações do Segment, dê uma olhada para entender o que o método Track faz.

Use a função Track do Segment para que os eventos sejam traduzidos e enviados para a Singular:

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

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

O Segment inclui todas as propriedades do evento como parâmetros de retorno de chamada no evento Singular.

Os eventos estarão disponíveis em relatórios e exportações ao nível do utilizador.

Observações:

• É altamente recomendável passar nomes e atributos de eventos em inglês para garantir a compatibilidade com parceiros de terceiros e soluções analíticas, se você planeja usá-los.
• Os nomes dos eventos estão limitados a 32 caracteres ASCII. As cadeias de caracteres em caracteres não-ASCII têm de ter menos de 32 bytes depois de convertidas para UTF-8.
• Os atributos e valores estão limitados a 500 caracteres ASCII.

Acompanhamento de receitas

A Singular receberá o rastreio de receitas quando for enviado um evento que contenha a propriedade revenue (incluindo o valor zero). Opcionalmente, pode passar a moeda (como um código de moeda ISO 4217 ). A moeda predefinida é 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 utilizador personalizado

Você pode enviar sua ID de usuário do segmento para a Singular usando o método de identificação do segmento.

• A ID de usuário pode ser qualquer identificador e não deve expor PII (Informações de identificação pessoal). Por exemplo, não deve utilizar o endereço de correio eletrónico, o nome de utilizador ou o número de telefone de um utilizador. A Singular recomenda o uso de um valor com hash exclusivo apenas para seus dados primários.
• O valor da ID de usuário passado para a Singular também deve ser a mesma ID de usuário interna que você captura em todas as plataformas (Web/Mobile/PC/Console/Offline).
• A Singular incluirá o ID de utilizador nas exportações ao nível do utilizador, ETL e postbacks do BI interno (se configurado). O ID do usuário é um dado primário e a Singular não o compartilha com outras partes.
• O valor da ID de usuário, quando definido, persistirá até que seja desmarcado usando o método de redefinição de segmento ou até que o aplicativo seja desinstalado. Fechar ou reiniciar o aplicativo não desinstala a ID do usuário.

Siga as etapas aqui para configurar para: iOS, Android.

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

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

Para cancelar a ID de usuário personalizada, chame o método de redefinição.

[[SEGAnalytics sharedAnalytics] reset];