> 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 app 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ê estiver planejando rastrear eventos em seus apps móveis, será necessário configurá-los na plataforma impact.com.

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

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

1. Na barra de navegação superior, selecione ![](/files/45f862e198f73982700ff092afe256a7fe2e0fff) **\[Perfil do usuário] → Configurações**.
2. À direita, em *Rastreamento*, selecione **Aplicativos mobile**.
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 o seu app.
* **Códigos:** Adicione códigos personalizados para atuarem como `EventTypeIds` quando seu app enviar dados de conversão. (ex.: 123, 456, 789).
* **Plataforma:** Especifique a plataforma do app.
* **Outras versões:** Se você criou rastreadores de app móvel para outras plataformas, você pode selecioná-los na caixa ao lado de *Outras versões*.
* **Bundle ID (iOS) / Nome do pacote (Android):** Insira o identificador exclusivo do seu app (ex.: `com.example.application`).
* **Impressões digitais SHA256 (Android):** Insira as impressões digitais do certificado de assinatura do seu app (ex.: `14:6D:E9:83:C5:73:06:50...` etc.).
* **ID da equipe (iOS):** Insira a string de duas partes usada para identificar seu app (ex.: `ABC123.com.example.application`).
* **ID do app (iOS):** Insira o identificador exclusivo do iTunes do seu app (ex.: 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 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 para o impact.com. Você precisará das credenciais de acesso à API da sua conta.
  * **Carregar arquivo no 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. Precisaremos 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-se ao seu servidor FTP.
    * **Diretório** — Insira o diretório onde o impact.com pode encontrar o arquivo (ex.: `/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ê pode 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 ![](/files/56148a29d7f42673dde9884eb52356c45eca06c3) **\[Ative] Especifique uma janela de duplicação de OID**, depois adicione a janela de duplicação.
* Se você quiser adicionar custos do cliente, ative ![](/files/56148a29d7f42673dde9884eb52356c45eca06c3) **\[Ative] Adicionar custos do cliente**, depois selecione como você quer incorporar os custos do cliente.
* Se você quiser adicionar bloqueio sem prazo, ative ![](/files/56148a29d7f42673dde9884eb52356c45eca06c3) **\[Ative] 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 seguir para a configuração de eventos pagos.
6. O *Eventos pagos* a tela é onde você pode configurar os eventos do app pelos quais deseja pagar.

<details>

<summary>Referência de eventos pagos</summary>

* **Instalações do app:** As instalações são rastreadas e pagas 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 de exibição descritivo para o evento, que aparecerá em seus Termos do Modelo.
  * **Código do evento** — Insira o código do evento, sensível a maiúsculas e minúsculas, que o impact.com receberá do seu MMP.
  * **Regra de crédito** — Selecione *Instalação*, 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 ![](/files/45f862e198f73982700ff092afe256a7fe2e0fff) **\[Perfil do usuário] → Configurações**.
2. À direita, em *Rastreamento*, selecione **Aplicativos mobile**.
3. Ao lado do rastreador que você quer editar, selecione ![](/files/19661962d7c41673a711ca84d7efe61f00165e41) **\[Mais] → Ver/Editar**.
4. Faça as alterações que deseja fazer.
5. Selecione **Salvar**.

</details>

<details>

<summary>Adicionar mais eventos pagos a um rastreador</summary>

1. Na barra de navegação superior, selecione ![](/files/45f862e198f73982700ff092afe256a7fe2e0fff) **\[Perfil do usuário] → Configurações**.
2. À direita, em *Rastreamento*, selecione **Aplicativos mobile**.
3. Ao lado do rastreador para o qual você quer adicionar códigos de disposição, selecione ![](/files/19661962d7c41673a711ca84d7efe61f00165e41) **\[Mais] → Gerenciar Eventos**.
4. No canto superior direito, selecione **Adicionar Evento**.
5. Ao lado de *Eventos no App*, selecione ![](/files/f04b408fd368673af7defa3c8a7a0cac711f0eb8) **\[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 ![](/files/45f862e198f73982700ff092afe256a7fe2e0fff) **\[Perfil do usuário] → Configurações**.
2. À direita, em *Rastreamento*, selecione **Aplicativos mobile**.
3. Ao lado do rastreador para o qual você quer adicionar códigos de disposição, selecione ![](/files/19661962d7c41673a711ca84d7efe61f00165e41) **\[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 você 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 gera a ação veja.
7. Ao lado de *Mudança de 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 ![](/files/45f862e198f73982700ff092afe256a7fe2e0fff) **\[Perfil do usuário] → Configurações**.
2. À direita, em *Rastreamento*, selecione **Aplicativos mobile**.
3. Encontre o rastreador móvel que você deseja excluir, selecione ![](/files/19661962d7c41673a711ca84d7efe61f00165e41) **\[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.
