Hämtar, lagrar och uppdaterar regelfelaktigheten automatiskt via SDK:n Adobe Target
- Ämnen:
- APIs/SDKs
Skapat för:
- Utvecklare
Det här arbetssättet är bäst när du kan initiera SDK:n för Adobe Target samtidigt som du initierar och startar webbservern. Regelartefakten hämtas av Adobe Target SDK och cachas i minnet innan webbserverprogrammet börjar bearbeta begäranden. När webbprogrammet är igång och körs kommer alla Adobe Target-beslut att köras med hjälp av minnesregelartefakten. Den cachelagrade regelartefakten uppdateras baserat på den pollingInterval
som du angav under SDK-initieringssteget.
Sammanfattning av steg
- Installera SDK
- Initiera SDK
- Lagra och använd regelartefakt
1. Installera SDK
npm i @adobe/target-nodejs-sdk -P
<dependency>
<groupId>com.adobe.target</groupId>
<artifactId>java-sdk</artifactId>
<version>1.0</version>
</dependency>
2. Initiera SDK
-
Importera först SDK:n. Importera till samma fil som du kan styra serverstarten från.
Node.js
const TargetClient = require("@adobe/target-nodejs-sdk");
Java
import com.adobe.target.edge.client.ClientConfig; import com.adobe.target.edge.client.TargetClient;
-
Använd metoden create för att konfigurera SDK.
Node.js
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
ClientConfig config = ClientConfig.builder() .client("<you target client code>") .organizationId("<your EC org id>") .build(); TargetClient targetClient = TargetClient.create(config);
-
Du kan hämta både klient- och OrganizationId från Adobe Target genom att gå till Administration > Implementation, vilket visas här.
<!— Insert image-client-code.png —>
3. Lagra och använda regelartefakt
Du behöver inte hantera regelfelaktigheten själv och det ska vara enkelt att anropa SDK-metoderna.
//req is the request object from the server request listener method
const targetCookie = req.cookies[TargetClient.TargetCookieName];
const request = {
context: {
channel: "web"
},
execute: {
mboxes: [{
address: { url: req.headers.host + req.originalUrl },
name: "on-device-homepage-banner"
}],
},
};
TargetClient.getOffers({
request,
targetCookie
}).then(function(response) {
//This Target response is coming from the In-memory Target artifact.
console.log("Target response", response);
}).catch(function(err) {
console.error("Target:", err);
})
MboxRequest mbox = new MboxRequest().name("homepage").index(0);
TargetDeliveryRequest request = TargetDeliveryRequest.builder()
.context(new Context().channel(ChannelType.WEB))
.execute(new ExecuteRequest().mboxes(Arrays.asList(mbox)))
.build();
TargetDeliveryResponse response = targetClient.getOffers(request);
TargetClient
en referens till artefakten i minnesregeln. När du använder det här objektet för att anropa SDK-standardmetoder används artefakten i minnet för att fatta beslut. Om ditt program är strukturerat så att du måste anropa SDK-metoderna i andra filer än den som initierar och lyssnar på klientförfrågningar, och om dessa filer inte har tillgång till TargetClient-objektet, kan du hämta JSON-nyttolasten och lagra den i en lokal JSON-fil som ska användas på andra filer som måste initiera SDK. Detta förklaras i nästa avsnitt om att hämta regelartefakten med JSON-nyttolast.Här är ett exempel som startar ett webbprogram efter att SDK:n Adobe Target har initierats.
const express = require("express");
const cookieParser = require("cookie-parser");
const TargetClient = require("@adobe/target-nodejs-sdk");
const CONFIG = {
client: "<your target client code>",
organizationId: "your EC org id",
decisioningMethod: "on-device",
pollingInterval : 300000,
events: {
clientReady: startWebServer
}
};
const app = express();
const targetClient = TargetClient.create(CONFIG);
app.use(cookieParser());
function saveCookie(res, cookie) {
if (!cookie) {
return;
}
res.cookie(cookie.name, cookie.value, {maxAge: cookie.maxAge * 1000});
}
const getResponseHeaders = () => ({
"Content-Type": "text/html",
"Expires": new Date().toUTCString()
});
function sendSuccessResponse(res, response) {
res.set(getResponseHeaders());
saveCookie(res, response.targetCookie);
res.status(200).send(response);
}
function sendErrorResponse(res, error) {
res.set(getResponseHeaders());
res.status(500).send(error);
}
function startWebServer() {
app.get('/*', async (req, res) => {
const targetCookie = req.cookies[TargetClient.TargetCookieName];
const request = {
execute: {
mboxes: [{
address: { url: req.headers.host + req.originalUrl },
name: "on-device-homepage-banner" // Ensure that you have a LIVE Activity running on this location
}]
}};
try {
const response = await targetClient.getOffers({ request, targetCookie });
sendSuccessResponse(res, response);
} catch (error) {
console.error("Target:", error);
sendErrorResponse(res, error);
}
});
app.listen(3000, function () {
console.log("Listening on port 3000 and watching!");
});
}
import com.adobe.target.edge.client.ClientConfig;
import com.adobe.target.edge.client.TargetClient;
import com.adobe.target.delivery.v1.model.ChannelType;
import com.adobe.target.delivery.v1.model.Context;
import com.adobe.target.delivery.v1.model.ExecuteRequest;
import com.adobe.target.delivery.v1.model.MboxRequest;
import com.adobe.target.edge.client.entities.TargetDeliveryRequest;
import com.adobe.target.edge.client.model.TargetDeliveryResponse;
@Controller
public class TargetController {
private TargetClient targetClient;
TargetController() {
// You should instantiate TargetClient in a Bean and inject the instance into this class
// but we show the code here for demonstration purpose.
ClientConfig config = ClientConfig.builder()
.client("<you target client code>")
.organizationId("<your EC org id>")
.build();
targetClient = TargetClient.create(config);
}
@GetMapping("/")
public String homePage() {
MboxRequest mbox = new MboxRequest().name("homepage").index(0);
TargetDeliveryRequest request = TargetDeliveryRequest.builder()
.context(new Context().channel(ChannelType.WEB))
.execute(new ExecuteRequest().mboxes(Arrays.asList(mbox)))
.build();
TargetDeliveryResponse response = targetClient.getOffers(request);
// ...
}
}