Creación y visualización de ofertas con Administración de decisiones

Obtenga información sobre cómo mostrar ofertas de Administración de decisiones de Journey Optimizer en sus aplicaciones móviles con el SDK móvil de Experience Platform.

Administración de decisiones de Journey Optimizer le ayuda a ofrecer la mejor oferta y experiencia a sus clientes en todos los puntos de contacto y en el momento adecuado. Una vez diseñada, la audiencia debe segmentarse con ofertas personalizadas.

Arquitectura

La administración de decisiones facilita la personalización con una biblioteca central de ofertas de marketing y un motor de decisión que aplica reglas y restricciones a perfiles enriquecidos en tiempo real creados por Adobe Experience Platform. Como resultado, le permite enviar a sus clientes la oferta correcta en el momento adecuado. Consulte Acerca de Administración de decisiones para obtener más información.

NOTE
Esta lección es opcional y solo se aplica a los usuarios de Journey Optimizer que buscan utilizar la funcionalidad Administración de decisiones para mostrar ofertas en una aplicación móvil.

Requisitos previos

  • La aplicación se ha creado y ejecutado correctamente con los SDK instalados y configurados.
  • Configure la aplicación para Adobe Experience Platform.
  • Acceso a Journey Optimizer: Administración de decisiones con los permisos adecuados para administrar ofertas y decisiones según se describe aquí.

Objetivos de aprendizaje

En esta lección, debe

  • Actualice la configuración de Edge para Administración de decisiones.
  • Actualice la propiedad de etiquetas con la extensión Journey Optimizer - Decisioning.
  • Actualice el esquema para capturar eventos de propuesta.
  • Valide la configuración en Assurance.
  • Cree una decisión de oferta basada en ofertas de Journey Optimizer - Gestión de decisiones.
  • Actualice la aplicación para registrar la extensión de Optimizer.
  • Implemente ofertas de Administración de decisiones en la aplicación.

Configuración

TIP
Si ya ha configurado su entorno como parte de la Configuración de pruebas A/B con Target En esta lección, es posible que ya haya realizado algunos de los pasos de esta sección de configuración.

Actualizar configuración de secuencia de datos

Para garantizar que los datos enviados desde su aplicación móvil a Platform Edge Network se reenvíen a Journey Optimizer - Gestión de decisiones, actualice su secuencia de datos.

  1. En la IU de recopilación de datos, seleccione Datastreams y seleccione la secuencia de datos, por ejemplo Luma Mobile App.

  2. Seleccionar Más para Experience Platform y seleccione Editar Editar en el menú contextual.

  3. En el Datastreams > Carpeta > Adobe Experience Platform pantalla, asegúrese de Offer decisioning, Segmentación de Edge, y Adobe Journey Optimizer están seleccionados. Si va a seguir la lección de Target, seleccione Destinos de personalización, también. Consulte Configuración de Adobe Experience Platform para obtener más información.

  4. Para guardar la configuración de la secuencia de datos, seleccione Guardar .

    Configuración de flujo de datos AEP

Instalación de Journey Optimizer: extensión de etiquetas de Decisioning

  1. Vaya a Etiquetas y busque la propiedad de etiquetas móviles y ábrala.

  2. Seleccionar Extensiones.

  3. Seleccionar Catálogo.

  4. Busque la variable Adobe Journey Optimizer - Toma de decisiones extensión.

  5. Instale la extensión de. La extensión no requiere ninguna configuración adicional.

    Añadir extensión de Decisioning

Actualizar el esquema

  1. Vaya a la interfaz de recopilación de datos y seleccione Esquemas desde el carril izquierdo.
  2. Seleccionar Examinar desde la barra superior.
  3. Seleccione el esquema para abrirlo.
  4. En el editor de esquemas, seleccione Añadir Añadir junto a Grupos de campos.
  5. En el Adición de campos y grupos diálogo, Buscar buscar proposition, seleccione Evento de experiencia: interacciones de propuesta y seleccione Adición de grupos de campos. Este grupo de campos recopila los datos de evento de experiencia relevantes para las ofertas: qué oferta se presenta, como parte de qué recopilación, decisión y otros parámetros (consulte más adelante en esta lección). Pero también ¿qué está pasando con la oferta? ¿Se muestra, interactúa con, se descarta, etc.?
    Proposición
  6. Seleccionar Guardar para guardar los cambios en el esquema.

