Ferramenta Entrada do Marketo
Ferramenta Entrada do Marketo
A ferramenta Entrada do Marketo lê os registros do Marketo com base em parâmetros específicos. Use a ferramenta Entrada do Marketo se não tiver dados para começar ou para obter amostras de dados de sua instância do Marketo. Se você tiver dados que deseja juntar a dados adicionais do Marketo, a ferramenta Marketo Append será uma opção melhor.
Importante
Esta ferramenta não é instalada automaticamente com o Designer. Para usá-la, faça o download na Comunidade Alteryx .
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
Dois tipos de registros do Marketo podem ser recuperados:
LeadRecords (ou registro de lead): são registros de leads, e haverá um registro para cada lead.
Registros de atividade dos leads : esses registros rastreiam as atividades de cada lead. Há muitos Registros de atividades de leads para cada registro de lead.
Com base nas seleções do tipo de registro, diferentes opções estão disponíveis e, com base nessa seleção, haverá parâmetros disponíveis para configurar; alguns são opcionais e outros são obrigatórios. A tabela abaixo mostra em detalhes quais parâmetros são obrigatórios com base na configuração escolhida.
Tipo de registro | Tipo de opção | Lista | Tipos de atividade (1–10) | Campos de saída | Data/Hora de início |
|---|---|---|---|---|---|
Registros de lead | Por tipo de atividade | Opcional | Obrigatório | Opcional | Obrigatório |
Registros de lead | Por ID de lista | Obrigatório | N/A | Opcional | N/A |
Registros de lead | Por alterações de lead | Opcional | N/A | N/A | Obrigatório |
Atividade de lead | Por tipo de atividade | N/A | Obrigatório | N/A | Obrigatório |
Atividade de lead | Por alterações de lead | N/A | N/A | N/A | Obrigatório |
Parâmetros
Listas : todas as listas estáticas para a instância do Marketo especificada na configuração estão listadas aqui (listas inteligentes não estão disponíveis no momento via API); Só é permitida uma seleção de lista por solicitação.
Tipos de atividade : todos os tipos de atividade disponíveis no Marketo estão listados aqui; há um máximo de dez seleções de tipo de atividade por solicitação.
Campos de saída : todos os campos disponíveis na instância do Marketo serão listados. Se nenhuma seleção for feita, a lista padrão de campos será recuperada: E-mail, ID do lead, Nome, Sobrenome, Data da atualização, Data da criação.
Data e hora de início : especifica o ponto de início no banco de dados para começar a recuperar registros.
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.