Felsökning av on-device decisioning

Verifierar konfiguration

Sammanfattning av steg

1. Kontrollera att loggaren är konfigurerad

När du initierar SDK måste du aktivera loggning.

Node.js

Ett logger-objekt måste anges för Node.js SDK.

const CONFIG = {
  client: "<your client code>",
  organizationId: "<your organization ID>",
  logger: console
};

Java SDK

Java SDK logRequests på ClientConfig ska aktiveras.

ClientConfig config = ClientConfig.builder()
  .client("<your client code>")
  .organizationId("<your organization ID>")
  .logRequests(true)
  .build();

Dessutom bör JVM startas med följande kommandoradsparameter:

java -Dorg.slf4j.simpleLogger.defaultLogLevel=DEBUG ...

2. Kontrollera att TargetSpår är aktiverat

Om du aktiverar spårningar genereras ytterligare information från Adobe Target med avseende på regelartefakten.

3. Verifiera att on-device decisioning regelartefakt har hämtats och cachelagrats enligt det definierade avsökningsintervallet.

4. Validera innehållsleverans via den cachelagrade regelartefakten genom att skapa en on-device decisioning-testaktivitet via den formulärbaserade upplevelsedispositionen

Meddelandefel för Inspect

När du använder On-device-beslut skickas meddelanden automatiskt för getOffers-körningsbegäranden. Dessa förfrågningar skickas tyst i bakgrunden. Eventuella fel kan kontrolleras genom att prenumerera på en händelse med namnet sendNotificationError. Här följer ett kodexempel som visar hur du prenumererar på meddelandefel med hjälp av Node.js SDK.

const TargetClient = require("@adobe/target-nodejs-sdk");
let client;

function onSendNotificationError({ notification, error }) {
  console.log(
    `There was an error when sending a notification: ${error.message}`
  );
  console.log(`Notification Payload: ${JSON.stringify(notification, null, 2)}`);
}

async function targetClientReady() {
  const request = {
    context: { channel: "web" },
    execute: {
      mboxes: [{
        name: "a1-serverside-ab",
        index: 1
      }]
    }
  };
  const targetResponse = await client.getOffers({ request });
}

client = TargetClient.create({
  events: {
    clientReady: targetClientReady,
    sendNotificationError: onSendNotificationError
  }
});

Vanliga felsökningsscenarier

Granska funktioner som stöds för on-device decisioning när du stöter på problem.

Beslutsaktiviteter på enheten körs inte på grund av målgrupp eller aktivitet som inte stöds

Ett vanligt problem som kan uppstå är att on-device decisioning aktiviteter inte körs på grund av att målgruppen används eller att aktivitetstypen inte stöds.

(1) Använd loggningsutdata för att granska posterna i egenskapen trace i ditt svarsobjekt. Identifiera kampanjegenskapen:

Kalkera utdata

  "execute": {
  "mboxes": [
    {
      "name": "your-mbox-name",
      "index": 0,
      "trace": {
        "clientCode": "your-client-code",
        ...
        "campaigns": [],
        ...
      }
    }

Du kommer att märka att aktiviteten som du försöker kvalificera dig för inte finns i egenskapen campaigns eftersom målgrupps- eller aktivitetstypen inte stöds. Om aktiviteten listas under egenskapen campaigns beror ditt problem inte på en målgrupp eller aktivitetstyp som inte stöds.

(2) Leta reda på filen rules.json genom att titta på trace > artifact > artifactLocation i loggutdata och observera att din aktivitet saknas i egenskapen rules > mboxes:

Loggningsutdata

 ...
 rules: {
   mboxes: { },
   views: { }
 }

Till sist går du till Targetanvändargränssnittet och letar upp aktiviteten i fråga: experience.adobe.com/target

Granska reglerna som används i publiken och se till att du bara använder de som stöds. Kontrollera dessutom att aktivitetstypen är A/B eller XT.

Beslutsaktiviteter på enheten körs inte på grund av okvalificerad publik

Om en beslutsaktivitet på enheten inte körs, men du har verifierat att filen rules.json innehåller aktiviteten, ska du utföra följande steg:

(1) Se till att mbox du kör i programmet är samma som aktiviteten använder:

 ...
 rules: {
   mboxes: {
    target-only-node-sdk-mbox: [{ // this mbox name must match the mbox in your request
      ...
    }]
   }
 ...

 const request = {
   trace: {
     authorizationToken: '2dfc1dce-1e58-4e05-bbd6-a6725893d4d6'
   },
   execute: {
     mboxes: [{
       address: getAddress(req),
       name: "target-only-node-sdk-mbox-two" // this mbox name must match the mbox the activity is using
     }]
   }};

Context context = new Context()
  .channel(ChannelType.WEB);
MboxRequest mbox = new MboxRequest()
  .name("target-only-node-sdk-mbox-two")
  .index(0);
ExecuteRequest executeRequest = new ExecuteRequest()
  .mboxes(Arrays.asList(mbox));

TargetDeliveryRequest request = TargetDeliveryRequest.builder()
  .context(context)
  .decisioningMethod(DecisioningMethod.ON_DEVICE)
  .execute(executeRequest)
  .build();

TargetDeliveryResponse response = targetClient.getOffers(request);

(2) Se till att du är kvalificerad för målgruppen för din aktivitet genom att granska egenskapen matchedRuleConditions eller unmatchedRuleConditions för dina trace-utdata:

Kalkera utdata

...
},
"campaignId": 368564,
"campaignType": "landing",
"matchedSegmentIds": [],
"unmatchedSegmentIds": [
  6188838
      ],
      "matchedRuleConditions": [],
          "unmatchedRuleConditions": [
            {
              "in": [
                "true",
                {
                  "var": "mbox.auth_lc"
                }
              ]
            }
          ]
    ...

Om du har oöverträffade regelvillkor är du inte kvalificerad för aktiviteten och aktiviteten kommer därför inte att köras. Granska reglerna för er målgrupp för att se varför ni inte är kvalificerade.

Beslutsaktiviteten på enheten körs inte, men orsaken är inte uppenbar

Det kanske inte är uppenbart varför en beslutsaktivitet på enheten inte utförs. I det här fallet följer du dessa felsökningssteg för att identifiera problemet:

(1) Läs igenom loggspårningsutdata i konsolen och identifiera artefaktegenskapen som ser ut ungefär som följande:

Kalkera utdata

...
      "artifact": {
          "artifactLocation": "https://assets.adobetarget.com/your-client-code/production/v1/rules.json",
          "pollingInterval": 300000,
          "pollingHalted": false,
          "artifactVersion": "1.0.0",
          "artifactRetrievalCount": 3,
          "artifactLastRetrieved": "2020-10-16T00:56:27.596Z",
          "clientCode": "adobeinterikleisch",
          "environment": "production"
        },
...

Titta på artefaktens artifactLastRetrieved-datum och se till att du har den senaste rules.json-filen hämtad till din app.

(2) Hitta egenskapen evaluatedCampaignTargets i loggutdata:

Loggningsutdata

...
  "evaluatedCampaignTargets": [
      {
        "context": {
          "current_timestamp": 1602812599608,
          "current_time": "0143",
          "current_day": 5,
          "user": {
            "browserType": "unknown",
            "platform": "Unknown",
            "locale": "en",
            "browserVersion": -1
          },
          "page": {
            "url": "localhost:3000/",
            "path": "/",
            "query": "",
            "fragment": "",
            "subdomain": "",
            "domain": "3000",
            "topLevelDomain": "",
            "url_lc": "localhost:3000/",
            "path_lc": "/",
            "query_lc": "",
            "fragment_lc": "",
            "subdomain_lc": "",
            "domain_lc": "3000",
            "topLevelDomain_lc": ""
          },
          "referring": {
            "url": "localhost:3000/",
            "path": "/",
            "query": "",
            "fragment": "",
            "subdomain": "",
            "domain": "3000",
            "topLevelDomain": "",
            "url_lc": "localhost:3000/",
            "path_lc": "/",
            "query_lc": "",
            "fragment_lc": "",
            "subdomain_lc": "",
            "domain_lc": "3000",
            "topLevelDomain_lc": ""
          },
          "geo": {},
          "mbox": {},
          "allocation": 23.79
        },
        "campaignId": 368564,
        "campaignType": "landing",
        "matchedSegmentIds": [],
        "unmatchedSegmentIds": [
          6188838
        ],
        "matchedRuleConditions": [],
        "unmatchedRuleConditions": [
          {
            "in": [
              "true",
              {
                "var": "mbox.auth_lc"
              }
            ]
          }
        ]
...

(3) Granska context-, page- och referring-data för att säkerställa att de är så förväntade som detta kan påverka aktivitetens målinriktningskvalifikation.

(4) Granska campaignId för att kontrollera att aktiviteten eller aktiviteterna som du väntar dig att köra utvärderas. campaignId matchar aktivitets-ID på aktivitetsöversiktsfliken i Targetgränssnittet:

(5) Granska matchedRuleConditions och unmatchedRuleConditions för att identifiera problem med kvalificering för målgruppsregler för en viss aktivitet.

(6) Granska den senaste rules.json-filen för att kontrollera att aktiviteten eller aktiviteterna som du vill köra lokalt ingår. Platsen anges ovan i steg 1.

(7) Se till att du använder samma mbox-namn i din begäran och dina aktiviteter.

(8) Se till att du använder målgruppsregler och aktivitetstyper som stöds.

Ett serveranrop görs trots att aktivitetsinställningarna under en mbox säger "Enhetsbeslut är valbart" i användargränssnittet i Target

Det finns några skäl till att ett serveranrop görs trots att enheten är berättigad till enhetsbeslut: