Salesforce Marketing Cloud

Inclua mensagens Xtremepush como parte de uma jornada em múltiplas etapas no Salesforce Marketing Cloud

A integração com o Salesforce Marketing Cloud permite que você crie campanhas na plataforma Xtremepush que estarão disponíveis para serem acionadas pelo Journey Builder do Salesforce Marketing Cloud.

Etapas de configuração no Salesforce Marketing Cloud

Para começar, acesse sua conta no Salesforce Marketing Cloud e navegue até Configurações > Configurar > Apps > Pacotes Instalados e clique em Novo. Dê um nome para seu pacote (por exemplo, Xtremepush) e clique em Salvar. Depois de concluído, você precisará adicionar dois componentes ao app: um para a Atividade do Construtor de Jornadas e outro para a integração da API.

Criar a integração da API

Clique em Adicionar Componente, que abrirá uma janela com os diferentes tipos de componentes e selecionará Integração de API como seu tipo de componente. Na próxima tela, selecione Servidor-para-Servidor como seu tipo de integração e clique em Próximo. Dê acesso de leitura na seção de Lista de Contatos > e Assinantes , acesse leitura e escrita pela Extensão de Dados > e clique em Salvar.

Adicione o componente de Atividade Construtor de Jornada

Após configurar a integração da API, de Configurações > Configuração > Apps > Pacotes Instalados > aplicação Xtremepush , clique novamente no botão Adicionar Componente .

1222

Selecione Journey Builder Activity como seu tipo de componente e clique em Próximo . Dê um nome à sua atividade do Construtor de Jornadas, selecione Mensagens como Categoria e inclua a URL do Endpoint. Por fim, clique em Salvar.

1290

Endpoint URL
A URL do Endpoint pode ser obtida nas Configurações > Integrações > Conecte Nova página sob o campo Chave de Atividade .

Etapas de configuração no Xtremepush

Depois de completar os passos acima, abra uma nova aba no seu navegador e faça login na sua conta Xtremepush. Navegue até Integrações > Marketplace, selecione o cartão Cloud de Marketing Salesforce na aba Integrations Marketplace e clique em Conectar.

Você precisará configurar as seções de Configurações de Conexão e Mapeamento de Dados .

Configurações de Conexão

Você precisará recuperar os detalhes do seu aplicativo Xtremepush no seu Salesforce Marketing Cloud navegando até Configurações > Configuração > Apps > Pacotes Instalados > aplicação Xtremepush . Em particular, você vai precisar:

URL da Base de Autenticação
URL da Base de Descanso
SOAP Base URL
ID do cliente
Segredo do Cliente
Client MID: clique no seu nome na barra principal para encontrar seu Client MID
Chave de Atividade: encontrada na seção de Atividades do Construtor de Jornadas, onde é chamada de Chave Única
JWT Token: referido como JWT signing secret no Salesforce

Após preencher esses dados, você precisará mapear o ContactID do Salesforce para o identificador Xtremepush.

Mapear o ContactID para o Xtremepush customer_id
Se você quiser mapear seu ContactID para o identificador Xtremepush customer_id e ele não estiver ativado para o seu projeto, por favor, entre em contato com seu Gerente de Conta.

Após mapear o ContatoID, você deve ir para a seção de Mapeamento de Dados .

Mapeamento de dados

Nesta seção, você poderá mapear o sistema Salesforce e os atributos personalizados para o sistema Xtremepush e os atributos personalizados, respectivamente.

Para configurar o mapeamento, clique em Adicionar Extensão de Dados para abrir a lista de extensões de dados criada no seu MC do Salesforce. Escolha uma extensão de dados da lista e clique em Aplicar.

Atributos personalizados do Salesforce para a extensão de dados selecionada são mostrados na primeira coluna. Para cada um deles, você pode opcionalmente armazenar o valor de um atributo Xtremepush, que pode ser selecionado no menu suspenso na coluna final.

Os atributos , email e mobile_number do Contact KeySalesforce (listados nos campos Colun) serão automaticamente mapeados para os atributos user_iddo sistema do Xtremepush, email e mobile_number.

Você pode adicionar várias extensões de dados e fazer o mapeamento de dados de atributos para cada uma.

Criação de atributos
Atributos do sistema são criados automaticamente no Xtremepush. No entanto, para mapear atributos personalizados, você precisa criar esses atributos primeiro no sistema Xtremepush. Revise nosso guia de Atributos e Tags para ver como fazer isso.

Atributos de e-mail e telefone
Para enviar campanhas de E-mail e SMS, é necessário garantir que os atributos de e-mail e telefone da conta Salesforce estejam mapeados para o padrão email e mobile_number atributos Xtremepush.

Mapeamento de Eventos

Nesta seção, você poderá mapear os eventos do Salesforce para os eventos do Xtremepush, o que permitirá usar eventos do Xtremepush como fonte de entrada de eventos da API para jornadas do Salesforce.

Para configurar o mapeamento, clique em Adicionar Mapeamento de Evento para abrir o modal de evento Adicionar Salesforce . Insira o nome do evento da API do Salesforce e a chave de definição do evento, que precisa ser recuperada do Journey Builder > Eventos > Fontes de Entrada no Salesforce. Depois, escolha o evento Xtremepush que você gostaria de mapear e a extensão de dados que deseja vincular a esse evento.

Após configurar o mapeamento do modal, clique em Aplicar. Para mapear mais eventos, siga os mesmos passos.

Mapeamento de Eventos Salesforce
Eventos da API do Salesforce precisam ser criados previamente no Salesforce para poder mapeá-los para eventos Xtremepush.

