Para ativar a integração do TikTok Web Ads:

1. Na AppsFlyer, no menu lateral, acesse Colaborar > Partner Marketplace.
2. Pesquise por TikTok Web (ou tiktokweb_int) e selecione-o.
3. Clique em Configurar a integração. Você será direcionado para a página de configuração de Integrações ativas.
4. Na aba Integração selecione Ativar parceiro. O botão deve permanecer ativado enquanto você trabalhar com o parceiro.
5. Desative a Privacidade Avançada (se estiver configurando uma integração de aplicativo iOS).
6. Compartilhamento de dados de correspondência avançada: Ative essa opção para compartilhar campos de correspondência avançada, como e-mail com hash, número de telefone com hash, nome com hash e sobrenome com hash, com o TikTok, se esses campos estiverem incluídos nas informações do evento enviadas à AppsFlyer. Para mais informações, consulte: Compartilhamento de dados de correspondência avançada (em inglês).
7. ID do pixel: Insira o ID do pixel. Você pode gerá-lo ou recuperá-lo no seu TikTok Ads Manager seguindo as instruções detalhadas AQUI.
8. Token de acesso: Insira o token de acesso. Para gerá-lo ou recuperá-lo, siga estas instruções

9. Limitar o uso, pelo TikTok Ads, de informações pessoais dos usuários (CCPA): Ative esta opção para permitir a compliance com as leis de proteção de dados.

    Nota

   O cumprimento das regulamentações de privacidade da CCPA limita os dados provenientes de usuários de anúncios do TikTok baseados na Califórnia ou em outros estados sensíveis dos EUA.

A AppsFlyer oferece suporte para a atribuição de view-through em campanhas web do TikTok usando uma landing page habilitada para Smart Script ou Smart Banner. Isso permite a atribuição de instalação de aplicativos por modelagem probabilística (PMOD), que é acionada por impressões de anúncios, mesmo quando os usuários não clicam diretamente no anúncio.

Quando um usuário clica em um anúncio web do TikTok e acessa uma landing page habilitada para Smart Script ou Smart Banner, a AppsFlyer pode atribuir a instalação do aplicativo mais adiante. Se disponível, o ttclid será incluído no postback para o TikTok a fim de aumentar a confiabilidade da atribuição.

Para habilitar a atribuição de view-through do TikTok web:

1. Na AppsFlyer, no menu lateral, abra Integrações ativas > anúncios web do TikTok.
2. Na aba Integração, vá até a seção Atribuição de instalação.
3. Ative a Atribuição de instalação por view-through.
4. [Opcional] Ative a Prioridade de atribuição equitativa entre plataformas e defina sua janela de lookback. Para mais informações, veja o artigo Ativar prioridade equitativa para impressões entre plataformas.
5. Clique na aba do link de atribuição.
6. Vá até Atribuição de view-through e defina a janela de lookback de view-through desejada (de até 24 horas).
7. Clique em Salvar integração para aplicar suas configurações.

Atualmente, as instalações são os únicos eventos que acionam postbacks padrão automáticos para o TikTok Ads. Para outros tipos de eventos, você pode criar postbacks personalizados mapeando eventos da AppsFlyer para eventos do TikTok Ads, que podem ser visualizados no TikTok Ads Manager.

Para definir os postbacks de eventos in-app, faça o seguinte:

1. Ative os postbacks de eventos in-app.
2. Se necessário, defina a janela de postback de eventos in-app (leia mais sobre a configuração da janela de postback de eventos in-app em geral in este artigo).
3. Clique em Adicionar evento para adicionar um evento à lista.
4. Na coluna evento da AppsFlyer , selecione o nome do evento na caixa suspensa. A AppsFlyer recebe o nome do evento do SDK integrado no aplicativo ou de eventos de server-to-server.
5. Na coluna mapeado para o evento do parceiro column, selecione na caixa suspensa o evento de parceiro predefinido mais adequado.
6. Na coluna Para usuários de , selecione Somente este parceiro para garantir que os postbacks de eventos in-app sejam enviados exclusivamente para eventos realizados por usuários que se originaram desse parceiro.

7. Na coluna Incluindo , selecione se os eventos serão enviados com os valores de receita. See Dados a incluir nos postbacks.

    Nota

   • Se você estiver configurando um evento de compra, defina a coluna including para Values and revenue. Selecionar qualquer outra opção fará com que o postback falhe.
   • Atualmente, apenas o evento de compra pode ser configurado para incluir receita.