Validar la configuración en Assurance

Para validar la configuración en Assurance:

  1. Vaya a la interfaz de usuario de Assurance.
  2. Seleccionar Configurar en el carril izquierdo y seleccione Añadir junto a Validar configuración debajo ADOBE JOURNEY OPTIMIZER DECISIONING.
  3. Seleccione Guardar.
  4. Seleccionar Validar configuración en el carril izquierdo. Se validan tanto la configuración del flujo de datos como la configuración del SDK en la aplicación.
    Validación de AJO Decisioning

Crear ubicación

Para poder crear ofertas, debe definir cómo y dónde se pueden colocar estas ofertas en la aplicación móvil. En Administración de decisiones, defina ubicaciones para este fin y definirá una ubicación para el canal móvil que admita una carga útil JSON:

  1. En la IU de Journey Optimizer, seleccione Componentes Componentes de GESTIÓN DE DECISIONES en el carril izquierdo.

  2. Seleccionar Ubicaciones desde la barra superior.

  3. Si no hay ninguna ubicación con el nombre JSON móvil, Móvil as Tipo de canal y JSON as Tipo de contenido , debe crear una ubicación. De lo contrario, continúe a Creación de ofertas.

Para crear la ubicación JSON de Mobile:

  1. Seleccionar Añadir Cree una ubicación.

    1. en el Detalles , introduzca Mobile JSON como el Nombre, seleccione Móvil de Tipo de canal y JSON de Tipo de contenido.
    2. Seleccionar Guardar para guardar la ubicación.

    Crear ubicación

