Vai al contenuto
Rex, il tuo assistente IA: al lavoro di routine ci pensa lui. Le idee sono tue 👉 Scopri Rex

Collega Apsis One

Crea una chiave API in Apsis One, collegala e invia i nuovi iscritti a una sezione con i loro attributi e le iscrizioni, passo dopo passo.

Con l'integrazione Apsis One, chiunque si iscriva viene creato o aggiornato come profilo in Apsis One, nella sezione che scegli, e può essere iscritto (opt-in) a una delle tue subscription di Apsis One.

Cosa ti serve

  • Un account Apsis One e un utente che possa gestire le chiavi API (di solito un amministratore).
  • Sapere se il tuo account Apsis One si trova nella regione Europe o Asia. La maggior parte degli account è in Europa.

Passaggio 1: crea una chiave API in Apsis One

  1. In Apsis One, apri Account settings e vai su API keys (nelle integrazioni).
  2. Clicca per creare una nuova chiave API. Dalle un nome che riconosci, per esempio "Scratcher".
  3. Dai alla chiave l'accesso alla sezione o alle sezioni a cui vuoi che Scratcher invii i profili, con i permessi indicati qui sotto.
  4. Salva e copia il Client ID e il Client secret. Il secret viene mostrato una sola volta.

Apsis ha una propria guida passo passo per questo. Trovi il link nella Guida alla configurazione della finestra di installazione in Scratcher ("Per installare l’integrazione, segui la guida qui").

I permessi di cui ha bisogno la chiave

Scratcher usa la chiave per:

  • leggere le tue sezioni e i relativi attributi, subscription (consent topic) ed eventi, così puoi sceglierli nella campagna;
  • creare profili e aggiornarne gli attributi;
  • aggiungere consensi (opt-in) ai profili;
  • aggiungere eventi ai profili.

Quindi la chiave ha bisogno di accesso in lettura alle sezioni e di accesso in scrittura a profili, consensi ed eventi nelle sezioni che usi. Senza accesso in scrittura, le consegne non riescono e compare il messaggio di errore di Apsis One.

Passaggio 2: collega Apsis One a Scratcher

  1. In Scratcher, vai su Impostazioni > Integrazioni e clicca su Apsis One.
  2. Scegli la Regione API: Europa o Asia.
  3. Incolla l'ID client e il Client secret.
  4. Clicca su Installa integrazione. Scratcher accede ad Apsis One per controllare i dati.

Passaggio 3: attivalo in una campagna

  1. Nell'editor, vai su Collega > Integrazioni > Apsis One e clicca su Attiva.
  2. Se hai collegato più di un account Apsis One, sceglilo in Seleziona account.
  3. In Sezione Apsis, scegli la sezione (Seleziona una sezione).
  4. In Mappature dei campi, clicca su Aggiungi mappatura dei campi per ogni campo e abbina il Campo Scratcher all'attributo di Apsis One in Campo di destinazione. L'elenco mostra gli attributi della sezione che hai scelto, compresi i tuoi.
  5. In Iscrizioni (consensi), scegli la subscription a cui iscrivere le persone, oppure Nessuno. "Scegli l’iscrizione a cui il partecipante deve aderire."
  6. In Filtra per consensi (facoltativo), scegli la tua casella di consenso al marketing, così vengono inviate solo le persone che l'hanno spuntata.
  7. Clicca su Salva e poi su Test per inviare un profilo di prova.

Mappatura dei campi

  • L'indirizzo email viene sempre inviato e serve a identificare il profilo. Non devi mapparlo.
  • Per i numeri di telefono, usa l'impostazione Formato per inviare il numero nel modo che il tuo attributo si aspetta.
  • Gli attributi sì/no ricevono true o false, quindi mappa il campo Accettato di un consenso su un attributo sì/no.

Consenso

Se scegli una subscription, ogni persona viene iscritta con il motivo "Subscribed via" seguito dal nome della campagna e con la fonte "Scratcher". Se la persona è già iscritta, non cambia nulla. Usa Filtra per consensi così vengono iscritte solo le persone che hanno spuntato la tua casella per il marketing.

Se la tua sezione ha l'evento del modulo di consenso di Apsis One, Scratcher registra anche l'iscrizione come evento sul profilo, con l'indirizzo della campagna.

Cosa viene inviato e quando

I nuovi iscritti vengono inviati entro un paio di minuti. Quando attivi l'integrazione, vengono inviati anche i lead già presenti nella campagna. Quando qualcuno partecipa di nuovo, il suo profilo viene aggiornato. Controlla ogni consegna in Impostazioni > Integrazioni > Stato della consegna; lì vedi anche se il profilo era nuovo o esisteva già. Vedi Controlla lo stato della consegna e invia di nuovo i lead.

Risoluzione dei problemi

  • "All or some of the fields are invalid..." durante l'installazione: controlla la regione e copia di nuovo client ID e secret.
  • Le consegne non riescono con un errore di accesso di Apsis One: la chiave non ha accesso alla sezione oppure le mancano i permessi di scrittura. Modifica la chiave in Apsis One.
  • Iscrizioni (consensi) è vuoto: la sezione non ha ancora subscription. Creane una in Apsis One e apri di nuovo l'integrazione.
Ti serve una mano?

Hai ancora bisogno di aiuto?

Persone vere sono qui per aiutarti. Se usi già Scratcher, il modo più veloce è la chat all'interno della piattaforma.

  • Chatta con noi

    Accedi e clicca sul pulsante della chat in basso a destra. Rex risponde subito e il nostro team è a un clic di distanza.

  • Prenota un incontro

    Una videochiamata gratuita di 30 minuti con il nostro team: un tour, idee per campagne o aiuto con la configurazione.

  • Scrivici

    Scrivi a contact@scratcher.io e ti risponderemo.