[Beta]{class="badge informative"}

Assimilar dados de pagamentos de sua conta Stripe para o Experience Platform usando a interface do usuário

NOTE
A origem Stripe está na versão beta. Leia os termos e condições na visão geral das fontes para obter mais informações sobre como usar fontes com rótulo beta.

Leia o tutorial a seguir para saber como assimilar dados de pagamentos de sua conta do Stripe para a Adobe Experience Platform usando a interface do usuário.

Introdução

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

Autenticação

Leia a Stripe visão geral para obter informações sobre como recuperar suas credenciais de autenticação.

Conectar sua conta do Stripe connect

Na interface da Platform, selecione Fontes na navegação à esquerda para acessar o espaço de trabalho Fontes. Você pode selecionar a categoria apropriada no catálogo no lado esquerdo da tela. Como alternativa, você pode encontrar a fonte específica com a qual deseja trabalhar usando a opção de pesquisa.

Na categoria Pagamentos, selecione Stripe e Configurar.

TIP
As origens no catálogo de origens exibem a opção Configurar quando uma determinada origem ainda não tem uma conta autenticada. Quando uma conta autenticada existir, esta opção será alterada para Adicionar dados.

O catálogo de origens na interface do usuário do Experience Platform, com o cartão de origem Stripe selecionado.

A página Conectar conta Stripe é exibida. Nesta página, você pode usar credenciais novas ou existentes.

Criar uma nova conta

Para criar uma nova conta, selecione Nova conta e forneça um nome, uma descrição opcional e suas credenciais.

Quando terminar, selecione Conectar à origem e aguarde algum tempo para que a nova conexão seja estabelecida.

A interface de criação de nova conta do fluxo de trabalho de origens.

table 0-row-2 1-row-2
Credencial Descrição
Token de acesso Seu token de acesso Stripe. Para obter informações sobre como recuperar o token de acesso, leia o Stripe guia de autenticação.
Usar uma conta existente

Para usar uma conta existente, selecione Conta existente e a conta que deseja usar no catálogo de contas existente.

Selecione Avançar para continuar.

A página de seleção de conta existente do catálogo de fontes.

Selecionar dados select-data

Agora que você tem acesso à sua conta, deve identificar o caminho apropriado para os dados do Stripe que deseja assimilar. Selecione Caminho do recurso e selecione o ponto de extremidade de onde deseja assimilar dados. Os pontos de extremidade Stripe disponíveis são:

  • Encargos
  • Assinaturas
  • Reembolsos
  • Transações de Saldo
  • Clientes
  • Preços

A janela suspensa de caminho de recurso.

Depois que o ponto de extremidade é selecionado, a interface é atualizada em uma tela de visualização, exibindo a estrutura de dados do ponto de extremidade Stripe selecionado. Selecione Avançar para continuar.

A janela de visualização dos seus dados de Stripe.

Fornecer detalhes do conjunto de dados e do fluxo de dados provide-dataset-and-dataflow-details

Em seguida, você deve fornecer informações sobre seu conjunto de dados e seu fluxo de dados.

Detalhes do conjunto de dados dataset-details

Um conjunto de dados é uma construção de armazenamento e gerenciamento para uma coleção de dados, normalmente uma tabela, que contém um esquema (colunas) e campos (linhas). Os dados assimilados com sucesso no Experience Platform são armazenados no data lake como conjuntos de dados. Durante essa etapa, você pode criar um novo conjunto de dados ou usar um conjunto de dados existente.

Usar um novo conjunto de dados

Para usar um novo conjunto de dados, selecione Novo conjunto de dados e forneça um nome e uma descrição opcional para seu conjunto de dados. Você também deve selecionar um esquema do Experience Data Model (XDM) ao qual seu conjunto de dados adere.

A nova interface de seleção do conjunto de dados.

table 0-row-2 1-row-2 2-row-2 3-row-2
Detalhes do novo conjunto de dados Descrição
Nome do conjunto de dados de saída O nome do novo conjunto de dados.
Descrição (Opcional) Uma breve explicação do novo conjunto de dados.
Esquema Uma lista suspensa de esquemas que existem em sua organização. Você também pode criar seu próprio esquema antes do processo de configuração de origem. Para obter mais informações, leia o manual sobre criação de um esquema XDM na interface.
Usar um conjunto de dados existente

Se você já tiver um conjunto de dados existente, selecione Conjunto de dados existente e use a opção Pesquisa avançada para exibir uma janela de todos os conjuntos de dados na sua organização, incluindo seus respectivos detalhes, como se eles estão habilitados para assimilação no Perfil do cliente em tempo real ou não.

A interface de seleção do conjunto de dados existente.

Selecione para obter as etapas para habilitar a Assimilação de perfil, o diagnóstico de erros e a assimilação parcial.

Se o seu conjunto de dados estiver habilitado para o Perfil de cliente em tempo real, durante essa etapa você poderá alternar para o conjunto de dados do perfil para habilitar seus dados para assimilação de perfil. Você também pode usar esta etapa para habilitar o Diagnóstico de erro e a Assimilação parcial.

  • Diagnóstico de erro: selecione Diagnóstico de erro para instruir a origem a produzir o diagnóstico de erro que você poderá consultar posteriormente ao monitorar a atividade do conjunto de dados e o status do fluxo de dados.
  • Assimilação parcial: a assimilação parcial de lotes é a capacidade de assimilar dados que contêm erros, até um determinado limite configurável. Esse recurso permite assimilar com sucesso todos os seus dados precisos no Experience Platform, enquanto todos os seus dados incorretos são armazenados em lote separadamente com informações sobre por que são inválidos.

Detalhes do fluxo de dados dataflow-details

