> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/tracking/mobile-app-tracking/set-up-a-mobile-app.md).

# Configurar um aplicativo móvel

<a href="https://pxa.impact.com/student/activity/1117597?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0?utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=tra-350&#x26;utm_campaign=help-center" class="button primary">Faça o curso PXA</a>

Se você está planejando rastrear eventos em seus aplicativos móveis, será necessário configurá-los na plataforma impact.com.

#### Criar um rastreador de aplicativo móvel

Você precisará já ter um aplicativo criado e disponível para instalação em uma loja de aplicativos antes de poder adicionar um rastreador para ele no impact.com

1. Na barra de navegação superior, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Perfil do usuário] → Configurações**.
2. À direita, em *Rastreamento*, selecione **Aplicativos móveis**.
3. No canto superior direito, selecione **Adicionar aplicativo móvel**.
4. Na *Configurações do aplicativo móvel* tela, preencha os campos em cada uma das seções a seguir:

<details>

<summary>Referência de informações do aplicativo móvel</summary>

* **Nome:** Adicione um nome para o seu aplicativo.
* **Códigos:** Adicione códigos personalizados para atuar como `EventTypeIds` quando o seu aplicativo enviar dados de conversão. (por exemplo, 123, 456, 789).
* **Plataforma:** Especifique a plataforma do aplicativo.
* **Outras versões:** Se você criou rastreadores de aplicativo móvel para outras plataformas, pode selecioná-los na caixa ao lado de *Outras versões*.
* **ID do bundle (iOS) / Nome do pacote (Android):** Insira o identificador exclusivo do seu aplicativo (por exemplo, `com.example.application`).
* **Impressões digitais SHA256 (Android):** Insira as impressões digitais SHA256 do certificado de assinatura do seu aplicativo (por exemplo, `14:6D:E9:83:C5:73:06:50...` etc).
* **ID da equipe (iOS):** Insira a string de duas partes usada para identificar seu aplicativo (por exemplo, `ABC123.com.example.application`).
* **ID do app (iOS):** Insira o identificador exclusivo do iTunes para o seu aplicativo (por exemplo, o identificador do iTunes para o *iBooks* o app é `364709193`)
* **URL de download:** Insira a URL direta de download de onde o app pode ser baixado na App Store (iOS) ou na Play Store (Android).

</details>

<details>

<summary>Referência de processamento de devoluções</summary>

Selecione como você quer lidar com reversões e modificações de ações.

* **Processar devoluções usando a tela de Pagamentos pendentes:** Se você quiser lidar com modificações de ações na [interface do impact.com](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/actions-and-payouts/payouts/approve-reverse-and-modify-pending-payouts-for-actions.md), selecione esta opção.
* **Automatizar o processamento de devoluções (avançado):** Se você quiser usar uma API, FTP ou SMTP para automatizar modificações de ações, selecione esta opção e escolha um dos métodos automatizados:
  * **Usar serviço web do sistema (API):** Use nossa API para enviar dados de conversão diretamente ao impact.com. Você precisará das credenciais de Acesso à API da sua conta.
  * **Enviar arquivo para o servidor FTP do sistema:** Use nosso servidor FTP para enviar dados de conversão em um arquivo CSV.
  * **Buscar arquivo do seu próprio servidor FTP:** Use seu próprio servidor FTP e faça com que o impact.com busque seus dados de conversão. Vamos precisar das seguintes informações:
    * **URL do servidor** — Selecione o prefixo de protocolo correto e insira a URL do servidor.
    * **Nome de usuário** — Insira o nome de usuário que o impact.com pode usar para acessar seu servidor FTP.
    * **Senha** — Insira a senha da conta FTP que o impact.com pode usar.
    * **Porta** — Insira a porta a ser usada ao se conectar ao seu servidor FTP.
    * **Diretório** — Insira o diretório onde o impact.com pode encontrar o arquivo (por exemplo, `/impact/returns`).
  * **Enviar arquivo por e-mail para o servidor SMTP do sistema:** O impact.com fornecerá um endereço de e-mail exclusivo para o qual você poderá enviar dados de conversão como anexo CSV.

</details>

<details>

<summary>Referência de Configurações avançadas</summary>

Se você quiser adicionar configurações avançadas, selecione **Mostrar configurações avançadas**.

* Se você quiser adicionar duplicação de ID do pedido (OID), ative ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[Ativar] Especificar uma janela de duplicação de OID**, depois adicione a janela de duplicação.
* Se você quiser adicionar custos do cliente, ative ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[Ativar] Adicionar custos do cliente**, depois selecione como você deseja incorporar os custos do cliente.
* Se você quiser adicionar bloqueio sem prazo, ative ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[Ativar] Bloquear ações atualizando seu status via serviços web ou uploads de arquivos em lote**.

</details>