8. [Opcional] Clique no ícone Adicionar condição para definir condições para um evento.
9. Clique em Salvar integração.
10. [Opcional] Após salvar a integração, você pode integrar mais aplicativos com o parceiro em questão:
    1. No canto superior esquerdo clique no nome do aplicativo para abrir a lista de aplicativos.
    2. Selecione um aplicativo diferente a partir da lista suspensa.
    3. Repita as etapas de integração para o aplicativo selecionado.

Você pode escolher qualquer evento in-app predefinido enviado pela AppsFlyer como objetivo da sua campanha ou escolher “Download” se quiser otimizar para instalações de aplicativos mobile.

1. Em Destino, na URL do site, insira a URL que serve como destino para seu anúncio. A URL deve ser para:
   • Uma landing page na web: O uso é recomendado quando:
     • Você tem um aplicativo em várias plataformas.
     • Você deseja usar a landing page para fornecer mais informações sobre o produto anunciado.

     • Você quer usar a página de destino para coletar mais dados.

       Para todos esses casos de uso, crie uma landing page habilitada para Smart Script ou Smart Banner-enabled landing page.

   • Links de atribuição da AF: Usar links de atribuição da AF (OneLink, plataforma única ou multiplataforma) é recomendado quando você deseja que o usuário seja redirecionado diretamente para a loja para fazer o download do aplicativo sem antes visitar uma landing page.
2. Clique em Criar um parâmetro de URL para adicionar os parâmetros de URL à URL (seja uma URL de landing page ou um link de atribuição da AppsFlyer).
3. Em Parâmetros personalizados, clique em Adicionar parâmetro.

4. Mapeie os parâmetros da AppsFlyer de acordo com seus valores do TikTok. Os parâmetros que você mapeará dependem de a URL de destino apontar para uma landing page, um link de atribuição ou uma loja de PC ou console.

   Landing page ou link de atribuição

   Se a URL de destino for uma landing page, um link de atribuição do OneLink ou um link de atribuição de plataforma única, mapeie os seguintes parâmetros da AppsFlyer para seus equivalentes no TikTok:

   Parâmetro AF	Valor mapeado no TikTok
   pid	tiktokweb_int
   c*	__campaign_name__
   af_c_id	__campaign_id__
   af_adset	__aid_name__
   af_adset_id	__aid__
   af_ad	__cid_name__
   af_ad_id	__cid__

   * Para simplificar a análise da campanha, inclua o tipo de campanha, (web ou mobile) como um prefixo ou sufixo no nome da campanha (por exemplo, nome-da-campanha_web).

   Um exemplo da URL resultante deve ser:

   https://app.appsflyer.com/{app_id}?pid=tiktokweb_int&c=__campaign_name__&af_c_id=__campaign_id__&af_adset=__aid_name__&af_adset_id=__aid__&af_ad=__cid_name__&af_ad_id=__cid__&af_r={https://Add-your-store-url.com}

   Se o APK do seu aplicativo NÃO estiver hospedado na Google Play Store, adicione o parâmetro af_r e mapeie-o para a URL da loja. Exemplo: https://Add-your-store-url.com.

   Loja de PC ou console

   Se a URL de destino for um PC ou uma loja de console, crie o link seguindo as instruções na tabela abaixo. Para mais informações, consulte: Links de atribuição direta das plataforma de CTV, PC e console

   Componente do link	Valor
   URL base	engagements.appsflyer.com/v1.0/c2s/click/app/
   Parâmetros de caminho obrigatórios	▪ platformExample: steam ▪ app_idExample: 123456
   Parâmetros de consulta obrigatórios	▪ af_media_source ▪ af_campaign_id ▪ af_r
   Outros parâmetros	Ver todos os parâmetros
   Estrutura da URL	https://engagements.appsflyer.com/v1.0/c2s/click/app/{platform}/{app_id}?af_media_source={media_source}&af_campaign_id={campaign_id}&af_r={app_store_url}

   Mapeie os seguintes parâmetros da AppsFlyer para seus equivalentes do TikTok:

   Parâmetro AF	Valor mapeado no TikTok
   media_source	tiktokweb_int
   af_campaign *	__campaign_name__
   af_campaign_id	__campaign_id__
   af_adset	__aid_name__
   af_adset_id	__aid__
   af_ad	__cid_name__
   af_ad_id	__cid__

   * Para simplificar a análise da campanha, inclua o tipo de campanha, (web ou mobile) como um prefixo ou sufixo no nome da campanha (por exemplo, nome-da-campanha_web).

   Um exemplo de URL multiplataforma:

   https://engagements.appsflyer.com/v1.0/c2s/click/app/steam/123456?af_media_source=tiktokweb_int&af_campaign_id=__campaign_id__&af_campaign=__campaign_name__&af_adset=__aid_name__&af_adset_id=__aid__&af_ad=__cid_name__&af_ad_id=__cid__&af_r=https%3A%2F%2Fstore.steampowered.com%2Fapp%2F440%2FTest_app2%2F%3Futm_term%3Dhello

    Nota

   O TikTok adiciona o ttclid={{ttclid}} à URL de destino automaticamente quando o anúncio é clicado

