Referência da API do ponto final SESSION
Caso de uso de servidor para servidor
A API REST da Singular permite a integração direta servidor-a-servidor como alternativa ao SDK. O LAUNCH ou Session Endpoint permite o rastreio de sessões nas suas aplicações. Quando seu aplicativo encaminha dados específicos do dispositivo para seu servidor, que então transmite os dados para os servidores da Singular, a plataforma Singular processa essas informações para: Atribuição de instalação, Atribuição de reengajamento e Métricas de retenção. Esses dados processados preenchem automaticamente seus relatórios, logs de exportação e postbacks configurados, fornecendo análises abrangentes para suas campanhas de marketing.
Enquanto o SDK recolhe automaticamente os dados do dispositivo e da aplicação, a abordagem S2S exige que:
- Recolha os pontos de dados necessários da sua aplicação
- Encaminhar esses dados para seu servidor
- Envie-os para o Singular via API REST
- Passar a resposta do Singular de volta para o aplicativo
Pontos principais
- Flexibilidade: Controlo total sobre a recolha e transmissão de dados
- Paridade de recursos: Suporta todas as funcionalidades do SDK quando os dados adequados são fornecidos
- Caminho de integração: Cliente → Seu Servidor → API Singular
- Processamento em tempo real: Um pedido de cada vez, sem processamento em lote
- Fluxo de dados sequencial: Os eventos devem ser processados por ordem cronológica
- Deduplicação de dados: O Singular não deduplica os dados recebidos. Recomenda-se enviar uma (1) solicitação bem-sucedida e salvar os logs para o caso de uma solicitação ser reproduzida novamente.
- Validação de dados: Os dados no nível do dispositivo são permanentes e não podem ser excluídos após a ingestão. Implemente uma validação completa dos dados antes de enviá-los à Singular para garantir a precisão.
Gerenciamento de sessão
O endpoint LAUNCH é usado para notificar a Singular sobre um evento de abertura de aplicativo para uma nova sessão de usuário.
-
A inicialização da sessão (solicitação de lançamento) é necessária para:
- Novas instalações de aplicativos
- Lançamentos de aplicativos a partir do estado terminado
- O aplicativo retorna do segundo plano para o primeiro plano
- A sessão deve ser estabelecida antes de qualquer rastreio de eventos
- Uma ordem de sessão inválida resultará em inconsistências de dados
- Recomenda-se a implementação de um tempo limite de sessão e o envio da notificação SESSION ao Singular apenas se a aplicação não tiver sido utilizada nos últimos 1 minuto. Se um utilizador colocar a aplicação em segundo plano e, em seguida, colocar a aplicação em primeiro plano no espaço de 1 minuto ou menos, tal não deverá desencadear uma SESSION Singular, mas se colocar a aplicação em primeiro plano num período superior a 1 minuto, deverá desencadear uma SESSION.
- Para suportar o deep linking, deve ser sempre enviada uma Session para a abertura da aplicação com o openURL no parâmetro 'open_uri'.
Como começar
A documentação do ponto de extremidade Session fornece:
- Parâmetros obrigatórios
- Parâmetros opcionais
- Exemplos de pedidos
- Códigos de resposta e erros
- Teste de sessão
Certifique-se de revisar as opções avançadas da integração Servidor para Servidor (S2S) da Singular, que exigem que o Ponto de extremidade de notificação de sessão inclua parâmetros adicionais. Saiba mais sobre as opções avançadas aqui.
Relatórios de sessões
A integração mais básica com o Singular envolve a notificação do Singular quando ocorre uma sessão de usuário, permitindo que o Singular acione vários processos internos:
- Se for a primeira sessão do aplicativo no dispositivo específico, o Singular reconhece uma nova instalação e aciona o processo de atribuição de instalação.
- Se a sessão se qualificar como uma sessão de reengajamento, o Singular aciona o processo de atribuição de reengajamento (saiba mais nas Perguntas frequentes sobre reengajamento).
- Caso contrário, o Singular marca a sessão como uma sessão, que é usada para rastrear a atividade do usuário e as métricas de retenção.
O tempo de uma solicitação de sessão e as solicitações de eventos subsequentes para os servidores do Singular são críticos:
-
Uma única sessão deve ser recebida antes de qualquer evento.
Por exemplo, o SDK do Singular acionará uma sessão na abertura do aplicativo quando um usuário começar a usar o aplicativo e, em seguida, os eventos no aplicativo poderão ser enviados após a sessão. Se o utilizador colocar a aplicação em segundo plano durante um período de tempo prolongado (superior a 1 minuto), a sessão será encerrada. Outra sessão seria enviada quando a aplicação voltasse ao primeiro plano. É recomendável usar eventos do ciclo de vida do aplicativo e um timer para ajudar a gerenciar o gerenciamento de sessões e regular as solicitações de sessão para o Singular. - Os eventos que ocorrem no aplicativo devem ser enviados em tempo real e após sua respectiva sessão.
Ponto de extremidade da API de sessão
Método HTTP e ponto de extremidade da sessão
GET https://s2s.singular.net/api/v1/launchParâmetros necessários
A tabela a seguir lista os parâmetros necessários que este endpoint suporta. Todos os parâmetros listados são parâmetros de consulta.
GET /api/v1/launch?param1=value1¶m2=value2
- Todos os parâmetros necessários têm de ser incluídos nos pedidos de API de SESSÃO
- Os parâmetros devem seguir o formato e os tipos de dados especificados
| Parâmetros necessários | |
|---|---|
| Chave da API | |
| Parâmetro | Descrição |
|
O parâmetro a especifica a Chave SDK Singular. Recupere a Chave SDK na IU do Singular, em Ferramentas de Desenvolvedor no Menu Principal. Nota: Não use a chave da API de relatório, pois isso resultará em dados rejeitados. Exemplo de valor: |
| Parâmetros do identificador do dispositivo | |
| Parâmetro | Descrição do parâmetro |
Plataformas suportadas:
|
O parâmetro idfa especifica o Identificador para Anunciantes (IDFA), que ajuda os anunciantes a rastrear e atribuir acções do utilizador (por exemplo, cliques em anúncios, instalações de aplicações) a campanhas específicas, permitindo uma segmentação precisa dos anúncios e a otimização das campanhas. A partir do iOS 14.5, os utilizadores devem aderir através da estrutura App Tracking Transparency (ATT) para que as aplicações possam aceder ao IDFA. Se os utilizadores não optarem por aderir ao IDFA, este não estará disponível, o que resulta na limitação das capacidades de rastreio.
Exemplo de valor: |
| Parâmetro | Descrição do parâmetro |
Plataformas suportadas:
|
O parâmetro idfv especifica o Identificador para Fornecedores (IDFV), um identificador único atribuído pela Apple a um dispositivo, que é específico de um determinado fornecedor ou programador. Permanece consistente em todas as aplicações do mesmo fornecedor num determinado dispositivo, permitindo ao fornecedor seguir o comportamento e as interações do utilizador no seu ecossistema de aplicações sem identificar o utilizador pessoalmente.
Exemplo de valor: |
| Parâmetro | Descrição do parâmetro |
Plataformas suportadas:
|
O parâmetro aifa especifica o Google Advertising Identifier (GAID), também conhecido como AIFA no singular ou Android Advertising ID (AAID). Este identificador é um identificador único, redefinível pelo utilizador, atribuído a dispositivos Android. Ajuda os anunciantes e os programadores de aplicações a rastrear e atribuir acções do utilizador (por exemplo, cliques em anúncios, instalações de aplicações) em aplicações a campanhas específicas, permitindo uma segmentação precisa dos anúncios e a otimização das campanhas, mantendo a privacidade do utilizador.
Exemplo de valor: |
| Parâmetro | Descrição do parâmetro |
Plataformas suportadas:
|
O parâmetro asid especifica o ID do conjunto de aplicações do Android. O ASID fornece uma forma de os programadores acompanharem os utilizadores nas suas próprias aplicações de uma forma consciente da privacidade. É particularmente útil para análises e prevenção de fraudes, mas não pode ser utilizado para fins publicitários, como anúncios personalizados ou medições.
Exemplo de valor: |
| Parâmetro | Descrição do parâmetro |
Plataformas suportadas:
|
O parâmetro amid especifica que a ID de publicidade é um identificador exclusivo e redefinível pelo utilizador que ajuda a proteger a privacidade do utilizador. Se recolher informações sobre o comportamento de um utilizador para apresentar anúncios baseados em interesses ou para gerar análises, tem de utilizar a ID de publicidade; não pode ser utilizado qualquer outro identificador ou método de rastreio. Os utilizadores podem redefinir a ID de publicidade ou optar por não utilizar anúncios baseados em interesses.
Exemplo de valor: |
| Parâmetro | Descrição do parâmetro |
Plataformas suportadas:
|
O parâmetro oaid especifica o Open Advertising Identifier (OAID). O OAID é um identificador único e anónimo utilizado para fins publicitários em dispositivos Android, especialmente os fabricados na China. Foi introduzido pela Mobile Security Alliance (MSA) como alternativa ao GAID (Advertising ID) da Google para dispositivos em que o Google Play Services não está disponível ou não é suportado, como no mercado chinês. O OAID é utilizado principalmente para atribuição de publicidade e seguimento de utilizadores em ambientes onde o Google Play Services é restrito, permitindo aos anunciantes e programadores seguir o comportamento dos utilizadores mantendo o anonimato. O OAID está disponível na maioria dos dispositivos Android fabricados na China, incluindo os de marcas como a Huawei, a Xiaomi e outras. Pode ser acedido através do MSA SDK ou dos Huawei Mobile Services (HMS).
Exemplo de valor: |
| Parâmetro | Descrição do parâmetro |
Plataformas suportadas:
|
O parâmetro andi especifica o ID do Android, que é um identificador único de 64 bits gerado pelo sistema operativo Android quando um dispositivo é configurado pela primeira vez. Foi concebido para ser persistente ao longo da vida útil do dispositivo, mas pode ser reposto em determinadas condições, como uma reposição de fábrica. O ID Android é único para cada dispositivo e, a partir do Android 8.0 (Oreo), tem um âmbito por aplicação e por utilizador. Isto significa que diferentes aplicações no mesmo dispositivo receberão diferentes IDs Android, a menos que partilhem a mesma chave de assinatura. A ID Android mantém-se constante, a menos que o dispositivo seja reiniciado de fábrica ou se uma aplicação for desinstalada e reinstalada após uma atualização OTA (over-the-air).
Exemplo de valor: |
| Parâmetro | Descrição do parâmetro |
Plataformas suportadas:
|
O parâmetro sdid especifica o ID de dispositivo único. Este valor é um UUIDv4 gerado no lado do cliente que representa uma instalação de aplicação única. Este é o único identificador de dispositivo utilizado para aplicações de PC e consola. Exemplo de valor: |
| Parâmetro | Descrição do parâmetro |
Plataformas suportadas:
|
O parâmetro sing é restrito a clientes Enterprise e especifica um identificador definido pelo cliente. Apenas utilizado em utilizações especiais em que todos os outros identificadores não estão disponíveis. Este identificador deve ser ativado pelo Engenheiro de Soluções Singular numa base App-by-App. Exemplo de valor: |
| Parâmetros do dispositivo | |
| Parâmetro | Descrição |
|
O parâmetro p especifica a plataforma da aplicação. A lista seguinte contém os valores de parâmetros sensíveis a maiúsculas e minúsculas permitidos:
Exemplo de valor: |
| Parâmetro | Descrição |
|
O parâmetro ip especifica o endereço IP público (IPV4) do dispositivo. O IPV6 não é suportado. Exemplo de valor: |
| Parâmetro | Descrição |
|
O parâmetro ve especifica a versão do sistema operativo do dispositivo no momento da sessão. Exemplo de valor: |
| Parâmetro | Descrição do parâmetro |
Plataformas suportadas:
|
O parâmetro ma especifica a marca do hardware do dispositivo, normalmente o nome virado para o consumidor. Este parâmetro deve ser utilizado com o parâmetro model. Como obter a marca do dispositivo Exemplos: |
| Parâmetro | Descrição do parâmetro |
Plataformas suportadas:
|
O parâmetro mo especifica o modelo do hardware do dispositivo. Este parâmetro deve ser utilizado com o parâmetro make. Como obter o modelo do dispositivo Exemplos: |
| Parâmetro | Descrição |
Plataformas suportadas:
|
O parâmetro lc especifica a etiqueta de localidade IETF para o dispositivo, utilizando o código de duas letras do idioma e do país, separados por um sublinhado. Como recuperar a localidade do dispositivo Exemplo de valor: |
| Parâmetro | Descrição do parâmetro |
Plataformas suportadas:
|
O parâmetro bd especifica a construção do dispositivo, codificada por URL. Como obter a compilação do dispositivo Exemplo de valor: |
| Parâmetros da aplicação | |
| Parâmetro | Descrição |
|
O parâmetro i especifica o identificador da aplicação. Este é o Nome do Pacote para Android ou o ID do Pacote para iOS ou da sua aplicação. valores de parâmetro sensíveis a maiúsculas e minúsculas :
Exemplo de valor: |
| Parâmetro | Descrição |
|
O parâmetro app_v indica a versão da aplicação. Exemplos: |
| Parâmetro | Descrição |
|
O parâmetro install especifica se esta sessão representa a primeira sessão após uma instalação ou reinstalação. Passe"true" se a sessão foi a primeira após a instalação da aplicação ou"false" se a aplicação já estiver instalada e esta for uma sessão subsequente ou uma aplicação aberta. Este parâmetro é necessário para as capacidades de controlo de Reinstalação. Exemplos: |
| Parâmetro | Descrição |
Plataformas suportadas:
|
O parâmetro install_time especifica a hora da primeira instalação da aplicação como hora UNIX. Para recuperar esse valor, use o link na plataforma. Exemplo de valor: |
| Parâmetro | Descrição do parâmetro |
Plataformas suportadas:
|
O parâmetro update_time especifica a hora da última atualização da aplicação como hora UNIX. Para recuperar esse valor, use o link na plataforma. Exemplo de valor: |
| Parâmetro | Descrição do parâmetro |
Plataformas suportadas:
|
O parâmetro att_authorization_status especifica o código de estado App Tracking Transparency (ATT). A partir do iOS 14.5, o prompt App Tracking Transparency (ATT) é necessário para aceder ao identificador IDFA. Nota: Mesmo que não implemente a solicitação ATT, exigimos que passe o estado de autorização ATT com o valor'0', indicando "indeterminado". Os valores suportados são:
Exemplos: |
| Parâmetros de fraude | |
| Parâmetro | Descrição |
Plataformas suportadas:
|
O parâmetro install_source especifica o nome do pacote da fonte de instalação no Android. Os valores recomendados para a fonte de instalação no PC são a loja de instalação. Os nomes de lojas de instalação suportados para PC incluem:
Exemplo para Android (Google Play Store): |
| Parâmetro | Descrição |
Plataformas suportadas:
|
O parâmetro install_receipt especifica o recibo recebido da instalação. Saiba como recuperá-lo em Recibo de instalação do iOS Exemplo de uma cadeia de recibos codificada em base64 do iOS: |
| Parâmetros de Deeplinking | |
| Parâmetro | Descrição do parâmetro |
Plataformas suportadas:
|
O parâmetro openuri especifica se o aplicativo foi aberto por meio de qualquer link profundo, iOS Universal Link ou Android App Link e você deve fornecer o valor de URL aberto codificado por URL. Abrir URL:Exemplo de valor: |
| Parâmetro | Descrição do parâmetro |
Plataformas suportadas:
|
O parâmetro ddl_enabled especifica se o aplicativo está habilitado para suportar Deferred deep links. Passe"true" se o servidor espera que um URL de link profundo diferido seja retornado ou"false" caso contrário. Exemplo de valor: Resposta de exemplo: |
| Parâmetro | Descrição do parâmetro |
Plataformas suportadas:
|
O parâmetro singular_link_resolve_required é utilizado para resolver uma ligação curta Singular. Deve ser enviado com um valor no 'openuri' que seja uma ligação curta Singular. Passe'true' se o servidor espera que a ligação curta expandida (ligação longa) seja devolvida ou'false' caso contrário. Consulte Tratamento de links curtos. Exemplo de valor: Resposta de exemplo: |
| Parâmetros avançados de atribuição | |
| Parâmetro | Descrição do parâmetro |
Plataformas suportadas:
|
O parâmetro install_ref especifica se o Google Install Referrer Information. O referenciador de instalação contém informações sobre quem enviou um usuário para a Google Play Store. Quando o referenciador de instalação está disponível para o Singular, ele fornece a maneira mais precisa de atribuir instalações. Recupere esse valor e passe-o para o Singular na primeira chamada de notificação de sessão. Ele é necessário para alguns recursos importantes do Singular, como receber dados do Facebook em nossas Exportações de nível de usuário, compartilhá-los com Destinos de dados e enviar postbacks. O Google Play recolhe informações de referenciador quando um utilizador chega à loja. Se o utilizador instalar posteriormente a aplicação para a qual foi direcionado, o Google Play disponibiliza as informações à aplicação. Para mais informações, consulte a documentação do Google para programadores. Exemplo de valor: |
| Parâmetro | Descrição do parâmetro |
Plataformas suportadas:
|
O parâmetro meta_ref especifica o "Meta Referrer", que é uma solução de medição específica do Android introduzida pelo Facebook para permitir aos anunciantes o acesso a dados de atribuição granulares ao nível do utilizador para instalações de aplicações Android (consulte as políticas de dados do Facebook). É composta pela implementação das tecnologias "Google Play Install Referrer" (consulte "Passar Google Install Referrer") e "Meta Install Referrer" para a medição da instalação da aplicação. Leia mais sobre o Meta Referrer nas Perguntas frequentes sobre o tópico. Exemplo de valor: |
| Parâmetro | Descrição do parâmetro |
Plataformas suportadas:
|
O parâmetro attribution_token especifica o token de atribuição do Apple Search Ads recuperado no iOS 14.3+ através da estrutura AdServices. Recupere o token de atribuição usando attributionToken() assim que o aplicativo for inicializado pela primeira vez após uma instalação ou reinstalação. Exemplo de valor: |
Corpo da solicitação
Não forneça um corpo de pedido ao chamar este método. O pedido deve ser enviado utilizando o método GET com parâmetros de consulta.
Exemplos de pedidos
Os seguintes exemplos de código podem não representar todos os parâmetros suportados. Ao implementar o pedido, certifique-se de que inclui todos os parâmetros necessários, conforme listado acima, e valide se os valores corretos estão a ser passados antes de enviar dados de uma instância de produção. Aconselha-se a utilização de um parâmetro `i` único (identificador da aplicação) para desenvolvimento e teste.
PYTHON
import requests
params = {
'a': 'sdk_key_here',
'p': 'Android',
'i': 'com.singular.app',
'ip': '10.1.2.3',
've': '9.2',
'ma': 'samsung',
'mo': 'SM-G935F',
'lc': 'en_US',
'aifa': '8ecd7512-2864-440c-93f3-a3cabe62525b',
'asid': 'edee92a2-7b2f-45f4-a509-840f170fc6d9',
'install': 'true',
'n': 'MyCoolAppName',
'bd': 'Build/13D15',
'app_v': '1.2.3',
'openuri': 'myapp://home/page?queryparam1=value1',
'ddl_enabled': 'true',
'install_source': 'com.android.vending',
'install_time': 1510040127,
'update_time': 1510090877
}
response = requests.get('https://s2s.singular.net/api/v1/launch', params=params)
print(response.json())CURL
curl -G "https://s2s.singular.net/api/v1/launch" \
--data-urlencode "a=sdk_key_here" \
--data-urlencode "p=Android" \
--data-urlencode "i=com.singular.app" \
--data-urlencode "ip=10.1.2.3" \
--data-urlencode "ve=9.2" \
--data-urlencode "ma=samsung" \
--data-urlencode "mo=SM-G935F" \
--data-urlencode "lc=en_US" \
--data-urlencode "aifa=8ecd7512-2864-440c-93f3-a3cabe62525b" \
--data-urlencode "asid=edee92a2-7b2f-45f4-a509-840f170fc6d9" \
--data-urlencode "install=true" \
--data-urlencode "n=MyCoolAppName" \
--data-urlencode "bd=Build/13D15" \
--data-urlencode "app_v=1.2.3" \
--data-urlencode "openuri=myapp://home/page?queryparam1=value1" \
--data-urlencode "ddl_enabled=true" \
--data-urlencode "install_source=com.android.vending" \
--data-urlencode "install_time=1510040127" \
--data-urlencode "update_time=1510090877"HTTP
GET /api/v1/launch
?a=sdk_key_here
&p=Android
&i=com.singular.app
&ip=10.1.2.3
&ve=9.2
&ma=samsung
&mo=SM-G935F
&lc=en_US
&aifa=8ecd7512-2864-440c-93f3-a3cabe62525b
&asid=edee92a2-7b2f-45f4-a509-840f170fc6d9
&install=true
&n=MyCoolAppName
&bd=Build%2F13D15
&app_v=1.2.3
&openuri=myapp%3A%2F%2Fhome%2Fpage%3Fqueryparam1%3Dvalue1
&ddl_enabled=true
&install_source=com.android.vending
&install_time=1510040127
&update_time=1510090877 HTTP/1.1
Host: s2s.singular.net
Accept: application/json
Exemplo JAVA
// Base URL
String baseUrl = "https://s2s.singular.net/api/v1/launch";
// Parameters
Map < String, String > params = new HashMap < > ();
params.put("a", "sdk_key_here");
params.put("p", "Android");
params.put("i", "com.singular.app");
params.put("ip", "10.1.2.3");
params.put("ve", "9.2");
params.put("ma", "samsung");
params.put("mo", "SM-G935F");
params.put("lc", "en_US");
params.put("aifa", "8ecd7512-2864-440c-93f3-a3cabe62525b");
params.put("asid", "edee92a2-7b2f-45f4-a509-840f170fc6d9");
params.put("install", "true");
params.put("n", "MyCoolAppName");
params.put("bd", "Build/13D15");
params.put("app_v", "1.2.3");
params.put("openuri", "myapp://home/page?queryparam1=value1");
params.put("ddl_enabled", "true");
params.put("install_source", "com.android.vending");
params.put("install_time", "1510040127");
params.put("update_time", "1510090877");
// Build URL with encoded parameters
StringBuilder urlBuilder = new StringBuilder(baseUrl);
urlBuilder.append('?');
for (Map.Entry < String, String > entry: params.entrySet()) {
if (urlBuilder.length() > baseUrl.length() + 1) {
urlBuilder.append('&');
}
urlBuilder.append(URLEncoder.encode(entry.getKey(), StandardCharsets.UTF_8))
.append('=')
.append(URLEncoder.encode(entry.getValue(), StandardCharsets.UTF_8));
}
// Create connection
URL url = new URL(urlBuilder.toString());
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("GET");
conn.setRequestProperty("Accept", "application/json");
// Get response
int responseCode = conn.getResponseCode();
BufferedReader in = new BufferedReader(
new InputStreamReader(conn.getInputStream())
);
String inputLine;
StringBuilder response = new StringBuilder();
while ((inputLine = in .readLine()) != null) {
response.append(inputLine);
} in .close();
// Check application-level status
System.out.println("HTTP Status Code: " + responseCode);
System.out.println("Response: " + response.toString());
// Disconnect
conn.disconnect();
Parâmetros opcionais
A tabela seguinte lista os parâmetros opcionais que este ponto final suporta. Todos os parâmetros listados são parâmetros de consulta.
| Parâmetros opcionais | |
|---|---|
| Parâmetros de carimbo de data/hora | |
| Parâmetro | Descrição |
|
O parâmetro utime especifica a hora da sessão em tempo UNIX de 10 dígitos.
Exemplo de valor: |
| Parâmetro | Descrição |
|
O parâmetro umilisec especifica o tempo da sessão em milissegundos, em hora UNIX de 13 dígitos.
Exemplo de valor: |
| Parâmetros do dispositivo e da rede | |
| Parâmetro | Descrição |
|
O parâmetro global_properties aceita um objeto JSON codificado por URL que contém até 5 pares de valores chave. Cada chave e valor pode ter um comprimento máximo de 200 caracteres. O objeto JSON tem de ser:
Exemplo de valor: |
| Parâmetro | Descrição |
|
O parâmetro use_ip diz ao Singular para extrair o endereço IP da solicitação HTTP em vez do parâmetro 'ip'. Passe'true' para usar esse recurso.
Exemplo de valor: |
| Parâmetro | Descrição |
|
O parâmetro country deve conter o código de país de duas letras ISO 3166-1 alfa-2 do utilizador no momento da execução da sessão. Este parâmetro só é necessário quando:
Exemplo Valor: |
| Parâmetro | Descrição |
|
O parâmetro ua especifica o User Agent (agente do utilizador) do dispositivo. O valor tem de ser codificado por URL.
Exemplo de valor: |
| Parâmetro | Descrição |
Plataformas suportadas:
|
O parâmetro c especifica o tipo de ligação de rede"wifi" ou"carrier".
Exemplo de valor: |
| Parâmetro | Descrição do parâmetro |
Plataformas suportadas:
|
O parâmetro cn especifica o nome da Operadora do provedor de internet.
Exemplo de valor: |
| Desinstalar o suporte de rastreio | |
| Parâmetro | Descrição |
Plataformas suportadas:
|
O parâmetro apns_token especifica o Token de Dispositivo do Serviço de Notificação Push da Apple (APNS).
Exemplo de valor: |
| Parâmetro | Descrição do parâmetro |
Plataformas suportadas:
|
O parâmetro fcm especifica o Token de dispositivo do Firebase Cloud Messaging.
Exemplo Valor: |
| Privacidade de dados | |
| Parâmetro | Descrição |
|
O parâmetro data_sharing_options especifica o consentimento do utilizador final para partilhar informações. Se for definido, este valor deve ser mantido e transmitido em todos os pedidos subsequentes de "SESSION" e "EVENT" para o utilizador.
O valor tem de ser uma cadeia de caracteres JSON codificada por URL.
Exemplo de valor: |
| Parâmetro | Descrição do parâmetro |
Plataformas suportadas:
|
O parâmetro dnt especifica o estado do Do Not Track. Passa 1 se a opção "Do Not Track" estiver activada ou 0 se a opção "Do Not Track" estiver desactivada. Exemplo de valor: |
| Parâmetro | Descrição do parâmetro |
Plataformas suportadas:
|
O parâmetro dntoff especifica se Do Not Track está desligado. Passe 0 se "não rastrear" estiver ativado ou 1 se "não rastrear" estiver desativado. Exemplo de valor: |
| Suporte a vários dispositivos | |
| Parâmetro | Descrição |
|
O parâmetro custom_user_id especifica o seu ID de utilizador interno.
Exemplo de valor: |
| Suporte iOS SkAdNetwork | |
| Parâmetro | Descrição |
Plataformas suportadas:
|
O parâmetro skan_conversion_value especifica o valor de conversão mais recente da SKAdNetwork no momento desta notificação de sessão(saiba mais sobre a implementação da SKAdNetwork).
Exemplo de valor: |
| Parâmetro | Descrição do parâmetro |
Plataformas suportadas:
|
O parâmetro skan_first_call_timestamp especifica o carimbo de data/hora Unix da primeira chamada à API SkAdNetwork subjacente(saiba mais sobre a implementação da SKAdNetwork).
Exemplo de valor: |
| Parâmetro | Descrição do parâmetro |
Plataformas suportadas:
|
O parâmetro skan_last_call_timestamp especifica o carimbo de data/hora Unix da última chamada à API SkAdNetwork subjacente no momento desta notificação de sessão(saiba mais sobre a implementação da SKAdNetwork).
Exemplo de valor: |
Teste de sessão
Depois de fazer a integração servidor a servidor, é essencial verificar se a Singular recebe os dados antes de colocar em funcionamento uma instância do produto. Consulte o nosso guia de testes para obter mais detalhes. Em um nível alto, as seguintes etapas devem ser seguidas:
- Obtenha a ID de publicidade do seu dispositivo de teste e adicione a ID no Singular SDK Console.
- Abra o Singular SDK Console e adicione o identificador do dispositivo para iniciar a captura de dados.
- Substitua o identificador do aplicativo por um identificador de aplicativo de desenvolvimento(com.singular.app.dev) para manter os dados e eventos de teste separados dos dados de produção.
- Criar ou abrir a aplicação a partir de um estado terminado
- Valide se a abertura da aplicação é enviada para o seu servidor com todos os pontos de dados Singular necessários
- Valide se o seu servidor dispara a Notificação de Sessão para o ponto de extremidade Singular'launch' com todos os pontos de dados necessários.
- Após alguns segundos, o evento de sessão deve ser exibido no Console do SDK do Singular.
- Repita o teste para validar se o App Open aciona a Session a partir de cada entrada de aplicativo ou operação "Foreground".
Confirme que o evento de sessão ocorre na abertura da aplicação ou em primeiro plano e antes de o evento ser recebido.
Se vir a Session na Consola SDK, concluiu um teste de ponta a ponta do tratamento da SESSION!