5. Selecione **Salvar e continuar** para passar para a configuração de eventos pagáveis.
6. O *Eventos pagáveis* é onde você pode configurar os eventos do aplicativo pelos quais deseja pagar.

<details>

<summary>Referência de eventos pagáveis</summary>

* **Instalações do app:** As instalações são rastreadas e pagas por padrão. (Se você estiver usando um MMP de terceiros, precisará relatar as instalações do app como um evento no app, conforme descrito na opção abaixo.)
* **Eventos no app:** Configure os eventos no app pelos quais você fará o pagamento:
  * **Nome de exibição do evento** — Insira um nome descritivo de exibição do evento que aparecerá nos Termos do seu Modelo.
  * **Código do evento** — Insira o código de evento que diferencia maiúsculas e minúsculas e que o impact.com receberá do seu MMP.
  * **Regra de crédito** — Selecione *Instalar*Instalação *Último clique*, que creditará o parceiro que gerou o último clique de referência para o seu app antes da conversão.

</details>

7. Selecione **Salvar**.

#### Gerencie seus rastreadores de aplicativos móveis

Há várias maneiras de gerenciar seus rastreadores de aplicativos móveis existentes:

<details>

<summary>Editar um rastreador de aplicativo móvel</summary>

1. Na barra de navegação superior, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Perfil do usuário] → Configurações**.
2. À direita, em *Rastreamento*, selecione **Aplicativos móveis**.
3. Ao lado do rastreador que você deseja editar, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FMLtRUwWz0pujlfmYWOgg%2FMoreVN.svg?alt=media\&token=03a3c355-a347-4207-baf7-c44fadf6d080) **\[Mais] → Ver/Editar**.
4. Faça as alterações desejadas.
5. Selecione **Salvar**.

</details>

<details>

<summary>Adicionar mais eventos pagáveis a um rastreador</summary>

1. Na barra de navegação superior, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Perfil do usuário] → Configurações**.
2. À direita, em *Rastreamento*, selecione **Aplicativos móveis**.
3. Ao lado do rastreador para o qual você deseja adicionar códigos de destinação, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FMLtRUwWz0pujlfmYWOgg%2FMoreVN.svg?alt=media\&token=03a3c355-a347-4207-baf7-c44fadf6d080) **\[Mais] → Gerenciar eventos**.
4. No canto superior direito, selecione **Adicionar evento**.
5. Ao lado de *Eventos no app*, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-6282f271b7521383385339243690b303086736d9%2F3b5a585dd2895bdf1c30d1236c72ba590dddd18717863b27074c8d313d05ae20.svg?alt=media) **\[Adicionar outro evento]**.
   * Informe o **Nome de exibição do evento**. Este é o nome que aparecerá nos contratos e nos termos do modelo.
   * Informe o **Código do evento**. Este é o código que seu app envia sempre que o evento rastreado acontece.
   * Selecione o **Regra de crédito** no menu suspenso. Você pode creditar o evento por uma instalação ou pelo último clique.
6. Selecione **Salvar**.

</details>

<details>

<summary>Adicionar um código de destinação a um rastreador móvel</summary>

1. Na barra de navegação superior, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Perfil do usuário] → Configurações**.
2. À direita, em *Rastreamento*, selecione **Aplicativos móveis**.
3. Ao lado do rastreador para o qual você deseja adicionar códigos de destinação, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FMLtRUwWz0pujlfmYWOgg%2FMoreVN.svg?alt=media\&token=03a3c355-a347-4207-baf7-c44fadf6d080) **\[Mais] → Códigos de destinação**.
4. No canto superior direito, selecione **Adicionar código de destinação**.
5. Ao lado de *Código de destinação*, selecione ou insira o código que deseja usar.
   * Se você quiser usar um código comum, selecione-o no menu suspenso.
   * Se você quiser criar seu próprio código, insira o nome ao lado de *Nome da destinação*.
6. Ao lado de *Transição de status*, selecione o que você quer que o parceiro que gerou a ação veja.
7. Ao lado de *Alteração da ação*, selecione qual ação, se houver, acontecerá quando este código for selecionado.
8. Selecione **Salvar**.

</details>

<details>

<summary>Excluir um rastreador móvel</summary>

1. Na barra de navegação superior, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Perfil do usuário] → Configurações**.
2. À direita, em *Rastreamento*, selecione **Aplicativos móveis**.
3. Encontre o rastreador móvel que você deseja excluir, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FMLtRUwWz0pujlfmYWOgg%2FMoreVN.svg?alt=media\&token=03a3c355-a347-4207-baf7-c44fadf6d080) **\[Mais] →** **Excluir**.
4. Leia a mensagem de aviso e, em seguida, selecione **Entendo, continuar**.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/tracking/mobile-app-tracking/set-up-a-mobile-app.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
