> 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 nos seus aplicativos móveis, será necessário configurá-los na plataforma impact.com.

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

Você precisará já ter um app 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 **Apps móveis**.
3. No canto superior direito, selecione **Adicionar app móvel**.
4. Na *Configurações do app móvel* tela, preencha os campos em cada uma das seções a seguir:

<details>

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

* **Nome:** Adicione um nome para seu app.
* **Códigos:** Adicione códigos personalizados para atuar como `EventTypeIds` quando seu app enviar dados de conversão. (por exemplo, 123, 456, 789).
* **Plataforma:** Especifique a plataforma do app.
* **Outras versões:** Se você criou rastreadores de app móvel para outras plataformas, pode selecioná-los na caixa ao lado de *Outras versões*.
* **ID do pacote (iOS) / Nome do pacote (Android):** Insira o identificador exclusivo do seu app (por exemplo, `com.example.application`).
* **Impressões digitais SHA256 (Android):** Insira as impressões digitais SHA256 do certificado de assinatura do seu app (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 app (por exemplo, `ABC123.com.example.application`).
* **ID do app (iOS):** Insira o identificador exclusivo do iTunes do seu app (por exemplo, o identificador do iTunes para o *iBooks* app é `364709193`)
* **URL de download:** Insira a URL direta de download 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 tratar reversões e modificações de ações.

* **Processar devoluções usando a tela de Pagamentos pendentes:** Se você quiser tratar 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 deixe o impact.com buscar 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 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), alterne ![](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, alterne ![](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 deseja incorporar os custos do cliente.
* Se você quiser adicionar Bloqueio sem prazo, alterne ![](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 o status delas por meio de serviços web ou uploads de arquivos em lote**.

</details>

5. Selecione **Salvar e continuar** para avançar para a configuração de eventos pagáveis.
6. O *Eventos pagáveis* tela é onde você pode configurar os eventos do app pelos quais deseja efetuar pagamento.

<details>

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

* **Instalações do app:** As instalações são rastreadas e pagáveis por padrão. (Se você estiver usando um MMP de terceiros, será necessário 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 seus Termos do modelo.
  * **Código do evento** — Insira o código do evento, com diferenciação entre maiúsculas e minúsculas, que o impact.com receberá do seu MMP.
  * **Regra de crédito** — Selecione *Instalar*, que creditará o parceiro que gerou a instalação inicial do seu app, ou *Ú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 app móvel

Há várias maneiras de gerenciar seus rastreadores de app móvel existentes:

<details>

<summary>Editar um rastreador de app 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 **Apps 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 que deseja.
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 **Apps móveis**.
3. Ao lado do rastreador para o qual você deseja adicionar códigos de disposiçã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 transmite 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 disposiçã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 **Apps móveis**.
3. Ao lado do rastreador para o qual você deseja adicionar códigos de disposiçã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 disposição**.
4. No canto superior direito, selecione **Adicionar código de disposição**.
5. Ao lado de *Código de disposiçã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 disposição*.
6. Ao lado de *Transição de estado*, 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 **Apps 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
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=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
