Aprenda como integrar a SDK da Advents em seu aplicativo React Native.

Pré-requisitos

Para continuar, você precisa de:

  • Acesso à plataforma da Advents.
  • Um app criado e configurado na plataforma.
  • A chave de API do seu app. Mais detalhes em: Chave da API.

1. Instalação

Para instalar a SDK da Advents, execute o comando abaixo no diretório do seu projeto:


Além da advents-react-native, você precisa instalar pacotes adicionais que são necessários para o funcionamento da SDK.
Dependendo do tipo do seu projeto - Expo ou React Native puro - você precisa instalar pacotes diferentes.

Expo

Terminal
npx expo install expo-application expo-device expo-clipboard expo-constants expo-tracking-transparency

O pacote expo-tracking-transparency não é obrigatório, mas é recomendado para melhorar a precisão da atribuição no iOS.
Caso deseje instalar, é necessário seguir etapas adicionais, consulte a documentação

React Native puro

O pacote @sparkfabrik/react-native-idfa-aaid não é obrigatório, mas é recomendado para melhorar a precisão da atribuição no iOS.
Caso deseje instalar, é necessário seguir etapas adicionais, consulte a documentação

2. Inicialização

Após a instalação, você precisa inicializar a SDK com sua chave de API. Recomendamos fazer isso o mais cedo possível no ciclo de vida do seu aplicativo, preferencialmente no componente de entrada do seu app.

App.tsx
import { advents } from 'advents-react-native'

export default function App() {
  advents.init('advents_abcdefghijklmno123456789')

  // ...
}

Permissão de trackeamento (ATT)

Os pacotes expo-tracking-transparency para projetos Expo e @sparkfabrik/react-native-idfa-aaid para projetos React Native puro, são responsáveis por solicitar a permissão de trackeamento - ATT (App Tracking Transparency) - ao usuário em dispositivos iOS. Para mais informações, consulte a documentação oficial da Apple.

Com a permissão concedida, a SDK consegue coletar o IDFA (Identifier for Advertisers) do dispositivo, o que melhora a precisão da atribuição.

Como dito anteriormente, os pacotes são opcionais. Caso opte por instalar, você deve solicitar a permissão de ATT antes de inicializar a SDK.

3. Verificação

Após finalizar a instalação e inicialização, entre em contato com a nossa equipe através do suporte para verificar se os eventos enviados pela SDK estão sendo recebidos corretamente.

Recursos Adicionais