[Beta]{class="badge informative"}
Assimilar dados de pagamentos de sua conta Stripe para o Experience Platform usando a interface do usuário
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:
-
Experience Data Model (XDM) Sistema: a estrutura padronizada pela qual o Experience Platform organiza os dados de experiência do cliente.
- Noções básicas sobre a composição de esquema: saiba mais sobre os blocos de construção básicos de esquemas XDM, incluindo princípios-chave e práticas recomendadas na composição de esquema.
- Tutorial do Editor de esquemas: saiba como criar esquemas personalizados usando a interface do Editor de esquemas.
-
Real-Time Customer Profile: Fornece um perfil de consumidor unificado em tempo real com base em dados agregados de várias fontes.
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.
A página Conectar conta Stripe é exibida. Nesta página, você pode usar credenciais novas ou existentes.
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.
| 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. |
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.
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
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.
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.
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.
| 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. |
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.
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.
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.
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.
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.
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
oncepara 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
minutepara agendar seu fluxo de dados para assimilar dados por minuto. - Hora: Defina sua frequência como
hourpara agendar seu fluxo de dados para assimilar dados por hora. - Dia: Defina sua frequência como
daypara agendar seu fluxo de dados para assimilar dados por dia. - Semana: Defina sua frequência como
weekpara agendar seu fluxo de dados para assimilar dados por semana.
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. Você não pode definir o intervalo como zero. O valor mínimo de intervalo aceito para cada frequência é o seguinte:
- Uma vez: n/d
- Minuto: 15
- Hora: 1
- Dia: 1
- Semana: 1
Depois de configurar o agendamento de assimilação do fluxo de dados, selecione Avançar.
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.
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.