Strumento Aggiunta di Marketo
Strumento Aggiunta di Marketo
Lo strumento Aggiunta di Marketo utilizza un flusso di dati in entrata specificato per recuperare i record corrispondenti dall'istanza Marketo. Lo strumento Aggiungi è particolarmente utile quando disponi di un elenco di indirizzi e-mail o di altri dati che stai utilizzando e desideri unire tali dati con altre informazioni di Marketo o verificare se sono già presenti nell'istanza Marketo.
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
Questo menu a discesa mostra l'elenco dei campi utilizzati come input per lo strumento. Marketo utilizzerà questo campo per trovare i record dei lead con questo valore di campo nell'istanza Marketo.
Tipologia di record del campo in entrata (e-mail, id SFDC, ecc.).
I campi da recuperare dal database Marketo. Questi campi, analogamente a quelli passati nello strumento, verranno restituiti nel flusso dei dati di output.
Se i campi di output selezionati sono contenuti anche nel flusso di dati in entrata, il campo di output proveniente da Marketo viene rinominato con un 2 alla fine del nome.
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.