Como integrar o SDK de eventos do app TikTok

Antes de começar

Você precisará de uma conta de anúncios do TikTok e de uma ID do app TikTok para usar o SDK de eventos do app TikTok para Android e iOS. É possível usar seu app atual, se tiver, ou criar um novo app.

Observação: O SDK de eventos do app TikTok agora aceita a configuração híbrida com MMPs na mesma conta. Você pode criar uma nova conta de anúncios do TikTok para integrar o SDK ou usar a sua conta existente do MMP para fazer isso.

Como integrar o SDK de eventos do app TikTok

Etapa 1: crie um app ou use um existente e gere uma ID do app TikTok e um segredo do app

Opção 1: Adicione o SDK a um app conectado ao MMP (configuração híbrida)

1. Faça login no TikTok Ads Manager.

2. Clique na guia Ferramentas e em Gerenciador de Eventos.

3. Selecione Fontes de dados e escolha o app que você quer adicionar à conexão do SDK.

   
   
   

4. Acesse a guia Configurações e clique em Escolher parceiro no SDK de eventos do app TikTok.

   
   
   

5. Siga o processo e adicione o SDK à conta. Gere a ID do app TikTok e o segredo do app.

   

Opção 2: Adicione o SDK a um app recém-criado

1. Faça login no TikTok Ads Manager.

2. Clique na guia Ferramentas e em Gerenciador de Eventos.

3. Selecione Conectar fonte de dados na barra de navegação superior à esquerda e escolha App.

   
   
   

4. Selecione SDK do TikTok para conectar o seu app.

   
   
   

5. Informe os detalhes e crie o seu app. Siga o processo e gere a ID do app TikTok e o segredo do app.

   
   
   

Etapa 2: siga as instruções no guia da Central de desenvolvedores do TikTok para integrar o SDK de eventos do app TikTok

1. Para inicializar o SDK, você precisa ter a ID do app, a ID do app TikTok e o segredo do app antes da etapa 1.

   1. Demonstração de ID do app e ID do app TikTok:

      
      
      

   2. Demonstração de segredo do app:

      
      
      

2. Faça download do SDK no GitHub. Por enquanto, oferecemos suporte ao SDK nativo do iOS, SDK nativo do Android e SDK do Unity.

Etapa 3: postback de eventos por meio do SDK

1. Para obter uma lista completa de eventos do app padrão que você pode registrar e de eventos registrados automaticamente, acesse: Eventos padrão.

2. Os eventos registrados automaticamente estão listados abaixo. Observação: Você pode desativar os eventos registrados automaticamente. Para saber mais, acesse Documentos para desenvolvedores do SDK de eventos do app.

   1. Lançar app: quando o app está sendo aberto.

   2. Instalar app: quando o app é aberto pela primeira vez.

   3. 2DRetention: o app é aberto novamente no dia seguinte àquele em que foi aberto pela primeira vez.

   4. Compra: pagamentos de bens consumíveis/não consumíveis/inscrições concluídos com êxito.

      1. Verifique se o postback de compra de registro automático está alinhado com os seus requisitos de negócios antes de ativá-lo. Veja mais detalhes sobre o evento de compra de registro automático do iOS e o evento de compra de registro automático do Android.

Aviso especial para eventos de compra de registro automático: o SDK pode capturar automaticamente transações feitas pelo faturamento do StoreKit (iOS) ou do Google Play (Android). Para passar mais propriedades e parâmetros ou se você não está usando um gateway de pagamento nativo da Apple ou do Google, é recomendável usar um postback de compra manual.

Etapa 4: [iOS] mensure eventos SKAN

No ambiente SKAdNetwork (SKAN), é recomendável ter apenas um SDK relatando os valores da conversão. Se você está usando MMP ou outro SDK para atualizar os valores de conversão para a SKAdNetwork, adicione disableSKAdNetworkSupport() à sua configuração para evitar conflitos de atualização.

Determine se precisa ativar a mensuração do SKAN do SDK do TikTok:

Se você tem um MMP:

• O SDK do MMP atualiza o valor da conversão (CV), e você pretende usar o esquema do SKAN do MMP: desative o suporte à SKAdNetwork no SDK do TikTok e não faça upload de um esquema para o Gerenciador de Eventos do TikTok. (Seu MMP permanece como a única fonte de verdade para atualizações do valor da conversão e o esquema.)

Se você NÃO tem um MMP:

Verifique se apenas um SDK no seu app atualiza o valor de conversão do SKAN.

• Outro SDK que não é do MMP está atualizando o valor da conversão: desative o suporte à SKAdNetwork no SDK do TikTok, mas faça upload de um esquema para o Gerenciador de Eventos do TikTok. (O TikTok usará o seu esquema, mas não fará atualizações redundantes do valor da conversão.)

• O SDK do TikTok é responsável por atualizar o valor da conversão: ative o suporte à SKAdNetwork no SDK do TikTok e faça upload de um esquema para o Gerenciador de Eventos do TikTok. (O TikTok se torna o principal gerenciador de atualizações do valor da conversão do SKAN.)

Para obter mais detalhes, consulte o documento para desenvolvedores do SDK de eventos do app.

Etapa 5: verifique postbacks em tempo real com o modo de depuração

A partir do SDK versão 1.5.0, há dois métodos de verificação da integração do SDK antes do lançamento:

• (Recomendado) Um modo de eventos de teste baseado em token, que é feito totalmente no Gerenciador de Eventos do TikTok e não requer modificação de código.

• Modo de depuração manual, que requer modificação. Ao usar a depuração manual, lembre-se de desativar o modo de depuração antes de lançar o app. Os eventos gerados ao usar uma dessas ferramentas passam por um pipeline de testes e não podem ser usados em relatórios.

  • Modo de depuração: Ativado

    

    Modo de depuração: Desativado

    

Etapa 6: lance a nova versão do app com o SDK do TikTok na App Store (iOS)/Play Store (Android)

Assim que o TikTok começar a receber seu indicador em tempo real do SDK, você poderá ver o evento do SDK na guia Relatórios no Gerenciador de Eventos. Indicadores em modo de teste não aparecerão aqui.

Etapa 7: veicule sua campanha usando o SDK do TikTok

Se tiver problemas ou dificuldades para integrar o SDK de eventos do app, abra um ticket no Atendimento ao Cliente. Selecione Mensuração e SDK de eventos do app como categoria de problema.