Passa al contenuto principale
Skip to article
  • Customer Experience
    Customer Experience
  • Employee Experience
    Employee Experience
  • Brand Experience
    Brand Experience
  • Core XM
    Core XM
  • Design XM
    Design XM

Domande API comuni

Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!

Informazioni sulle domande API comuni

Qualtrics dispone di una varietà di prodotti diversi che consentono ai nostri clienti di raccogliere dati utilizzabili in tempo reale. Alcuni di questi prodotti includono la Piattaforma di sondaggio, il Feedback Website / App, la Directory XM e Qualtrics 360. Una volta acquistata la funzione API di Qualtrics, sarai in grado di utilizzarla per tutti i prodotti che fanno parte della tua licenza.

Piattaforma sondaggio

Ho tutti i parametri corretti, ma continuo a ricevere un messaggio di errore che dice “Richiesta non valida. Parametro Request mancante o non valido.” Perché questo sta accadendo?

Esempio: 

curl -X POST \  https://yourdatacenterid.qualtrics.com/API/v3/responseexports \  
 -H 'content-type: application/json' \  -H 'x-api-token: 12345678901234567890' \  
 -d '{"geometyId":"SV_1234567890","Format":"json"}'

I parametri API Qualtrics fanno distinzione tra maiuscole e minuscole. In questo esempio, il parametro viene chiamato “Formato” quando deve essere “format”. Aggiornalo e sarai in grado di eseguire correttamente la tua richiesta API.

Desidero scaricare i miei dati grezzi da aprire in Excel. Quale richiesta API devo utilizzare?
Si vorrà utilizzare la richiesta Crea esportazione risposte per avviare il processo di esportazione e specificare che il formato del file di esportazione delle risposte deve essere CSV. Quindi, sarà necessario utilizzare la richiesta Ottieni avanzamento esportazione risposte per controllare se il file è pronto, seguita dalla richiesta Ottieni file di esportazione risposte per scaricare il file CSV.
Quando utilizzi Crea importazione contatti, quali sono i diversi metodi per pubblicare o inviare il mio elenco di contatti a Qualtrics?
Esistono due opzioni per caricare il tuo elenco di contatti:

  1. È possibile impostare Content-Type su multipart/form-data e caricare i contatti come file JSON.
  2. È possibile impostare Content-Type su application/json e pubblicare i contatti come matrice JSON nel corpo della richiesta.
Sono limitato al numero di richieste che posso fare per la mia organizzazione? E quante richieste API simultanee posso effettuare contemporaneamente?
Consultare questa pagina API per ulteriori informazioni sui limiti.
Sto utilizzando la richiesta Importa sondaggio e ho salvato il sondaggio come file TXT. La richiesta è riuscita, ma le mie domande non vengono visualizzate nel sondaggio appena importato. Perché questo sta accadendo?
Dovrai assicurarti di seguire il formato necessario per importare i sondaggi in Qualtrics. Per ulteriori informazioni sulla formattazione TXT, visualizzare Preparazione di un file TXT in formato semplice e Preparazione di un file TXT in formato avanzato. Una volta che il file è stato formattato correttamente, la richiesta verrà eseguita correttamente.
Sto utilizzando la richiesta Crea esportazione risposta con i parametri startDate e endDate. Tuttavia, quando guardo i dati scaricati, non vedo l’intervallo di date previsto per le risposte.
La chiave per utilizzare i parametri startDate e endDate è capire quale valore data viene utilizzato per valutare la condizione che si sta creando (ad esempio, quali date vengono analizzate per valutare la data di inizio impostata e la data di fine impostate). Questi due parametri utilizzano la data in cui il partecipante ha iniziato l’indagine. Questo valore, denominato Data di inizio, è disponibile nella scheda Dati e analisi e nei dati scaricati. Pertanto, se imposti il parametro startDate su 2017-01-01 e il tuo parametro endDate su 2017-01-02, scaricherai le risposte che sono state registrate (inviate o incomplete) per i partecipanti al sondaggio che hanno iniziato il sondaggio nell’intervallo di date dal 1° gennaio 2017 al 2 gennaio 2017.

Suggerimento: una risposta al sondaggio non viene registrata finché il partecipante non fa clic sul pulsante Invia all’interno di un sondaggio o quando risposte al sondaggio incomplete Il periodo è stato rispettato.

feedback website/app

Per domande sul feedback website / app, contatta il nostro team di supporto Website / App Feedback.

Directory XM

Posso usare l’API Survey Platform (Piattaforma di sondaggio) ora che uso anche la directory XM?
Sì, assolutamente. XM Directory ha alcune richieste API che sostituiranno le richieste effettuate tramite l’API Survey Platform, ma per la maggior parte puoi ancora usare tutte le richieste dell’API Survey Platform. Le richieste Contatti Piattaforma Sondaggio sono le uniche che possono variare. Nella documentazione v3, le richieste API non supportate per gli utenti della directory XM (e viceversa) avranno un avviso.
A quale funzionalità aggiuntiva fornisce l’API XM Directory a cui non ho accesso solo con l’API Survey Platform?
L’API XM Directory ti fornisce alcune richieste uniche specifiche per la directory XM. Puoi utilizzare getBouncedContacts (API v2.4) per trovare tutti i contatti nella tua directory (o in una specifica lista di invio) che hanno mai avuto un rimbalzo e-mail. La richiesta Contatti della directory della lista può essere utilizzata per esportare un sottoinsieme dell’intera directory. La richiesta getIncentiveRecipients consente di scaricare una lista di tutti i contatti presenti nella directory che hanno guadagnato uno specifico incentivo, come una voce premio a punti o sweepstakes. Queste richieste e altre sono disponibili con l’API Directory XM.
Qual è la differenza tra l’ID contatto e l’ID destinatario?
Ogni richiesta API XM Directory richiede in genere l’ID contatto del contatto. Questo ID inizia con “CID_” ed è seguito da una stringa alfanumerica univoca. L’ID contatto è l’ID univoco del contatto nella directory. Alcune richieste API richiedono l’ID destinatario del contatto. Questo ID inizia con “CGC_” ed è seguito da una stringa alfanumerica univoca. L’ ID destinatario è l’ID univoco del contatto in una lista di invio.

Per comprendere la differenza tra l’ID contatto e l’ID destinatario, è importante ricordare che ogni contatto deve esistere nella directory una sola volta. Quindi un singolo contatto potrebbe essere trovato nella tua directory una sola volta, ma potrebbe anche essere membro di molteplici liste di invio. Se questo contatto fosse membro di tre liste di invio, disporrebbe di un ID contatto e tre ID destinatario, uno per ciascuna lista.

Qualtrics 360

Per domande Qualtrics 360, contatta il nostro team di supporto Qualtrics 360.

Molte delle pagine di questo sito sono state tradotte dall'originale in inglese mediante traduzione automatica. Sebbene in Qualtrics abbiamo profuso il massimo impegno per avere le migliori traduzioni automatiche possibili, queste non sono mai perfette. Il testo originale inglese è considerato la versione ufficiale, e qualsiasi discrepanza tra questo e le traduzioni automatiche non è legalmente vincolante.