Configurar destaques de marketing

Destaques de marketing mostra a atividade Marketo ativa de cada cliente potencial, como aberturas e cliques de email, visitas à Web e preenchimentos de formulário. Este artigo explica como conectar sua instância Marketo para que a atividade flua para dentro.

IMPORTANT
A conclusão desta instalação requer acesso à Adobe Developer Console e ao Administrador em Marketo. Trabalhe com seu contato da Adobe e com seu administrador do Marketo para concluir as quatro partes abaixo.

A instalação tem quatro partes:

  • Parte A: Criar credenciais de API na Adobe Developer Console.
  • Parte B: Obtenha seus identificadores e endpoint do Sales Qualifier.
  • Parte C: Configurar um webhook no Marketo Engage.
  • Parte D: adicionar o webhook a um acionador de Campanha inteligente.

Após a conclusão da instalação, os usuários verão e filtrarão esta atividade em Clientes potenciais > Destaques de marketing.

Parte A: Criar credenciais de API part-a-create-api-credentials

Essas credenciais permitem que o Marketo se autentique com segurança no Sales Qualifier.

Para criar as credenciais:

  1. Acesse o Adobe Developer Console e faça logon com seu Adobe ID.

  2. Selecione Criar novo projeto ou abra um projeto existente.

  3. Selecione Editar projeto, renomeie o projeto para algo identificável, como Sales Qualifier Marketing Highlights, e selecione Salvar.

  4. Selecione Adicionar API, selecione API Experience Platform e Avançar.

  5. Escolha OAuth Server-to-Server como o tipo de autenticação e selecione Avançar.

    O OAuth Server-to-Server permite que o Marketo chame a API do Sales Qualifier diretamente do servidor, sem exigir que uma pessoa entre.

  6. Insira um nome de credencial com 45 caracteres ou menos, como Sales Qualifier Marketing Highlights Creds.

  7. Selecione o perfil de produto a ser associado e selecione Salvar API configurada.

  8. Em Credenciais conectadas, abra a credencial servidor para servidor OAuth. Selecione Recuperar segredo do cliente e copie a ID do Cliente e o Segredo do Cliente. Você usa estes valores na Parte C.

WARNING
Mantenha o segredo do cliente privado. Tratá-la como uma senha e não enviá-la por email. Use o canal seguro aprovado da sua organização para compartilhá-lo com quem configurar o webhook.

Parte B: Coletar endpoint e identificadores part-b-gather-your-endpoint-and-identifiers

Você precisa de três valores para a Parte C:

  • URL do Ponto de Extremidade — O endereço do webhook do Sales Qualifier para sua região.
  • imsOrg ID — O identificador da sua organização no Adobe Identity Management System (IMS), no formato {ORG_ID}@AdobeOrg.
  • Nome da sandbox — O nome da sandbox do AEP exatamente como aparece no URL do Sales Qualifier (o valor sname), não o nome de exibição mostrado na interface. Use o valor de URL em minúsculas, por exemplo prod, não Prod.
Região
URL do ponto de extremidade do Webhook
América do Norte
https://5r6xakp9k3.execute-api.us-east-1.amazonaws.com/prod/external/marketo/signals
EMEA
https://pc72i8q1k3.execute-api.eu-west-1.amazonaws.com/prod/external/marketo/signals
APAC / Austrália
https://5cxxxyqlai.execute-api.ap-southeast-2.amazonaws.com/prod/external/marketo/signals

Se você não tiver certeza da sua região, ID imsOrg ou nome da sandbox, o contato da Adobe poderá confirmá-los.

Parte C: Configurar o webhook do Marketo part-c-configure-the-marketo-webhook

