Configuração do parceiro Buzzvil
O Buzzvil é uma rede de anúncios integrada à Adjust. Nossa integração permite que o Buzzvil 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 Buzzvil 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 Buzzvil.
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 Buzzvil. Siga os guias abaixo para usar essa funcionalidade.
iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
Selecione Buzzvil e o seu aplicativo no Campaign Lab
- Em Campaign Lab, selecione Parceiros.
- Selecione Novo parceiro > Buzzvil. 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 Buzzvil.
- Selecione Próximo.
Habilitar o compartilhamento de dados
Habilite o compartilhamento de dados para ativar a integração com o Buzzvil. Para habilitá-lo:
- Deixe na opção Habilitado
Depois que você habilitar o compartilhamento de dados com o Buzzvil, a Adjust enviará automaticamente os seguintes dados ao Buzzvil, por padrão:
- install
- session
- uninstall
- reinstall
- reattribution
- event
- rejectedInstall
- rejectedReattribution
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 Buzzvil por padrão.
- install
- session
- uninstall
- reinstall
- reattribution
- event
- rejectedInstall
- rejectedReattribution
Enviar dados adicionais
Escolha a quantidade e o tipo de dados que você deseja compartilhar com o Buzzvil por meio de callbacks. O Buzzvil 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 Buzzvil:
- Dados de todas as fontes de atribuição
- Somente dados atribuídos ao Buzzvil
Sessões
A Adjust não envia automaticamente callbacks de sessão devido ao alto volume de sessões. Ao compartilhar sessões, o Buzzvil receberá a atividade da sessão do seu aplicativo.
Desinstalações ou reinstalações
O compartilhamento de desinstalações ou reinstalações permite que o Buzzvil receba os dados de desinstalação e/ou reinstalação do seu aplicativo mensurados pela Adjust.
No caso de apps iOS, pode haver uma baixa quantia de desinstalações e/ou reinstalações. Para mais informações, confira o artigo Mensuração de desinstalações e reinstalações.
Receita in-app (de compras in-app)
O compartilhamento de receita in-app permite que o Buzzvil 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 Buzzvil pode receber. Os dados de eventos não mapeados não são compartilhados com o Buzzvil.
Mapear eventos individuais
Se você tiver um aplicativo multiplataforma, poderá optar por compartilhar eventos diferentes por plataforma com o Buzzvil. 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 à Buzzvil.
Selecione Mapear evento.
Na lista Evento da Adjust, escolha o evento da Adjust que quer compartilhar com Buzzvil.
Em Evento de parceiro, selecione o evento do Buzzvil 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 Buzzvil receberá dados de eventos in-app para todos os seus eventos vinculados.
Mapear todos os eventos
Se o Buzzvil 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 Buzzvil 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 Buzzvil.
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 Buzzvil. Isso permite que o Buzzvil 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 Buzzvil, 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 Buzzvil
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 Buzzvil.
Depois de criar o link, compartilhe-o com o Buzzvil para colocá-lo nas campanhas.
Lista de todos os parâmetros encaminhados a Buzzvil
Buzzvil solicita que a Adjust envie os seguintes parâmetros (pontos de dados) com seus callbacks:
| Placeholder | Information |
{api_level} | API level (Android only) |
{city} | Device city |
{click_attribution_window} | Attribution window settings for device matching (hours) |
{cost_amount} | Cost of the user engagement (available for ad spend tracking only) |
{cost_currency} | ISO 4217 currency code of the cost data (available for ad spend tracking only) |
{cost_type} | The campaign pricing model (available for ad spend tracking only) |
{country_subdivision} | Device subdivision of country, e.g., state |
{country} | Device two-character country code |
{deeplink} | Deeplink URL appended to click URL |
{device_name} | Device model number |
{device_type} | Device type |
{environment} | Current Adjust SDK environment setting |
{event_name} | Event name, as set in the Dashboard |
{gps_adid} | Google Play Store advertising ID |
{idfa} | ID for advertisers (iOS only) |
{idfv} | Uppercase iOS ID for vendors |
{impression_attribution_window} | Attribution window settings for impression matching (hours) |
{ip_address} | Device IP address |
{is_reattributed} | 1 if user was reattributed at least once from an earlier source. 0 if user has never been reattributed |
{isp} | Device internet service provider |
{language} | Device two-character language code |
{lifetime_session_count} | Number of sessions recorded across entire user lifetime |
{match_type} | Attribution method |
{mcc} | Mobile country code: three-digit code identifying a device's country. Use with the mobile network code to identify a device's carrier. |
{mnc} | Mobile network code: two-digit code. Use with the mobile country code to identify a device's carrier. |
{os_name} | Device operating system |
{os_version} | Operating system version number |
{partner_parameters} | Custom partner parameters collected by the Adjust SDK or S2S request and transmitted to third party providers via postbacks |
{postal_code} | Device postal code of IP address |
{referrer} | Google Play Store referrer (Android only) |
{reftag} | Random device reference tag |
{region} | Device region code |
{reporting_cost} | Cost of the user engagement converted to your app's reporting currency and as reported in the Adjust Dashboard (available for ad spend tracking only) |
{reporting_currency} | Dashboard reporting ISO 4217 currency code |
{timezone} | Device time zone |
{tracking_enabled} | 1 if tracking is enabled, 0 if not |
{tracking_limited} | 1 if tracking is limited, 0 if not |
{user_agent} | Incoming raw user agent |
{activity_kind} | Type of user activity |
{adgroup_name} | Adgroup name, as taken from the tracker |
{app_id} | Store App ID or Google Play Store |
{app_name_dashboard} | Name of the app in the Adjust Dashboard |
{app_name} | Name of the app |
{app_version_raw} | App version number (Android), build-version-number for the bundle (iOS) |
{app_version_short} | App version number (Android), release-version-number for the bundle (iOS) |
{app_version} | App version number (Android), build-version-number for the bundle (iOS) |
{campaign_name} | Campaign name, as taken from the tracker |
{click_time} | Attributed click timestamp |
{connection_type} | Internet connection type |
{conversion_duration} | Time between click and install or reattribution in seconds |
{cpu_type} | CPU type |
{created_at} | Activity timestamp |
{creative_name} | Creative name, as taken from the tracker |
{device_manufacturer} | Device manufacturer name |
{engagement_time} | Engagement timestamp |
{first_tracker} | 6-character Adjust tracker token for a user's first attribution source |
{hardware_name} | Hardware name |
{impression_based} | 1 if impression-based engagement, 0 if not |
{impression_time} | Attributed impression timestamp |
{install_begin_time} | App download began timestamp (Android and Google Play Store only) |
{install_finish_time} | App download completion timestamp |
{installed_at} | Install (i.e., first app open) timestamp |
{is_organic} | 1 if organic traffic, 0 if non-organic |
{last_tracker} | 6-character Adjust tracker token of a reattributed user's previous tracker |
{network_name} | Network name, as taken from the tracker |
{network_type} | Network type |
{referral_time} | User landed on app Play Store page timestamp (Android and Google Play Store only) |
{reinstalled_at} | Reinstall timestamp |
{rejection_reason} | Reason for a rejected attribution |
{store} | Target store of click |
{tracker_name} | Current tracker name |
{proxy_ip_address} | IP address of user's proxy |