Documentación Guía para desarrolladores de Target

Resolución de problemas on-device decisioning

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Temas:
APIs/SDKs

Creado para:

Desarrollador

Validando configuración

Resumen de pasos

Asegúrese de que logger esté configurado
Asegúrese de que los seguimientos de Target estén habilitados
Compruebe que el on-device decisioning artefacto de regla se haya recuperado y almacenado en caché según el intervalo de sondeo definido.
Valide la entrega de contenido mediante el artefacto de reglas en caché creando una actividad de prueba on-device decisioning a través del compositor de experiencias basadas en formularios.
Inspect envía errores de notificación

1. Asegúrese de que el registrador esté configurado

Al inicializar el SDK, asegúrese de habilitar el registro.

Nodo.js

Para el SDK de Node.js, se debe proporcionar un objeto logger.

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

SDK de Java

Para el SDK de Java logRequests en ClientConfig debe estar habilitado.

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

Además, la JVM debe iniciarse con el siguiente parámetro de línea de comandos:

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

2. Asegúrese de que TargetTraces esté habilitado

Al habilitar los seguimientos, se generará información adicional de Adobe Target con respecto al artefacto de reglas.

Vaya a la Targetinterfaz de usuario de Experience Cloud.
Vaya a Administration > Implementation y haga clic en Generate New Authorization Token.

Copie el token de autorización recién generado al portapapeles y agréguelo a su Targetsolicitud:

Nodo.js

   const request = {
  trace: {
    authorizationToken: "88f1a924-6bc5-4836-8560-2f9c86aeb36b"
  },
  execute: {
    mboxes: [{
      name: "sdk-mbox"
    }]
}};

Java

   Trace trace = new Trace()
  .authorizationToken("88f1a924-6bc5-4836-8560-2f9c86aeb36b");
Context context = new Context()
  .channel(ChannelType.WEB);
MboxRequest mbox = new MboxRequest()
  .name("sdk-mbox")
  .index(0);
ExecuteRequest executeRequest = new ExecuteRequest()
  .mboxes(Arrays.asList(mbox));

TargetDeliveryRequest request = TargetDeliveryRequest.builder()
  .trace(trace)
  .context(context)
  .execute(executeRequest)
  .build();

Con el registrador y el seguimiento en su lugar, inicie la aplicación y supervise el terminal del servidor. El siguiente resultado del registrador confirma que se ha recuperado el artefacto de regla:

SDK de Node.js
AT: LD.ArtifactProvider fetching artifact - https://assets.adobetarget.com/your-client-code/production/v1/rules.json AT: LD.ArtifactProvider artifact received - status=200

3. Compruebe que el on-device decisioning artefacto de regla se haya recuperado y almacenado en caché según el intervalo de sondeo definido.

Espere la duración del intervalo de sondeo (el valor predeterminado es 20 minutos) y asegúrese de que el SDK esté recuperando el artefacto. Se generarán los mismos registros de terminal.

Además, la información del seguimiento TargetTrace debe enviarse al terminal con detalles sobre el artefacto de regla.

   "trace": {
  "clientCode": "your-client-code",
  "artifact": {
    "artifactLocation": "https://assets.adobetarget.com/your-client-code/production/v1/rules.json",
    "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"
  },

4. Valide la entrega de contenido mediante el artefacto de reglas en caché creando una actividad de prueba on-device decisioning a través del compositor de experiencias basadas en formularios

Vaya a la TargetIU en el Experience Cloud
Cree una nueva actividad XT con el Compositor de experiencias basadas en formularios.
Escriba el nombre de mbox utilizado en la solicitud Target como ubicación para la actividad XT (tenga en cuenta que debe ser un nombre de mbox único específicamente para fines de desarrollo).
Cambie el contenido a una oferta de HTML u oferta JSON. Esto se devolverá en la Targetsolicitud a su aplicación. Deje el objetivo de la actividad como "Todos los visitantes" y seleccione la métrica que desee. Asigne un nombre a la actividad, guárdela y actívela para asegurarse de que el mbox o la ubicación en uso solo sean aptos para el desarrollo.

En su aplicación, agregue instrucciones de registro para el contenido recibido en la respuesta de su Targetsolicitud

SDK de Node.js

   try {
  const response = await targetClient.getOffers({ request });
  console.log('Response: ', response.response.execute.mboxes[0].options[0].content);
} catch (error) {
  console.error('Something went wrong', error);
}

SDK de Java

   try {
  Context context = new Context()
    .channel(ChannelType.WEB);
  MboxRequest mbox = new MboxRequest()
    .name("sdk-mbox")
    .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);
  logger.debug("Response: ", response.getResponse().getExecute().getMboxes().get(0).getOptions().get(0).getContent());
} catch (Exception exception) {
  logger.error("Something went wrong", exception);
}

Revise los registros de su terminal para verificar que el contenido se está enviando y que se entregó a través del artefacto de reglas en su servidor. El objeto LD.DeciscionProvider se genera cuando la calificación y la toma de decisiones de la actividad se determinaron en el dispositivo en función del artefacto de reglas. Además, debido al registro de content, debería ver <div>test</div> o como sea que haya decidido que sea la respuesta al crear la actividad de prueba.

