> 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 personalizzati integrati 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 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 personalizzati integrati nell'app. #### Diagramma di flusso del risultato desiderato Il diagramma di flusso seguente 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 dell'app mobile pertinente ogni volta che è possibile. Se 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 alle 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 degli URL web devono essere mappati 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 loro URI sarà `acmeapp://item/view/12345`. * Devi conoscere eventuali percorsi non supportati (ovvero, percorsi che non sono mappati) all'interno della tua app mobile, in modo da poter implementare i filtri corrispondenti per la pagina interstiziale nelle condizioni della regola, come descritto di seguito. #### Configura il tracciamento dello schema URI {% stepper %} {% step %} **Passaggio 1: configura il tracciamento dello schema URI sulla 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 rilevanti. 2. Chiama l'API PageLoad, passando l'URI al campo PageUrl negli eventi di apertura dell'app. * Vedi il [Crea un Page Load](https://integrations.impact.com/brand-api-reference/reference/page-load/page-load) consulta la documentazione API per ulteriori dettagli.

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

{% 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 *Tracciamento*, seleziona **Generale**. 3. Nel campo URI Scheme, 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**, escludendo `://` dalla fine dello schema. * Se sono elencati più schemi URI, impact.com userà per impostazione predefinita il primo schema. 5. Seleziona **Salva**. {% endstep %} {% step %} **Passaggio 3: crea la 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 la regola**. 4. **Nome** la regola in modo descrittivo. * Il nome dovrebbe indicare lo scopo della regola. 5. Aggiungi un *Condizione* con il **Nome dell'app** parametro, e inserisci le piattaforme dell'app mobile per le quali la regola è applicabile. * 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 **Pagina di destinazione** parametro, e specifica i percorsi e i domini per i quali vuoi 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 il test A/B.
{% endstep %} {% step %} **Passaggio 4: personalizza l'interstitial 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 interstiziale in modo che sia coerente con il tuo brand: | Campi | Descrizione | | -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Testo dell'intestazione e colore del carattere | Il testo dell'intestazione è una breve frase visualizzata nell'interstitial in caratteri grandi. Puoi specificare il contenuto di questo testo e definire il colore del carattere usando il selettore di colori oppure [esadecimale](https://en.wikipedia.org/wiki/Hexadecimal) notazione. | | Testo del sottotitolo e colore del carattere | Il testo del sottotitolo è una breve frase visualizzata nell'interstitial sotto il testo dell'intestazione. Puoi specificare il contenuto di questo testo e definire il colore del carattere usando il selettore di colori oppure [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. | | Carica immagine di copertina | Carica un'immagine di sfondo appropriata 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 contenuto di questo testo e definire il colore del carattere usando il selettore di colori oppure [esadecimale](https://en.wikipedia.org/wiki/Hexadecimal) notazione. | | Etichetta e colore del carattere 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 carattere usando il selettore di colori oppure [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:

• Non appena l'interstitial viene caricato \[Consigliato] — apri automaticamente la tua app mobile sul dispositivo dell'utente non appena l'interstitial viene caricato.

• Quando viene toccato il pulsante — dopo il caricamento dell'interstitial, 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 non selezionata]** per definire un timeout nel caso in cui l'apertura dell'app fallisca, dopo il quale verranno reindirizzati automaticamente al link web. impact.com consiglia un timeout di **10**- secondi di timeout. | | Percorso URI predefinito | Inserisci un percorso URI, ad esempio quello della home page del tuo sito web, da usare quando non viene estratto dall'URL. In questo modo la tua app si apre correttamente anche da un browser personalizzato integrato nell'app 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 risultante dello schema URI sarà `acmeapp://home`. | | Regex URI personalizzata |

Per impostazione predefinita, impact.com crea un link con 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, lo schema URI risultante sarà acmeapp\://product/12345.

Tuttavia, puoi anche usare regex per specificare quali parti di un URL della 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.\*$, lo schema URI risultante sarà acmeapp\://acme.com/product/12345.

| 2. Ricordati di **Salva** salvare la regola al termine. {% 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, assicurando 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 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 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=&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.