Mapeamentos de resposta

O Marketo pode traduzir dados de webhook de JSON ou XML e gravar os valores para campos de cliente potencial. O parâmetro Campo do Marketo sempre usa o nome da API do SOAP do campo.

Cada webhook pode ter um número ilimitado de mapeamentos de resposta. Para adicionar ou editar mapeamentos, selecione Editar no painel Mapeamentos de Resposta do webhook:

Um mapeamento de resposta emparelha esses valores:

Para acessar uma propriedade por meio dos mapeamentos de resposta do Marketo, sua chave deve conter apenas caracteres alfanuméricos, traço (-), sublinhado (_), dois pontos (:) e espaço em branco.

Mapeamentos JSON

Acesse propriedades JSON com a notação de pontos e a notação de matriz. A notação de matriz Marketo aceita apenas números inteiros, não sequências de caracteres.

Para recuperar dados de um documento JSON, defina o tipo de resposta como JSON:

{ "foo":"bar"}

A propriedade foo está no primeiro nível do objeto JSON. Usar sua propriedade name, foo, no mapeamento de resposta:

O exemplo a seguir contém uma matriz:

{
    "profileId" : 1234,
    "firstName" : "Jane",
    "lastName" : "Doe",
    "orders" : [
        {
            "orderId" : 5678,
            "orderDate" : "2015-01-01",
            "orderProductId" : "4982"
        },
        {
            "orderId" : 5678,
            "orderDate" : "2014-05-07",
            "orderProductId" : "4982"
        }
    ]
}

Para acessar orderDate a partir do primeiro elemento da matriz orders, use orders[0].orderDate.

Mapeamentos XML

Acesse valores de elementos XML individuais usando a notação de pontos, semelhante aos mapeamentos JSON. Considere este exemplo:

<?xml version="1.0" encoding="UTF-8"?>
<example>
    <foo>bar</foo>
</example>

Para acessar a propriedade foo, use example.foo.

Referencie o elemento de exemplo antes de acessar foo. Um mapeamento deve fazer referência a cada elemento na hierarquia de propriedades.

Para um documento XML com uma matriz, considere este exemplo:

<?xml version="1.0" encoding="UTF-8"?>
<elementList>
    <element>
        <foo>baz</foo>
    </element>
    <element>
        <foo>bar</foo>
    </element>
    <element>
        <foo>bar</foo>
    </element>
</elementList>

A matriz pai é elementList. Cada elemento filho contém a propriedade foo. Os mapeamentos de resposta do Marketo fazem referência à matriz como elementList.element e acessam seus filhos por meio de elementList.element[i].

Para obter o valor de foo do primeiro filho de elementList, use o atributo de resposta elementList.element[0].foo. Esse mapeamento retorna o valor “baz” para o campo designado.

Acessar propriedades dentro de elementos que contêm nomes de elementos exclusivos e não exclusivos produz comportamento indefinido. Cada elemento deve ser uma única propriedade ou uma matriz. Não misture os tipos.

Tipos

Ao mapear atributos para campos, verifique se o tipo de resposta do webhook é compatível com o campo de destino. Por exemplo, o Marketo não grava um valor de resposta de string em um campo do tipo inteiro. Para obter mais informações, consulte Tipos de Campo.