Salida del registrador
AT: LD.DecisionProvider {...} AT: Response received {...} Response: <div>test</div>

Inspect envía errores de notificación

Al utilizar la toma de decisiones en el dispositivo, las notificaciones se envían automáticamente para que getOffers ejecute solicitudes. Estas solicitudes se envían silenciosamente en segundo plano. Cualquier error se puede inspeccionar mediante la suscripción a un evento denominado sendNotificationError. Este es un ejemplo de código que muestra cómo suscribirse a los errores de notificación mediante el SDK de Node.js.

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
  }
});

Escenarios comunes de resolución de problemas

Asegúrese de revisar funciones compatibles para on-device decisioning cuando encuentre problemas.

Las actividades de toma de decisiones en el dispositivo no se ejecutan debido a una audiencia o actividad no admitidas

Un problema común que se puede producir es que on-device decisioning actividades no se ejecutan debido a que la audiencia está en uso o el tipo de actividad no es compatible.

(1) Con el resultado del registrador, revise las entradas de la propiedad trace en el objeto response. Identifique específicamente la propiedad de campañas:

Salida de seguimiento

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

Observará que la actividad para la que intenta calificar no está en la propiedad campaigns, ya que no se admite la audiencia o el tipo de actividad. Si la actividad aparece en la propiedad campaigns, el problema no se debe a una audiencia o a un tipo de actividad no compatibles.

(2) Además, busque el archivo rules.json mirando trace > artifact > artifactLocation en la salida del registrador y observe que falta su actividad en la propiedad rules > mboxes:

Salida del registrador

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

Finalmente, vaya a la Targetinterfaz de usuario y busque la actividad en cuestión: experience.adobe.com/target

Revise las reglas utilizadas en la audiencia y asegúrese de utilizar solo las mencionadas que son compatibles. Además, asegúrese de que el tipo de actividad sea A/B o XT.

imagen alt

Las actividades de toma de decisiones en el dispositivo no se ejecutan debido a una audiencia no cualificada

Si no se está ejecutando una actividad de toma de decisiones en el dispositivo, pero ha verificado que el archivo rules.json contiene la actividad, realice los siguientes pasos:

(1) Asegúrese de que el mbox que está ejecutando en la aplicación es el mismo que utiliza la actividad:

rule.json

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

SDK de Node.js

 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
     }]
   }};

SDK de Java

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) Asegúrese de que cumple los requisitos para la audiencia de su actividad revisando la propiedad matchedRuleConditions o unmatchedRuleConditions del resultado del seguimiento:

Salida de seguimiento

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

Si tiene condiciones de regla no coincidentes, no cumple los requisitos para la actividad y, por lo tanto, la actividad no se ejecutará. Revise las reglas de la audiencia para ver por qué no cumple los requisitos.

La actividad de toma de decisiones en el dispositivo no se ejecuta, pero el motivo no es aparente

Puede que no sea evidente por qué no se está ejecutando una actividad de toma de decisiones en el dispositivo. En este caso, siga estos pasos de solución de problemas para identificar el problema:

(1) Lea el resultado de seguimiento del registrador en la consola e identifique la propiedad artifact, que tendrá un aspecto similar al siguiente:

Salida de seguimiento

...
      "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"
        },
...

Observe la fecha artifactLastRetrieved del artefacto y asegúrese de que ha descargado el archivo más reciente de rules.json en su aplicación.

(2) Busque la propiedad evaluatedCampaignTargets en la salida del registrador:

Salida del registrador

...
  "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) Revise los datos de context, page y referring para asegurarse de que son lo esperados, ya que esto puede afectar a la calificación de la actividad como objetivo.

(4) Revise campaignId para asegurarse de que se evalúan la actividad o actividades que espera ejecutar. campaignId coincidirá con el ID de actividad en la ficha de información general de actividad de la TargetIU:

imagen alt

(5) Revise matchedRuleConditions y unmatchedRuleConditions para identificar los problemas con la calificación de las reglas de audiencia para una actividad determinada.

(6) Revise el archivo rules.json más reciente para asegurarse de que se incluyen la actividad o actividades que desea ejecutar localmente. En el paso 1 se hace referencia a la ubicación.

(7) Asegúrese de que utiliza los mismos nombres de mbox en sus solicitudes y actividades.

(8) Asegúrese de que utiliza reglas de audiencia y tipos de actividades compatibles.

Se realiza una llamada al servidor aunque la configuración de la actividad en un mbox indique "Opción de decisiones en el dispositivo elegible" en la interfaz de usuario Target

Existen varias razones por las que se realiza una llamada al servidor aunque el dispositivo sea apto para la toma de decisiones en el dispositivo:

Cuando el mbox utilizado para una actividad "Opción de decisiones en el dispositivo elegible" también se usa para otras actividades que no son "Opción de decisiones en el dispositivo elegible", el mbox se enumera en la sección remoteMboxes del artefacto rules.json. Cuando un mbox aparece en remoteMboxes, cualquier llamada de getOffer(s) a ese mbox resulta en una llamada al servidor.
Si configura una actividad en un espacio de trabajo o una propiedad y no incluye la misma al configurar el SDK, esto puede hacer que se descargue el rules.josn del espacio de trabajo predeterminado, que puede utilizar el mbox en la sección remoteMboxes.

recommendation-more-help