Audience Activation

La extensión Audience Activation le permite activar audiencias de Real-Time CDP en Adobe Commerce para crear ofertas únicas en el carro de compras. Estas ofertas e incentivos incluyen técnicas comunes de comercialización de comercio electrónico, como comprar 2 y obtener 1 gratis, banners a pantalla completa dirigidos a ese cliente y precios de productos modificados a través de varias ofertas. Las audiencias creadas en Real-Time CDP se basan en datos de varios sistemas empresariales, como Enterprise Resource Planning (ERP), Customer Relationship Management (CRM), puntos de venta y sistemas de marketing. Debido a que la información del segmento del cliente se actualiza constantemente, los clientes pueden asociarse y desasociarse de un segmento a medida que compran en su tienda.

Puede activar audiencias en una tienda de Luma o sin encabezado. En una tienda de Luma, la información de audiencia (pertenencia a segmentos) se almacena en una cookie en Commerce. En una tienda sin encabezado, la información de audiencia se pasa en el encabezado de la API de GraphQL como parámetro denominado: aep-segments-membership.

Notas de la versión

Esta sección contiene información sobre las actualizaciones realizadas en la extensión de Audience Activation e incluye:

Nuevo - Nuevas características
Corrección : correcciones y mejoras
Error : problemas conocidos

Consulte Próximas versiones para obtener más información sobre las programaciones de versiones y la compatibilidad.

Consulte la documentación para desarrolladores para obtener más información acerca de la compatibilidad del producto.

Actualizaciones de servicios compatibles

En estas notas de la versión se describen cambios y correcciones de funciones relacionados con las extensiones que utiliza Audience Activation.

Actualizaciones de servicios compatibles

15 de agosto de 2023

Corrección : se ha actualizado el panel Audiencias de Real-Time CDP para simplificar el filtrado.

27 de junio de 2023

Corrección : Se ha agregado compatibilidad con PHP 8.2 en el paquete magento/module-data-services-graphql.

30 de mayo de 2023

Nuevo - Se ha actualizado el tablero de audiencias de Real-Time CDP para incluir la capacidad de ordenar, buscar y filtrar las audiencias activas dentro de la instancia de Adobe Commerce.

2.2.0

[Compatibilidad]{class="badge informative" title="Compatibilidad"}

12 de junio de 2024

Nuevo : versión de GA para reglas de productos relacionadas informadas por las audiencias.

2.1.1

[Compatibilidad]{class="badge informative" title="Compatibilidad"}

4 de abril de 2024

Nuevo - Se agregó compatibilidad con PHP 8.3.

2.2.0-beta1

[Compatibilidad]{class="badge informative" title="Compatibilidad"}

16 de febrero de 2024

Nuevo - Si participa en la versión beta, asegúrese de que el archivo composer.json tenga lo siguiente en el nivel raíz: "minimum-stability": "beta".
Nuevo - (Beta) Se ha agregado la capacidad de crear reglas de producto relacionadas informadas por las audiencias.

2.1.0

[Compatibilidad]{class="badge informative" title="Compatibilidad"}

24 de enero de 2024

Nuevo - Se ha actualizado el panel Audiencias de Real-Time CDP para incluir los sitios web que contienen las audiencias y especificar qué bloques dinámicos y reglas de precios de carrito están configurados para usar esas audiencias.

2.0.1

[Compatibilidad]{class="badge informative" title="Compatibilidad"}

16 de noviembre de 2023

Corrección : estabilidad mejorada.

2.0.0

[Compatibilidad]{class="badge informative" title="Compatibilidad"}

10 de octubre de 2023

Nuevo : se agregó compatibilidad con OAuth 2.0 al configurar la extensión de Audience Activation.
Corrección : estabilidad mejorada.

1.2.0

[Compatibilidad]{class="badge informative" title="Compatibilidad"}

15 de agosto de 2023

Corrección : Se ha actualizado la versión de los componentes de la interfaz de usuario.

1.1.0

30 de mayo de 2023

[Compatibilidad]{class="badge informative" title="Compatibilidad"}

Nuevo : se agregó compatibilidad con bloques dinámicos en una tienda sin encabezado.

1.0.1

11 de mayo de 2023

[Compatibilidad]{class="badge informative" title="Compatibilidad"}

Corrección : se corrigió un problema en el cual no se aplicaba un bloque dinámico o una regla de precio de carro de compras a la tienda.
Corrección : se ha corregido un problema por el que una instalación no configurada de la extensión de Audience Activation provocaba un error cuando un comerciante intentaba crear o actualizar un bloque dinámico.

1.0.0

31 de marzo de 2023

[Compatibilidad]{class="badge informative" title="Compatibilidad"}

Nuevo : versión de disponibilidad general

Implementación

Las siguientes tareas se aplican a las implementaciones de tiendas de Luma y sin encabezado. Para activar audiencias en Adobe Commerce, debe:

  • Instalar Adobe Commerce versión 2.4.4 o superior
  • Activar Adobe Commerce como destino en Real-Time CDP
  • Instalar la extensión Audience Activation en el administrador
  • Configurar la extensión Audience Activation en el administrador