Creación de ofertas

  1. En la IU de Journey Optimizer, seleccione Ofertas Ofertas de GESTIÓN DE DECISIONES en el carril izquierdo.

  2. En el Ofertas pantalla, seleccione Examinar para ver la lista de ofertas.

  3. Seleccionar Crear oferta.

  4. En el Nueva oferta diálogo, seleccione Oferta personalizada y haga clic en Siguiente.

  5. En el Detalles paso de Crear nueva oferta personalizada:

    1. Introduzca una Nombre para la oferta, por ejemplo Luma - Juno Jacket, e introduzca un Fecha y hora de inicio y un Fecha y hora de finalización. Fuera de estas fechas, el motor de decisión no selecciona la oferta.

    2. Seleccione Siguiente.

      Ofertas: detalles

  6. En el Añadir representaciones paso de Crear nueva oferta personalizada:

    1. Seleccionar Móvil Móvil de Canal y seleccione. JSON móvil desde el Ubicación lista.

    2. Seleccionar Personalizado para Contenido.

    3. Seleccionar Añadir contenido. En el Añadir personalización diálogo:

      1. En el caso a Modo está disponible, asegúrese de que está configurado en JSON.

      2. Introduzca el siguiente JSON:

        code language-json
        {
            "title": "Juno Jacket",
            "text": "On colder-than-comfortable mornings, you'll love warming up in the Juno All-Ways Performance Jacket, designed to compete with wind and chill. Built-in Cocona™ technology aids evaporation, while a special zip placket and stand-up collar keep your neck protected.",
            "image": "https://luma.enablementadobe.com/content/dam/luma/en/products/women/tops/jackets/wj06-purple_main.jpg"
        }
        
      3. Seleccione Guardar.

        Ofertas: contenido personalizado

    4. Seleccione Siguiente.

      Representaciones de ofertas

  7. En el Añadir restricciones paso del Crear nueva oferta personalizada:

    1. Establecer Prioridad hasta 10.

    2. Alternar Incluir límite apagada.

    3. Seleccione Siguiente.

      Ofertas: restricciones

  8. En el Revisar paso de Crear nuevo elemento personalizado oferta:

    1. Revise la oferta y seleccione Finalizar.
    2. En el Guardar oferta diálogo, seleccione Guardar y aprobar.
  9. Repita los pasos del 3 al 8 para crear cuatro ofertas más con nombres y contenido diferentes. Todos los demás valores de configuración, como Fecha y hora de inicio o Prioridad, son similares a la primera oferta creada. Puede crear y editar ofertas duplicadas rápidamente.

    1. En la IU de Journey Optimizer, seleccione Ofertas Ofertas en el carril izquierdo, seleccione Ofertas en la barra superior.

    2. Seleccione la fila de la oferta que ha creado.

    3. En el panel derecho, seleccione Más Más acciones y en el menú contextual, seleccione Duplicar Duplicar.

      Utilice la tabla siguiente para definir las otras cuatro ofertas.

      table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-fixed
      Nombre de oferta Contenido de oferta en JSON
      Luma: confirme la botella de agua { "title": "Affirm Water Bottle", "text": "You'll stay hydrated with ease with the Affirm Water Bottle by your side or in hand. Measurements on the outside help you keep track of how much you're drinking, while the screw-top lid prevents spills. A metal carabiner clip allows you to attach it to the outside of a backpack or bag for easy access.", "image": "https://luma.enablementadobe.com/content/dam/luma/en/products/gear/fitness-equipment/ug06-lb-0.jpg" }
      Luma: Desiree Fitness Tee { "title": "Desiree Fitness Tee", "text": "When you're too far to turn back, thank yourself for choosing the Desiree Fitness Tee. Its ultra-lightweight, ultra-breathable fabric wicks sweat away from your body and helps keeps you cool for the distance.", "image": "https://luma.enablementadobe.com/content/dam/luma/en/products/women/tops/tees/ws05-yellow_main.jpg" }
      Luma - Adrienne Trek Jacket { "title": "Adrienne Trek Jacket", "text": "You're ready for a cross-country jog or a coffee on the patio in the Adrienne Trek Jacket. Its style is unique with stand collar and drawstrings, and it fits like a jacket should.", "image": "https://luma.enablementadobe.com/content/dam/luma/en/products/women/tops/jackets/wj08-gray_main.jpg" }
      Luma: Camiseta de fitness diaria de Aero { "title": "Aero Daily Fitness Tee", "text": "Need an everyday action tee that helps keep you dry? The Aero Daily Fitness Tee is made of 100% polyester wicking knit that funnels moisture away from your skin. Don't be fooled by its classic style; this tee hides premium performance technology beneath its unassuming look.", "image": "https://luma.enablementadobe.com/content/dam/luma/en/products/men/tops/tees/ms01-black_main.jpg" }
  10. Finalmente, debe crear una oferta de reserva, que es una oferta enviada a los clientes si no cumplen los requisitos para otras ofertas.

    1. Seleccionar Crear oferta.

    2. En el Nueva oferta diálogo, seleccione Oferta personalizada y seleccione Siguiente.

    3. En el Detalles paso de Crear nueva oferta de reserva, introduzca un Nombre para la oferta, por ejemplo Luma - Fallback Offery seleccione Siguiente.

    4. En el Añadir representaciones paso de Crear nueva oferta de reserva:

      1. Seleccionar Móvil Móvil de Canal y seleccione. JSON móvil de Ubicación lista.

      2. Seleccionar Personalizado para Contenido.

      3. Seleccionar Añadir contenido.

      4. En el Añadir personalización , introduzca el siguiente JSON y seleccione Guardar:

        code language-json
        {
           "title": "Luma",
           "text": "Your store for sports wear and equipment.",
           "image": "https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png"
        }
        
      5. Seleccione Siguiente.

  11. En el Revisar paso de Crear nueva reserva oferta:

    1. Revise la oferta y seleccione Finalizar.
    2. En el Guardar oferta diálogo, seleccione Guardar y aprobar.

Ahora debería tener la siguiente lista de ofertas:
Lista de ofertas

Crear una colección

