Configuração do parceiro Unity CTV
O Unity CTV é uma rede de anúncios integrada à Adjust. Nossa integração permite que o Unity CTV 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 Unity CTV 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 Unity CTV.
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 Unity CTV. 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 Unity CTV e o seu aplicativo no Campaign Lab
- Em Campaign Lab, selecione Parceiros.
- Selecione Novo parceiro > Unity CTV. 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 Unity CTV.
- Selecione Próximo.
Habilitar o compartilhamento de dados
Habilite o compartilhamento de dados para ativar a integração com o Unity CTV. Para habilitá-lo:
- Deixe na opção Habilitado
Depois que você habilitar o compartilhamento de dados com o Unity CTV, a Adjust enviará automaticamente os seguintes dados ao Unity CTV, por padrão:
- install
- 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 Unity CTV por padrão.
- install
- reattribution
- event
- rejectedInstall
- rejectedReattribution
Enviar dados adicionais
Escolha a quantidade e o tipo de dados que você deseja compartilhar com o Unity CTV por meio de callbacks. O Unity CTV 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 Unity CTV:
- Dados de todas as fontes de atribuição
- Somente dados atribuídos ao Unity CTV
Mapear eventos
Mapeie os eventos que você deseja compartilhar com os valores que o Unity CTV pode receber. Os dados de eventos não mapeados não são compartilhados com o Unity CTV.
Mapear eventos individuais
Se você tiver um aplicativo multiplataforma, poderá optar por compartilhar eventos diferentes por plataforma com o Unity CTV. 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 à Unity CTV.
Selecione Mapear evento.
Na lista Evento da Adjust, escolha o evento da Adjust que quer compartilhar com Unity CTV.
Em Evento de parceiro, selecione o evento do Unity CTV 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 Unity CTV receberá dados de eventos in-app para todos os seus eventos vinculados.
Mapear todos os eventos
Se o Unity CTV 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 Unity CTV receberá dados de eventos in-app de todos os seus eventos vinculados.
Configure seu link e suas definições
Você tem a opção de definir:
Crie seu link e compartilhe-o com Unity CTV
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 Unity CTV.
Depois de criar o link, compartilhe-o com o Unity CTV para colocá-lo nas campanhas.
Lista de todos os parâmetros encaminhados a Unity CTV
Unity CTV solicita que a Adjust envie os seguintes parâmetros (pontos de dados) com seus callbacks:
Placeholder | Information |
{adid} | Adjust device ID (all platforms) |
{android_id_md5} | Lowercase Android ID hex MD5 hash |
{android_id} | Android ID (Android only) |
{city} | Device city |
{gps_adid_md5} | Lowercase hex MD5 hash of Google Play Store advertising ID |
{gps_adid} | Google Play Store advertising ID |
{iad_conversion_type} | Download status: first or subsequent app download |
{idfa_md5_hex} | IDFA hex MD5 hash |
{idfa_md5} | IDFA base64 MD5 hash |
{idfa} | ID for advertisers (iOS only) |
{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 |
{match_type} | Attribution method |
{os_name} | Device operating system |
{os_version} | Operating system version number |
{postal_code} | Device postal code of IP address |
{revenue_usd_cents} | Revenue, in US cents |
{revenue_usd} | Revenue, in US dollars |
{user_agent} | Incoming raw user agent |
{activity_kind} | Type of user activity |
{app_id} | Store App ID or Google Play Store |
{app_name} | Name of the app |
{app_version} | App version number (Android), build-version-number for the bundle (iOS) |
{click_time} | Attributed click timestamp |
{connection_type} | Internet connection type |
{created_at} | Activity timestamp |
{device_manufacturer} | Device manufacturer name |
{hardware_name} | Hardware name |
{impression_time} | Attributed impression timestamp |
{installed_at} | Install (i.e., first app open) timestamp |
{is_organic} | 1 if organic traffic, 0 if non-organic |
{reattributed_at} | Reattribution timestamp |
{reinstalled_at} | Reinstall timestamp |
{rejection_reason} | Reason for a rejected attribution |
{store} | Target store of click |
{proxy_ip_address} | IP address of user's proxy |