Integração do SDK

Requisitos

O plugin depende dos nossos SDKs nativos, portanto o app deve atender aos requisitos deles:

• Android: Android Gradle Plugin 8.9.1 ou superior (Gradle 8.11.1 ou superior), compile SDK 36 ou superior, Kotlin 2.2 ou superior e SDK mínimo 24 ou superior
• iOS: Xcode 15.0 ou superior e target deployment iOS 13.0 ou superior

Cuidado

Os templates do React Native geralmente vêm com uma versão antiga do Android Gradle Plugin, portanto a versão declarada pelo app precisa ser elevada para 8.9.1 ou superior. Caso contrário, o build falha com um erro de AAR metadata.

Instalar dependência

Para integrar nosso SDK para React Native, você precisa executar o seguinte comando na raiz do projeto:

npm install @wortise/react-native-sdk --save

Nota

A versão mais recente do SDK para React Native é a 1.8.0

Configurar projeto Expo

Se o seu projeto usa o framework Expo, o processo de configuração pode ser feito de forma simples.

Basta adicionar os seguintes detalhes dentro do arquivo app.json do projeto:

{
  "expo": {
    "plugins": [
      [
        "@wortise/react-native-sdk",
        {
          "androidGoogleAppId": "ca-app-pub-xxxxxxxxxxxxxx~yyyyyyyyyy",
          "iosGoogleAppId": "ca-app-pub-xxxxxxxxxxxxxx~yyyyyyyyyy"
        }
      ]
    ]
  }
}

Nota

Este valor pode ser encontrado em nosso dashboard, nos detalhes do app, sob o nome Google App ID.

Após concluir a configuração, nosso plugin inserirá automaticamente os “App IDs” do Google para ambas as plataformas, assim como os repositórios e outros detalhes necessários para completar a integração do SDK.

Configurar projeto manualmente

Se o seu projeto não usa o framework Expo, ou se você prefere fazer uma configuração manual, siga os passos a seguir:

Adicionar repositórios (Android)

Em seguida, os seguintes repositórios Maven precisam ser adicionados dentro do bloco allprojects > repositories do arquivo android/build.gradle:

allprojects {
    repositories {
        ...
        maven { url 'https://maven.wortise.com/artifactory/public' }

        maven { url 'https://artifact.bytedance.com/repository/pangle' }
        maven { url 'https://artifactory.bidmachine.io/bidmachine' }
    }
}

Configurar Manifest (Android)

Você precisa adicionar o seguinte elemento <meta-data> no arquivo android/app/src/main/AndroidManifest.xml, dentro do bloco <application>, com o ID de aplicativo do Google como valor:

<manifest>
    ...
    <application>
        ...
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    </application>
</manifest>

Nota

Este valor pode ser encontrado em nosso dashboard, nos detalhes do app, sob o nome Google App ID.

Configurar Info.plist (iOS)

Você precisa adicionar o seguinte parâmetro no arquivo Info.plist, com o ID de aplicativo do Google como valor:

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-xxxxxxxxxxxxxxxxxx</string>

Nota

Este valor pode ser encontrado em nosso dashboard, nos detalhes do app, sob o nome Google App ID.

Em seguida, basta adicionar o seguinte bloco, no mesmo arquivo, para completar a integração correta com o Google:

<key>SKAdNetworkItems</key>
<array>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>cstr6suwn9.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4fzdc2evr5.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4pfyvq9l8r.skadnetwork </string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>2fnua5tdw4.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ydx93a7ass.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>5a6flpkh64.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>p78axxw29g.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v72qych5uu.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ludvb6z3bs.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>cp8zw746q7.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>c6k4g5qg8m.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>s39g8k73mm.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3qy4746246.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3sh42y64q3.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>f38h382jlk.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>hs6bdukanm.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>prcb7njmu6.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v4nxqhlyqp.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>wzmmz9fp6w.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>yclnxrl5pm.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>t38b2kh725.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>7ug5zh24hu.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>9rd848q2bz.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>y5ghdn5j9k.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>n6fk4nfna4.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v9wttpbfk9.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>n38lu8286q.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>47vhws6wlr.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>kbd757ywx3.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>9t245vhmpl.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>a2p9lx4jpn.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>22mmun2rn5.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4468km3ulz.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>2u9pt9hc89.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>8s468mfl3y.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>av6w8kgt66.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>klf5c3l5u5.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ppxm28t8ap.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>424m5254lk.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ecpz2srf59.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>uw77j35x4d.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>mlmmfzh3r3.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>578prtvx9j.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4dzt52r2t5.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>gta9lk7p23.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>e5fvkxwrpn.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>8c4e2ghe7u.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>zq492l623r.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3rd42ekr43.skadnetwork</string>
    </dict>
    <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3qcr597p9d.skadnetwork</string>
    </dict>
</array>

Solicitar consentimento

Dica

É altamente recomendável solicitar o consentimento do usuário para poder exibir anúncios personalizados. Isso nos permitirá exibir conteúdo de maior interesse e gerar receitas mais altas.

Você pode consultar a seguinte seção para implementar essa solicitação e obter o consentimento do usuário: Consentimento do usuário

Inicializar o SDK

Existem duas opções para fazer a inicialização do SDK:

Opção 1 (recomendada)

A opção mais recomendada é fazer a inicialização na classe Application do app. Para isso, o seguinte código deve ser integrado no método onCreate() do arquivo MainApplication.java:

WortiseSdk.initialize(this, "sua app key");

Opção 2

Nesta opção, a inicialização do SDK é feita diretamente no código JavaScript do projeto. Para isso, as seguintes linhas devem ser adicionadas ao código em um lugar apropriado:

import { RNWortiseSdk } from '@wortise/react-native-sdk';

await RNWortiseSdk.initialize('sua app key');

Modo de teste

Para verificar a integração, o SDK oferece um modo de teste que permite que o app sempre receba anúncios.

Além da opção disponível em nosso dashboard, você pode ativar esse modo de teste programaticamente, a partir do próprio SDK, usando o seguinte código:

import { RNWortiseAdSettings } from '@wortise/react-native-sdk';

RNWortiseAdSettings.setTestEnabled(true);