> 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 l'uso di [schemi URI](https://en.wikipedia.org/wiki/List_of_URI_schemes) per garantire un tracciamento coerente quando il deep linking standard non funziona. Segui i passaggi di questo articolo per migliorare l'accuratezza del tracciamento delle conversioni quando gli utenti interagiscono con la tua landing page di vendita tramite questi browser in-app personalizzati.

#### Diagramma di flusso dell'esito desiderato

Il diagramma di flusso qui sotto rappresenta il risultato che desideri ottenere. In breve, vuoi configurare una regola di reindirizzamento su impact.com per indirizzare gli utenti che fanno clic sul tuo link di tracciamento alla pagina pertinente dell'app mobile ogni volta che possibile. Se ciò non è possibile perché l'app non è installata sul dispositivo dell'utente, vorrai indirizzarli alla versione web di quella pagina. Puoi anche configurare una landing page interstiziale su impact.com, poiché ciò ti consentirà di assicurarti che l'utente venga reindirizzato solo a pagine di destinazione riconosciute dalla tua app.

<div data-with-frame="true"><figure><img src="/files/084a04a31e9c9d6c16a53e2506821199ba44b1ad" alt="" width="296"><figcaption></figcaption></figure></div>

#### Prerequisiti

* Lo schema URI della tua app mobile, ad es. **`acmeapp://`**`item/view/12345`, deve essere lo stesso nelle versioni Android e iOS della tua app.
* I percorsi dei tuoi URL web devono essere mappati allo schema URI della tua app mobile affinché il reindirizzamento funzioni, ad esempio, se l'URL di ACME Corporation è `https://acme.com/item/view/12345`, il relativo URI sarà `acmeapp://item/view/12345`.
* Devi conoscere eventuali percorsi non supportati (ossia percorsi che non sono mappati) all'interno della tua app mobile, in modo da poter implementare i filtri corrispondenti nella pagina interstiziale all'interno delle condizioni della regola, come dettagliato di seguito.

#### Configura il tracciamento dello schema URI

{% stepper %}
{% step %}
**Passaggio 1: configura il tracciamento dello schema URI nella tua app**

Configura la tua app mobile per tracciare quando il referrer è uno schema URI.

