ÃÛ¶¹ÊÓƵ

DocumentationTargetTarget Developer Guide

Rule artifact overview

Last update: Mon Jul 17 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Developer

The rule artifact is a JSON representation of your ÃÛ¶¹ÊÓƵ Target on-device decisioning activities. It is generated by ÃÛ¶¹ÊÓƵ Target and propagated to the Akamai CDN to ensure there is a rule artifact available as close as possible to your end users. It contains metadata that ensures precise execution and delivery of your activities, while also allowing for real-time analytics via event tracking. The ÃÛ¶¹ÊÓƵ Target SDKs can be configured in a way that allows for automatic management of the rule artifact, by which it may be downloaded or updated according to a user-specified time interval. Furthermore, you can also maintain your own local copy of the rule artifact using a distributed memory caching system like to initialize the ÃÛ¶¹ÊÓƵ Target SDK, so your stateless servers can serve requests immediately. To learn more about these options, reference the following guides:

Example rule artifact

Click here for an example of the rule artifact.

How to view the rule artifact for your client

Enabling traces will output additional information from ÃÛ¶¹ÊÓƵ Target in regards to the rule artifact, specifically the URL.

  1. Navigate to the Target UI.

    alt image

  2. Navigate to Administration > Implementation and click Generate New Authorization Token.

    alt image

  3. Copy the newly generated authorization token to the clipboard and add it to your Target request.

    code language-javascript line-numbers 
       const request = {
  trace: {
    authorizationToken: '88f1a924-6bc5-4836-8560-2f9c86aeb36b'
  },
  execute: {
    mboxes: [{
      address: getAddress(req),
      name: "node-sdk-mbox"
    }]
}};

  4. Output the Target Trace via the terminal to view details about the artifact. The URL is accessible via the artifactLocation variable.

    code language-none 
    "trace": {
  "clientCode": "your-client-code",
  "artifact": {
    "artifactLocation": "https://assets.adobetarget.com/your-client-code/production/v1/rules.bin",
    "pollingInterval": 300000,
    "pollingHalted": false,
    "artifactVersion": "1.0.0",
    "artifactRetrievalCount": 10,
    "artifactLastRetrieved": "2020-09-20T00:09:42.707Z",
     "clientCode": "your-client-code",
   "environment": "production",
    "generatedAt": "2020-09-22T17:17:59.783Z"
  },
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3