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: 
npm i advents-react-native

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

npm i react-native-device-info @react-native-clipboard/clipboard @sparkfabrik/react-native-idfa-aaid
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. 
import { advents } from 'advents-react-native'
import { requestTrackingPermissionsAsync } from 'expo-tracking-transparency'

export default function App() {
  useEffect(() => {
    init()
  }, [])

  const init = async () => {
    await requestTrackingPermissionsAsync()
    advents.init('advents_abcdefghijklmno123456789')
  }

  // ...
}

​
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

advents-react-native

As nossas SDKs são open source e disponíveis no GitHub.

advents-react-native

Pacote disponível no npm.