1. A URL do anúncio do TikTok inclui o  pid=tiktokweb_int parâmetro. Quando o usuário clica no anúncio, um parâmetro ttclid é automaticamente anexado à URL clicada.
2. O usuário é redirecionado para o destino da URL: uma landing page que contém um Smart Script.
3. Quando a landing page é carregada, o Smart Banner envia uma impressão para a AppsFlyer contendo os parâmetros da URL de entrada. A impressão permitirá a atribuição de view-through na landing page da web. Para saber mais sobre impressões e atribuição de view-through, leia este artigo.
4. O Smart Script gera as URLs de saída para os botões CTA na página com base nos parâmetros da URL de entrada, incluindo o ttclid parâmetro. Os botões podem levar a:
   • Google Play e App Store por meio de um link de atribuição do OneLink.
   • Lojas de várias plataformas (exemplo: CTV, Epic e Steam). Nesse caso, o Smart Script gera um único link de atribuição para cada plataforma, levando à loja especificada.
   • Download de um arquivo APK para o dispositivo do usuário.
5. Quando o usuário clica no botão CTA, o clique é acionado e registrado na AppsFlyer.
6. Em seguida, ele é redirecionado para a loja e baixa o aplicativo.
7. Quando o usuário abre o aplicativo, o evento de instalação é registrado na AppsFlyer.
8. A AppsFlyer atribui a instalação com base em modelo probabilístico ou, se um install referrer estiver disponível, deterministicamente.
9. Um postback com os parâmetros de ttclid e outros parâmetros de evento é gerado e enviado ao TikTok por meio da Events API. O TikTok usa o parâmetro ttclid para identificar o clique específico, enquanto os outros parâmetros ajudam a otimizar a campanha.

Para configurar suas campanhas do TikTok Ads com o Smart Script, faça o seguinte:

1. Configure o template para os links de atribuição do OneLink da campanha. Para obter mais informações, veja como criar templates do OneLink.

2. Crie um Smart Script. Para mais informações, veja como criar um Smart Script do OneLink.

    Nota

   As instruções abaixo se concentram nas etapas específicas necessárias para configurar uma campanha do TikTok Ads com o Smart Script. Para um guia abrangente sobre como configurar campanhas de Smart Script, consulte Como criar um OneLink Smart Script no artigo de configuração do OneLink Smart Script V2.

3. Certifique-se de que todos os parâmetros de URL relevantes sejam anexados à URL de entrada. Para revisar os parâmetros anexados à URL de entrada, abra o TikTok Ads Manager e verifique os parâmetros de URL definidos durante a criação da URL de destino. Para obter mais informações, consulte  Set destination URL.
4. Mapeie os parâmetros de URL de entrada necessários para a campanha do TikTok Ads com os parâmetros de URL de saída que serão enviados à AppsFlyer quando o usuário clicar no botão CTA:
   • PID: Certifique-se de que o Smart Script pegue o valor do parâmetro pid=tiktokweb_int da URL de entrada e o mapeie para os parâmetros correspondentes na URL de saída.

   • TTCLID: O ttclid parâmetro é essencial para enviar com sucesso postbacks de eventos in-app para o TikTok. O ttclid parâmetro deve ser mapeado manualmente na seção de mapeamento de parâmetros de URL da página do Smart Script page:

     1. Em Mapeamento para, selecione Parâmetro personalizado.
     2. Em Outgoing URL parameter e Incoming URL parameters insira ttclid.

      Nota

     Para exibir nos relatórios de dados brutos da AppsFlyer, o parâmetro de entrada ttclid também deve ser mapeado (além do parâmetro de saída ttclid ) para um dos parâmetros de saída af_sub[1-5] .

Para configurar suas campanhas do TikTok Ads com o Smart Script para páginas de destino multiplataforma, faça o seguinte:

1. Configure o template para os links de atribuição do OneLink da campanha. Para obter mais informações, veja como criar templates do OneLink.
   • Ative seu template do OneLink para atribuição multiplataforma, veja aqui.
