O RudderStack é uma plataforma de dados de clientes (CDP) de código aberto que permite às empresas recolher, unificar e encaminhar dados de clientes para vários destinos. Fornece uma plataforma centralizada para gerir pipelines de dados de clientes, permitindo que as organizações recolham facilmente dados de várias fontes, como sites, aplicações móveis, servidores e serviços na nuvem.
O Singular SDK oferece muitas funcionalidades que não estão disponíveis através das opções de integração padrão "Device-Mode" ou "Cloud-Mode".
A integração por meio de uma metodologia híbrida é recomendada ao usar o Rudderstack com o Singular para aproveitar todos os recursos e funcionalidades do Singular.
A abordagem híbrida consiste em:
- Implementar o SDK do Singular independentemente do Rudderstack, permitindo que o SDK do Singular lide com o rastreamento de sessão, suporte adicional para estruturas de SDK (React Native, Unity, etc.), SkAdNetwork, deep link e deferred deep links e recursos avançados.
- Ativação da opção "Cloud-Mode" no Rudderstack para um destino singular. Isso permite que todos os eventos de rastreamento móvel do Rudderstack sejam enviados para o Destino do Singular.
As instruções abaixo ilustram como configurar uma implementação Singular Hybrid com o Rudderstack.
| Guia para | Equipes de engenharia |
| Pré-requisitos | Este artigo pressupõe que você já tenha o SDK do Rudderstack Mobile integrado ao seu aplicativo. |
Para usar essa integração, você deve estar usando os SDKs móveis do Rudderstack.
O SDK Singular fornecerá suporte para:
- Atribuição de instalação
- Suporte a SkAdNetwork
- Suporte ao referenciador de instalação do Google
- Suporte ao Referenciador de instalação META
- Atribuição de anúncios de pesquisa da Apple
- Rastreamento de eventos personalizados no aplicativo
- Rastreamento de receita
- ID de utilizador personalizado
- Suporte a propriedades globais
- Opções de privacidade
A integração do Rudderstack "Cloud-Mode" fornecerá suporte para:
- Rastreio de eventos personalizados na aplicação
- Rastreamento de receita
- ID de utilizador personalizado
Configuração híbrida
-
Integrar o SDK Singular
Implemente o Singular SDK independentemente do Rudderstack. Veja as opções e estruturas do SDK AQUI.
-
Habilitar o Rudderstack - Singular Destination (Cloud-Mode)
Siga o Guia AQUI.
Configuração adicional recomendada
Ao usar uma Metodologia Híbrida, recomenda-se passar o Rudderstack AnonymousId e o Rudderstack User ID para o SDK da Singular.
Tome nota e cuidado especial para implementar esses recursos opcionais da documentação do SDK. Os passos podem variar ligeiramente dependendo da estrutura que estiver a utilizar.
Implementar propriedades globais
Passe o Rudderstack AnonymousId para uma Propriedade Global Singular. Isto irá associar o Rudderstack AnonymousId aos dados ao nível do dispositivo do SDK.
A Propriedade Global deve ser configurada ao inicializar o SDK Singular com a chave: rudderstack_anonymous_id e o valor do Rudderstack anonymousId recuperado do SDK Rudderstack. O Rudderstack AnonymousID pode ser obtido a partir do Rudderstack SDK utilizando este método [iOS][Android].
[RSClient getInstance].anonymousId;Exemplo de configuração do SDK Singular
- (SingularConfig *)getConfig {
// Get the 3rd-party identifiers to set in Global Properties:
// If 3rd-party SDKs are providing any identifiers to Singular, the
// respective SDK must be initialized before Singular.
NSString* thirdPartyKey = @"rudderstack_anonymous_id";
NSString* thirdPartyValue = [RSClient getInstance].anonymousId;
// Singular Config Options
SingularConfig* config = [[SingularConfig alloc]
initWithApiKey:APIKEY andSecret:SECRET];
...
// Using Singular Global Properties feature to capture 3rd-party identifiers
[config setGlobalProperty:thirdPartyKey
withValue:thirdPartyValue overrideExisting:YES];
...
return config;}// (Optional) Get 3rd-party identifiers to set in Global Properties:
// If 3rd-party SDKs are providing any identifiers to Singular, the
// respective SDK must be initialized before Singular.
String thirdPartyKey = new String("rudderstack_anonymous_id");
String thirdPartyValue = new String(RudderClient.getInstance()?.anonymousId);
// Singular Config Options
SingularConfig config = new SingularConfig("SDK KEY", "SDK SECRET")
.withGlobalProperty(thirdPartyKey, thirdPartyValue, true);Implementar ID de utilizador personalizado
Passe o Rudderstack UserId para o método Singular Custom User ID. Isso associará o Rudderstack UserId aos dados de nível de dispositivo do SDK. Fornecer esse valor ao Singular no objeto Singular Config no momento da Inicialização do SDK do Singular também permitirá que o Singular envie o UserId no postback da Instalação para o Rudderstack. Leia mais sobre a documentação da estrutura do SDK que você está usando para a integração do Singular. Exemplo de[iOS][Android]
Além disso, o UserID será associado a qualquer evento in-app acionado nativamente a partir do Singular SDK.
Para os eventos "Cloud-Mode" recebidos, o Singular mapeou o ID de usuário personalizado para o valor do ID de usuário do Rudderstack.