> 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 del risultato desiderato Il diagramma di flusso seguente rappresenta il risultato che vuoi ottenere. In breve, desideri 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 fosse possibile perché l'app non è installata sul dispositivo dell'utente, vorrai indirizzarli alla versione web di quella pagina. Puoi anche configurare una pagina intermedia su impact.com, poiché ciò ti consentirà di assicurarti che l'utente venga reindirizzato solo verso pagine di destinazione riconosciute dalla tua app.
#### 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 associati allo schema URI della tua app mobile affinché il reindirizzamento funzioni; ad es., 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 (cioè percorsi che non sono mappati) all'interno della tua app mobile, in modo da poter implementare i filtri corrispondenti alla pagina intermedia all'interno delle condizioni della regola, come descritto 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 dagli altri parametri di tracciamento del gateway pertinenti. 2. Chiama l'API PageLoad, passando l'URI al campo PageUrl sugli eventi di apertura dell'app. * Vedi il [Crea un Page Load](https://integrations.impact.com/brand-api-reference/reference/page-load/page-load) documentazione API per maggiori dettagli.

Esempio: acmeapp://item/view/12345?clickid=abcdef12345.

{% endstep %} {% step %} **Passaggio 2: configura lo schema URI del tuo programma** 1. Dalla 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 *Tracciamento*, 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à come predefinito il primo schema. 5. Seleziona **Salva**. {% endstep %} {% step %} **Passaggio 3: crea la regola di reindirizzamento** 1. Dalla 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. **Nome** la regola in modo descrittivo. * Il nome dovrebbe indicare lo scopo della regola. 5. Aggiungi un *Condizione* con il **Nome app** parametro e inserisci le piattaforme dell'app mobile a cui la regola si applica. * 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 altro]** condizione con il **Landing page** parametro e specifica i percorsi e i domini per cui desideri reindirizzare gli utenti. * Questo passaggio è consigliato e ti consentirà di usare la funzionalità solo per i percorsi che la tua app può riconoscere. * Usa [regex](https://en.wikipedia.org/wiki/Regular_expression) per corrispondere alle landing page che contengono percorsi specifici — vedi 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 altro]** condizione con il **Probabilità** parametro e specifica una percentuale del traffico da reindirizzare per i test A/B.
{% endstep %} {% step %} **Passaggio 4: personalizza la pagina intermedia per il Mobile Deep Linking** 1. Nel *Azione* campo, 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 pagina intermedia in modo che sia coerente con il tuo brand: | Campi | Descrizione | | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Testo dell'intestazione e colore del font | Il testo dell'intestazione è una breve frase visualizzata nel tuo interstitial in caratteri grandi. Puoi specificare il contenuto di questo testo e definire il colore del font utilizzando il selettore colore o [esadecimale](https://en.wikipedia.org/wiki/Hexadecimal) notazione. | | Testo del sottotitolo e colore del font | Il testo del sottotitolo è una breve frase visualizzata nel tuo interstitial sotto il testo dell'intestazione. Puoi specificare il contenuto di questo testo e definire il colore del font utilizzando 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 contenuto di questo testo e definire il colore del font utilizzando il selettore colore o [esadecimale](https://en.wikipedia.org/wiki/Hexadecimal) notazione. | | Etichetta e colore del font del link Continua | L'etichetta del link è il testo visualizzato sul link che apre l'URL della tua pagina web di destinazione. Puoi specificare il contenuto di questo testo e definire il colore del font utilizzando il selettore colore o [esadecimale](https://en.wikipedia.org/wiki/Hexadecimal) notazione. |
{% endstep %} {% step %} **Passaggio 5: configura la logica di apertura dell'app e il reindirizzamento automatico** 1. Nel *Azione* campo, scorri fino alla fine delle opzioni di personalizzazione visiva e compila i seguenti campi. | Campo | Descrizione | | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Apertura app |

Indica quando aprire la tua app mobile:

• Appena viene caricata la pagina intermedia \[Consigliato] — apri automaticamente la tua app mobile sul dispositivo dell'utente non appena viene caricata la pagina intermedia.

• Quando viene toccato il pulsante — dopo il caricamento della pagina intermedia, richiedi all'utente di approvare l'apertura della tua app mobile sul suo dispositivo.

| | Reindirizzamento automatico | Seleziona il ![](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 deselezionata]** per definire un timeout nel caso in cui l'apertura dell'app non riesca, dopo il quale verranno reindirizzati automaticamente al link web. impact.com consiglia un **10**timeout di -secondi. | | Percorso URI predefinito | Inserisci un percorso URI, ad esempio quello della home page del tuo sito web, da usare 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 |

Per impostazione predefinita, impact.com crea un link dello schema URI aggiungendo i percorsi dell'URL della landing page di destinazione allo schema URI. Ad es., se l'URL della tua pagina di destinazione è , e il tuo schema URI è acmeapp, il relativo schema URI risultante sarà acmeapp\://product/12345.

Tuttavia, puoi anche usare regex 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 è , e inserisci una regex di acme.com.\*$, il relativo schema URI risultante sarà acmeapp\://acme.com/product/12345.

| 2. Ricordati di **Salva** salvare la tua regola quando hai finito. {% endstep %} {% endstepper %} #### Uso degli interstitial con i postback Se usi [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'interstitial 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 di aprire la tua app mobile. Questo approccio garantisce che l'attribuzione funzioni correttamente quando la conversione viene registrata in uno dei programmi figli. --- # 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/it/what-would-you-like-to-learn-about/platform-features/tracking/mobile-app-tracking/configure-deep-linking-logic-with-uri-schemes.md?ask=&goal= ``` `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.