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:

- Nuevas características
: correcciones y mejoras
: 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.

2.3.0

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

29 de julio de 2024

: se ha agregado sintaxis de línea de comandos para que pueda probar las credenciales para determinar si es necesario actualizarlas para extraer datos de audiencia de Adobe Experience Platform.

2.2.0

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

12 de junio de 2024

: 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

- Se agregó compatibilidad con PHP 8.3.

2.2.0-beta1

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

16 de febrero de 2024

- 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".
- (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

- 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

: estabilidad mejorada.

2.0.0

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

10 de octubre de 2023

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

1.2.0

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

15 de agosto de 2023

: 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"}

: 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"}

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

: 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:

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:

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

Con la extensión Audience Activation habilitada, puede:

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.

El tablero contiene los campos siguientes:

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:

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.

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:

Las secciones siguientes describen cómo solucionar estos problemas.

Validación de la conexión

Para validar las credenciales y la respuesta de Adobe Experience Platform, ejecute el siguiente comando:

bin/magento audiences:config:status

Este comando devuelve el estado de la conexión. Agregue el indicador -v para proporcionar información detallada adicional:

./bin/magento audiences:config:status -v

Por ejemplo:

+----------------------------------+---------------+---------------------------------------------+---------------------------------------------------------+--------------+
| Client ID                        | Client secret | Technical account ID                        | Technical account email                                 | Sandbox name |
+----------------------------------+---------------+---------------------------------------------+---------------------------------------------------------+--------------+
| 1234bd57fac8497d8933327c535347d8 | *****         | 12341E116638D6B00A495C80@techacct.adobe.com | 12345-b95b-4894-a41c-a4130d26bd80@techacct.adobe.com | dev          |

Tipo de autenticación incorrecto seleccionado en la configuració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: