Ferramenta de saída do marketo
A ferramenta de saída do marketo faz uma chamada para o ponto de extremidade de API REST do marketo: criar/atualizar leads. Os dados são de saída para marketo com base na ação selecionada na configuração.
Ferramenta Gallery
Esta ferramenta não é instalada automaticamente com Designer. Para usar esta ferramenta, baixe-a da Alteryx Analytics Gallery.
Configure a ferramenta
Credenciais de marketo
URL: a instância de REST de marketo para recuperar registros de. Esta informação é encontrada em marketo (admin > integração > serviços Web > API REST).
IDdo cliente: ID do cliente para o usuário da função API. Esta informação pode ser encontrada no marketo (admin > integração > LaunchPoint).
Segredodo cliente: segredo do cliente para o usuário da função da API. Esta informação pode ser encontrada no marketo (admin > integração > LaunchPoint).
Mais informações sobre como configurar o serviço Web e as funções de usuário para acessar a API REST do marketo podem ser encontradas no site de documentação de REST do marketo .
Opções
Campode chave: este drop-down mostrará a lista de campos que você usou como entrada para a ferramenta. O marketo usará este campo para encontrar os registros duplicados. Se nenhum campo for especificado, o email será usado por padrão.
Se o campo ' ID ' estiver incluído em seus registros, ' ID ' deve ser selecionado como o campo-chave.
Selecione uma ação de saída.
- Criar ou atualizar (padrão): com base no campo de chave, crie um chumbo se o chumbo não existir, atualize o lead se ele existir.
- Criar duplicado: criar outro chumbo mesmo que já exista.
- Update Only: Atualize o lead se ele já existir, não faça nada se ele não fizer.
- Criar somente: criar um novo lead se ele não existir, se existir, ignorá-lo.
Nomeda partição: se a instância de marketo que está sendo acessada tiver partições configuradas, elas serão listadas no drop-down. Essa seleção de campo será necessária se a instância que está sendo gravada tiver partições de chumbo configuradas. Se não houver partições disponíveis, o ' default ' será usado.
Considerações sobre dados
Um status de resumo dos registros enviados será listado como uma mensagem na janela de resultados.
Mensagens de erro, como falhas de autenticação, etc. será exibida na janela de configuração. As mensagens de erro, como as seleções de configuração ausentes, serão mostradas pela 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 por marketo.
A API REST de marketo limita contas a 10.000 solicitações por dia, as solicitações para a API REST não contam para as limitações diárias da API SOAP.
Você quer ter certeza de manter as estruturas de campo marketo em Alteryx, antes de escrever de volta para marketo para evitar erros. O conector marketo converterá os dados para os tipos apropriados antes da saída para o marketo, desde que os nomes de campo sejam válidos. Se os nomes de campo não forem encontrados no marketo, a saída falhará.
Campos DateTime
Todas as datas no marketo são armazenadas com um deslocamento UTC. Este formato é composto da hora local com um deslocamento acrescentado que pode ser positivo ou negativo. Por exemplo, um valor DateTime no marketo pode ser semelhante a este, com a data inserida no marketo a partir de um fuso horário que é 6 horas antes horário UTC (horário de Verão da montanha):
Leitura de dados de marketo
Para tornar mais fácil para os artesãos Alteryx trabalhar com esses valores DateTime, Alteryx irá converter o valor DateTime Leia de marketo para uma máquina local DateTime valor. Isso permite que os artesãos para trabalhar com os valores DateTime em seus horários locais. Por exemplo, o DateTime valor acima seria parecido com isso em um fluxo de trabalho Alteryx ou aplicativo, Supondo que você também está 6 horas antes do horário UTC:
Ou, se você fosse apenas 4 horas antes do que UTC, seria devolvido a você assim:
Data de escrita para marketo
Quando DateTime valores são gravados novamente em Marketo usando uma operação de inserção ou atualização, Alteryx irá converter o valor (s) de volta ao formato que o marketo espera. Isto é feito por calculando a máquina local UTC Offset e acrescentando que até o final de DateTime valor. Alteryx vai colocar um ' T' entre a data ea hora partes do valor DateTime, conforme mostrado nos exemplos acima.
Usando os exemplos acima, se um valor DateTime foi escrito a partir de um fuso horário com um deslocamento de-6:00, como este:
E depois escrito de volta ao marketo (não modificado), de um computador com um deslocamento UTC de-4:00 horas, seria escrito de volta ao mercado assim:
Ambas as vezes são idênticas e representam o mesmo momento no tempo.