Paywallo

React Native

Ponha o SDK do Paywallo no seu app React Native.

Antes de começar

  • Um app React Native.
  • iOS 15 ou superior.
  • Android 7 (API 24) ou superior.
  • O app já criado no Paywallo.

Passo 1: Instalar o pacote

1

No terminal, na pasta do projeto, instale o SDK.

bash
npm install @virex-tech/paywallo-sdk
2

Instale os 3 módulos do Expo que o SDK usa.

bash
npx expo install expo-application expo-device expo-localization
3

Só no iOS, instale a parte nativa.

bash
cd ios && pod install
4

Já tem um development build? Gere de novo, porque módulo nativo novo não entra só com reload.

bash
npx expo run:ios
# ou
npx expo run:android

Passo 2: Pegar a chave do app

1

No Paywallo, clique em Configurações.

2

Abra Apps e clique no seu app.

3

No card SDK Key, clique em Copiar.

Nos exemplos, a chave aparece como pk_XXXX. Troque pela sua.

Passo 3: Iniciar o SDK

A. Só no iOS: pedir a permissão de rastreio (ATT)

1

No Info.plist, adicione NSUserTrackingUsageDescription com o texto que o usuário vai ler.

2

Peça a permissão e espere a resposta antes de montar o Provider. Sem isso, o install perde atribuição. Instale o pacote com npx expo install expo-tracking-transparency.

tsx
import * as TrackingTransparency from "expo-tracking-transparency";
import { Platform } from "react-native";

async function bootstrap() {
  if (Platform.OS === "ios") {
    await TrackingTransparency.requestTrackingPermissionsAsync();
  }
}

B. Envolver o app com o Provider

1

Abra o arquivo raiz do app, o App.tsx.

2

Envolva o app com PaywalloProvider e cole a chave em appKey.

tsx
import { PaywalloProvider } from "@virex-tech/paywallo-sdk";
import * as Application from "expo-application";

export default function App() {
  return (
    <PaywalloProvider
      config={{
        appKey: "pk_XXXX",
        // Sem isso, os eventos levam a versão "unknown"
        appVersion: Application.nativeApplicationVersion ?? undefined,
      }}
    >
      <YourApp />
    </PaywalloProvider>
  );
}

O SDK envia o evento de install sozinho. Você não faz mais nada.

Passo 4: Confirmar que funcionou

1

Rode o app no celular ou no simulador.

2

No Paywallo, abra o painel e olhe o card Complete seu setup.

3

O item SDK muda para SDK conectado e enviando eventos.

Não mudou? Veja se a chave é a do app certo e se o aparelho tem internet.

Próximos passos

  • : liga o aparelho ao seu usuário.
  • : envia os eventos do seu app.
  • : avisa o Meta de cada install e compra.

Usa outra tecnologia?

Desenvolvido e mantido por Virex