> 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/configure-deep-linking-logic-with-uri-schemes.md).

# Configura la logica di deep linking con schemi URI

Alcune app mobili con browser in-app personalizzati non supportano tutte le tecnologie di deep linking, rendendo necessario usare [schemi URI](https://en.wikipedia.org/wiki/List_of_URI_schemes) per garantire un monitoraggio coerente quando il deep linking standard non funziona. Segui i passaggi di questo articolo per migliorare la precisione del monitoraggio delle conversioni quando gli utenti interagiscono con la tua landing page di vendita tramite questi browser in-app personalizzati.

#### Diagramma di flusso del risultato desiderato

Il diagramma di flusso qui sotto rappresenta il risultato a cui punti. In breve, vuoi configurare una regola di reindirizzamento su impact.com per indirizzare, quando possibile, gli utenti che fanno clic sul tuo link di monitoraggio alla pagina pertinente dell'app mobile. Se non è possibile perché l'app non è installata sul dispositivo dell'utente, dovrai indirizzarlo alla versione web di quella pagina. Puoi anche configurare una landing page interstiziale su impact.com, così da assicurarti che l'utente venga reindirizzato solo a pagine di destinazione riconosciute dalla tua app.

<div data-with-frame="true"><figure><img src="https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-fed65268965e8e1db8473062d52095b14b220e3d%2F260dbc4571ab3a646158dccf6f817e64888da69f1fe481f7a4d9c2f90fe73003.png?alt=media" alt="" width="296"><figcaption></figcaption></figure></div>

#### Prerequisiti

* Lo schema URI della tua app mobile, ad esempio **`acmeapp://`**`item/view/12345`, deve essere identico nelle versioni Android e iOS della tua app.
* Affinché il reindirizzamento funzioni, i percorsi URL del tuo sito web devono essere mappati allo schema URI della tua app mobile. Ad esempio, se l'URL di ACME Corporation è `https://acme.com/item/view/12345`, il relativo URI sarà `acmeapp://item/view/12345`.
* Devi conoscere i percorsi non supportati dalla tua app mobile (ovvero i percorsi non mappati) per poter applicare i filtri corrispondenti alla pagina interstiziale nelle condizioni della regola, come descritto di seguito.

#### Configurare il monitoraggio degli schemi URI

{% stepper %}
{% step %}
**Passaggio 1: configura il monitoraggio degli schemi URI nella tua app**

Configura la tua app mobile in modo che rilevi quando il referrer è uno schema URI.

1. Analizza il parametro `clickid` dello schema URI e gli altri parametri di monitoraggio del gateway pertinenti.
2. Chiama l'API PageLoad, passando l'URI al campo PageUrl negli eventi di apertura dell'app.

   * Per ulteriori dettagli, consulta il riferimento API [Crea un caricamento di pagina](https://integrations.impact.com/brand-api-reference/reference/page-load/page-load) .

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Esempio:</strong> <code>acmeapp://item/view/12345?clickid=abcdef12345</code>.</p></div>

{% endstep %}

{% step %}
**Passaggio 2: configura lo schema URI del tuo programma**

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. Nella colonna di destra, sotto *Monitoraggio*, seleziona **Generale**.
3. Nel campo Schema URI, seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-a600f51d86cbf3c02c36ea5cf311867b2bb4cf89%2F00a06da7505c774dc36762a66bcd169b1d62cb35af729e3383729755194758fb.svg?alt=media) **\[Modifica]**.
4. Inserisci lo **schema URI**della tua app mobile, escludendo `://` dalla fine dello schema.
   * Se sono elencati più schemi URI, impact.com userà per impostazione predefinita il primo.
5. Seleziona **Salva**.
   {% endstep %}

{% step %}
**Passaggio 3: crea una regola di reindirizzamento**

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. Nella colonna di destra, sotto *Tecnico*, seleziona **Blocco e reindirizzamento**.
3. Nell'angolo in alto a destra, seleziona **Configura regola**.
4. **Assegna un nome** descrittivo alla regola.
   * Il nome dovrebbe indicare lo scopo della regola.
5. Aggiungi una *Condizione* con il parametro **Nome app**  e inserisci le piattaforme dell'app mobile a cui si applica la regola.
   * impact.com consiglia di includere *Facebook*, *Instagram* e *X*.
6. Facoltativamente, ![](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'altra]**  condizione con il parametro **Pagina di destinazione**  e specifica i percorsi e i domini a cui vuoi reindirizzare gli utenti.

   * Questo passaggio è consigliato e ti consentirà di utilizzare questa funzionalità solo per i percorsi che la tua app è in grado di riconoscere.
   * Usa [regex](https://en.wikipedia.org/wiki/Regular_expression) per trovare corrispondenze con le pagine di destinazione che contengono percorsi specifici. Consulta l'esempio qui sotto.

   ```programlisting
   ^(https?:\/\/)?(www\.)?(domain\.com|sub\.domain\.com)(\/(shop|product)(\/[^?]*?)?)?(\/?(\?.*)?)?$
   ```
7. Facoltativamente, ![](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'altra]**  condizione con il parametro **Probabilità**  e specifica la percentuale di traffico da reindirizzare per i test A/B.

   <div data-with-frame="true"><figure><img src="https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FxXIQNl4H15BdQNWJdkKC%2FScreenshot%202026-05-25%20at%2011.01.54.png?alt=media&amp;token=9823e26d-1b50-4022-a1c5-24831e9b0abc" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}
**Passaggio 4: personalizza la schermata interstitial per il Mobile Deep Linking**

1. Nel campo *Azione*  usa il ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[Menu a discesa]** per selezionare **Mobile Deep Linking**.
2. Personalizza il modello della schermata interstitial in modo che rispecchi il tuo brand:

| Campi                                              | Descrizione                                                                                                                                                                                                                                                                   |
| -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Testo dell'intestazione e colore del carattere     | Il testo dell'intestazione è una breve frase visualizzata in caratteri grandi nella schermata interstitial. Puoi specificare il testo e definire il colore del carattere usando il selettore colori o la [notazione esadecimale](https://en.wikipedia.org/wiki/Hexadecimal) . |
| Testo del sottotitolo e colore del carattere       | Il testo del sottotitolo è una breve frase visualizzata nella schermata interstitial sotto l'intestazione. Puoi specificare il testo e definire il colore del carattere usando il selettore colori o la [notazione esadecimale](https://en.wikipedia.org/wiki/Hexadecimal) .  |
| Carica logo                                        | Carica il logo del tuo brand in formato .gif, .jpg, .png o .svg. L'immagine non può superare 1 MB.                                                                                                                                                                            |
| Carica immagine di copertina                       | Carica un'immagine di sfondo adatta in formato .gif, .jpg, .png o .svg. L'immagine non può superare 1 MB.                                                                                                                                                                     |
| Etichetta e colori del pulsante Apri app           | L'etichetta del pulsante è il testo visualizzato sul pulsante che apre lo schema URI della tua app mobile. Puoi specificare il testo e definire il colore del carattere usando il selettore colori o la [notazione esadecimale](https://en.wikipedia.org/wiki/Hexadecimal) .  |
| Etichetta e colore del carattere del link Continua | L'etichetta del link è il testo visualizzato sul link che apre l'URL della pagina web di destinazione. Puoi specificare il testo e definire il colore del carattere usando il selettore colori o la [notazione esadecimale](https://en.wikipedia.org/wiki/Hexadecimal) .      |

<div data-with-frame="true"><figure><img src="https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-05ea3ea50f8f93b549691e27fe0bc882cd02a9c9%2Fbdbeb71e1227b728b8a97a7b0fa9083cd676a5ab73dd505b312ee1a60c80f751.png?alt=media" alt="" width="373"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Passaggio 5: configura la logica di apertura dell'app e il reindirizzamento automatico**

1. Nel campo *Azione* , scorri fino alla fine delle opzioni di personalizzazione visiva e compila i seguenti campi.

   | Campo                       | Descrizione                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
   | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | Apertura dell'app           | <p>Indica quando aprire la tua app mobile:</p><p>• <strong>Non appena viene caricato l'interstitial</strong> <mark style="color:$success;">\[Consigliato]</mark> — apre automaticamente l'app mobile sul dispositivo dell'utente non appena viene caricato l'interstitial.</p><p>• <strong>Quando si tocca il pulsante</strong> — dopo il caricamento dell'interstitial, richiede all'utente di autorizzare l'apertura dell'app mobile sul proprio dispositivo.</p>                                                                                                                                                                                                                                                                                                                                                                                         |
   | Reindirizzamento automatico | Seleziona la ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b5e1740618ed6571d97b8fed7c25a7678f85d375%2F299632fb6f4f91fbf9847471754cc6180e4284a65b4960af4c4ea472a159f552.svg?alt=media) **\[Casella non selezionata]** per definire un timeout nel caso in cui l'apertura dell'app non riesca, trascorso il quale l'utente verrà reindirizzato automaticamente al link web. impact.com consiglia un timeout di **10** secondi.                                                                                                                                                                                                                                                                                                                                         |
   | Percorso URI predefinito    | Inserisci un percorso URI, ad esempio quello della pagina iniziale del tuo sito web, da usare quando non è possibile estrarne uno dall'URL. In questo modo l'app si apre correttamente anche da un browser integrato personalizzato che altrimenti non riuscirebbe ad aprirla. Ad esempio, se l'URL della pagina di destinazione è `https://acme.com`, e inserisci come percorso URI predefinito `home`, lo schema URI risultante sarà `acmeapp://home`.                                                                                                                                                                                                                                                                                                                                                                                                    |
   | Regex URI personalizzata    | <p>Per impostazione predefinita, impact.com crea un link con schema URI aggiungendo allo schema URI i percorsi dell'URL della pagina di destinazione. Ad esempio, se l'URL della pagina di destinazione è <code><https://acme.com/product/12345></code>, e lo schema URI è <code>acmeapp</code>, lo schema URI risultante sarà <code>acmeapp\://product/12345</code>.</p><p>Tuttavia, puoi anche usare una <a href="https://en.wikipedia.org/wiki/Regular_expression">espressione regolare</a> per specificare quali parti dell'URL di una pagina di destinazione estrarre e aggiungere allo schema URI. Ad esempio, se l'URL della pagina di destinazione è <code><https://acme.com/product/12345></code>, e inserisci l'espressione regolare <code>acme.com.\*$</code>, lo schema URI risultante sarà <code>acmeapp\://acme.com/product/12345</code>.</p> |
2. Ricordati di **salvare** la regola al termine.
   {% endstep %}
   {% endstepper %}

#### Usare gli interstitial con i postback

Se usi i [postback](https://help.impact.com/brand/it/what-would-you-like-to-learn-about/account-administration/account-settings/notifications/enable-event-notification-postbacks-for-brands.md) per monitorare le conversioni nei vari tipi di programmi impact.com, impact.com consiglia di implementare l'interstitial solo nel programma principale. Il programma principale gestisce l'ultimo reindirizzamento prima della pagina di destinazione, assicurando che tutti i clic vengano tracciati prima di aprire l'app mobile. Questo approccio garantisce un'attribuzione accurata quando la conversione viene inviata a uno dei programmi secondari.


---

# 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/configure-deep-linking-logic-with-uri-schemes.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.
