> 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/advocate-program/getting-started-with-advocate/import-referral-program-data-from-saasquatch.md).

# Importa i dati del programma di referral da SaaSquatch

Questo articolo contiene riferimenti utili per aiutarti a importare i dati della tua piattaforma di referral da SaaSquatch a impact.com.

#### Riferimento colonne del file CSV

<details>

<summary>File dati utenti</summary>

<table><thead><tr><th width="185.05078125">Colonna</th><th width="131.55078125">Obbligatorio</th><th>Descrizione</th></tr></thead><tbody><tr><td>ID utente</td><td><img src="/files/15430cee723b81ff760cbb1ae4083c1f9a391be4" alt="" data-size="original"></td><td>L'identificativo del partecipante.</td></tr><tr><td>ID account</td><td><img src="/files/15430cee723b81ff760cbb1ae4083c1f9a391be4" alt="" data-size="original"></td><td>L'identificativo dell'account del partecipante.</td></tr><tr><td>Email</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>L'indirizzo email del partecipante.</td></tr><tr><td>Nome</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Il nome del partecipante.</td></tr><tr><td>Cognome</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Il cognome del partecipante.</td></tr><tr><td>Codice referral</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Il codice referral del programma principale del partecipante (se specificato).</td></tr><tr><td>URL dell'immagine</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>L'URL dell'immagine del partecipante.</td></tr><tr><td>IP visto per la prima volta</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>L'indirizzo IP del partecipante la prima volta che ha eseguito un upsert non API.</td></tr><tr><td>IP visto più di recente</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>L'indirizzo IP del partecipante l'ultima volta che ha eseguito un upsert non API.</td></tr><tr><td>Data di creazione</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>La data di creazione di questo utente partecipante, formattata in <a href="https://currentmillis.com/">millisecondi dall’epoch Unix</a> .</td></tr><tr><td>Hash email</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Il valore hash MD5 dell'indirizzo email di un partecipante.</td></tr><tr><td>Impostazioni locali</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>La posizione geografica del partecipante.</td></tr><tr><td>Codice paese</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Il codice paese del partecipante.</td></tr><tr><td>Segmenti</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>I segmenti utente del partecipante.</td></tr><tr><td>Link condivisibile</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Il link di condivisione del programma principale del partecipante (se specificato).</td></tr><tr><td>Link di condivisione Facebook</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Il link di condivisione Facebook del programma principale del partecipante (se specificato).</td></tr><tr><td>Link di condivisione Twitter</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Il link di condivisione Twitter/X del programma principale del partecipante (se specificato).</td></tr><tr><td>Link di condivisione email</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Il link di condivisione email del programma principale del partecipante (se specificato).</td></tr><tr><td>Link di condivisione LinkedIn</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Il link di condivisione LinkedIn del programma principale del partecipante (se specificato).</td></tr><tr><td>Link di condivisione pulito</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Il link vanity principale del partecipante senza codifica.</td></tr><tr><td>Campo personalizzato</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Se un partecipante ha un campo personalizzato, <code>{ExampleName}</code> sarà il nome del campo.</td></tr></tbody></table>

</details>

<details>

<summary>File dati referral</summary>

