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 não aceita a configuração dupla com MMPs na mesma conta de anúncios. Crie uma nova conta de anúncios do TikTok para integrar o SDK de eventos do app à nova conta de anúncios sem MMP.

Como integrar o SDK de eventos do app TikTok

Etapa 1: crie um app e gere uma ID do app TikTok no Gerenciador de Eventos do TikTok.

1. No TikTok Ads Manager, acesse o Gerenciador de Eventos clicando na guia Ferramentas e em Evento.

2. Selecione Conectar fonte de dados na barra de navegação superior à direita.

3. Selecione App e continue.

4. Informe os detalhes do app.

5. Selecione Usar o SDK de eventos do TikTok e continue. O app é criado.

6. Gere a sua ID do app TikTok.

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 obter uma lista completa de eventos do app padrão que você pode registrar e de eventos registrados automaticamente, consulte: Eventos padrão.

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

   1. LaunchApp: quando o app está sendo aberto.

   2. InstallApp: 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. Comprar (somente iOS): pagamentos de bens consumíveis/não consumíveis/inscrições concluídos com êxito.

3. [Apenas para iOS] Configure o esquema de valor da conversão do SKAN no Gerenciador de Eventos do TikTok (TTEM).

   1. É obrigatório configurar o esquema de valor da conversão no TTEM para receber conversões do SKAN. O TikTok é compatível com o mapeamento de valores da conversão de 64 bits no SKAN 3.0 e o mapeamento de esquema do SKAN 4.0.

   2. [Prática recomendada] No ambiente SKAdNetwork (SKAN), é recomendável ter apenas um SDK relatando os valores da conversão. Se estiver usando MMP ou outro SDK para atualizar os valores da conversão para a SKAdNetwork, você precisará:

      1. Configurar o esquema de CV do TTEM com os mesmos valores configurados no MMP.

      2. Implementar o recurso disableSKAdNetworkSupport() para evitar que o SDK de eventos do app TikTok atualize os valores da conversão.

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

1. Para verificar e depurar os postbacks de eventos e os parâmetros relevantes em tempo real, ative o modo de depuração no app. Para ver os eventos, acesse a guia Evento de teste do app no Gerenciador de Eventos do TikTok.

Observações:

• Os eventos de teste aceitam testar várias IDs do App TikTok ao mesmo tempo. No entanto, se várias IDs do App TikTok forem testadas juntas, todos os eventos de teste dessas várias IDs aparecerão na guia Evento de teste na conta de anúncios que tem a primeira ID do App TikTok associada.

• Depois de verificar a configuração dos seus indicadores, desligue o modo de depuração antes de lançar o app na App Store/Play Store. Os eventos de teste podem ficar visíveis por até 72 horas depois de desativados. Se eles ainda estiverem visíveis depois de 72 horas na guia Evento de teste, é porque o modo de depuração ainda não está desativado. Veja o exemplo abaixo:

Modo de depuração: Ativado

Modo de depuração: Desativado

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

Etapa 5: 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.