Configuração do parceiro TikTok For Business
Se esta for a primeira campanha que você está executando com o TikTok, recomendamos que ative também a integração SAN do TikTok juntamente com a não SAN. Isso garante que você tenha uma mensuração completa durante o período de transição no qual ambas as integrações estão em funcionamento.
Descubra como configurar a integração com o TikTok como uma rede autoatribuída (SAN).O TikTok For Business é uma rede de anúncios integrada à Adjust. Nossa integração permite que o TikTok For Business 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 TikTok For Business 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 TikTok For Business.
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 TikTok For Business. 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 TikTok For Business e o seu aplicativo no Campaign Lab
- Em Campaign Lab, selecione Parceiros.
- Selecione Novo parceiro > TikTok For Business. 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 TikTok For Business.
- Selecione Próximo.
Habilitar o compartilhamento de dados
Habilite o compartilhamento de dados para ativar a integração com o TikTok For Business. Para habilitá-lo:
- Deixe na opção Habilitado
Depois que você habilitar o compartilhamento de dados com o TikTok For Business, a Adjust enviará automaticamente os seguintes dados ao TikTok For Business, por padrão:
- 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 TikTok For Business por padrão.
- instalação
- sessão
- reatribuição
- evento
Envio de dados adicionais
Escolha a quantidade e o tipo de dados que você deseja compartilhar com o TikTok For Business por meio de callbacks. O TikTok For Business 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 TikTok For Business:
- Dados de todas as fontes de atribuição
- Somente dados atribuídos ao TikTok For Business
Sessões
A Adjust não envia automaticamente callbacks de sessão devido ao alto volume de sessões. Ao compartilhar sessões, o TikTok For Business receberá a atividade das sessões do seu aplicativo.
Receita in-app (de compras in-app)
O compartilhamento de receita in-app permite que o TikTok For Business 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 TikTok For Business pode receber. Os dados de eventos não mapeados não são compartilhados com o TikTok For Business.
- Limite de caracteres: Até 50 caracteres.
- Caracteres: Apenas letras do alfabeto, número arábicos, sublinhados, e hífens são aceitos.
- Formato: deve iniciar com uma letra do alfabeto e não pode terminar com um espaço.
Mapear eventos individuais
Se você tiver um aplicativo multiplataforma, poderá optar por compartilhar eventos diferentes por plataforma com o TikTok For Business. 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 à TikTok For Business.
Selecione Mapear evento.
Na lista Evento da Adjust, escolha o evento da Adjust que quer compartilhar com TikTok For Business.
Em Evento do parceiro, selecione o evento do TikTok For Business 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 do parceiro, escolha ou insira um nome de evento personalizado que você deseja mapear ao evento da Adjust.
Selecione Aplicar.
Agora o TikTok For Business receberá dados de eventos in-app para todos os seus eventos vinculados.
Mapear todos os eventos
Se o TikTok For Business 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 TikTok For Business 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 TikTok For Business.
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 TikTok For Business. Isso permite que o TikTok For Business receba detalhes de eventos personalizados para cada um de seus eventos vinculados.
Antes de adicionar novos parâmetros do parceiro ao SDK da Adjust, confira se não há parâmetros pré-existentes que já atendem seus requisitos.
Para compartilhar parâmetros do parceiro com o TikTok For Business, 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 os encaminhará 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 TikTok For Business
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 TikTok For Business.
Depois de criar o link, compartilhe-o com o TikTok For Business para colocá-lo nas campanhas.
Exemplo de URL de clique:
https://s2s.adjust.com/xxxxxx?campaign=__CAMPAIGN_NAME__%20(__CAMPAIGN_ID__)&adgroup=__AID_NAME__%20(__AID__)&creative=__CID_NAME__%20(__CID__)&s2s=1&idfa=__IDFA__&gps_adid=__GAID__&adgroup_id=__AID__&ip_address=__IP__&user_agent=__UA__&campaign_id=__CAMPAIGN_ID__&creative_id=__CID__&tiktok_placement=__PLACEMENT__&external_tracker_ids=1&tiktok_callback_param=__callback_param__Exemplo de URL de impressão:
https://s2s.adjust.com/impression/xxxxxx?campaign=__CAMPAIGN_NAME__%20(__CAMPAIGN_ID__)&adgroup=__AID_NAME__%20(__AID__)&creative=__CID_NAME__%20(__CID__)&s2s=1&idfa=__IDFA__&gps_adid=__GAID__&adgroup_id=__AID__&ip_address=__IP__&user_agent=__UA__&campaign_id=__CAMPAIGN_ID__&creative_id=__CID__&tiktok_placement=__PLACEMENT__&external_tracker_ids=1&tiktok_callback_param=__callback_param__Exportações de dados brutos
As diretrizes do TikTok estipulam que os IDs de dispositivo das atribuições de visualizações (VTA) só podem ser compartilhados no nível de rede. Relatórios de VTA diários agregados que incluem metadados de campanhas, mas não IDs de dispositivo, permanecem inalterados.
Relatórios de estrutura de campanha
Para permanecer em conformidade com essas diretrizes, a Adjust registra dados brutos de atribuições de visualizações do TikTok da seguinte maneira:
- Link no nível de rede =
TikTok Installs - Token de link =
tt_inst
Parâmetros de impressão
MMPs não podem compartilhar marca temporal, ID de publicidade, estrutura de campanhas e outros dados relacionados ao usuário a partir de callbacks de atribuições de visualizações. A marca temporal de callbacks de conversão de visualização (como instalações, sessões, eventos etc.) não é afetada.
Instruções de configuração de parceiros específicos
ID do app TikTok
O ID do app TikTok é um campo opcional no módulo do TikTok For Business. Quando você insere o ID do app TikTok, a Adjust o compartilha diretamente com o TikTok. Você pode encontrar o ID do app TikTok no painel do TikTok Ads.
Note que para inserir vários IDs do app TikTok, é necessário separá-los por vírgula. O TikTok os analisará dessa forma.
Encaminhamento de sessões
Ao ativar o Encaminhamento de sessões, a Adjust automaticamente mapeia sessões ao evento APP Launch do Tiktok.
Mensuração de impressões
A Adjust registra uma impressão quando um usuário visualiza seu anúncio mobile. Se você gostaria que a Adjust atribuísse instalações a impressões, ative a atribuição baseada em impressões com matching de dispositivos e/ou modelagem probabilística em seu painel da Adjust. Você pode pausar a mensuração de impressões a qualquer momento.
Mensuração do SKAdNetwork
Você pode conferir seus dados agregados do SKAdNetwork no Datascape.
Para saber mais como usar essa integração nos seus casos de uso, leia nossa página única com o TikTok. Em caso de dúvidas sobre as informações fornecidas na página, escreva para partners@adjust.com .
Lista de todos os parâmetros encaminhados ao TikTok For Business
O TikTok For Business requer que a Adjust envie os seguintes parâmetros (pontos de dados) com seus callbacks:
| Espaço reservado | Informação |
{currency} | O código da moeda ISO 4217 original enviado pelo SDK da Adjust |
{gps_adid} | Advertising ID da Google Play Store |
{idfa} | ID para anunciantes (apenas iOS) |
{idfv} | iOS ID em caixa-alta para fornecedores |
{ip_address} | Endereço IP do dispositivo |
{is_reattributed} | 1 se o usuário foi reatribuído pelo menos uma vez de uma fonte anterior. 0 se o usuário nunca tiver sido reatribuído. |
{os_name} | Sistema operacional do dispositivo |
{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 |
{revenue_float} | Receita conforme enviada do SDK da Adjust, em unidades de moedas inteiras |
{user_agent} | Agente do usuário bruto de entrada |
{app_id} | Store App ID ou Google Play Store |
{app_name} | Nome do aplicativo |
{app_version_short} | Número da versão do aplicativo (Android), número da versão do lançamento para bundle (iOS) |
{created_at} | Marca temporal da atividade |
{impression_based} | 1 se engajamento baseado em impressão, 0 se não |