Para presentar una oferta al usuario de la aplicación móvil, debe definir una colección de ofertas que consista en una o más de las ofertas creadas.

  1. En la IU de Journey Optimizer, seleccione Ofertas desde el carril izquierdo.

  2. Seleccionar Colecciones desde la barra superior.

  3. Seleccionar Añadir Crear colección.

  4. En el Nueva colección diálogo, introduzca un Nombre para su colección, por ejemplo Luma - Mobile App Collection, seleccione Crear una colección estática y haga clic en Siguiente.

  5. Entrada Luma - Mobile App Collection, seleccione las ofertas que desee incluir en la colección. Para este tutorial, elija las cinco ofertas que ha creado. Puede filtrar fácilmente la lista utilizando el campo de búsqueda, por ejemplo, escribiendo Luma.

  6. Seleccione Guardar.

    Ofertas: colección

Crear una decisión

El paso final es definir una decisión, que es la combinación de uno o más ámbitos de decisión y la oferta de reserva.

Un ámbito de decisión es una combinación de una ubicación específica (por ejemplo, un HTML en un correo electrónico o JSON en una aplicación móvil) y uno o más criterios de evaluación.

Un criterio de evaluación es la combinación de

  • una colección de ofertas,
  • reglas de elegibilidad: por ejemplo, ¿la oferta solo está disponible para una audiencia específica,
  • un método de clasificación: cuando hay varias ofertas disponibles para elegir, qué método se utiliza para clasificarlas (por ejemplo, por prioridad de oferta, mediante una fórmula o un modelo de IA).

Consulte Pasos clave para crear y administrar ofertas si desea comprender mejor cómo interactúan y se relacionan entre sí las ubicaciones, las reglas, las clasificaciones, las ofertas, las representaciones, las colecciones, las decisiones, etc. Esta lección se centra únicamente en el uso del resultado de una decisión, en lugar de en la flexibilidad para definir decisiones dentro de Journey Optimizer: Gestión de decisiones.

  1. En la IU de Journey Optimizer, seleccione Ofertas desde el carril izquierdo.

  2. Seleccionar Decisiones desde la barra superior.

  3. Seleccionar Añadir Crear decisión.

  4. En el Detalles paso de Crear una nueva decisión de oferta:

    1. Introduzca una Nombre para la decisión, por ejemplo Luma - Mobile App Decision, introduzca Fecha y hora de inicio y Fecha y hora de finalización.
    2. Seleccione Siguiente.
  5. En el Agregar ámbitos de decisión paso de Crear una nueva decisión de oferta:

    1. Seleccionar JSON móvil de Ubicación lista.

    2. En el Criterios de evaluación mosaico, seleccione Añadir Añadir.

      1. En el Añadir colección de ofertas , seleccione la colección de ofertas. Por ejemplo, Luma - Mobile App Collection.

      2. Seleccionar Añadir.

        Decisión: Seleccionar colección

    3. Asegúrese de que Ninguno está seleccionado para Idoneidad, y Prioridad de ofertas está seleccionado como Método de clasificación.

    4. Seleccione Siguiente.

      Ámbitos de decisión .

  6. En el Añadir oferta de reserva paso de Crear una nueva decisión de oferta:

    1. Seleccione la oferta de reserva, por ejemplo, la Luma - Fallback offer.
    2. Seleccione Siguiente.
  7. En el Resumen paso de Crear una nueva decisión de oferta:

    1. Seleccione Finalizar.
    2. En el Guardar decisión de oferta diálogo, seleccione Guardar y activar.
    3. En el Decisiones pestaña, verá su decisión con el estado Activo.

