Beta

Criar um Customer.io conexão de origem e fluxo de dados na interface do

NOTE
A variável Customer.io a fonte está na versão beta. Leia as visão geral das origens para obter mais informações sobre o uso de fontes rotuladas como beta.

Este tutorial fornece etapas para a criação de um Customer.io conexão de origem e fluxo de dados usando a interface do usuário do Adobe Experience Platform.

Introdução getting-started

Este tutorial requer um entendimento prático dos seguintes componentes do Experience Platform:

Pré-requisitos prerequisites

A seção a seguir fornece informações sobre os pré-requisitos a serem concluídos antes da criação de um Customer.io conexão de origem.

Amostra de JSON para definir o esquema de origem para Customer.io prerequisites-json-schema

Antes de criar uma Customer.io conexão de origem, será necessário fornecer um esquema de origem. Você pode usar o JSON abaixo.

{
  "event_id": "01E4C4CT6YDC7Y5M7FE1GWWPQJ",
  "object_type": "customer",
  "metric": "subscribed",
  "timestamp": 1613063089,
  "data": {
    "customer_id": "42",
    "email_address": "test@example.com",
    "identifiers": {
      "id": "42",
      "email": "test@example.com",
      "cio_id": "d9c106000001"
    }
  }
}

Criar um esquema da Platform para Customer.io create-platform-schema

Você também deve garantir a criação de um schema da Platform para usar na origem. Veja o tutorial sobre criação de um schema do Platform para obter etapas abrangentes sobre como criar um schema.

Captura de tela da interface do usuário da plataforma mostrando um esquema de exemplo para Customer.io

Conecte seu Customer.io account connect-account

Na interface do usuário da Platform, selecione Origens na navegação à esquerda, para acessar a Origens e veja um catálogo de fontes disponíveis no Experience Platform.

Use o Categorias para filtrar fontes por categoria. Como alternativa, insira um nome de origem na barra de pesquisa para localizar uma origem específica do catálogo.

Vá para a Automação de marketing categoria para ver o Customer.io cartão de origem. Para começar, selecione Adicionar dados.

Captura de tela da interface do usuário da plataforma para catálogo com o cartão Customer.io

Selecionar dados select-data

A variável Selecionar dados será exibida, fornecendo uma interface para que você selecione os dados que deseja trazer para a Platform.

  • A parte esquerda da interface é um navegador que permite visualizar os fluxos de dados disponíveis em sua conta;
  • A parte direita da interface permite visualizar até 100 linhas de dados de um arquivo JSON.

Selecionar Fazer upload de arquivos para carregar um arquivo JSON do seu sistema local. Como alternativa, você pode arrastar e soltar o arquivo JSON que deseja fazer upload na Arrastar e soltar arquivos painel.

A etapa adicionar dados do fluxo de trabalho de fontes.

Depois que o arquivo for carregado, a interface de visualização será atualizada para exibir uma visualização do esquema carregado. A interface de visualização permite inspecionar o conteúdo e a estrutura de um arquivo. Você também pode usar a variável Campo de pesquisa para acessar itens específicos no esquema.

Quando terminar, selecione Próxima.

A etapa de visualização do fluxo de trabalho de origens.

Detalhes do fluxo de dados dataflow-detail

A variável Detalhes do fluxo de dados A etapa é exibida, fornecendo opções para usar um conjunto de dados existente ou estabelecer um novo para o fluxo de dados, bem como uma oportunidade de fornecer um nome e uma descrição para o fluxo de dados. Durante essa etapa, você também pode definir configurações para Assimilação de perfil, diagnóstico de erro, assimilação parcial e alertas.

Quando terminar, selecione Próxima.

A etapa detalhada do fluxo de dados do fluxo de trabalho de origens.

Mapeamento mapping

A variável Mapeamento é exibida, fornecendo uma interface para mapear os campos de origem do esquema de origem para os campos XDM de destino apropriados no esquema de destino.

A Platform fornece recomendações inteligentes para campos mapeados automaticamente com base no esquema ou conjunto de dados de destino selecionado. Você pode ajustar manualmente as regras de mapeamento para atender aos seus casos de uso. Com base nas suas necessidades, você pode optar por mapear campos diretamente ou usar funções de preparação de dados para transformar dados de origem para derivar valores calculados ou calculados. Para obter etapas abrangentes sobre o uso da interface do mapeador e campos calculados, consulte o Guia da interface de preparação de dados.

Todos os mapeamentos listados abaixo são obrigatórios e devem ser configurados antes de prosseguir para a Revisão estágio.