Para criar o webhook:

  1. Em Marketo, selecione Admin > Webhooks.

  2. Selecione Novo Webhook.

  3. Defina a URL para a URL do ponto de extremidade da sua região da Parte B.

  4. Definir Tipo de Solicitação como POST.

  5. Defina Solicitar Codificação de Token para JSON. Esta configuração é obrigatória.

  6. Cole o modelo de conteúdo abaixo no Modelo. Use o Token de Inserção de Marketo para corresponder aos nomes de campo na sua instância.

    note
    NOTE
    Com a codificação JSON, não coloque os tokens de sequência entre aspas. Marketo os adiciona automaticamente.
    code language-json
    {
      "leadId": {{lead.Id:default=0}},
      "email": {{lead.Email Address:default=}},
      "fullName": {{lead.Full Name:default=}},
      "company": {{company.Company Name:default=}},
      "title": {{lead.Job Title:default=}},
      "department": {{lead.Department:default=}},
      "country": {{lead.Country:default=}},
      "score": {{lead.Lead Score:default=0}},
      "rating": {{lead.Lead Rating:default=}},
      "leadStatus": {{lead.Lead Status:default=}},
      "leadSource": {{lead.Lead Source:default=}},
      "isCustomer": {{lead.Is Customer:default=false}},
      "industry": {{company.Industry:default=}},
      "annualRevenue": {{company.Annual Revenue:default=0}},
      "numEmployees": {{company.Num Employees:default=0}},
      "campaignId": {{campaign.id:default=0}},
      "campaignName": {{campaign.name:default=}},
      "programName": {{program.name:default=}},
      "occurredAt": {{system.dateTime:default=}},
      "munchkinId": {{system.munchkinId:default=}},
      "triggerName": {{trigger.Trigger Name:default=}},
      "crmId": {{lead.SFDC ID:default=}},
      "crmType": {{lead.SFDC Type:default=}},
      "crmOwnerEmail": {{lead.Lead Owner Email Address:default=}},
      "crmOwnerFirstName": {{lead.Lead Owner First Name:default=}},
      "crmOwnerLastName": {{lead.Lead Owner Last Name:default=}},
      "attributes": {
        "asset": {{trigger.Name:default=}},
        "link": {{trigger.Link:default=}},
        "subject": {{trigger.Subject:default=}},
        "webPage": {{trigger.Web Page:default=}},
        "category": {{trigger.Category:default=}},
        "details": {{trigger.Details:default=}},
        "sentBy": {{trigger.Sent By:default=}},
        "receivedBy": {{trigger.Received By:default=}},
        "referrer": {{trigger.Referrer:default=}},
        "searchEngine": {{trigger.Search Engine:default=}},
        "searchQuery": {{trigger.Search Query:default=}},
        "imDescription": {{lead.Last Interesting Moment Desc:default=}},
        "imType": {{lead.Last Interesting Moment Type:default=}},
        "imDate": {{lead.Last Interesting Moment Date:default=}},
        "imSource": {{lead.Last Interesting Moment Source:default=}},
        "chatAgentName": {{trigger.Agent Name:default=}},
        "chatAgentEmail": {{trigger.Agent Email:default=}},
        "chatConversationStatus": {{trigger.Conversation Status:default=}},
        "chatConversationSummary": {{trigger.Conversation Summary:default=}},
        "chatGoalName": {{trigger.Goal name:default=}},
        "chatMeetingStatus": {{trigger.meeting status:default=}},
        "chatScheduledFor": {{trigger.Scheduled For:default=}},
        "chatDocumentName": {{trigger.Document Name:default=}},
        "chatDocumentUrl": {{trigger.Document URL:default=}},
        "chatPageUrl": {{trigger.Page URL:default=}}
      }
    }
    
  7. Selecione Ações do Webhook > Definir Cabeçalho Personalizado e adicione os seguintes cabeçalhos, usando os valores da Parte A e da Parte B:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto
    Header Valor
    Content-Type application/json
    x-client-id Sua ID do cliente
    x-client-secret Segredo do cliente
    x-gw-ims-org-id Sua ID imsOrg
    x-sandbox-name O nome da sua sandbox
  8. Selecione Salvar.

Parte D: Adicionar o webhook a um acionador de Campanha inteligente part-d-add-the-webhook-to-a-trigger-smart-campaign

Adicione uma etapa de fluxo do Webhook de chamada para acionar uma Campanha Inteligente, existente ou nova. Os acionadores da Smart List nessa campanha decidem quais atividades são enviadas para o Sales Qualifier.

Para adicionar o webhook:

  1. Abra uma Campanha Inteligente de acionador existente ou crie uma nova (Atividades de Marketing > Novo > Campanha Inteligente).
  2. Na guia Smart List, adicione o(s) acionador(es) para as atividades que deseja enviar, por exemplo Link de Cliques no Email, Preenche o Formulário ou Página da Web de Visitas.
  3. Na guia Fluxo, adicione a etapa Chamar Webhook e selecione o webhook criado na Parte C.
  4. Ative a Campanha inteligente.

A atividade dessa Campanha inteligente agora flui para o Sales Qualifier. Os representantes veem e filtram esta atividade em Clientes potenciais > Destaques de marketing.

recommendation-more-help
sales-qualifier-help