La decisión de oferta, que consiste en un conjunto de ofertas, ya está lista para su uso. Para utilizar la decisión en la aplicación, debe hacer referencia en el código al ámbito de decisión.

  1. En la IU de Journey Optimizer, seleccione Ofertas.

  2. Seleccionar Decisiones desde la barra superior.

  3. Seleccione su decisión, por ejemplo Luma - Mobile App Decision.

  4. En el Ámbitos de decisión mosaico, seleccione Copiar Copiar.

  5. En el menú contextual, seleccione Ámbito de decisión.
    Copiar ámbito de decisión

  6. Utilice cualquier editor de texto para pegar el ámbito de decisión para utilizarlo posteriormente. El ámbito de decisión tiene el siguiente formato JSON.

    code language-json
    {
        "xdm:activityId":"xcore:offer-activity:xxxxxxxxxxxxxxx",
        "xdm:placementId":"xcore:offer-placement:xxxxxxxxxxxxxxx"
    }
    

Implementación de ofertas en la aplicación

Como se ha explicado en lecciones anteriores, la instalación de una extensión de etiqueta móvil solo proporciona la configuración. A continuación, debe instalar y registrar Optimize SDK. Si estos pasos no están claros, revise la Instalación de SDK sección.

NOTE
Si ha completado la Instalación de SDK , el SDK ya está instalado y puede omitir este paso.
  1. En Xcode, asegúrese de que Optimización de AEP se añade a la lista de paquetes en Dependencias del paquete. Consulte Administrador De Paquetes Swift.

  2. Vaya a Luma > Luma > AppDelegate en el navegador del proyecto Xcode.

  3. Asegurar AEPOptimize forma parte de su lista de importaciones.

    code language-swift
    import AEPOptimize
    
  4. Asegurar Optimize.self forma parte de la matriz de extensiones que está registrando.

    code language-swift
    let extensions = [
        AEPIdentity.Identity.self,
        Lifecycle.self,
        Signal.self,
        Edge.self,
        AEPEdgeIdentity.Identity.self,
        Consent.self,
        UserProfile.self,
        Places.self,
        Messaging.self,
        Optimize.self,
        Assurance.self
    ]
    
  5. Vaya a Luma > Luma > Model > Data > decisiones en el navegador del proyecto Xcode. Actualice el activityId y placementId valores con los detalles del ámbito de decisión copiados desde la interfaz de Journey Optimizer.

  6. Vaya a Luma > Luma > Utils > MobileSDK en el navegador del proyecto Xcode. Busque el func updatePropositionOD(ecid: String, activityId: String, placementId: String, itemCount: Int) async función. Añada el siguiente código:

    code language-swift
    // set up the XDM dictionary, define decision scope and call update proposition API
    Task {
       let ecid = ["ECID" : ["id" : ecid, "primary" : true] as [String : Any]]
       let identityMap = ["identityMap" : ecid]
       let xdmData = ["xdm" : identityMap]
       let decisionScope = DecisionScope(activityId: activityId, placementId: placementId, itemCount: UInt(itemCount))
       Optimize.clearCachedPropositions()
       Optimize.updatePropositions(for: [decisionScope], withXdm: xdmData)
    }
    

    Esta función:

    • configura un diccionario XDM xdmData, que contiene el ECID para identificar el perfil para el que debe presentar las ofertas.

    • define decisionScope: un objeto que se basa en la decisión que ha definido en la interfaz de Journey Optimizer - Gestión de decisiones y se define mediante el ámbito de decisión copiado de Crear una decisión. La aplicación de Luma utiliza un archivo de configuración (decisions.json) que recupera los parámetros de ámbito en función del siguiente formato JSON:

      code language-swift
      "scopes": [
          {
              "name": "name of the scope",
              "activityId": "xcore:offer-activity:xxxxxxxxxxxxxxx",
              "placementId": "xcore:offer-placement:xxxxxxxxxxxxxxx",
              "itemCount": 2
          }
      ]
      

      Sin embargo, puede utilizar cualquier tipo de implementación para asegurarse de que las API de optimización obtienen los parámetros adecuados (activityId, placementId y, itemCount), para construir un válido DecisionScope para su implementación.
      Para su información: los demás valores clave de la variable decisions.json son para uso futuro y no son relevantes y se utilizan actualmente en esta lección y como parte del tutorial.

    • llama a dos API: Optimize.clearCachePropositions y Optimize.updatePropositions. Estas funciones borran todas las propuestas almacenadas en caché y actualizan las propuestas de este perfil.

  7. Vaya a Luma > Luma > Views > Personalización > EdgeOffersView en el navegador del proyecto Xcode. Busque el func onPropositionsUpdateOD(activityId: String, placementId: String, itemCount: Int) async e inspeccione el código de esta función. La parte más importante de esta función es la Optimize.onPropositionsUpdate Llamada de API, que

    • recupera las propuestas del perfil actual en función del ámbito de decisión (que ha definido en Journey Optimizer - Gestión de decisiones),
    • recupera la oferta de la propuesta,
    • desajusta el contenido de la oferta para que se pueda mostrar correctamente en la aplicación, y
    • déclencheur el displayed() acción en la oferta que devuelve un evento a la red perimetral que indica que se muestra la oferta.
  8. Sigue en EdgeOffersView, agregue el siguiente código a .onFirstAppear modificador. Este código garantiza que la llamada de retorno para actualizar las ofertas se registre solo una vez.

    code language-swift
    // Invoke callback for offer updates
    Task {
        await self.onPropositionsUpdateOD(activityId: decision.activityId, placementId: decision.placementId, itemCount: decision.itemCount)
    }
    
  9. Sigue en EdgeOffersView, agregue el siguiente código a .task modificador. Este código actualiza las ofertas cuando se actualiza la vista.

    code language-swift
    // Clear and update offers
    await self.updatePropositionsOD(ecid: currentEcid, activityId: decision.activityId, placementId: decision.placementId, itemCount: decision.itemCount)
    

