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

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

Antes de adicionar um rastreador para um aplicativo no impact.com, você precisa já ter criado o aplicativo e disponibilizado para instalação em uma loja de aplicativos.

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 tela *Configurações do aplicativo móvel* , preencha os campos de cada uma das seções a seguir:

<details>

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

* **Nome:** Adicione um nome para o aplicativo.
* **Códigos:** Adicione códigos personalizados para usar como `EventTypeIds` quando o 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 aplicativos móveis para outras plataformas, poderá selecioná-los na caixa ao lado de *Outras versões*.
* **ID do pacote (iOS) / Nome do pacote (Android):** Insira o identificador exclusivo do aplicativo (por exemplo, `com.example.application`).
* **Impressões digitais SHA256 (Android):** Insira as impressões digitais SHA256 do certificado de assinatura do aplicativo (por exemplo, `14:6D:E9:83:C5:73:06:50...` etc.).
* **ID da equipe (iOS):** Insira a sequência de duas partes usada para identificar o aplicativo (por exemplo, `ABC123.com.example.application`).
* **ID do aplicativo (iOS):** Insira o identificador exclusivo do iTunes para o aplicativo (por exemplo, o identificador do iTunes para o aplicativo *iBooks* é `364709193`)
* **URL de download:** Insira o URL direto de download pelo qual o aplicativo pode ser baixado da App Store (iOS) ou da Play Store (Android).

</details>

<details>

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

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

* **Processar devoluções usando a tela Pagamentos pendentes:** Se quiser lidar com modificações de ações na [interface do impact.com](https://help.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 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 no seu próprio servidor FTP:** Use seu próprio servidor FTP e permita que a 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 a impact.com pode usar para acessar seu servidor FTP.
    * **Senha** — Insira a senha da conta FTP que a impact.com pode usar.
    * **Porta** — Insira a porta que deve ser usada ao se conectar ao seu servidor FTP.
    * **Diretório** — Insira o diretório onde a impact.com pode encontrar o arquivo (por exemplo, `/impact/returns`).
  * **Enviar arquivo por e-mail para o servidor SMTP do sistema:** A 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 das configurações avançadas</summary>

Para adicionar configurações avançadas, selecione **Mostrar configurações avançadas**.

* Para adicionar a 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) **\[Ativado] Especificar um período de duplicação de OID**, depois adicione o período de duplicação.
* Para 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) **\[Ativado] Adicionar custos do cliente**, depois selecione como deseja incluir os custos do cliente.
* Para adicionar o bloqueio por prazo indeterminado, 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) **\[Ativado] 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 prosseguir para a configuração dos eventos remuneráveis.
6. A tela *Eventos remuneráveis* é onde você pode configurar os eventos do aplicativo pelos quais deseja pagar.

<details>

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

* **Instalações do aplicativo:** As instalações são rastreadas e remuneradas por padrão. (Se você estiver usando um MMP de terceiros, deverá reportar as instalações do aplicativo como um evento no aplicativo, conforme descrito na opção abaixo.)
* **Eventos no aplicativo:** Configure os eventos no aplicativo pelos quais você fará pagamentos:
  * **Nome de exibição do evento** — Insira um nome descritivo para exibição do evento, que aparecerá nos Termos do seu modelo.
  * **Código do evento** — Insira o código do evento, que diferencia maiúsculas de minúsculas, que a impact.com receberá do seu MMP.
  * **Regra de atribuição** — Selecione *Instalação*, que atribuirá os créditos ao parceiro que gerou a instalação inicial do seu aplicativo, ou *Último clique*, que atribuirá os créditos ao parceiro que gerou o último clique de referência no seu aplicativo antes da conversão.

</details>

7. Selecione **Salvar**.

#### Gerenciar os rastreadores do seu aplicativo móvel

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ê quer 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] → Visualizar/Editar**.
4. Faça as alterações desejadas.
5. Selecione **Salvar**.

</details>

<details>

<summary>Adicionar mais eventos remunerá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 ao qual você quer 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 aplicativo*, 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]**.
   * Insira o **Nome de exibição do evento**. Esse é o nome que aparecerá nos contratos e nos termos dos modelos.
   * Insira o **Código do evento**. Esse é o código que seu aplicativo envia sempre que o evento rastreado ocorre.
   * Selecione a **Regra de atribuição** no menu suspenso. Você pode atribuir o crédito ao evento com base em uma instalação ou no ú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 **Aplicativos móveis**.
3. Ao lado do rastreador ao qual você quer 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 você quer usar.
   * Se quiser usar um código comum, selecione-o no menu suspenso.
   * Se 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 responsável pela ação veja.
7. Ao lado de *Alteração da ação*, selecione qual ação, se houver, será realizada quando esse 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ê quer excluir e 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 selecione **Entendi, 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.