Depois que o conjunto de dados é configurado, você deve fornecer detalhes sobre o fluxo de dados, incluindo um nome, uma descrição opcional e configurações de alerta.

A etapa de configuração de detalhes do fluxo de dados.

Configurações de fluxo de dados
Descrição
Nome do fluxo de dados
O nome do fluxo de dados. Por padrão, esse campo usará o nome do arquivo que está sendo importado.
Descrição
(Opcional) Uma breve descrição do fluxo de dados.
Alertas

O Experience Platform pode produzir alertas baseados em eventos que os usuários podem assinar. Todas essas opções exigem um fluxo de dados em execução para serem acionadas. Para obter mais informações, leia a visão geral dos alertas

  • Início da Execução do Fluxo de Dados de Fontes: selecione este alerta para receber uma notificação quando a execução do fluxo de dados começar.
  • Êxito na Execução do Fluxo de Dados de Fontes: selecione este alerta para receber uma notificação se o fluxo de dados terminar sem erros.
  • Falha na execução do fluxo de dados de fontes: selecione este alerta para receber uma notificação se a execução do fluxo de dados terminar com erros.

Quando terminar, selecione Avançar para continuar.

Mapear campos para um esquema XDM mapping

A etapa Mapping é exibida. Use a interface de mapeamento para mapear os dados de origem para os campos de esquema apropriados antes de assimilar esses dados no Experience Platform. Para obter um guia abrangente sobre como usar a interface de mapeamento, leia o guia da interface do usuário do Preparo de Dados para obter mais informações.

A interface de mapeamento do fluxo de trabalho de origens.

Configurar programação de assimilação scheduling

Em seguida, use a interface de programação para criar uma programação de assimilação para o fluxo de dados.

Selecione a lista suspensa de frequência para configurar a frequência de assimilação do fluxo de dados.

O menu suspenso de frequência.

Você também pode selecionar o ícone de calendário e usar um calendário pop-up para configurar a hora de início da assimilação.

O calendário configurável para agendamento.

Configuração de agendamento
Descrição
Frequência

Configure a frequência para indicar a frequência de execução do fluxo de dados. Você pode definir a frequência como:

  • Uma vez: defina sua frequência como once para criar uma assimilação única. As configurações para intervalo e preenchimento retroativo não estão disponíveis ao criar um fluxo de dados de assimilação única. Por padrão, a frequência de agendamento é definida como uma vez.
  • Minuto: Defina sua frequência como minute para agendar seu fluxo de dados para assimilar dados por minuto.
  • Hora:Defina sua frequência como hour para agendar seu fluxo de dados para assimilar dados por hora.
  • Dia: Defina sua frequência como day para agendar seu fluxo de dados para assimilar dados por dia.
  • Semana: Defina sua frequência como week para agendar seu fluxo de dados para assimilar dados por semana.
Intervalo
Depois de selecionar uma frequência, você pode definir o intervalo para estabelecer o intervalo de tempo entre cada assimilação. Por exemplo, se você definir a frequência como dia e configurar o intervalo como 15, o fluxo de dados será executado a cada 15 dias. Observação: não é possível definir o intervalo como zero.
Hora de início
O carimbo de data e hora da execução projetada, apresentado no fuso horário UTC.
Preenchimento retroativo
O preenchimento retroativo determina quais dados são assimilados inicialmente. Se o preenchimento retroativo estiver ativado, todos os arquivos atuais no caminho especificado serão assimilados durante a primeira assimilação agendada. Se o preenchimento retroativo estiver desativado, somente os arquivos carregados entre a primeira execução da assimilação e a hora de início serão assimilados. Os arquivos carregados antes da hora de início não serão assimilados.

Depois de configurar o agendamento de assimilação do fluxo de dados, selecione Avançar.

A interface de agendamento do fluxo de trabalho de origens.

Revisar seu fluxo de dados

A etapa final no processo de criação do fluxo de dados é revisar o fluxo de dados antes de executá-lo. Use a etapa Revisão para revisar os detalhes do novo fluxo de dados antes de ele ser executado. Os detalhes estão agrupados nas seguintes categorias:

  • Conexão: mostra o tipo de origem, o caminho relevante do arquivo de origem escolhido e o número de colunas nesse arquivo de origem.
  • Atribuir campos de conjunto de dados e mapa: mostra em qual conjunto de dados os dados de origem estão sendo assimilados, incluindo o esquema ao qual o conjunto de dados pertence.
  • Agendamento: mostra o período, a frequência e o intervalo ativos do agendamento de assimilação.

Depois de revisar o fluxo de dados, selecione Concluir e aguarde algum tempo para que o fluxo de dados seja criado.

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

Próximas etapas

Seguindo este tutorial, você criou com êxito um fluxo de dados para trazer dados de pagamentos da sua origem Stripe para o Experience Platform. Para obter recursos adicionais, consulte a documentação descrita abaixo.

Monitorar seu fluxo de dados

Depois que o fluxo de dados for criado, você poderá monitorar os dados que estão sendo assimilados por meio dele para exibir informações sobre taxas de assimilação, sucesso e erros. Para obter mais informações sobre como monitorar o fluxo de dados, visite o tutorial em monitoramento de contas e fluxos de dados na interface.

Atualizar seu fluxo de dados

Para atualizar as configurações do agendamento de fluxos de dados, mapeamento e informações gerais, visite o tutorial em atualizando fluxos de dados de fontes na interface.

Excluir seu fluxo de dados

Você pode excluir fluxos de dados que não são mais necessários ou que foram criados incorretamente usando a função Excluir disponível no espaço de trabalho Fluxos de Dados. Para obter mais informações sobre como excluir fluxos de dados, visite o tutorial em excluindo fluxos de dados na interface.

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