Baixando, armazenando e atualizando automaticamente o artefato de regra por meio do SDK Adobe Target
Essa abordagem é melhor quando você pode inicializar o SDK do Adobe Target ao mesmo tempo em que inicializa e inicia o servidor Web. O artefato da regra será baixado pelo SDK do Adobe Target e armazenado em cache na memória antes que o aplicativo do servidor Web inicie a veiculação de solicitações. Quando o aplicativo Web estiver em execução, todas as decisões do Adobe Target serão executadas usando o artefato de regra na memória. O artefato da regra em cache será atualizado com base no pollingInterval
especificado durante a etapa de inicialização do SDK.
Resumo das etapas
- Instalar o SDK
- Inicializar o SDK
- Armazenar e usar o artefato de regra
1. Instalar o SDK
code language-javascript line-numbers |
---|
|
code language-javascript line-numbers |
---|
|
2. Inicializar o SDK
-
Primeiro, importe o SDK. Importar para o mesmo arquivo a partir do qual você pode controlar a inicialização do servidor.
Node.js
code language-javascript line-numbers const TargetClient = require("@adobe/target-nodejs-sdk");
Java
code language-javascript line-numbers import com.adobe.target.edge.client.ClientConfig; import com.adobe.target.edge.client.TargetClient;
-
Para configurar o SDK, use o método de criação.
Node.js
code language-javascript line-numbers const CONFIG = { client: "<your target client code>", organizationId: "your EC org id", decisioningMethod: "on-device", pollingInterval : 300000, events: { clientReady: startWebServer } }; const TargetClient = TargetClient.create(CONFIG); function startWebServer() { //Adobe Target SDK has now downloaded the JSON Artifacts and is available in the memory. //You can start your web server now to serve requests now. }
Java
code language-javascript line-numbers ClientConfig config = ClientConfig.builder() .client("<you target client code>") .organizationId("<your EC org id>") .build(); TargetClient targetClient = TargetClient.create(config);
-
O cliente e a organizationId podem ser recuperados de Adobe Target navegando até Administration > Implementation, como mostrado aqui.
<!— Inserir image-client-code.png —>
3. Armazene e use o artefato de regra
Não é necessário gerenciar o artefato da regra por conta própria e chamar os métodos do SDK deve ser simples.
code language-javascript line-numbers |
---|
|
code language-java line-numbers |
---|
|
TargetClient
contém uma referência ao artefato de regra na memória. Quando você usa esse objeto para chamar métodos SDK padrão, ele usa o artefato da regra na memória para a tomada de decisão. Se o aplicativo estiver estruturado de modo que você precise chamar os métodos SDK em arquivos diferentes daquele que inicializa e escuta as solicitações do cliente, e se esses arquivos não tiverem acesso ao objeto TargetClient, você poderá baixar a carga JSON e armazená-la em um arquivo JSON local para ser consumido em outros arquivos, que precisam inicializar o SDK. Isso é explicado na próxima seção, em relação ao download do artefato de regra usando uma carga JSON.Este é um exemplo que inicia um aplicativo Web após inicializar o SDK Adobe Target.
code language-javascript line-numbers |
---|
|
code language-java line-numbers |
---|
|