> 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/it/what-would-you-like-to-learn-about/platform-features/tracking/mobile-app-tracking/set-up-a-mobile-app.md).

# Configura un'app mobile

<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">Segui il corso PXA</a>

Se hai intenzione di monitorare gli eventi nelle tue app per dispositivi mobili, dovrai configurarle sulla piattaforma impact.com.

#### Crea un tracker per app per dispositivi mobili

Prima di aggiungere un tracker su impact.com, dovrai aver già creato l'app e averla resa disponibile per l'installazione in un app store

1. Nella barra di navigazione superiore, seleziona ![](https://1043985218-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) **\[Profilo utente] → Impostazioni**.
2. A destra, sotto *Monitoraggio*, seleziona **App per dispositivi mobili**.
3. Nell'angolo in alto a destra, seleziona **Aggiungi app per dispositivi mobili**.
4. Nella schermata *Impostazioni app per dispositivi mobili* , compila i campi di ciascuna delle seguenti sezioni:

<details>

<summary>Riferimento alle informazioni sull'app per dispositivi mobili</summary>

* **Nome:** Inserisci un nome per la tua app.
* **Codici:** Aggiungi codici personalizzati da usare come `EventTypeIds` quando la tua app invia i dati di conversione (ad es. 123, 456, 789).
* **Piattaforma:** Specifica la piattaforma dell'app.
* **Altre versioni:** Se hai creato tracker per app per dispositivi mobili per altre piattaforme, puoi selezionarli dalla casella accanto a *Altre versioni*.
* **ID bundle (iOS) / Nome pacchetto (Android):** Inserisci l'identificatore univoco della tua app (ad es. `com.example.application`).
* **Impronte digitali SHA256 (Android):** Inserisci le impronte digitali SHA256 del certificato di firma della tua app (ad es. `14:6D:E9:83:C5:73:06:50...` e così via).
* **ID team (iOS):** Inserisci la stringa in due parti usata per identificare la tua app (ad es. `ABC123.com.example.application`).
* **ID app (iOS):** Inserisci l'identificatore iTunes univoco della tua app (ad es., l'identificatore iTunes dell'app *iBooks* è `364709193`)
* **URL di download:** Inserisci l'URL diretto da cui è possibile scaricare l'app dall'App Store (iOS) o dal Play Store (Android).

</details>

<details>

<summary>Riferimento all'elaborazione dei resi</summary>

Seleziona come vuoi gestire gli storni e le modifiche delle azioni.

* **Elabora i resi usando la schermata Pagamenti in sospeso:** Se vuoi gestire le modifiche delle azioni nell'interfaccia [di impact.com](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/platform-features/actions-and-payouts/payouts/approve-reverse-and-modify-pending-payouts-for-actions.md), seleziona questa opzione.
* **Automatizza l'elaborazione dei resi (avanzato):** Se vuoi usare un'API, FTP o SMTP per automatizzare le modifiche delle azioni, seleziona questa opzione e scegli uno dei metodi automatizzati:
  * **Usa il servizio web di sistema (API):** Usa la nostra API per inviare i dati di conversione direttamente a impact.com. Ti serviranno le credenziali di accesso API del tuo account.
  * **Carica il file sul server FTP del sistema:** Usa il nostro server FTP per inviare i dati delle conversioni in un file CSV.
  * **Preleva il file dal tuo server FTP:** Usa il tuo server FTP e consenti a impact.com di prelevare i dati delle conversioni. Ci serviranno le seguenti informazioni:
    * **URL del server** — Seleziona il prefisso del protocollo corretto e inserisci l’URL del server.
    * **Nome utente** — Inserisci il nome utente che impact.com può usare per accedere al tuo server FTP.
    * **Password** — Inserisci la password dell’account FTP che impact.com può usare.
    * **Porta** — Inserisci la porta da usare per connettersi al tuo server FTP.
    * **Directory** — Inserisci la directory in cui impact.com può trovare il file (ad es., `/impact/returns`).
  * **Invia il file al server SMTP del sistema:** impact.com fornirà un indirizzo email univoco a cui potrai inviare i dati delle conversioni come allegato CSV.

</details>

<details>

<summary>Riferimento alle impostazioni avanzate</summary>

Per aggiungere impostazioni avanzate, seleziona **Mostra impostazioni avanzate**.

* Per aggiungere la duplicazione dell’ID ordine (OID), attiva ![](https://1043985218-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) **\[Attiva] Specifica un intervallo di duplicazione OID**, quindi aggiungi l’intervallo di duplicazione.
* Per aggiungere i costi del cliente, attiva ![](https://1043985218-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) **\[Attiva] Aggiungi i costi del cliente**, quindi seleziona come vuoi includere i costi del cliente.
* Per aggiungere il blocco a tempo indeterminato, attiva ![](https://1043985218-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) **\[Attiva] Blocca le azioni aggiornandone lo stato tramite servizi web o caricamenti di file batch**.

</details>

5. Seleziona **Salva e continua** per passare alla configurazione degli eventi remunerabili.
6. La schermata *Eventi remunerabili* consente di configurare gli eventi dell’app per i quali vuoi effettuare pagamenti.

<details>

<summary>Riferimento agli eventi remunerabili</summary>

* **Installazioni dell’app:** Le installazioni vengono monitorate e sono remunerabili per impostazione predefinita. (Se usi un MMP di terze parti, dovrai segnalare le installazioni dell’app come evento in-app, come descritto nell’opzione seguente.)
* **Eventi in-app:** Configura gli eventi in-app per i quali effettuerai i pagamenti:
  * **Nome visualizzato dell’evento** — Inserisci un nome descrittivo per l’evento, che verrà visualizzato nei termini del modello.
  * **Codice evento** — Inserisci il codice evento, rispettando maiuscole e minuscole, che impact.com riceverà dal tuo MMP.
  * **Regola di attribuzione** — Seleziona *Installazione*, che attribuisce il merito al partner che ha generato l’installazione iniziale della tua app, oppure *Ultimo clic*, che attribuisce il merito al partner che ha generato l’ultimo clic referral alla tua app prima della conversione.

</details>

7. Seleziona **Salva**.

#### Gestisci i tracker della tua app mobile

Esistono diversi modi per gestire i tracker delle app per dispositivi mobili esistenti:

<details>

<summary>Modificare un tracker di un'app per dispositivi mobili</summary>

1. Nella barra di navigazione superiore, seleziona ![](https://1043985218-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) **\[Profilo utente] → Impostazioni**.
2. A destra, sotto *Monitoraggio*, seleziona **App per dispositivi mobili**.
3. Accanto al tracker che vuoi modificare, seleziona ![](https://1043985218-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) **\[Altro] → Visualizza/Modifica**.
4. Apporta le modifiche desiderate.
5. Seleziona **Salva**.

</details>

<details>

<summary>Aggiungere altri eventi remunerabili a un tracker</summary>

1. Nella barra di navigazione superiore, seleziona ![](https://1043985218-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) **\[Profilo utente] → Impostazioni**.
2. A destra, sotto *Monitoraggio*, seleziona **App per dispositivi mobili**.
3. Accanto al tracker a cui vuoi aggiungere codici di esito, seleziona ![](https://1043985218-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) **\[Altro] → Gestisci eventi**.
4. Nell'angolo in alto a destra, seleziona **Aggiungi evento**.
5. Accanto a *Eventi nell'app*, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-6282f271b7521383385339243690b303086736d9%2F3b5a585dd2895bdf1c30d1236c72ba590dddd18717863b27074c8d313d05ae20.svg?alt=media) **\[Aggiungi un altro evento]**.
   * Inserisci **Nome visualizzato dell'evento**. Questo è il nome che apparirà nei contratti e nei termini dei modelli.
   * Inserisci **Codice evento**. È il codice che la tua app invia ogni volta che si verifica l'evento monitorato.
   * Seleziona **Regola di attribuzione** dal menu a discesa. Puoi attribuire l'evento a un'installazione o all'ultimo clic.
6. Seleziona **Salva**.

</details>

<details>

<summary>Aggiungere un codice di esito a un tracker per dispositivi mobili</summary>

1. Nella barra di navigazione superiore, seleziona ![](https://1043985218-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) **\[Profilo utente] → Impostazioni**.
2. A destra, sotto *Monitoraggio*, seleziona **App per dispositivi mobili**.
3. Accanto al tracker a cui vuoi aggiungere codici di esito, seleziona ![](https://1043985218-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) **\[Altro] → Codici di esito**.
4. Nell'angolo in alto a destra, seleziona **Aggiungi codice di esito**.
5. Accanto a *Codice di esito*, seleziona o inserisci il codice che vuoi usare.
   * Se vuoi usare un codice comune, selezionalo dal menu a discesa.
   * Se vuoi creare un codice personalizzato, inseriscine il nome accanto a *Nome dell'esito*.
6. Accanto a *Transizione di stato*, seleziona ciò che vuoi che veda il partner che esegue l'azione.
7. Accanto a *Modifica dell'azione*, seleziona quale azione, se prevista, deve verificarsi quando viene selezionato questo codice.
8. Seleziona **Salva**.

</details>

<details>

<summary>Eliminare un tracker per dispositivi mobili</summary>

1. Nella barra di navigazione superiore, seleziona ![](https://1043985218-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) **\[Profilo utente] → Impostazioni**.
2. A destra, sotto *Monitoraggio*, seleziona **App per dispositivi mobili**.
3. Individua il tracker per dispositivi mobili che vuoi eliminare e seleziona ![](https://1043985218-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) **\[Altro] →** **Elimina**.
4. Leggi il messaggio di avviso, quindi seleziona **Ho capito, continua**.

</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/it/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.