1. Analizza il `clickid` dallo schema URI e da altri parametri di tracciamento del gateway pertinenti.
2. Chiama l'API PageLoad, passando l'URI al campo PageUrl sugli eventi di apertura dell'app.

   * Consulta la [Crea un Page Load](https://integrations.impact.com/impact-brand/reference/create-a-pageload) riferimento API per maggiori dettagli.

   <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. Dalla barra di navigazione in alto, seleziona ![](/files/a0314b1a64ec39500a614699810af2308cfe8328) **\[Profilo utente] → Impostazioni**.
2. Nella colonna di destra, sotto *Tracking*, seleziona **Generale**.
3. Nel campo URI Scheme, seleziona ![](/files/4334bf9e77c50dcf2ea2f1bfb42aaffe7d2ea72b) **\[Modifica]**.
4. Inserisci lo **schema URI**, escludendo `://` dalla fine dello schema.
   * Se sono elencati più schemi URI, impact.com utilizzerà per impostazione predefinita il primo schema.
5. Seleziona **Salva**.
   {% endstep %}

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

1. Dalla barra di navigazione in alto, seleziona ![](/files/a0314b1a64ec39500a614699810af2308cfe8328) **\[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. **Nome** la regola in modo descrittivo.
   * Il nome dovrebbe indicare lo scopo della regola.
5. Aggiungi una *Condizione* con il parametro **Nome app** e inserisci le piattaforme dell'app mobile per le quali la regola è applicabile.
   * impact.com consiglia di includere *Facebook*, *Instagram*, e *X*.
6. Facoltativamente, ![](/files/0aafef99ec4e77d9b7b3e0531467b63590add75d) **\[Aggiungi un'altra]** condizione con il **Pagina di destinazione** parametro e specifica i percorsi e i domini per i quali desideri reindirizzare gli utenti.

   * Questo passaggio è consigliato e ti consentirà di usare la funzione solo per i percorsi che la tua app è in grado di riconoscere.
   * Usa [regex](https://en.wikipedia.org/wiki/Regular_expression) per abbinare le landing page che contengono percorsi specifici — vedi l'esempio sotto.

   ```programlisting
   ^(https?:\/\/)?(www\.)?(domain\.com|sub\.domain\.com)(\/(shop|product)(\/[^?]*?)?)?(\/?(\?.*)?)?$
   ```
7. Facoltativamente, ![](/files/0aafef99ec4e77d9b7b3e0531467b63590add75d) **\[Aggiungi un'altra]** condizione con il **Probabilità** parametro e specifica una percentuale del traffico da reindirizzare per il test A/B.

   <div data-with-frame="true"><figure><img src="/files/1532fa3a9f45685a4e47a86c2c97cc82964a8608" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}
**Passaggio 4: personalizza l'interstiziale per il Mobile Deep Linking**

1. Nella *Azione* campo, usa il ![](/files/a474859b52eb0cf0ee293759ee5542cfc1ffd5f8) **\[Menu a discesa]** per selezionare **Mobile Deep Linking**.
2. Personalizza il modello interstiziale in linea con il tuo brand:

| Campi                                         | Descrizione                                                                                                                                                                                                                                                                      |
| --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Testo intestazione e colore del font          | Il testo dell'intestazione è una breve frase visualizzata nel tuo interstiziale con caratteri grandi. Puoi specificare il testo e definire il colore del font usando il selettore colore o [esadecimale](https://en.wikipedia.org/wiki/Hexadecimal) notazione.                   |
| Testo sottointestazione e colore del font     | Il testo della sottointestazione è una breve frase visualizzata nel tuo interstiziale sotto il testo dell'intestazione. Puoi specificare il testo e definire il colore del font usando il selettore colore o [esadecimale](https://en.wikipedia.org/wiki/Hexadecimal) notazione. |
| Carica logo                                   | Carica il logo del tuo brand in formato .gif, .jpg, .png o .svg. L'immagine non può superare 1 MB di dimensione.                                                                                                                                                                 |
| Carica immagine di copertina                  | Carica un'immagine di sfondo adatta in formato .gif, .jpg, .png o .svg. L'immagine non può superare 1 MB di dimensione.                                                                                                                                                          |
| 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 font usando il selettore colore o [esadecimale](https://en.wikipedia.org/wiki/Hexadecimal) notazione.              |
| Etichetta del link Continua e colore del font | L'etichetta del link è il testo visualizzato sul link che apre l'URL della tua pagina web di destinazione. Puoi specificare il testo e definire il colore del font usando il selettore colore o [esadecimale](https://en.wikipedia.org/wiki/Hexadecimal) notazione.              |

<div data-with-frame="true"><figure><img src="/files/6b3d02fa5251f5cfd06827fc27b138fe6c814bc1" alt="" width="373"><figcaption></figcaption></figure></div>
{% endstep %}

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

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

   | Campo                       | Descrizione                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
   | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | Apertura app                | <p>Indica quando aprire la tua app mobile:</p><p>• <strong>Non appena l'interstiziale viene caricato</strong> <mark style="color:$success;">\[Consigliato]</mark> — apri automaticamente la tua app mobile sul dispositivo dell'utente non appena l'interstiziale viene caricato.</p><p>• <strong>Quando si tocca il pulsante</strong> — dopo il caricamento dell'interstiziale, richiedi all'utente di approvare l'apertura della tua app mobile sul proprio dispositivo.</p>                                                                                                                                                                                                                                                                                                                                                                |
   | Reindirizzamento automatico | Seleziona il ![](/files/cec8fb6b06bdba97a0f302d45d30862de79a5365) **\[Casella non selezionata]** per definire un timeout nel caso in cui l'apertura dell'app non riesca, dopo il quale verrà reindirizzato automaticamente al link web. impact.com consiglia un timeout di **10**secondi.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
   | Percorso URI predefinito    | Inserisci un percorso URI, ad esempio per la home page del tuo sito web, da utilizzare quando non ne viene estratto uno dall'URL. In questo modo la tua app si apre correttamente anche da un browser in-app personalizzato che altrimenti non riuscirebbe ad aprire la tua app. Ad es., se l'URL della tua pagina di destinazione è `https://acme.com`, e inserisci un percorso URI predefinito di `home`, il link dello schema URI risultante sarà `acmeapp://home`.                                                                                                                                                                                                                                                                                                                                                                        |
   | Regex URI personalizzata    | <p>Per impostazione predefinita, impact.com crea un link di schema URI aggiungendo i percorsi dell'URL della pagina di destinazione allo schema URI. Ad es., se l'URL della tua pagina di destinazione è <code><https://acme.com/product/12345></code>, e il tuo schema URI è <code>acmeapp</code>, lo schema URI risultante sarà <code>acmeapp\://product/12345</code>.</p><p>Tuttavia, puoi anche usare <a href="https://en.wikipedia.org/wiki/Regular_expression">regex</a> per specificare quali parti dell'URL di una pagina di destinazione devono essere estratte e aggiunte allo schema URI. Ad es., se l'URL della tua pagina di destinazione è <code><https://acme.com/product/12345></code>, e inserisci una regex di <code>acme.com.\*$</code>, lo schema URI risultante sarà <code>acmeapp\://acme.com/product/12345</code>.</p> |
2. Ricordati di **Salva** la tua regola quando hai finito.
   {% endstep %}
   {% endstepper %}

#### Utilizzo degli interstiziali con i postback

Se utilizzi [postback](/brand/it/what-would-you-like-to-learn-about/account-administration/account-settings/notifications/enable-event-notification-postbacks-for-brands.md) per tracciare le conversioni tra vari tipi di programmi impact.com, impact.com consiglia di implementare l'interstiziale solo sul tuo programma principale. Il programma principale gestisce l'ultimo reindirizzamento prima della pagina di destinazione, garantendo che tutti i clic vengano tracciati prima dell'apertura della tua app mobile. Questo approccio garantisce che l'attribuzione funzioni correttamente quando la conversione viene registrata in uno dei programmi figlio.


---

# 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:

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

The question should be specific, self-contained, and written in natural language.
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.
