Vai al contenuto principale

Integra ZAP~POST con Omnisend

Scopri come catturare dati da Omnisend a ZAP~POST

Scritto da Edgaras Vaninas

Collega Omnisend con ZAP~POST per inviare cartoline fisiche a nuovi contatti nei paesi supportati.L'integrazione controlla Omnisend ogni 30 minuti e invia le informazioni sui contatti e sugli indirizzi idonei alla campagna ZAP~POST che corrisponde al paese del contatto.

Questa è un'integrazione unidirezionale da Omnisend a ZAP~POST.Le consegne, i resi e altri stati di ZAP~POST non vengono sincronizzati su Omnisend.


Prima di iniziare

Assicurati di avere:

  • Un account ZAP~POST attivo.

  • Una Chiave API ZAP~POST e una Password API.

  • Almeno una campagna ZAP~POST con opere Front e Back pubblicate.

  • Dati di indirizzo, città e paese per i contatti a cui desideri inviare posta.

  • Una campagna ZAP~POST con un nome che identifica chiaramente il paese che serve.

  • Accesso all'integrazione ZAP~POST nel mercato delle app di Omnisend.

Ad esempio, puoi nominare le campagne:

  • Cartolina di Benvenuto - Stati Uniti

  • Cartolina di Benvenuto - Regno Unito

  • Cartolina di Benvenuto - Germania

Importante: Una campagna non pubblicata può restituire unrisposta 404 Not Found quando invii un contatto.Pubblica l'opera d'arte anteriore e posteriore della campagna prima di utilizzarla con l'integrazione.

Crea credenziali API ZAP~POST

Passo 1. Accedi a ZAP~POST ZAPP.

Passaggio 2. Vai a Impostazioni →Consumatori API. SelezionaAggiungi Nuovo Consumatore.

Passo 3. Seleziona Genera Nuove Chiavi.

Passo 4. Copia la chiave generataChiave API e Password API.

Hai bisogno di entrambe le credenziali per collegare ZAP~POST a Omnisend.

Collega ZAP~POST a Omnisend

Passo 1. Apri l'integrazione ZAP~POST nel mercato delle app di Omnisend.

Passo 2. Inserisci la tuaChiave API e poi la tua ZAP~POSTPassword API.

Passo 3. Salva la connessione.

L'integrazione utilizza queste credenziali per inviare singoli record di contatto a ZAP~POST.

Crea Flusso Automatizzato per Cartoline

L'integrazione utilizza un Flusso Automatizzato chiamato Cartolina di Benvenuto.

  1. Crea o apri il Flusso Automatizzato Cartolina di Benvenuto.

  2. Seleziona il trigger Nuovo contatto di Omnisend.

  3. Aggiungi un filtro che richiede al contatto di avere:

    • Un indirizzo

    • Una città

    • Un paese

  4. Aggiungi l'azione ZAP~POST Invia Record Individuale.

  5. Seleziona tutte le campagne ZAP~POST che il Flusso Automatizzato può utilizzare.

  6. Salva il Flusso Automatizzato.

L'integrazione controlla i nomi delle campagne selezionate e instrada ogni contatto alla campagna che corrisponde al loro paese.

Imposta il Routing delle Campagne

Il campo Campagne supporta selezioni multiple.Seleziona ogni campagna ZAP~POST che questo Flusso Automatizzato dovrebbe poter utilizzare.

L'integrazione non invia ogni contatto a ogni campagna selezionata.Confronta il paese del contatto con il nome di ogni campagna selezionata.

Ad esempio:

  • Un contatto dagli Stati Uniti viene instradato a una campagna contenente Stati Uniti o US.

  • Un contatto dal Regno Unito o dall'Irlanda del Nord viene instradato a una campagna contenente Regno Unito o UK.

  • Un contatto da un altro paese viene instradato a una campagna quando un nome di campagna selezionato include quel paese o la sua abbreviazione riconosciuta.

ZAP~POST non fornisce un campo paese separato per questo routing.Il nome della campagna è il segnale del paese disponibile per l'integrazione.

Usa nomi di campagna chiari, come:

  • Cartolina di Benvenuto - Germania

  • Cartolina di Benvenuto - DE

  • Cartolina di Benvenuto - Francia

Un contatto proveniente dal Regno Unito o dall'Irlanda del Nord non viene instradato a una campagna degli Stati Uniti, anche quando entrambe le campagne sono selezionate.Questi paesi utilizzano diversi formati di posta fisica e richiedono configurazioni di campagna separate.

Le campagne archiviate possono rimanere visibili nel selettore delle campagne.Sono etichettate con lo stato fornito da ZAP~POST e sono escluse dalla ricezione della posta.

Paesi Supportati

L'integrazione instrada un contatto quando il suo paese corrisponde a un nome di campagna ZAP~POST selezionato.

I seguenti paesi hanno confermato il supporto end-to-end:

  • Regno Unito

  • Irlanda del Nord

  • Stati Uniti

La logica di instradamento può anche corrispondere ad altri paesi quando esiste una campagna nominata correttamente.Il supporto per paesi aggiuntivi deve essere confermato con un test end-to-end prima di fare affidamento su di esso per le spedizioni di produzione.

ZAP~POST può supportare la consegna in paesi come Germania, Paesi Bassi, Francia e Italia.Tuttavia, la disponibilità tramite questa integrazione dipende dall'avere una campagna corrispondente configurata e testata.

Nota: IlRepubblica d'Irlanda non è supportata da questa integrazione. ZAP~POST richiede un minimo di 2.000 record per invio campagna per l'Irlanda, che non si adatta al modello di invio Contatto individuale di questa integrazione.

