Neste exercício, você criará uma fonte de dados externa personalizada usando o Adobe Journey Optimizer.
Faça logon no Adobe Journey Optimizer acessando Adobe Experience Cloud. Clique em Journey Optimizer.
Você será redirecionado para a exibição Início no Journey Optimizer.
Primeiro, certifique-se de usar a sandbox correta. A sandbox a ser usada é chamada de --aepSandboxId--
. Para alterar de uma sandbox para outra, clique em PRODUCTION Prod (VA7) e selecione a sandbox da lista. Neste exemplo, a sandbox é chamada de AEP Enablement FY21.
Em seguida, você estará na exibição Início da sandbox --aepSandboxId--
.
No menu esquerdo, role para baixo e clique em Configurations. Em seguida, clique no botão Gerenciar em Fontes de Dados.
Você verá a lista Fontes de Dados.
Clique em Criar fonte de dados para começar a adicionar a fonte de dados.
Você verá um pop-up de fonte de dados vazio.
Antes de começar a configurar isso, você precisará de uma conta com o serviço Open Weather Map. Siga estas etapas para criar sua conta e obter a chave de API.
Vá para https://openweathermap.org/. Na página inicial, clique em Fazer logon.
Clique em Criar uma conta.
Preencha os detalhes.
Clique em Criar conta.
Em seguida, você será redirecionado para a sua Página da conta.
No menu, clique em Chaves de API para recuperar a chave de API, que será necessário para configurar a fonte de dados externa personalizada.
Uma Chave da API tem esta aparência: b2c4c36b6bb59c3458d6686b05311dc3
.
Você pode encontrar a Documentação da API para o Tempo atual aqui.
No nosso caso de uso, implementaremos a conexão com o Open Weather Map com base na cidade em que o cliente está.
Volte para Adobe Journey Optimizer, para seu pop-up vazio Fonte de Dados Externa.
Como um Nome para a fonte de dados, use ldapWeatherApi
e substitua Ldap
por seu LDAP. Neste exemplo, o Nome da fonte de dados é vangeluwWeatherApi
.
Defina Descrição como: Access to the Open Weather Map
.
O URL para a API do mapa de tempo aberto é: http://api.openweathermap.org/data/2.5/weather?units=metric
Em seguida, é necessário selecionar a Autenticação a ser usada.
Use estas variáveis:
Campo | Valor |
---|---|
Tipo | Chave de API |
Nome | APPID |
Valor | sua chave de API |
Localização | Parâmetro de consulta |
Por fim, é necessário definir um FieldGroup, que é basicamente a solicitação que você enviará para a API do Tempo. No nosso caso, queremos usar o nome da Cidade para solicitar o Tempo Atual para aquela Cidade.
De acordo com a Documentação da API de tempo, precisamos enviar um parâmetro q=City
.
Para corresponder à Solicitação de API esperada, configure o FieldGroup da seguinte maneira:
O nome do grupo de campos deve ser exclusivo. Use esta convenção de nomenclatura: ldapWeatherByCity
portanto, nesse caso, o nome deve ser vangeluwWeatherByCity
Para a Carga de Resposta, é necessário colar um exemplo da Resposta que será enviada pela API de Tempo.
Você pode encontrar a Resposta JSON da API esperada na página Documentação da API aqui.
Ou você pode copiar a Resposta JSON daqui:
{"coord": { "lon": 139,"lat": 35},
"weather": [
{
"id": 800,
"main": "Clear",
"description": "clear sky",
"icon": "01n"
}
],
"base": "stations",
"main": {
"temp": 281.52,
"feels_like": 278.99,
"temp_min": 280.15,
"temp_max": 283.71,
"pressure": 1016,
"humidity": 93
},
"wind": {
"speed": 0.47,
"deg": 107.538
},
"clouds": {
"all": 2
},
"dt": 1560350192,
"sys": {
"type": 3,
"id": 2019346,
"message": 0.0065,
"country": "JP",
"sunrise": 1560281377,
"sunset": 1560333478
},
"timezone": 32400,
"id": 1851632,
"name": "Shuzenji",
"cod": 200
}
Copie a resposta JSON acima para a área de transferência e vá para a tela de configuração personalizada da fonte de dados.
Clique no ícone Editar Carga.
Você verá um pop-up em que agora precisa colar a Resposta JSON acima.
Cole a resposta JSON, depois disso você verá isso. Clique em Salvar.
A configuração personalizada da fonte de dados foi concluída. Role para cima e clique em Save.
Sua fonte de dados agora foi criada com êxito e faz parte da lista Fontes de dados.
Próxima etapa: 12.3 Definir uma ação personalizada