Instalación de la extensión

Instale la extensión Audience Activation desde marketplace o ejecute el siguiente comando:

composer require magento/audiences

Configuración de la extensión

Después de instalar la extensión Audience Activation, debe iniciar sesión en el administrador de Commerce y completar lo siguiente:

  1. En la barra lateral Admin, vaya a System > Services>Commerce Services Connector.

  2. Inicia sesión en tu cuenta de Adobe y selecciona tu ID de organización.

  3. En la barra lateral Admin, vaya a System > Services>Data Connection.

  4. En el campo Datastream ID, pegue el ID de la secuencia de datos que creó al activar Adobe Commerce como destino en Real-Time CDP.

    Esta secuencia de datos envía datos del sitio web de Commerce a Real-Time CDP para determinar si un comprador pertenece a una audiencia. Si aún no ha creado una secuencia de datos, cree una en el Experience Platform, agréguela al destino de Commerce en Real-Time CDP y a la extensión Data Connection en el administrador.

    note note
    NOTE
    Cuando especifica un ID de secuencia de datos, lo asocia a un sitio web específico en la extensión Data Connection. Si tu tienda Commerce tiene varios sitios web, crea un destino para cada sitio web en Real-Time CDP y usa un identificador de flujo de datos diferente para cada uno.
  5. En la barra lateral Admin, vaya a Stores > Settings>Configuration.

  6. Expanda Services y seleccione Data Connection.

  7. Agregar detalles de cuenta de servicio y credenciales.

Dónde usar las audiencias de Real-Time CDP en Commerce

Con la extensión Audience Activation habilitada, puede:

TIP
Para ver un caso de uso completo e integral sobre cómo exportar datos de Commerce a Real-Time CDP, generar una audiencia y activar esa audiencia en Commerce, consulte Crear una audiencia en Real-Time CDP con Commerce datos de evento.

Panel de audiencias de Real-Time CDP

Puede ver todas las audiencias activas que están disponibles para personalizar en su instancia de Adobe Commerce mediante el panel Audiencias de Real-Time CDP.

Para acceder al panel de Audiencias de Real-Time CDP, ve a la barra lateral de Administración y luego ve a Customers > Real-time CDP Audience.

Panel de audiencias de Real-Time CDP

El tablero contiene los campos siguientes:

Columna
Descripción
Hide filters
Permite mostrar u ocultar cualquier filtro que se pueda aplicar al panel. Actualmente, el único filtro que puede aplicar es Last updated. Este filtro le permite seleccionar un intervalo de fechas para las audiencias en función de la última actualización.
Search
Le permite buscar audiencias activas en la instancia de Commerce.
Name
Nombre proporcionado a la audiencia en Real-Time CDP.
Origin
Indica la procedencia de la audiencia, como Experience Platform.
Websites
Indica qué sitios web están configurados para utilizar las audiencias.
Dynamic Blocks
Indica qué bloques dinámicos están configurados para utilizar las audiencias.
Cart Price Rules
Indica qué reglas de precios del carro de compras están configuradas para usar las audiencias.
Related Product Rules
Indica qué reglas de producto relacionadas están configuradas para usar las audiencias.
Last updated
Indica cuándo se modificó la audiencia en Real-Time CDP.
Sync now
Recupera audiencias nuevas o actualizadas de Real-Time CDP.
Customize table
Permite mostrar u ocultar las columnas Origin, Websites, Dynamic Blocks, Cart Price Rules y Last updated.

Compatibilidad sin encabezado

Puede activar audiencias en una instancia de Adobe Commerce AEM sin encabezado, como el de la aplicación y el de PWA, para mostrar reglas de precios del carro de compras, reglas de productos relacionadas o bloques dinámicos basados en las audiencias.

Reglas de precios del carro de compras y reglas de productos relacionadas

Para las reglas de precios del carro de compras y las reglas de productos relacionadas, una tienda sin encabezado se comunica con el Experience Platform a través del Commerce integration framework CIF (). El marco de trabajo proporciona una API del lado del servidor que se implementa mediante GraphQL. La información de audiencia, como el segmento de un comprador, pasa a Commerce a través de un parámetro de encabezado de GraphQL denominado: aep-segments-membership.

La arquitectura general es la siguiente:

Envío de datos de tienda sin encabezado al servidor

Después de instalar y configurar la extensión, el SDK web de Experience Platform contiene la información de audiencia en forma de abono a segmentos.

Para capturar esas pertenencias a segmentos desde el SDK, consulte este fragmento de código.

Una vez recuperado, puede pasar esos segmentos a Commerce dentro del encabezado de GraphQL. Por ejemplo:

curl 'http://magento.config/graphql' -H 'Authorization: Bearer abc123' -H 'aep-segments-membership: urlencoded_list_of_segments' -H 'Content-Type: application/json' --data-binary '{"query":"query {\ncustomer {\nfirstname\nlastname\nemail\n}\n}"}'

Bloques dinámicos

Para bloques dinámicos, las consultas de GraphQL dynamicBlocks pueden contener el atributo de entrada audience_id. Si especifica uno o más valores de audience_id en una consulta dynamicBlocks, devolverá una lista de bloques dinámicos asignados a esas audiencias.