Quando o mapeamento de eventos estiver concluído, clique no botão Conectar e sua integração será conectada com sucesso.

Revisando e modificando uma integração existente

Navegue até Integrações > Marketplace > Integrações Configuradas > Configurações de > do Salesforce Marketing Cloud para revisar e modificar as configurações.

Se você adicionar novos atributos na sua extensão de dados no Salesforce Marketing Cloud, certifique-se de clicar no botão Atualizar . Isso atualizará a lista de atributos dessa extensão de dados e você poderá mapeá-la para o atributo personalizado Xtremepush apropriado da seção de Mapeamento de Dados da integração existente.

Crie uma campanha Salesforce no Xtremepush

Você pode criar uma campanha no Xtremepush que pode ser selecionada para ser acionada na janela de atividades personalizadas do Salesforce Journey Builder para o Xtremepush.

No Xtremepush, navegue até Campanhas > Criar Campanha e escolha Campanha de Estágio Único > campanha Salesforce , seguindo os passos habituais de configuração da campanha .

Você também pode adicionar seu conteúdo dinâmico usando um atributo do Salesforce no texto da sua mensagem, clicando no ícone do Salesforce e escolhendo o atributo dinâmico relacionado no menu suspenso.

2230 — Neste exemplo, clique no ícone do Salesforce para puxar a lista de atributos disponíveis do Salesforce, incluindo o first_name dos usuários.

Use o Xtremepush no seu Construtor de Jornadas Salesforce

Quando você navega até o Construtor de Jornadas a partir do seu Salesforce Marketing Cloud para criar uma jornada em várias etapas, agora poderá listar a atividade das mensagens do Xtremepush na seção Atividades .

Para escolher uma fonte de entrada, arraste-a do menu à esquerda. A atividade Xtremepush atualmente suporta Data Extension, API Event e Event (apenas Data Based Only) como fontes de entrada.

Clique na fonte de entrada para selecioná-la entre suas fontes pré-criadas (Extensões de Dados, Eventos da API, Evento) na sua conta Salesforce Marketing Cloud.

Evento Baseado em Data
O evento base de data (DBE) passa o ID da extensão de dados para a atividade Xtremepush somente após salvar a jornada. Por causa disso, você precisa adicionar DBE à jornada e depois salvá-la antes de adicionar a atividade Xtremepush à jornada. Caso contrário, a campanha não será acionada.

Depois de selecionar a fonte de entrada, você poderá gerenciar o cronograma da viagem.

2856 — A programação da campanha é definida clicando em 'Programar'.

Depois, arraste o tipo de atividade Xtremepush para a jornada a partir da seção Atividades > Mensagens à esquerda.

2294

O nome que demos ao nosso componente ao configurar a integração será o nome que será mostrado na mensagem Xtremepush (neste caso, chamamos de Xtremepush).

Clique no ícone de atividade do Xtremepush, que abrirá uma janela de dois passos. No primeiro passo (aba de Configuração ), você precisará selecionar a campanha que quer acionar no Xtremepush.

1198 — Selecione a campanha Xtremepush no menu suspenso.

Clique em Próximo para navegar até a aba Atributos da Extensão e verificar quais atributos serão atualizados com essa jornada. Termine sua jornada adicionando quantos passos precisar e clique em Ativar assim que terminar de editar.

Listar estatísticas da campanha
Para verificar o desempenho da sua campanha, após enviar a jornada, você navega de volta para a jornada e passa o mouse sobre o ícone de atividade XP, que mostrará uma janela de 'desempenho da campanha'. Clique no botão Expandir para ver os detalhes sobre o desempenho da campanha.

Se você usar a mesma campanha Xtremepush em jornadas diferentes, as estatísticas da campanha mostrarão o número total de todas as jornadas. Se você quiser ver estatísticas individuais de cada jornada, precisa garantir que cada campanha Xtremepush seja usada apenas em uma jornada Salesforce.

Alteração da extensão de dados após a configuração da campanha
Se você mudar sua extensão de dados após configurar sua campanha, deve abrir e reconfigurar cada atividade do Xtremepush dentro dessa campanha.

Use eventos de mensagens do Xtremepush e dados de assinatura

Uma vez que a campanha seja enviada no Xtremepush, os eventos de mensagens da campanha e os dados de assinatura serão enviados de volta para a Salesforce.

Os dados de engajamento da campanha serão armazenados na extensão de dados XP Message Events , que é atualizada a cada 10 minutos. Essa extensão de dados será criada automaticamente com a integração.

A extensão de dados XP Message Events terá as seguintes colunas:

Coluna	Descrição
`contact_key`	Identificador do contato
`journey_id`	ID de jornada Salesforce de onde os dados relacionados ao evento estão sendo enviados
`campaign_id`	ID de campanha Xtremepush de onde os dados de eventos relacionados estão sendo recebidos
`event_name`	Atividade da mensagem do contato
`event_time_utc`	Carimbo de tempo da atividade da mensagem

Os dados de status da assinatura serão armazenados na extensão de dados XP Subscription Statuses , que é atualizada a cada 10 minutos. Essa extensão de dados será criada automaticamente com a integração.

A extensão de dados XP Subscription Statuses incluirá a endereçabilidade e os dados de assinatura dos contatos relacionados. Você pode ler mais sobre endereçabilidade do Xtremepush e dados de assinatura aqui

Uso de dados na segmentação
Para usar essas extensões de dados (Eventos de Mensagens XP e Status de Assinatura XP) em suas futuras campanhas, certifique-se de atribuí-las a um grupo de atributos do Construtor de Contatos no Salesforce.