Campo de destino
Descrição
object_type
O tipo de objeto, consulte a Customer.io events documentação dos tipos suportados.
id
O identificador do objeto.
email
O endereço de email associado ao objeto.
event_id
O identificador exclusivo do evento.
cio_id
A variável Customer.io identificador do evento.
metric
O tipo de evento. Para obter mais informações, consulte Customer.io events documentação para os tipos suportados.
timestamp
O carimbo de data e hora quando o evento ocorreu.
IMPORTANT
Não mapear cio_id ao executar Customer.io webhook no test mode como não haverá campos associados enviados de Customer.io.

Depois que os dados de origem forem mapeados com sucesso, selecione Próxima.

A etapa de mapeamento do fluxo de trabalho de origens.

Consulte a seção review

A variável Revisão é exibida, permitindo que você revise seu novo fluxo de dados antes de ele ser criado. Os detalhes são agrupados nas seguintes categorias:

  • Conexão: mostra o tipo de origem, o caminho relevante do arquivo de origem escolhido e a quantidade de colunas nesse arquivo de origem.
  • Atribuir conjunto de dados e mapear campos: mostra em qual conjunto de dados os dados de origem estão sendo assimilados, incluindo o esquema ao qual o conjunto de dados adere.

Depois de revisar o fluxo de dados, selecione Concluir e aguarde algum tempo para criar o fluxo de dados.

A etapa de revisão do fluxo de trabalho de origens.

Obter o URL do ponto de extremidade de streaming get-streaming-endpoint

Com o fluxo de dados de transmissão criado, agora é possível recuperar o URL do ponto de extremidade de transmissão. Esse endpoint será usado para assinar seu webhook, permitindo que a fonte de streaming se comunique com o Experience Platform.

Para construir o URL usado para configurar o webhook no Customer.io você deve recuperar o seguinte:

  • ID do fluxo de dados
  • Endpoint de transmissão

Para recuperar o ID do fluxo de dados e Endpoint de transmissão, vá para a Atividade de fluxo de dados página do fluxo de dados que você acabou de criar e copie os detalhes da parte inferior da Propriedades painel.

O ponto final de transmissão na atividade de fluxo de dados.

Depois de recuperar o ponto de extremidade de transmissão e a ID do fluxo de dados, crie um URL com base no seguinte padrão: {STREAMING_ENDPOINT}?x-adobe-flow-id={DATAFLOW_ID}. Por exemplo, um URL de webhook construído pode ser semelhante a: https://dcs.adobedc.net/collection/febc116d22ba0ea2868e9c93b199375302afb8a589617700991bb8f3f0341ad7?x-adobe-flow-id=439b3fc4-3042-4a3a-b5e0-a494898d3fb0

Configurar webhook de relatórios no Customer.io set-up-webhook

Com o URL do webhook criado, agora é possível configurar o webhook de relatórios usando o Customer.io interface do usuário. Para obter as etapas sobre como configurar webhooks para relatórios, leia o Customer.io guia em configurar webhooks.

No Customer.io interface do usuário, insira seu URL do webhook no WEBHOOK ENDPOINT campo.

A interface do usuário Customer.io que mostra o campo de ponto de extremidade do webhook

TIP
Você pode assinar uma variedade de eventos diferentes para seu webhook de relatórios. A mensagem de cada evento será assimilada na Platform quando um Customer.io o critério do acionador de evento de ação foi atendido. Para obter mais informações sobre os diferentes eventos, consulte a Customer.io documentação de eventos.

Próximas etapas next-steps

Ao seguir este tutorial, você configurou com êxito um fluxo de dados de transmissão para trazer seus Customer.io dados para Experience Platform. Para monitorar os dados que estão sendo assimilados, consulte o manual sobre monitoramento de fluxos de dados de transmissão usando a interface do usuário da plataforma.

Recursos adicionais additional-resources

As seções abaixo fornecem recursos adicionais que você pode consultar ao usar o Customer.io origem.

Medidas de proteção guardrails

Para obter informações sobre as medidas de proteção, consulte Customer.io página tempos limite e falhas.

Validação validation

Para validar se você configurou corretamente a origem e Customer.io estão sendo assimiladas, siga as etapas abaixo:

  • Você pode verificar o Customer.io Logs de atividade página para identificar os eventos que estão sendo capturados pelo Customer.io.

Captura de tela da interface do usuário Customer.io mostrando os logs de atividades

  • Na interface do usuário da Platform, selecione Exibir fluxos de dados ao lado da variável Customer.io no catálogo de origens. Em seguida, selecione Visualizar conjunto de dados para verificar os dados que foram assimilados para os eventos selecionados no Customer.io.

Captura de tela da interface do usuário da plataforma mostrando eventos assimilados

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089