Beta
Testar e enviar sua origem
Criado para:
- Desenvolvedor
As etapas finais para integrar sua nova fonte à Adobe Experience Platform usando Fontes de autoatendimento (SDK de transmissão) são testar e enviar sua nova fonte. Depois de concluir a especificação de conexão e atualizar a especificação do fluxo de transmissão, você pode começar a testar a funcionalidade da fonte por meio da API ou da interface do usuário. Depois de obter sucesso, você pode enviar sua nova fonte entrando em contato com o representante da Adobe.
O documento a seguir fornece etapas sobre como testar e depurar sua origem usando a Flow Service API.
Introdução
- Para obter informações sobre como fazer chamadas para APIs do Experience Platform com êxito, consulte o manual sobre introdução às APIs do Experience Platform.
- Para obter informações sobre como gerar suas credenciais para as APIs do Experience Platform, consulte o tutorial sobre autenticação e acesso às APIs do Experience Platform.
- Para obter informações sobre como configurar o Postman para APIs do Experience Platform, consulte o tutorial em configuração do console do desenvolvedor e Postman.
- Para ajudar no processo de teste e depuração, baixe a coleção e o ambiente de verificação de Fontes de Autoatendimento aqui e siga as etapas descritas abaixo.
Testar sua fonte usando a API
Para testar sua fonte usando a API, você deve executar a coleção e o ambiente de verificação de Fontes de Autoatendimento em Postman enquanto fornece as variáveis de ambiente apropriadas que pertencem à sua fonte.
Para iniciar o teste, primeiro você deve configurar a coleção e o ambiente em Postman. Em seguida, especifique a ID de especificação de conexão que deseja testar.
flowSpecificationId
e targetConnectionSpecId
, que são valores fixos.x-api-key
x-api-key
.c8d9a2f5c1e03789bd22e8efdd1bdc1b
x-gw-ims-org-id
x-gw-ims-org-id
.ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
authorizationToken
authorizationToken
.Bearer authorizationToken
schemaId
https://ns.adobe.com/{TENANT_ID}.schemas.0ef4ce0d390f0809fad490802f53d30b
schemaVersion
application/vnd.adobe.xed-full-notext+json; version=1
schemaAltId
meta:altId
que é retornado com o schemaId
ao criar um novo esquema._{TENANT_ID}.schemas.0ef4ce0d390f0809fad490802f53d30b
dataSetId
5f3c3cedb2805c194ff0b69a
mappings
[{"destinationXdmPath":"person.name.firstName","sourceAttribute":"email.email_id","identity":false,"version":0},{"destinationXdmPath":"person.name.lastName","sourceAttribute":"email.activity.action","identity":false,"version":0}]
mappingId
bf5286a9c1ad4266baca76ba3adc9366
connectionSpecId
2e8580db-6489-4726-96de-e33f5f60295f
flowSpecificationId
GenericStreamingAEP
. Valor fixo.e77fde5a-22a8-11ed-861d-0242ac120002
targetConnectionSpecId
c604ff05-7f1a-43c0-8e18-33bf874cb11c
verifyWatTimeInSecond
40
startTime
1597784298
Depois de fornecer todas as variáveis de ambiente, você pode começar a executar a coleção usando a interface Postman. Na interface Postman, selecione as reticências (…) ao lado de Sources SSSs Verification Collection e selecione Executar coleção.
A interface Runner é exibida, permitindo configurar a ordem de execução do fluxo de dados. Selecione Executar Coleção de Verificação de SSS para executar a coleção.
Testar sua fonte usando a interface do
Para testar sua origem na interface do usuário, acesse o catálogo de origens da sandbox da sua organização na interface do usuário do Experience Platform. Aqui, você deve ver sua nova fonte na categoria Streaming.
Com a nova fonte agora disponível na sandbox, você deve seguir o fluxo de trabalho de fontes para testar as funcionalidades. Para começar, selecione Configurar.
A etapa Adicionar dados é exibida. Para testar se a fonte pode transmitir dados, use o lado esquerdo da interface para carregar uma amostra de dados JSON. Depois que os dados forem carregados, o lado direito da interface será atualizado para uma pré-visualização da hierarquia de arquivos dos dados. Selecione Avançar para continuar.
A página Detalhes do fluxo de dados permite selecionar se você deseja usar um conjunto de dados existente ou um novo conjunto de dados. Durante esse processo, você também pode configurar seus dados para serem assimilados no Perfil e habilitar configurações como Diagnóstico de erro e Assimilação parcial.
Para testes, selecione Novo conjunto de dados e forneça um nome de conjunto de dados de saída. Durante essa etapa, também é possível fornecer uma descrição opcional para adicionar mais informações ao conjunto de dados. Em seguida, selecione um esquema para mapear usando a opção Pesquisa avançada ou rolando pela lista de esquemas existentes no menu suspenso. Depois de selecionar um esquema, forneça um nome e uma descrição para o fluxo de dados.
Quando terminar, selecione Próximo.
A etapa 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.
O Experience 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 como usar a interface do mapeador e campos calculados, consulte o guia da interface do Preparo de Dados
Depois que os dados de origem forem mapeados com êxito, selecione Próximo.
A etapa 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: exibe o nome da sua conta, o tipo de origem e outras informações diversas específicas para a fonte de armazenamento da nuvem de streaming que você está usando.
- Atribuir conjunto de dados e mapear campos: exibe o conjunto de dados e o esquema de destino que você está usando para o fluxo de dados.
Depois de revisar o fluxo de dados, selecione Concluir e aguarde algum tempo para que o fluxo de dados seja criado.
Por fim, você deve recuperar o ponto de extremidade de transmissão do fluxo de dados. Esse endpoint será usado para assinar seu webhook, permitindo que a fonte de streaming se comunique com o Experience Platform. Para recuperar o ponto de extremidade de streaming, vá para a página Atividade de fluxo de dados do fluxo de dados que você acabou de criar e copie o ponto de extremidade da parte inferior do painel Propriedades.
Enviar sua fonte
Assim que a origem puder concluir todo o fluxo de trabalho, você poderá continuar a entrar em contato com o representante da Adobe e enviar a origem para integração em outras organizações da Experience Platform.