Documentación Guía para desarrolladores de Target

Entrega de personalización

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

Temas:
APIs/SDKs

Creado para:

Desarrollador

Resumen de los pasos

Habilitar on-device decisioning para su organización
Crear una actividad Experience Targeting (XT)
Definir experiencia personalizada por audiencia
Verificar experiencia personalizada por audiencia
Configuración de informes
Agregar métricas para KPI de seguimiento
Implementación de ofertas personalizadas en la aplicación
Implementación de código para hacer un seguimiento de eventos de conversión
Activar su actividad de personalización Experience Targeting (XT)

Supongamos que es una empresa de turismo. Desea ofrecer una oferta personalizada del 25% de descuento en determinados paquetes de viaje. Para que la oferta resuene entre sus usuarios, decide mostrar un punto de referencia de la ciudad de destino. También debe asegurarse de que la entrega de sus ofertas personalizadas se ejecute con una latencia cercana a cero para que no afecte negativamente a las experiencias de los usuarios y distorsione los resultados.

1. Habilite on-device decisioning para su organización

Al habilitar la toma de decisiones en el dispositivo, se garantiza que una actividad A/B se ejecute con una latencia cercana a cero. Para habilitar esta característica, vaya a Administration > Implementation > Account details en Adobe Target y habilite la opción On-Device Decisioning.

NOTE
Debe tener el rol de administrador o aprobador user para habilitar o deshabilitar la opción On-Device Decisioning.

Después de habilitar la opción On-Device Decisioning, Adobe Target comienza a generar artefactos de regla para su cliente.

2. Crear una actividad Experience Targeting (XT)

En Adobe Target, vaya a la página Activities y, a continuación, seleccione Create Activity > Experience Targeting.
En el modal Create Experience Targeting Activity, deje seleccionada la opción predeterminada Web (1), seleccione Form como compositor de experiencias (2), seleccione un espacio de trabajo y una propiedad (3) y haga clic en Next (4).

3. Defina una experiencia personalizada por audiencia

En el paso Experiences de creación de la actividad, haga clic en Change Audience para crear una audiencia de los visitantes que deseen viajar a San Francisco, California.
En el modal Create Audience, defina una regla personalizada donde destinationCity = San Francisco. Define el grupo de usuarios que desea viajar a San Francisco.
En el paso Experiences, escriba el nombre de la ubicación (1) dentro de su aplicación donde desea presentar una oferta especial con respecto a Golden Gate Bridge, pero solo para los que se dirigen a San Francisco. En el ejemplo que se muestra aquí, homepage es la ubicación seleccionada para la oferta de HTML (2), que se define en el área Content.
Agregue otra audiencia de segmentación haciendo clic en Add Experience Targeting. En esta ocasión, defina una regla de audiencia donde destinationCity = New York sea el destino de una audiencia que desee viajar a Nueva York. Defina la ubicación dentro de su aplicación donde desea presentar una oferta especial con respecto al Empire State Building. En el ejemplo que se muestra aquí, homepage es la ubicación seleccionada para la oferta de HTML (2), que se define en el área Content.

4. Verificar la experiencia personalizada por audiencia

En el paso Targeting, compruebe que ha configurado la experiencia personalizada que desea por audiencia.

imagen alt

5. Configurar informes

En el paso Goals & Settings, elija Adobe Target como Reporting Source para ver los resultados de la actividad en la interfaz de usuario de Adobe Target o elija Adobe Analytics para verlos en la interfaz de usuario de Adobe Analytics.

imagen alt

6. Agregar métricas para el seguimiento de KPI

Elija un(a) Goal Metric para medir el éxito de la actividad. En este ejemplo, una conversión correcta se basa en si el usuario hace clic en la oferta de destino personalizada.

7. Implementar las ofertas personalizadas en la aplicación

Nodo.js

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

const CONFIG = {
  client: "acmeclient",
  organizationId: "1234567890@AdobeOrg"
};

const targetClient = TargetClient.create(CONFIG);

targetClient.getOffers({
  request: {
    execute: {
      pageLoad: {
        parameters: {
          destinationCity: "San Francisco"
        }
      }
    }
  }
})
.then(console.log)
.catch(console.error);

Java

ClientConfig config = ClientConfig.builder()
  .client("acmeclient")
  .organizationId("1234567890@AdobeOrg")
  .build();
TargetClient targetClient = TargetClient.create(config);

Context context = new Context().channel(ChannelType.WEB);

ExecuteRequest executeRequest = new ExecuteRequest();

RequestDetails pageLoad = new RequestDetails();
pageLoad.setParameters(
    new HashMap<String, String>() {
      {
        put("destinationCity", "San Francisco");
      }
    });

executeRequest.setPageLoad(pageLoad);

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

TargetDeliveryResponse offers = targetClient.getOffers(request);

8. Implementar código para rastrear eventos de conversión

Nodo.js

//... Code removed for brevity

//When a conversion happens
TargetClient.sendNotifications({
    targetCookie,
    "request" : {
      "notifications" : [
        {
          type: "click",
          timestamp : Date.now(),
          id: "conversion",
          mbox : {
            name : "destinationOffer"
          }
        }
      ]
    }
})

Java

ClientConfig config = ClientConfig.builder()
  .client("acmeclient")
  .organizationId("1234567890@AdobeOrg")
  .build();
TargetClient targetClient = TargetClient.create(config);

Context context = new Context().channel(ChannelType.WEB);

ExecuteRequest executeRequest = new ExecuteRequest();

RequestDetails pageLoad = new RequestDetails();
pageLoad.setParameters(
    new HashMap<String, String>() {
      {
        put("destinationCity", "San Francisco");
      }
    });

executeRequest.setPageLoad(pageLoad);
NotificationDeliveryService notificationDeliveryService = new NotificationDeliveryService();

Notification notification = new Notification();
notification.setId("conversion");
notification.setImpressionId(UUID.randomUUID().toString());
notification.setType(MetricType.CLICK);
notification.setTimestamp(System.currentTimeMillis());
notification.setTokens(
    Collections.singletonList(
        "IbG2Jz2xmHaqX7Ml/YRxRGqipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q=="));

TargetDeliveryRequest targetDeliveryRequest =
    TargetDeliveryRequest.builder()
        .context(context)
        .execute(executeRequest)
        .notifications(Collections.singletonList(notification))
        .build();

TargetDeliveryResponse offers = targetClient.getOffers(request);
notificationDeliveryService.sendNotification(request);

9. Active la actividad de segmentación de experiencias (XT)

imagen alt

recommendation-more-help