Configuração do parceiro Cognant
O Cognant é uma rede de anúncios integrada à Adjust. Nossa integração permite que o Cognant receba dados de atribuição e eventos in-app por meio de callbacks automáticos.
Neste artigo, saiba como configurar a mensuração com o Cognant para seu aplicativo. Isso inclui a ativação da integração, a criação de um link de campanha e a escolha dos dados que a Adjust pode compartilhar com Cognant.
Antes de começar
Requisitos
- Permissões de Administrador, Editor ou Editor personalizado na Adjust.
- SDK versão 4.0.0 da Adjust e posteriormente para mapear os parâmetros do SDK aos parâmetros de Cognant. Siga os guias abaixo para usar essa funcionalidade.
iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
Credenciais
MZ CODE
- Para obter ajuda para encontrar suas credenciais, entre em contato com seu representante do Cognant.
Selecione Cognant e o seu aplicativo no Campaign Lab
- Em Campaign Lab, selecione Parceiros.
- Selecione Novo parceiro > Cognant. Selecione Próximo para ir para a próxima tela.
- Na tela Seleção de aplicativos, escolha o aplicativo para o qual deseja criar o link e habilite a integração para compartilhar dados com o Cognant.
- Selecione Próximo.
Habilitar o compartilhamento de dados
Habilite o compartilhamento de dados para ativar a integração com o Cognant. Para habilitá-lo:
- Insira seus MZ CODE.
Depois que você habilitar o compartilhamento de dados com o Cognant, a Adjust enviará automaticamente os seguintes dados ao Cognant, por padrão:
- clique
- instalação
- sessão
- reatribuição
- evento
Configurar suas opções de compartilhamento de dados
Se estiver trabalhando com um aplicativo multiplataforma com compartilhamento de dados habilitado para várias plataformas, você pode:
- Separar opções de compartilhamento de dados no nível de plataforma selecionando Usar as configurações específicas da plataforma.
- Definir as mesmas configurações de compartilhamento de dados para múltiplas plataformas selecionando Usar as configurações globais.
Agora, em O que será compartilhado por padrão?, revise as atividades que a Adjust compartilha com o Cognant por padrão.
- clique
- instalação
- sessão
- reatribuição
- evento
Enviar dados adicionais
Escolha a quantidade e o tipo de dados que você deseja compartilhar com o Cognant por meio de callbacks. O Cognant pode usar essas informações para otimizar o desempenho.
- Em Quais fontes de dados você deseja compartilhar?, escolha a fonte de atribuição dos dados que você está compartilhando com o Cognant:
- Dados de todas as fontes de atribuição
- Somente dados atribuídos ao Cognant
Sessões
A Adjust não envia automaticamente callbacks de sessão devido ao alto volume de sessões. Ao compartilhar sessões, o Cognant receberá a atividade da sessão do seu aplicativo.
Receita in-app (de compras in-app)
O compartilhamento de receita in-app permite que o Cognant receba valores de receita junto com seus dados de eventos com receita. Você precisa mapear eventos que geram receita para compartilhar esses dados.
Mapear eventos
Mapeie os eventos que você deseja compartilhar com os valores que o Cognant pode receber. Os dados de eventos não mapeados não são compartilhados com o Cognant.
Mapear eventos individuais
Se você tiver um aplicativo multiplataforma, poderá optar por compartilhar eventos diferentes por plataforma com o Cognant. Isso possibilita:
- Definir eventos individuais para gerenciar estratégias de campanha para cada plataforma.
- Personalizar o compartilhamento de dados por plataforma.
Em Mapear eventos, siga estes passos para escolher os eventos in-app que você quer enviar diretamente à Cognant.
Selecione Mapear evento.
Na lista Evento da Adjust, escolha o evento da Adjust que quer compartilhar com Cognant.
Em Evento de parceiro, selecione o evento do Cognant que corresponde ao evento da Adjust.
Para aplicativos de plataforma única e aplicativos multiplataforma com compartilhamento de dados habilitado apenas para uma única plataforma, mapeie eventos apenas para essa plataforma. Para aplicativos multiplataforma com compartilhamento de dados habilitado para várias plataformas, você pode:
- Selecionar Usar mapeamento específico da plataforma para mapear eventos separados no nível da plataforma ou para não mapear eventos para determinadas plataformas.
- Selecionar Usar mapeamento global para mapear os mesmos eventos para todas as plataformas.
Na lista de Eventos de parceiro , escolha ou insira um nome de evento personalizado que você gostaria de mapear ao evento da Adjust.
Selecione Aplicar.
Agora Cognant receberá dados de eventos in-app para todos os seus eventos vinculados.
Mapear todos os eventos
Se o Cognant oferecer suporte para o mapeamento automático de todos os eventos, em Mapear eventos , selecione Mapear todos os eventos . Isso economiza tempo no mapeamento de eventos individuais.
Agora o Cognant receberá dados de eventos in-app de todos os seus eventos vinculados.
Mapear parâmetros
Normalmente é necessário mapear os parâmetros para compartilhar dados personalizados com o Cognant.
Os parâmetros de parceiros (disponíveis no SDK da Adjust, versão 4.0+) permitem à Adjust coletar pontos de dados personalizados do seu aplicativo e enviá-los ao Cognant. Isso permite que o Cognant receba detalhes de eventos personalizados para cada um de seus eventos vinculados.
Antes de adicionar novos parâmetros de parceiros ao SDK da Adjust, confira se não há parâmetros de parceiros que já atendem seus requisitos.
Para encaminhar parâmetros de parceiros ao Cognant, siga estes passos.
Configure os parâmetros do parceiro no SDK da Adjust.
- Confira Antes de começar para ver todos os links de plataformas de desenvolvimento de SDK.
Em Configure suas opções de compartilhamento de dados, selecione Parâmetros.
Em Mapear parâmetros, você pode especificar como deseja enviar à rede os parâmetros do parceiro definidos no SDK:
- Selecione Mapear parâmetro.
- No campo Parâmetro do SDK, insira o nome do parâmetro de SDK que você deseja compartilhar com a rede.
- No campo Parâmetro do parceiro, insira o parâmetro de rede que corresponde ao parâmetro do SDK.
Se você configurar os parâmetros do parceiro no SDK da Adjust sem configurar o compartilhamento de parâmetros no painel, a Adjust encaminhará os parâmetros conforme nomeados no SDK da Adjust.
Configure seu link e suas definições
Você tem a opção de definir:
Crie seu link e compartilhe-o com Cognant
Na tela de Revisão de configuração, revise suas escolhas. Você também pode retornar e fazer alterações em:
- Seu app selecionado
- Opções de compartilhamento de dados
- Parâmetros de estrutura de link
- Destinos do usuário
- Configurações de atribuição
Selecione Criar link para criar sua URL de clique e URL de impressão, bem como seu QR Code e seu token de link. A criação de um link também permite o compartilhamento de dados e a integração com Cognant.
Depois de criar o link, compartilhe-o com o Cognant para colocá-lo nas campanhas.
Instruções de configuração de parceiros específicos
Quando você ativa o módulo, você pode escolher para qual endpoint você quer que os callbacks sejam enviados. Você pode ativar os botões de alternância para “Staging Endpoint Only” e “Production Endpoint Only”.
Você pode ter um ou ambos os botões dos endpoints ativados. Lembre que se ambos os botões estiverem DESATIVADOS, os CALLBACKS NÃO SERÃO ENVIADOS.
Lista de todos os parâmetros encaminhados a Cognant
Cognant solicita que a Adjust envie os seguintes parâmetros (pontos de dados) com seus callbacks:
| Placeholder | Informação |
{adid} | ID de dispositivo da Adjust (todas as plataformas) |
{android_id_md5} | Em minúsculas, Android ID hex MD5 hash |
{android_id} | Android ID (apenas Android) |
{api_level} | Nível da Android (somente Android) |
{city} | Cidade do dispositivo |
{click_attribution_window} | Configurações da janela de atribuição para identificação de dispositivos (horas) |
{country_subdivision} | Subdivisão do dispositivo do país, p.ex. estado |
{country} | Código do país de dois caracteres do dispositivo |
{currency} | O código da moeda ISO 4217 original enviado pelo SDK da Adjust |
{deeplink} | URL do deeplink adicionada à URL do clique |
{device_name} | Número do modelo do dispositivo |
{device_type} | tipo de dispositivo |
{environment} | Configuração do ambiente do SDK da Adjust atual |
{gclid} | ID de clique do Google |
{gps_adid_md5} | Advertising ID em caixa-baixa hex MD5 do Google Play Store |
{gps_adid} | Advertising ID da Google Play Store |
{idfa_md5_hex} | IDFA hex MD5 hash |
{idfa_md5} | IDFA base64 MD5 hash |
{idfa_upper} | IDFA em letras maiúsculas |
{idfa} | ID para anunciantes (apenas iOS) |
{idfv} | iOS ID em caixa-alta para fornecedores |
{impression_attribution_window} | Configurações da janela de atribuição para identificação de impressão (horas) |
{inactive_user_definition} | Período de inatividade necessário para a reatribuição (horas) |
{ip_address} | Endereço IP do dispositivo |
{isp} | Provedor de serviços de internet para dispositivos |
{label} | Valor do parâmetro "label" da Adjust enviado no clique |
{language} | Código do idioma de dois caracteres do dispositivo |
{last_time_spent} | Duração da última sessão do usuário, em segundos |
{mac_md5} | Uppercase MAC MD5 hash |
{mac_sha1} | Uppercase MAC SHA-1 hash |
{match_type} | método de atribuição |
{nonce} | String aleatória alfanumérica em caixa-baixa (única por callback) |
{partner_parameters} | Parâmetros dos parceiros personalizados coletados pelo SDK da Adjust ou solicitação S2S e transmitidos a fornecedores de terceira parte via postbacks |
{postal_code} | Código postal do endereço IP do dispositivo |
{publisher_parameters} | Os parâmetros personalizados do publisher coletados pelo Adjust SDK (jamais exibidos no Painel da Adjust) |
{random} | Número aletório (único por callback) |
{reattribution_attribution_window} | Configurações da janela de atribuição para reatribuição (horas) |
{referrer} | Google Play Store Referrer (somente Android) |
{reftag} | Tag aleatória de referência do dispositivo |
{region} | Código da região do dispositivo |
{reporting_currency} | Relatório do painel com código de moeda da ISO 4217 |
{reporting_revenue} | Receita, conforme registrada no painel da Adjust, em unidades de moedas inteiras |
{revenue_usd_cents} | Receita, em centavos de dólares americanos |
{revenue_usd} | Receita, em dólares americanos |
{revenue} | Receita, conforme enviada pelo SDK da Adjust (em centavos) |
{sdk_version} | Versão do SDK da Adjust (por aplicativo) |
{search_term} | Termo de pesquisa orgânica no Google |
{time_spent} | Duração da última sessão do usuário, em segundos |
{timezone} | Fuso horário do dispositivo |
{tracking_enabled} | 1 se o monitoramento está ativado, 0 se não |
{tracking_limited} | 1 se o monitoramento é limitado, 0 se não |
{tweet_id} | Tweet ID único |
{twitter_line_item_id} | ID do item de linha do Twitter |
{user_agent} | Agente do usuário bruto de entrada |
{win_hwid} | ID do hardware do Windows Store |
{win_udid} | ID do dispositivo único do Windows Phone |
{activity_kind} | Tipo de atividade do usuário |
{adgroup_name} | Nome do grupo de anúncios, conforme retirado do tracker |
{app_id} | Store App ID ou Google Play Store |
{app_name_dashboard} | Nome do aplicativo no Painel da Adjust |
{app_name} | Nome do aplicativo |
{app_version_raw} | Número da versão do aplicativo (Android), número da versão para bundle (iOS) |
{app_version_short} | Número da versão do aplicativo (Android), número da versão do lançamento para bundle (iOS) |
{app_version} | Número da versão do aplicativo (Android), número da versão para bundle (iOS) |
{campaign_name} | Nome da campanha, conforme retirado do tracker |
{click_referer} | Cabeçalho referrer do clique |
{click_time_hour} | Marca temporal do clique atribuído arrendondada para hora mais próxima |
{click_time} | Marca temporal do clique atribuído |
{connection_type} | Tipo de conexão de internet |
{conversion_duration} | Tempo entre o clique e a instalação ou reatribuição em segundos |
{created_at_hour} | Marca temporal da atividade, arredondada para a hora mais próxima |
{created_at} | Marca temporal da atividade |
{creative_name} | Nome criativo, conforme retirado do tracker |
{engagement_time_hour} | Marca temporal do engajamento arrendondada para a hora mais próxima |
{engagement_time} | Marca temporal do engajamento |
{impression_based} | 1 se engajamento baseado em impressão, 0 se não |
{installed_at_hour} | Marca temporal da instalação (isto é, primeira abertura do aplicativo) arrendondada para hora mais próxima |
{installed_at} | Marca temporal da instalação (isto é, primeira abertura do aplicativo) |
{is_organic} | 1 se for tráfego orgânico, 0 se for não orgânico |
{last_tracker_name} | O nome anterior do tracker de um usuário reatribuído |
{last_tracker} | Tracker token de 6 caracteres da Adjust do tracker anterior de um usuário reatribuído |
{network_name} | Nome da rede, conforme retirado do tracker |
{reattributed_at_hour} | Marca temporal de reatribuição arrendondada para hora mais próxima |
{reattributed_at} | Marca temporal da reatribuição |
{rejection_reason} | Razão para a rejeição da atribuição |
{store} | Loja de destino do clique |
{tracker_name} | Nome atual do tracker |
{tracker} | Tracker token da Adjust de 6 caracteres |
{google_ads_adgroup_id} | ID do adgroup do Google Ads |
{google_ads_campaign_id} | ID da campanha do Google Ads |
{google_ads_campaign_name} | Nome da campanha do Google Ads |
{google_ads_campaign_type} | Tipo de campanha do Google Ads |
{google_ads_creative_id} | ID do criativo do Google Ads |
{google_ads_keyword} | Palavra-chave de pesquisa do Google Ads |
{google_ads_matchtype} | Palavra-chave de pesquisa e tipo de match do Google Ads |
{google_ads_network_subtype} | Subtipo de rede do Google Ads |
{google_ads_network_type} | Tipo de rede do Google Ads |
{google_ads_placement} | Posicionamento de anúncio do Google Ads |
{google_ads_video_id} | ID do vídeo do Google Ads |