2. Certifique-se de que todos os parâmetros de URL relevantes sejam anexados à URL de entrada. Para revisar os parâmetros anexados à URL de entrada, abra o TikTok Ads Manager e examine os parâmetros de URL que você definiu ao criar a URL de destino. Para obter mais informações, veja como definir uma URL de destino.
3. Para cada parâmetro de entrada, decida o parâmetro de saída para onde ele será mapeado. Por exemplo, o parâmetro af_site_id na URL de entrada será mapeado para o parâmetro de af_site_id na URL de saída.
4. Decida o valor padrão para os parâmetros de saída obrigatórios que não podem estar vazios.
5. Envie ao seu desenvolvedor as seguintes informações:
   • Seu mapeamento de parâmetros de entrada e saída. O desenvolvedor criará um script que gera uma URL direta de saída com base no mapeamento de parâmetros de entrada e saída.
   • Os valores padrão dos parâmetros. O script preencherá os parâmetros de URL de saída com os valores padrão sempre que não houver valores de parâmetros de URL de entrada correspondentes.
   • Se você estiver usando um link de atribuição do OneLink, envie o ID do domínio e do template para seu desenvolvedor. O desenvolvedor usa isso para criar a URL de saída do OneLink. Exemplos: yourbrand.onelink.me/A1b2 ou click.yourbrand.com/A1b2
   • Envie ao seu desenvolvedor os seguintes links do Dev Hub:
     • Exemplos de instruções e códigos sobre como criar URLs de saída para plataformas não mobile.
     • Uma demonstração e instruções sobre como criar uma landing page multiplataforma.

• Lembre seu desenvolvedor de incluir o parâmetro de entrada ttclid na URL de saída.

   Nota

  Para exibir nos relatórios de dados brutos da AppsFlyer, o parâmetro de entrada ttclid também deve ser mapeado (além do parâmetro de saída ttclid ) para um dos parâmetros de saída af_sub[1-5] .

1. A URL do anúncio do TikTok inclui o  pid=tiktokweb_int parâmetro. Quando o usuário clica no anúncio, um ttclid parâmetro é automaticamente anexado à URL clicada.
2. O usuário é redirecionado para o destino da URL: uma landing page que contém um Smart Banner.
3. Quando a landing page é carregada, o Smart Banner envia uma impressão para a AppsFlyer contendo os parâmetros da URL de entrada. Essa impressão permite a atribuição de view-through para a landing page. Para saber mais sobre impressões e atribuição de view-through, leia este artigo.
4. O Smart Banner gera a URL de saída para o botão CTA no banner. A URL de saída é baseada nos parâmetros da URL de entrada, incluindo o ttclid parâmetro. O Smart Banner pode gerar somente links baseados no OneLink.
5. Quando o usuário clica no botão CTA do Smart Banner, o clique é acionado e registrado na AppsFlyer.
6. Em seguida, ele é redirecionado para a loja e baixa o aplicativo.
7. Quando o usuário abre o aplicativo, o evento de instalação é registrado na AppsFlyer.
8. A AppsFlyer atribui a instalação com base em modelagem probabilística ou deterministicamente se um install referrer estiver disponível.
9. Um postback contendo os ttclid parâmetros e outros parâmetros de evento é gerado e enviado ao TikTok por meio da Events API. O TikTok usa o ttclid parâmetro para identificar o clique específico, enquanto os outros parâmetros ajudam a otimizar a campanha.

Para configurar suas campanhas de Smart Banners do TikTok Ads, faça o seguinte:

1. Configure o template para os links de atribuição do OneLink da campanha. Para obter mais informações, veja como criar templates do OneLink.

2. Crie um Smart Banner.

    Nota

   As instruções abaixo se concentram nas etapas específicas necessárias para configurar uma campanha do TikTok Ads com Smart Banners. Para obter um guia abrangente sobre como configurar campanhas de Smart Banners, consulte a seção de configuração do artigo Smart Banners — web-to-app mobile (para profissionais de marketing).

3. Defina os parâmetros do Smart Banner para campanhas do TikTok Ads:
   • Certifique-se de que todos os parâmetros de URL relevantes sejam anexados à URL de entrada. Mais importante ainda, o pid=tiktokweb_int e ttclid estão disponíveis na URL de entrada para permitir que o Smart Banner os colete. Esses dois parâmetros são necessários para atribuição e envio de postbacks para o TikTok Ads. Para revisar os parâmetros que são anexados à URL de entrada, abra o TikTok Ads Manager e examine os parâmetros de URL definidos durante a criação da URL de destino. Consulte: Configurar URL de destino.