<table><thead><tr><th width="256.85546875">Colonna</th><th width="113.3828125">Obbligatorio</th><th>Descrizione</th></tr></thead><tbody><tr><td>Utente referenziato - ID utente</td><td><img src="/files/15430cee723b81ff760cbb1ae4083c1f9a391be4" alt="" data-size="original"></td><td>L'ID utente esterno dell'amico referenziato.</td></tr><tr><td>Utente referenziato - ID account</td><td><img src="/files/15430cee723b81ff760cbb1ae4083c1f9a391be4" alt="" data-size="original"></td><td>L'ID account esterno dell'amico referenziato.</td></tr><tr><td>Utente referente - ID utente</td><td><img src="/files/15430cee723b81ff760cbb1ae4083c1f9a391be4" alt="" data-size="original"></td><td>L'ID utente esterno del customer advocate.</td></tr><tr><td>Utente referente - ID account</td><td><img src="/files/15430cee723b81ff760cbb1ae4083c1f9a391be4" alt="" data-size="original"></td><td>L'ID account esterno del customer advocate.</td></tr><tr><td>ID referral</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>L'identificativo univoco del referral.</td></tr><tr><td>Data di modifica</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>La data dell'ultima modifica del referral (cioè avviato, convertito, moderato, ecc.), formattata in <a href="https://currentmillis.com/">millisecondi dall’epoch Unix</a> .</td></tr><tr><td>Data di inizio referral</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>La data di creazione del referral, formattata in <a href="https://currentmillis.com/">millisecondi dall’epoch Unix</a> .</td></tr><tr><td>Data di conversione</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>La data in cui è stato raggiunto il primo obiettivo, formattata in <a href="https://currentmillis.com/">millisecondi dall’epoch Unix</a> .</td></tr><tr><td>Data modifica utente</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>La data in cui un utente è stato rimosso da un referral (eliminazione utente) o aggiunto a un referral, formattata in <a href="https://currentmillis.com/">millisecondi dall’epoch Unix</a> .</td></tr><tr><td>ID programma</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>L'identificativo del programma per cui è stato creato il referral.</td></tr><tr><td>Nome programma</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Il nome del programma per cui è stato creato il referral.</td></tr><tr><td>Utente referenziato - Email</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>L'indirizzo email dell'amico referenziato.</td></tr><tr><td>Utente referenziato - Nome</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Il nome dell'amico referenziato.</td></tr><tr><td>Utente referenziato - Cognome</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Il cognome dell'amico referenziato.</td></tr><tr><td>Utente referenziato - Codice referral</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Il codice referral principale dell'amico referenziato (dipende dal programma in cui è stato creato questo referral.</td></tr><tr><td>Utente referenziato - Primo IP rilevato</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Il primo indirizzo IP utilizzato dall'amico referenziato quando caricava un widget.</td></tr><tr><td>Utente referenziato - Ultimo IP rilevato</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>L'indirizzo IP più recente utilizzato dall'amico referenziato quando caricava un widget.</td></tr><tr><td>Utente referenziato - URL immagine</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>L'immagine dell'amico referenziato.</td></tr><tr><td>Utente referenziato - Locale</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Il locale dell'amico referenziato.</td></tr><tr><td>Utente referenziato - Data di creazione</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>La data in cui l'amico referenziato è stato visto per la prima volta da SaaSquatch (creato in SaaSquatch), formattata in <a href="https://currentmillis.com/">millisecondi dall’epoch Unix</a> .</td></tr><tr><td>Utente referenziato - Segmenti</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>I segmenti utente dell'amico referenziato.</td></tr><tr><td>referredUserCustomFields.&#x3C;fieldName></td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>I campi personalizzati dell'amico referenziato.</td></tr><tr><td>Utente referente - Email</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>L'indirizzo email del customer advocate.</td></tr><tr><td>Utente referente - Nome</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Il nome del customer advocate.</td></tr><tr><td>Utente referente - Cognome</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Il cognome del customer advocate.</td></tr><tr><td>Utente referente - Codice referral</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Il codice referral principale del customer advocate (ad es. il codice referral utilizzato per creare questo referral).</td></tr><tr><td>Utente referente - Primo IP rilevato</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Il primo indirizzo IP utilizzato dal customer advocate quando caricava un widget.</td></tr><tr><td>Utente referente - Ultimo IP rilevato</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>L'indirizzo IP più recente utilizzato dal customer advocate quando caricava un widget.</td></tr><tr><td>Utente referente - URL immagine</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>L'immagine del customer advocate.</td></tr><tr><td>Utente referente - Locale</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Il locale del customer advocate.</td></tr><tr><td>Utente referente - Data di creazione</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>La data in cui il customer advocate è stato visto per la prima volta da SaaSquatch (creato in SaaSquatch), formattata in <a href="https://currentmillis.com/">millisecondi dall’epoch Unix</a> .</td></tr><tr><td>Stato di moderazione</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Lo stato di moderazione della frode del referral (ad es., <code>PENDING</code>, <code>ACTIONED</code>).</td></tr><tr><td>Data di moderazione</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>La data di inizio del referral, formattata in <a href="https://currentmillis.com/">millisecondi dall’epoch Unix</a> .</td></tr><tr><td>Utente referenziato - ID ricompensa</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>L'identificativo della ricompensa dell'amico referenziato.</td></tr><tr><td>Utente referente - ID ricompensa</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>L'identificativo della ricompensa del customer advocate.</td></tr><tr><td>Utente referrer - Segmenti</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>I segmenti utente del customer advocate.</td></tr><tr><td>referrerUserCustomFields.&#x3C;fieldName></td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>I campi personalizzati del customer advocate.</td></tr><tr><td>Codice referral utilizzato</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Il codice referral del customer advocate utilizzato per il referral.</td></tr><tr><td>Link di condivisione utilizzato</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Il link di condivisione del customer advocate utilizzato per il referral.</td></tr></tbody></table>

</details>

<details>

<summary>File dati ricompensa</summary>

<table><thead><tr><th width="203.2734375">Colonna</th><th width="118.1015625">Obbligatorio</th><th>Descrizione</th></tr></thead><tbody><tr><td>ID utente</td><td><img src="/files/15430cee723b81ff760cbb1ae4083c1f9a391be4" alt="" data-size="original"></td><td>L'identificativo dell'utente.</td></tr><tr><td>ID account</td><td><img src="/files/15430cee723b81ff760cbb1ae4083c1f9a391be4" alt="" data-size="original"></td><td>L'identificativo dell'account dell'utente.</td></tr><tr><td>Tipo</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Il <a href="/pages/3ee22cfa2d88380ca4afdaaf815d4726938922ad">tipo di ricompensa</a>, ad es. credito, sconto, carta regalo, ecc.</td></tr><tr><td>Unità del premio</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>L'unità in cui vengono guadagnate le ricompense, ad es. denaro, punti, mesi, ecc.</td></tr><tr><td>Valore del premio</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Il valore numerico della ricompensa nella sua unità di misura più piccola, ad es. per una ricompensa in denaro di $1,00, il valore sarebbe 100 (centesimi).</td></tr><tr><td>Nome del premio</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Il nome che hai assegnato alla ricompensa quando l'hai creata nel tuo programma.</td></tr><tr><td>Valore in USD</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Il valore della ricompensa in USD.</td></tr><tr><td>ID programma</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>L'identificativo del programma per cui è stata creata la ricompensa.</td></tr><tr><td>Chiave premio globale</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Chiave della configurazione globale della ricompensa nel catalogo ricompense. Si trova sotto <strong>Ricompense → Catalogo → Crea ricompense → Nome della ricompensa</strong>.</td></tr><tr><td>Fonte del premio</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Come è stata creata la ricompensa, ad es. <em>Manuale</em>, <em>Utente referenziato</em>, <em>Registrazione dell'amico</em>.</td></tr><tr><td>Data di creazione</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>La data in cui la ricompensa è stata guadagnata, formattata in <a href="https://currentmillis.com/">millisecondi dall’epoch Unix</a> .</td></tr><tr><td>Data di assegnazione</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>La data in cui la ricompensa è stata assegnata, formattata in <a href="https://currentmillis.com/">millisecondi dall’epoch Unix</a> . (Questo valore può differire da <em>Data di creazione</em> se la ricompensa era in sospeso).</td></tr><tr><td>Data prevista per</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>La data in cui era programmata l'assegnazione della ricompensa all'utente, formattata in <a href="https://currentmillis.com/">millisecondi dall’epoch Unix</a> .</td></tr><tr><td>Data di scadenza</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>La data dopo la quale la ricompensa non può più essere riscattata, formattata in <a href="https://currentmillis.com/">millisecondi dall’epoch Unix</a> .</td></tr><tr><td>Data di annullamento</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>La data in cui hai annullato la ricompensa, formattata in <a href="https://currentmillis.com/">millisecondi dall’epoch Unix</a> .</td></tr><tr><td>Data di modifica</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>La data in cui hai apportato modifiche alla ricompensa, formattata in <a href="https://currentmillis.com/">millisecondi dall’epoch Unix</a> .</td></tr><tr><td>Data di riscatto</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>La data in cui la ricompensa completa è stata riscattata dall'utente, formattata in <a href="https://currentmillis.com/">millisecondi dall’epoch Unix</a> .</td></tr><tr><td>Credito assegnato</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>L'importo nell'unità base per le ricompense in Credito. È l'equivalente di <em>Valore del premio</em>, ma per le ricompense in Credito.</td></tr><tr><td>Importo riscattato</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Il <em>Valore</em> della parte della ricompensa che è stata riscattata.</td></tr><tr><td>Tipo Fuel Tank</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Può essere <em>Credito</em> oppure <em>% di sconto</em>.</td></tr><tr><td>Codice Fuel Tank</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>È simile a un codice coupon, ad es. <em>SummerSave20</em>, <em>20%OFF</em>, ecc.</td></tr><tr><td>ID utente referenziato</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>L'identificativo utente dell'amico referenziato.</td></tr><tr><td>ID account referenziato</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>L'identificativo dell'account dell'amico referenziato.</td></tr><tr><td>referral.referredUser.id</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Usato in combinazione con <em>ID programma</em> per collegare un referral a un ID programma, se vogliamo associare un referral a una ricompensa. Potrebbe non corrispondere sempre a <em>ID utente</em>.</td></tr><tr><td>referral.referredUser.accountId</td><td><img src="/files/c96de39af87633db9566a8e17bb691a36a3e18f5" alt="" data-size="original"></td><td>Usato in combinazione con <em>ID programma</em> per collegare un referral a un ID programma, se vogliamo associare un referral a una ricompensa. Potrebbe non corrispondere sempre a <em>ID account</em>.</td></tr></tbody></table>

</details>

#### Riferimento agli errori di convalida

Puoi ricevere 3 tipi di errori di convalida:

1. **Messaggio di errore inline:** questi compaiono nella tabella di convalida dell’anteprima e fanno sì che le righe con errore vengano evidenziate in rosso:

   * `INVALID_FIELD` — ad es., il *Data di creazione* campo non è stato formattato in [millisecondi dall’epoch Unix](https://currentmillis.com/) .
   * `MISSING_FIELD` — ad es., un campo obbligatorio come *ID utente* oppure *ID account* manca.

   <div data-with-frame="true"><figure><img src="/files/2b0682ff95abac73ab882e1c72a7ec5429fbdb2a" alt="" width="563"><figcaption></figcaption></figure></div>
2. **Messaggio di errore:** questi compaiono al posto della tabella di convalida dell’anteprima come messaggi di avviso rossi:

   * `MISSING_HEADER` — ad es., un’intestazione di colonna obbligatoria come *ID account* oppure *Valore del premio* manca.
   * `CSV_PARSING` — ad es., il file CSV contiene caratteri speciali formattati in modo errato.
   * `FILE_REF_IO` — ad es., il file è danneggiato e non può essere letto.

   <div data-with-frame="true"><figure><img src="/files/227be8ea29844d9fe6e28b653bfc647c9a4a1a28" alt="" width="563"><figcaption></figcaption></figure></div>
3. **Errori elencati:** questi compaiono come un elenco di conteggi degli errori nella *Importazioni ed esportazioni* schermata quando il tipo di importazione non dispone di una tabella di convalida dell'anteprima. Gli errori di riga e gli errori del file verranno visualizzati insieme:
   1. Nella barra di navigazione a sinistra, seleziona ![](/files/56eb48c7f3195590132b62ea75c0575abe0113e5) **\[Engage] → Report**.
   2. Seleziona **Importazioni ed esportazioni** per visualizzare il report.


---

# 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/advocate-program/getting-started-with-advocate/import-referral-program-data-from-saasquatch.md?ask=<question>&goal=<endgoal>
```

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