Ferramenta Agrupamento do Marketo
Ferramenta Agrupamento do Marketo
A ferramenta Agrupamento do Marketo usa um fluxo de dados de entrada que você especifica para recuperar registros correspondentes da sua instância do Marketo. Usar essa ferramenta é mais útil em situações em que você tem uma lista de endereços de e-mail, ou outros dados com os quais você já está trabalhando, e deseja juntar esses dados com informações adicionais do Marketo, ou ver se eles já existem em sua instância do Marketo.
Configuração de ferramentas
Credenciais do Marketo
URL : a instância REST do Marketo da qual os registros serão recuperados. Essas informações são encontradas no Marketo (API Admin > Integration > Web Services > REST).
ID do cliente : ID do cliente para o usuário da função da API. Essas informações podem ser encontradas no Marketo (Admin > Integration > LaunchPoint).
Segredo do cliente : segredo do cliente para o usuário da função da API. Essas informações podem ser encontradas no Marketo (Admin > Integration > LaunchPoint).
Mais informações sobre como configurar o serviço da Web e as funções de usuário para acessar a API REST do Marketo podem ser encontradas no site da Documentação da REST do Marketo .
Opções
Esta lista suspensa mostrará a lista de campos que você usou como entrada para a ferramenta. O Marketo usará esse campo para encontrar registros de leads com esse valor de campo na instância do Marketo.
Que tipo de registro está no campo de entrada (e-mail, ID SFDC etc.).
Os campos que você deseja recuperar do banco de dados do Marketo. Esses campos, bem como os campos que foram passados para a ferramenta, serão retornados no fluxo de dados de saída.
Se os campos de saída selecionados também estiverem contidos no fluxo de dados de entrada, o campo de saída proveniente do Marketo será renomeado com um "2" no final.
Considerações sobre dados
Mensagens de erro, como falhas de autenticação etc., serão exibidas na janela de configuração. Mensagens de erro, como seleções de configuração ausentes, serão exibidas acima da ferramenta no fluxo de trabalho.
A ferramenta envia registros em lotes de 300 registros ou menos, cada lote conta como uma chamada de API separada para o limite diário definido pelo Marketo.
A API REST do Marketo limita as contas a 10.000 solicitações por dia, e as solicitações à API REST não contam para as limitações diárias da API SOAP.
Para evitar erros, mantenha as estruturas de campo do Marketo no Alteryx antes de gravar novamente no Marketo. O conector do Marketo converterá os dados para os tipos de dados adequados antes de enviar para o Marketo, desde que os nomes dos campos sejam válidos. Se os nomes dos campos não forem encontrados no Marketo, ocorrerá uma falha na saída.
Campos de data e hora
Todas as datas no Marketo ficam armazenadas com uma compensação de UTC. Esse formato é composto pelo horário local com um deslocamento anexado, que pode ser positivo ou negativo. Por exemplo, um valor de data e hora no Marketo pode ser semelhante a este, com a data inserida no Marketo a partir de um fuso horário que é seis horas anterior ao horário UTC (horário de Verão das Montanhas):
2012-02-28T14:00:00-06:00
Lendo dados do Marketo
Para facilitar o trabalho dos criadores do Alteryx com esses valores de data e hora, o Alteryx converterá o valor de data e hora lido do Marketo em um valor da data e hora locais da máquina. Com isso, os criadores podem trabalhar com os valores de data e hora nos horários locais. Por exemplo, o valor de data e hora acima seria semelhante a este em um fluxo de trabalho ou aplicativo do Alteryx, supondo que você também esteja seis horas antes do horário UTC:
2012-02-28 14:00:00
Ou, se você estivesse apenas quatro horas antes do UTC, o horário devolvido seria assim:
2012-02-28 16:00:00
Data da gravação no Marketo
Quando os valores de data e hora são gravados novamente no Marketo usando uma operação de inserção ou atualização, o Alteryx converterá os valores de volta para o formato que o Marketo usa. Isso é feito calculando a compensação do UTC da máquina local e anexando essa informação ao final do valor de data e hora. O Alteryx colocará um "T" entre as partes de data e hora do valor de data e hora, conforme mostrado nos exemplos acima.
Usando os exemplos acima, se um valor de data e hora tiver sido gravado de um fuso horário com uma compensação de -6:00, como este:
2012-02-28T14:00:00-06:00
E, mais tarde, gravado de volta no Marketo (não modificado), de um computador com uma compensação de UTC de -4:00 horas, a informação seria gravada no Marketo assim:
2012-02-28T16:00:00-04:00
Ambos os horários são idênticos e representam o mesmo momento no tempo.