Validación mediante la aplicación

  1. Vuelva a compilar y ejecute la aplicación en el simulador o en un dispositivo físico desde Xcode mediante Reproducir .

  2. Vaya a la pestaña Personalisation.

  3. Seleccione Edge Personalisation.

  4. Desplácese hasta la parte superior y verá dos ofertas aleatorias mostradas desde la colección que ha definido en la DECISION LUMA - MOBILE APP DECISION mosaico.

    {width="300"}

    Las ofertas son aleatorias, ya que ha dado a todas las ofertas la misma prioridad y la clasificación de la decisión se basa en la prioridad.

Validar la implementación en Assurance

Para validar la implementación de ofertas en Assurance:

  1. Revise la instrucciones de configuración para conectar el simulador o dispositivo a Assurance.

  2. Seleccionar Configurar en el carril izquierdo y seleccione Añadir junto a Revisar y simular debajo ADOBE JOURNEY OPTIMIZER DECISIONING.

  3. Seleccione Guardar.

  4. Seleccionar Revisar y simular en el carril izquierdo. Tanto la configuración del flujo de datos como la configuración del SDK se validan en la aplicación.

  5. Seleccionar Solicitudes en la barra superior. Ya ve su Ofertas solicitudes.
    Validación de AJO Decisioning

  6. Puede explorar Simular y Lista de eventos para obtener más funcionalidad, compruebe la configuración de Journey Optimizer Decision Management.

Pasos siguientes

Ahora debería tener todas las herramientas para empezar a añadir más funcionalidades a su implementación de Journey Optimizer - Gestión de decisiones. Por ejemplo:

  • aplique parámetros diferentes a las ofertas (por ejemplo, prioridad o límite)
  • recopilar atributos de perfil en la aplicación (consulte Perfil) y utilice estos atributos de perfil para crear audiencias. A continuación, utilice estas audiencias como parte de las reglas de idoneidad en su decisión.
  • combinar más de un ámbito de decisión.
SUCCESS
Ha habilitado la aplicación para que muestre ofertas con la extensión Journey Optimizer - Decisioning para el SDK de Experience Platform Mobile.
Gracias por dedicar su tiempo a conocer el SDK móvil de Adobe Experience Platform. Si tiene preguntas, desea compartir comentarios generales o tiene sugerencias sobre contenido futuro, compártalas en este Entrada de discusión de la comunidad Experience League.

Siguiente: Realizar pruebas A/B

recommendation-more-help
9fed61f5-c338-47ad-8005-0b89a5f4af8b