Dati inviati a ZAP~POST

L'azione Invia Record Individuale invia i dati di contatto a ZAP~POST.

Campo

Requisito

ID Cliente

Obbligatorio e unico.Limitato a 100 caratteri.Mappato dall'ID Contatto di Omnisend.

Paese

Obbligatorio.Supporta lettere, spazi, trattini, parentesi, punti, e commerciali, e apostrofi.

Email

Facoltativo.Limitato a 255 caratteri.

Nome

Facoltativo.

Cognome

Facoltativo.

Nome dell'azienda

Facoltativo.

Saluto

Facoltativo.

Campi nome

Un nome consegnabile richiede una combinazione valida dei campi nome.Il limite combinato è di 120 caratteri.

Indirizzo Linea 1

Facoltativo individualmente.

Indirizzo Linea 2

Facoltativo individualmente.

Indirizzo Linea 3

Facoltativo individualmente.

Città

Facoltativo individualmente.

Codice postale

Facoltativo individualmente.

Campi indirizzo

Un indirizzo consegnabile richiede una combinazione valida di indirizzo, città e codice postale.Il limite combinato è di 150 caratteri.

Valuta

Facoltativo.Utilizza solo lettere e supporta fino a tre caratteri, come GBP.

Lingua

Facoltativo.Utilizza solo lettere e supporta fino a 10 caratteri.

Dati personalizzati

JSON facoltativo per campi specifici della campagna.

ZAP~POST richiede informazioni sufficienti su nome e indirizzo per consegnare la cartolina.I contatti senza informazioni sufficienti possono non superare la validazione o potrebbero non essere consegnabili.

Aggiungi Dati Personalizzati

Utilizza Dati Personalizzati per inviare valori specifici della campagna che non fanno parte dei campi di contatto standard.

Esempi includono:

  • Offerta

  • CodiceOfferta

  • Valore

  • DataInizio

Questi campi devono già essere configurati per la campagna in ZAP~POST.Usa il nome del campo in minuscolo come chiave JSON.

Usa l'impostazione Solo record validi

L'azione include un toggle Solo record validi.

Quando l'impostazione è attivata, ZAP~POST rifiuta l'intera sottomissione se un campo non supera la validazione.

Quando l'impostazione è disattivata, che è il valore predefinito, i campi validi vengono inviati e i fallimenti di validazione vengono restituiti nella risposta.

Scegli l'impostazione in base a se desideri che un campo non valido blocchi l'intera sottomissione.

Comprendere il programma di invio

L'integrazione controlla Omnisend per nuovi contatti ogni 30 minuti.

ZAPPOST può combinare internamente le singole sottomissioni in un'unica batch giornaliera.Questo influisce su come i record appaiono nella pagina di elaborazione o reporting di ZAPPOST.Non cambia il comportamento di invio.

Lo stato della mail di un record inviato potrebbe non essere disponibile per la consultazione fino al giorno successivo all'invio.

Risoluzione dei problemi

Vedo "Si è verificato un errore, contattare il supporto"

Per un nuovo account ZAP~POST o riconnesso, questo messaggio può indicare un periodo di prova scaduto.

Controlla lo stato della tua prova ZAP~POST o di fatturazione prima di risolvere la connessione Omnisend.

Ricevo una risposta 404 Not Found

Conferma che la campagna ZAP~POST selezionata ha pubblicato opere Front e Back.

Una campagna non pubblicata può restituire una risposta 404 Not Found.Omnisend non può rilevare opere non pubblicate prima della sottomissione.

Un contatto non riceve una cartolina

Controlla quanto segue:

  1. Il contatto ha un indirizzo, una città e un paese.

  2. Il paese del contatto corrisponde a un nome di campagna selezionato.

  3. La campagna corrispondente non è archiviata.

  4. La campagna ha pubblicato opere Front e Back.

  5. Il tuo stato di prova o di fatturazione ZAP~POST è attivo.

  6. La Chiave API e la Password API sono corrette.

  7. Il contatto contiene informazioni sufficienti su nome e indirizzo per la consegna.

Domande frequenti

Quando posso visualizzare lo stato della posta?

ZAP~POST non rende disponibile lo stato di un record inviato per la consultazione nello stesso giorno.Controlla lo stato il giorno successivo.

L'integrazione sincronizza gli stati di consegna ZAP~POST su Omnisend?

No. L'integrazione invia i dati di contatto da Omnisend a ZAPPOST.Non sincronizza eventi di consegna, ritorno o altri eventi ZAPPOST su Omnisend.

Quanto velocemente ZAP~POST invia una cartolina?

Omnisend controlla nuovi contatti ogni 30 minuti.ZAP~POST può raggruppare internamente le singole sottomissioni per l'elaborazione giornaliera.Il processo di batch influisce sulla reportistica, non sul comportamento di invio dell'integrazione.

Posso usare una campagna per più paesi?

Usa campagne separate quando i paesi richiedono formati di posta fisica diversi.

Il Regno Unito e l'Irlanda del Nord possono utilizzare una campagna condivisa.Gli Stati Uniti richiedono una campagna separata.

Cosa devo fare se un paese non riceve posta?

Assicurati che una campagna ZAP~POST selezionata includa il paese del contatto o l'abbreviazione riconosciuta nel suo nome.Conferma anche che la campagna è attiva e ha pubblicato opere.

Se il problema persiste, contatta il supporto Omnisend con l'ID contatto e il nome della campagna ZAP~POST.


Hai altre domande? I nostri specialisti del supporto sono disponibili 24 ore su 24 tramite chat in-app o via email a [email protected]

Hai ricevuto la risposta alla tua domanda?