Hai la possibilità di inviare le tue prove di acquisto/servizio, in totale autonomia, grazie al metodo di automazione API.
Clicca sulla versione corrispondente al tuo menu:
| ✨ Nuova Piattaforma | 🖥️ Piattaforma Storica |
Altri metodi di automazione, come SFTP o CSV, sono anche disponibili. (clicca sul metodo desiderato per accedere alla procedura)
✨ Nuova Piattaforma
Prerequisiti
Ti consigliamo di inviarci gli ordini degli ultimi 3 mesi per raccogliere recensioni pertinenti.
Configurazione
Vai al menu laterale
Raccogli Recensioni, poi Configurazione
Seleziona API nel banner di configurazione.
Clicca sul pulsante per creare il tuo account API
Una volta creato l'account, puoi visualizzare le impostazioni API: URL, Identificativo del sito web e Chiave segreta.
Genera la tua chiave segreta cliccando su Visualizza Chiave.
Se riscontri problemi, puoi rigenerare questa chiave.
Struttura e invia la richiesta
L'API di Skeepers utilizza OpenId Connect Client Credential grant per autenticare le richieste. Questo metodo non autentica un utente specifico, ma verifica le credenziali e restituisce un access_token generico.
Questa autorizzazione (OpenId Connect Client Credential grant) è utilizzata per l'autenticazione da macchina a macchina.
https://auth.skeepers.io/realms/skeepers/protocol/openid-connect/token
-
Authorization: Imposta come
Basic <base64 encoded "clientId:clientSecret"> -
Content-Type: Imposta come
application/x-www-form-urlencoded
-
grant_type: Imposta come
client_credentials -
scope: Imposta come
openid
POST https://auth.skeepers.io/realms/skeepers/protocol/openid-connect/token HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Authorization: Basic <base64 encoded "clientId:clientSecret">
grant_type="client_credentials" & scope="openid"
Clicca su questo link (Swagger) per accedere alla guida per configurare e simulare le richieste di prova d'acquisto o di servizio. Qui, nella sezione Authentication, dovrai inserire l’identificativo del tuo sito web:
Trova i codici di integrazione
Per trovare la tua chiave segreta e l'ID del tuo sito web:
- Vai al menu laterale sinistro in Recensioni Verificate
Gestione account, poi
Il mio account.
- Le informazioni si trovano poi a destra della pagina nella sezione Codice di integrazione.
Monitora la raccolta
Puoi verificare la trasmissione e l'integrazione delle tue prove di acquisto/servizio, così come lo stato delle richieste di recensioni.
Per farlo, vai al menu laterale sinistro Raccogli recensioni, poi Follow-up delle richieste di recensioni
Se vuoi raccogliere solo recensioni sul marchio, devi rimuovere la variabile prodotto dalla tua chiamata API.
Scopri di più nella documentation: Submit Purchase Event > solicitation_parameters > purchase_event_type.