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.
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:
-
Acesse o Adobe Developer Console e faça logon com seu Adobe ID.
-
Selecione Criar novo projeto ou abra um projeto existente.
-
Selecione Editar projeto, renomeie o projeto para algo identificável, como
Sales Qualifier Marketing Highlights, e selecione Salvar. -
Selecione Adicionar API, selecione API Experience Platform e Avançar.
-
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.
-
Insira um nome de credencial com 45 caracteres ou menos, como
Sales Qualifier Marketing Highlights Creds. -
Selecione o perfil de produto a ser associado e selecione Salvar API configurada.
-
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.
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 exemploprod, nãoProd.
https://5r6xakp9k3.execute-api.us-east-1.amazonaws.com/prod/external/marketo/signalshttps://pc72i8q1k3.execute-api.eu-west-1.amazonaws.com/prod/external/marketo/signalshttps://5cxxxyqlai.execute-api.ap-southeast-2.amazonaws.com/prod/external/marketo/signalsSe 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:
-
Em Marketo, selecione Admin > Webhooks.
-
Selecione Novo Webhook.
-
Defina a URL para a URL do ponto de extremidade da sua região da Parte B.
-
Definir Tipo de Solicitação como
POST. -
Defina Solicitar Codificação de Token para
JSON. Esta configuração é obrigatória. -
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=}} } } -
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-Typeapplication/jsonx-client-idSua ID do cliente x-client-secretSegredo do cliente x-gw-ims-org-idSua ID imsOrg x-sandbox-nameO nome da sua sandbox -
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:
- Abra uma Campanha Inteligente de acionador existente ou crie uma nova (Atividades de Marketing > Novo > Campanha Inteligente).
- 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.
- Na guia Fluxo, adicione a etapa Chamar Webhook e selecione o webhook criado na Parte C.
- 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.