Ejemplo de uso

La siguiente consulta devuelve todos los bloques dinámicos asociados con varios ID de audiencia.

Solicitud:

{
  dynamicBlocks(input:
  {
    type: SPECIFIED
    audience_id: {
      in: [
        "cd29a789-9be8-40ad-a1ef-640c33b3742e"
        "92c3e14d-c72b-40d0-96b7-b96801dcc135"
      ]
    }
  })
  {
    items {
      uid
      audience_id
      content {
        html
      }
    }
    page_info {
      current_page
      page_size
      total_pages
    }
    total_count
  }
}

Respuesta:

{
  "data": {
    "dynamicBlocks": {
      "items": [
        {
          "uid": "MQ==",
          "audience_id": [
            "cd29a789-9be8-40ad-a1ef-640c33b3742e"
          ],
          "content": {
            "html": "<h2><strong>SAVE 20%</strong></h2>\r\n<p>(some restrictions apply)</p>\r\n<p>&nbsp;</p>"
          }
        },
        {
          "uid": "Mg==",
          "audience_id": [
            "cd29a789-9be8-40ad-a1ef-640c33b3742e",
            "92c3e14d-c72b-40d0-96b7-b96801dcc135"
          ],
          "content": {
            "html": "<p><img src=\"{{media url=&quot;wysiwyg/save20.png&quot;}}\" alt=\"save 20% red\"></p>"
          }
        }
      ],
      "page_info": {
        "current_page": 1,
        "page_size": 20,
        "total_pages": 1
      },
      "total_count": 2
    }
  }
}

Obtenga más información acerca de la consulta de GraphQL dynamicBlocks en la documentación para desarrolladores.

Recuperación de audiencias mediante el SDK para móviles de Adobe Experience Platform

Puede recuperar audiencias de Real-Time CDP mediante el SDK para móviles de Adobe Experience Platform.

IMPORTANT
El SDK de Adobe Experience Platform Mobile para iOS es compatible con iOS 11 o posterior.

Una vez completada la configuración, utilice las operaciones del SDK móvil para recuperar los datos de audiencia. Por ejemplo:

Edge.sendEvent(experienceEvent: experienceEvent) { (handles: [EdgeEventHandle]) in
    for handle in handles {
        if handle.type == "activation:pull" {
        let payloadItems = handle.payload ?? []
            for payloadItem in payloadItems {
                if let segments = payloadItem["segments"] as? any Sequence {
                    var segmentsArr = [Any]()
                    for segment in segments {
                        let response = segment as AnyObject?
                        segmentsArr.append(response?.object(forKey: "id")! ?? "")
                    }
                    print("Saving segments ->  \(segments)")
                    storage.set(segmentsArr, forKey: "segments")
                    print("End saving segments")
                }

                // Show segments
                let rSegments = storage.object(forKey: "segments") ?? nil;
                print("Retrieving segments -> \(rSegments)")
            }
        }
    }
}

Una vez recuperados los datos, puedes usarlos para crear reglas de precio del carro de compras, bloques dinámicos y reglas de producto relacionadas basadas en la audiencia en la aplicación Commerce.

Las audiencias no se muestran en Commerce

Si las audiencias de Real-Time CDP no se muestran en Commerce, puede deberse a lo siguiente:

  • Se seleccionó un tipo de autenticación incorrecto en la página de configuración Conexión de datos
  • Privilegios insuficientes en el token generado

Las dos secciones siguientes describen cómo solucionar problemas en cualquiera de los casos.

Tipo de autenticación incorrecto seleccionado en la configuración

  1. Abra la instancia de Commerce.
  2. En la barra lateral Admin, vaya a Stores > Settings>Configuration.
  3. Expanda Services y seleccione Data Connection.
  4. Asegúrese de que el método de autorización de servidor a servidor especificado en el campo Authentication Type sea correcto. El Adobe recomienda usar OAuth. JWT se ha desaprobado. Más información.

Privilegios insuficientes en el token generado

Este problema puede deberse a la falta de privilegios de API para el token generado. Para asegurarse de que el token tenga los privilegios correctos:

  1. Identifique al administrador de sistemas de Adobe Experience Platform de su organización.
  2. Busque el proyecto y las credenciales que utilizará.
  3. Identifique el correo electrónico de la cuenta técnica, por ejemplo: fe3c9476-1234-1234-abcd-2a51a785009a@techacct.adobe.com.
  4. Pida al administrador de sistemas que inicie Adobe Experience Platform y vaya a Permissions -> Users -> API credentials.
  5. Utilizando el correo electrónico de cuenta técnica de arriba, busque las credenciales que desea modificar.
  6. Abra las credenciales y seleccione Roles -> Add roles.
  7. Agregue la función que contiene el permiso Manage destinations.
  8. Haga clic en Save.
  9. Regenerar el token de acceso en la consola.
  10. Compruebe que el token proporciona una respuesta válida mediante la API Conexiones de Target.
recommendation-more-help
09e7db7e-4210-474a-8bbf-c72a92c7537c