DocumentaçãoExperience PlatformGuia dos conectores de origem

Enviar sua fonte

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Desenvolvedor

A etapa final para integrar sua nova origem ao Adobe Experience Platform usando Fontes de autoatendimento (SDK em lote) é testar sua origem para verificação. Depois de bem-sucedido, 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

Testar sua origem

Para testar sua fonte, 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.

Especificar authSpecName

Depois de inserir a ID de especificação de conexão, você deve especificar o authSpecName que está usando para a conexão base. Dependendo da sua escolha, pode ser OAuth 2 Refresh Code ou Basic Authentication. Depois de especificar o authSpecName, você deve incluir suas credenciais necessárias no ambiente. Por exemplo, se você especificar authSpecName como OAuth 2 Refresh Code, deverá fornecer as credenciais necessárias para o OAuth 2, que são host e accessToken.

Especificar sourceSpec

Com os parâmetros de especificação de autenticação adicionados, você deverá adicionar as propriedades necessárias da especificação de origem. Você pode encontrar as propriedades necessárias em sourceSpec.spec.properties. No caso do exemplo de MailChimp Members abaixo, a única propriedade necessária é listId, o que significa listId e seu valor de ID correspondente ao seu ambiente Postman.

"spec": {
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "description": "Define user input parameters to fetch resource values.",
  "properties": {
    "listId": {
      "type": "string",
      "description": "listId for which members need to fetch."
    }
  }
}

Depois que os parâmetros de autenticação e especificação de origem forem fornecidos, você poderá começar a preencher o restante das variáveis de ambiente. Consulte a tabela abaixo para obter referência:

NOTE
Todas as variáveis de exemplo abaixo são valores de espaço reservado que você deve atualizar, exceto para flowSpecificationId e targetConnectionSpecId, que são valores fixos.
Parâmetro
Descrição
Exemplo
x-api-key
Um identificador exclusivo usado para autenticar chamadas para APIs Experience Platform. Consulte o tutorial sobre autenticação e acesso às APIs do Experience Platform para obter informações sobre como recuperar o x-api-key.
c8d9a2f5c1e03789bd22e8efdd1bdc1b
x-gw-ims-org-id
Uma entidade corporativa que pode ser proprietária ou licenciar produtos e serviços e permitir acesso a seus membros. Consulte o tutorial em configuração do console do desenvolvedor e Postman para obter instruções sobre como recuperar as informações de x-gw-ims-org-id.
ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
authorizationToken
O token de autorização necessário para completar chamadas para APIs de Experience Platform. Consulte o tutorial sobre autenticação e acesso às APIs do Experience Platform para obter informações sobre como recuperar o authorizationToken.
Bearer authorizationToken
schemaId
Para que os dados de origem sejam usados na Platform, um esquema de destino deve ser criado para estruturar os dados de origem de acordo com suas necessidades. Para obter etapas detalhadas sobre como criar um esquema XDM de destino, consulte o tutorial sobre criação de um esquema usando a API.
https://ns.adobe.com/{TENANT_ID}.schemas.0ef4ce0d390f0809fad490802f53d30b
schemaVersion
A versão exclusiva que corresponde ao esquema.
application/vnd.adobe.xed-full-notext+json; version=1
schemaAltId
O meta:altId que é retornado com o schemaId ao criar um novo esquema.
_{TENANT_ID}.schemas.0ef4ce0d390f0809fad490802f53d30b
dataSetId
Para obter etapas detalhadas sobre como criar um conjunto de dados de destino, consulte o tutorial sobre criação de um conjunto de dados usando a API.
5f3c3cedb2805c194ff0b69a
mappings
Os conjuntos de mapeamento podem ser usados para definir como os dados em um esquema de origem são mapeados para o de um esquema de destino. Para obter etapas detalhadas sobre como criar um mapeamento, consulte o tutorial sobre criação de um conjunto de mapeamento usando a API.
[{"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
O identificador exclusivo que corresponde ao seu conjunto de mapeamento.
bf5286a9c1ad4266baca76ba3adc9366
connectionSpecId
A ID de especificação de conexão que corresponde à sua origem. Esta é a ID gerada após criar uma nova especificação de conexão.
2e8580db-6489-4726-96de-e33f5f60295f
flowSpecificationId
A ID da especificação de fluxo de RestStorageToAEP. Valor fixo.
6499120c-0b15-42dc-936e-847ea3c24d72
targetConnectionSpecId
A ID de conexão de destino do data lake onde os dados assimilados chegam. Valor fixo.
c604ff05-7f1a-43c0-8e18-33bf874cb11c
verifyWatTimeInSecond
O intervalo de tempo designado a ser seguido ao verificar a conclusão de uma execução de fluxo.
40
startTime
A hora de início designada para seu fluxo de dados. A hora inicial deve ser formatada em hora unix.
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.

executor

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.

NOTE
Você pode desabilitar Excluir Fluxo da lista de verificação de ordem de execução se preferir usar o painel de monitoramento de fontes na interface do usuário da Platform. No entanto, após concluir o teste, é necessário garantir que os fluxos de teste sejam excluídos.

executar-coleção

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.

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