O que é uma campanha PAI? #
Nas campanhas Google Play Auto-Install (PAI), os Fabricantes de Equipamento Original (OEM), as operadoras de telemóveis e os parceiros de descoberta de aplicações pré-instalam ou sugerem aplicações durante a primeira ativação do dispositivo (a experiência “out-of-the-box”). Isto permite que os anunciantes alcancem os utilizadores no momento exato em que começam a utilizar o seu novo telemóvel, sem recorrerem aos anúncios online tradicionais.
Como funciona a atribuição: Ao contrário das campanhas normais, que se baseiam nos cliques nos anúncios, o PAI utiliza a API de referência de instalação do Google Play.
- O fabricante (OEM) ou a operadora transmite uma sequência de rastreamento específica (que contém o utm_campaign) à Google Play Store quando a aplicação é instalada.
- Quando o utilizador abre a aplicação, o SDK da Tenjin obtém esta cadeia de caracteres diretamente da Play Store.
- O Tenjin cruza estes dados de referência para atribuir a instalação de forma determinística.
Pré-requisitos #
Para garantir que o Tenjin consiga capturar os dados de atribuição do PAI, consulte a documentação do SDK Android da Tenjin e confirme se a biblioteca Google Play Install Referrer foi adicionada às dependências do ficheiro build.gradle da sua aplicação.
Parceiros apoiados #
Entre os parceiros habituais que apoiam as campanhas da PAI contam-se:
- Xiaomi
- Oppo
- Vivo
- Huawei
- Honra
- Transsion
Guia de configuração #
Passo 1: Criar uma campanha no painel do Tenjin #
- Aceda a CONFIGURAR > Canais, clique em «Adicionar um canal» e selecione o seu parceiro para esta campanha.
- Para a Oppo & Vivo Global: Basta introduzir um nome de conta e clicar em «Adicionar conta publicitária».
- Para a Xiaomi: Introduza o seu App ID e a sua App Key.
- Aceda a CONFIGURAR > Campanhas e clique em Criar campanha.
- Na secção «Conta de marketing», selecione a conta que acabou de criar.
- Selecione a aplicação para a sua campanha.
- Dê um nome à campanha e clique em «Criar campanha».
Passo 2: Copiar o ID da campanha Tenjin #
- Clique na campanha que acabou de criar.
- Localize o ID da Campanha Tenjin (uma sequência alfanumérica).
- Clique em Copiar.

Passo 3: Configurar os callbacks de instalação #
Para garantir que o seu parceiro possa otimizar a campanha, deve enviar-lhe os dados de instalação.
- Aceda a CONFIGURAR > Aplicações e selecione a sua aplicação.
- No separador «Callbacks > Integrações», selecione o canal (por exemplo, Oppo) no menu suspenso.
- Certifique-se de que a opção «Callback de instalação» está ativada.
Passo 4: Ajustar a janela de atribuição (recomendado) #
As campanhas PAI têm, normalmente, um ciclo de conversão mais longo do que os anúncios normais (um utilizador pode configurar o telemóvel, mas não abrir a sua aplicação durante vários dias).
- Consulte o seu gestor de conta na rede de publicidade para saber qual é o período recomendado (normalmente 30 dias).
- Se o período recomendado for diferente do valor predefinido da sua aplicação (o valor predefinido do Tenjin é de 7 dias), deve ajustá-lo para este canal específico, a fim de evitar discrepâncias nos dados.
- Aceda a CONFIGURAR > Aplicações, selecione a sua aplicação e selecione o separador Atribuição.
- Selecione o canal da sua campanha (por exemplo, Oppo)
- Ative a opção “Substituir definições da aplicação“
- Defina a janela Atribuição de cliques – Correspondência de dispositivos de atribuição para 30 dias (ou o valor recomendado pelo seu parceiro).
Se pretender definir um período de atribuição diferente do das outras campanhas deste canal, pode criar um canal personalizado exclusivamente para a campanha PAI.
Passo 5: Envie o ID da campanha Tenjin ao seu gestor de conta #
Envie o ID da Campanha Tenjin (da Etapa 2) ao seu gestor de conta na rede de publicidade. Este irá introduzir esse ID no sistema para mapear corretamente a sequência utm_campaign.