Strumento Input di Marketo
Strumento Input di Marketo
Lo strumento Input di Marketo legge i record di Marketo in base a parametri specifici. Utilizza lo strumento Input di Marketo se non disponi di dati da cui iniziare o per campionare i dati dalla tua istanza di Marketo. Se disponi di dati che vuoi collegare ad altri dati di Marketo, è meglio utilizzare lo strumento Aggiunta di Marketo.
Importante
Questo strumento non viene installato automaticamente con Designer. Per utilizzare questo strumento, scaricalo dalla community di Alteryx .
Configurazione strumento
Credenziali Marketo
URL : l'istanza REST di Marketo da cui recuperare i record. Queste informazioni sono disponibili in Marketo (Admin > Integration > Web Services > REST API).
ID client : ID client per l'utente con ruolo API. Queste informazioni sono disponibili in Marketo (Admin > Integration > LaunchPoint).
Segreto client : segreto client per l'utente con ruolo API. Queste informazioni sono disponibili in Marketo (Admin > Integration > LaunchPoint).
Ulteriori informazioni sulla configurazione del servizio Web e dei ruoli utente per l'accesso all'API REST di Marketo sono disponibili sul sito della documentazione REST di Marketo .
Opzioni
È possibile recuperare due tipi di record di Marketo:
Record di lead : si tratta dei record dei lead e ci sarà un record per ogni lead.
Record di attività lead : questi record tengono traccia delle attività per ciascun lead. Esistono potenzialmente molti record di attività lead per ogni record di lead.
In base alle selezioni del tipo di record, sono disponibili diverse opzioni e, in base alla specifica selezione, saranno disponibili vari parametri da configurare, alcuni opzionali e altri obbligatori. La tabella seguente illustra i parametri obbligatori in base alla configurazione scelta.
Tipo di record | Tipo di opzione | Elenco | Tipi di attività (1-10) | Campi di output | Data/ora di inizio |
|---|---|---|---|---|---|
Record principali | Per tipo di attività | Facoltativo | Obbligatorio | Facoltativo | Obbligatorio |
Record principali | Per ID dell'elenco | Obbligatorio | N/A | Facoltativo | N/A |
Record principali | Per cambiamenti principali | Facoltativo | N/A | N/A | Obbligatorio |
Attività principale | Per tipo di attività | N/A | Obbligatorio | N/A | Obbligatorio |
Attività principale | Per cambiamenti principali | N/A | N/A | N/A | Obbligatorio |
Parametri
Elenchi : vengono riportati qui tutti gli elenchi statici per l'istanza di Marketo specificata nella configurazione (gli elenchi smart non sono attualmente disponibili tramite l'API). È consentita la selezione di un solo elenco per richiesta.
Tipi di attività : vengono riportati qui tutti i tipi di attività disponibili in Marketo. È consentita la selezione di massimo 10 tipi di attività per richiesta.
Campi di output : vengono riportati qui tutti i campi disponibili nell'istanza di Marketo. Se non viene effettuata alcuna selezione, viene restituito l'elenco predefinito dei campi: E-mail, ID lead, Nome, Cognome, Data aggiornamento, Data creazione.
Data/ora di inizio : specifica il punto di partenza nel database da cui iniziare il recupero dei record.
Considerazioni sui dati
I messaggi di errore come gli errori di autenticazione e così via vengono visualizzati nella finestra di configurazione. I messaggi di errore come le selezioni di configurazione mancanti vengono visualizzati sullo strumento nel flusso di lavoro.
Lo strumento invia i record in batch di 300 record o meno. Ogni batch viene conteggiato come una chiamata API separata ai fini del limite giornaliero impostato da Marketo.
L'API REST di Marketo limita gli account a 10.000 richieste al giorno. Le richieste all'API REST non vengono conteggiate ai fini delle limitazioni giornaliere dell'API SOAP.
Devi assicurarti di mantenere le strutture dei campi di Marketo in Alteryx prima della riscrittura in Marketo per evitare errori. Il connettore Marketo convertirà i dati nei tipi di dati corretti prima di inviare l'output a Marketo, a condizione che i nomi dei campi siano validi. Se i nomi dei campi non vengono trovati in Marketo, l'operazione di output avrà esito negativo.
Campi data e ora
Tutte le date in Marketo vengono memorizzate con un offset dall'ora UTC. Questo formato è composto dall'ora locale con un offset aggiunto che può essere positivo o negativo. Ad esempio, un valore di data e ora in Marketo potrebbe essere simile al seguente, dove la data inserita in Marketo proviene da un fuso orario che è 6 in anticipo rispetto all'ora UTC (ora legale fuso occidentale):
02/28/2012 20:00:00
Lettura dei dati da Marketo
Per semplificare l'utilizzo di questi valori di data e ora da parte degli Alteryx Artisan, Alteryx convertirà il valore di data e ora letto da Marketo in un valore di data e ora locale del computer. In questo modo gli Artisan possono utilizzare i valori di data e ora nei loro orari locali. Ad esempio, il valore di data e ora precedente sarà simile al seguente in un flusso di lavoro o in un'app Alteryx, supponendo che anche tu sia 6 ore in anticipo rispetto all'ora UTC:
2012-02-28 14:00:00
Oppure, se sei solo 4 ore in anticipo rispetto all'ora UTC, il valore restituito sarà il seguente:
2012-02-28 16:00:00
Scrittura della data in Marketo
Quando i valori di data e ora vengono riscritti in Marketo utilizzando un'operazione di inserimento o aggiornamento, Alteryx li riconvertirà nel formato previsto da Marketo. Tale conversione viene eseguita calcolando l'offset dall'ora UTC del computer locale e aggiungendolo alla fine del valore di data e ora. Alteryx inserirà una 'T' tra la data e l'ora del valore come mostrato negli esempi precedenti.
Utilizzando gli esempi precedenti, se un valore di data e ora è stato scritto da un fuso orario con un offset pari a -6:00, come il seguente:
02/28/2012 20:00:00
e poi riscritto in Marketo (non modificato) da un computer con un offset pari a -4:00 ore, verrebbe riscritto in Marketo come segue:
02/28/2012 20:00:00
Entrambe le date e le ore sono identiche e rappresentano lo stesso momento nel tempo.