Audience Activation

El Audience Activation La extensión de 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 en comercio electrónico, como comprar 2 obtener 1 gratis, banners promocionales 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 acéfalo tienda. 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 funciones
Fix - 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 obtenga 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

Fix - Se ha actualizado el Panel de audiencias de Real-Time CDP para simplificar el filtrado.

27 de junio de 2023

Fix - Se ha agregado compatibilidad con PHP 8.2 en el magento/module-data-services-graphql paquete.

30 de mayo de 2023

Nuevo - Se ha actualizado el Panel 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 producto relacionadas informado por las audiencias.

2.1.1

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

4 de abril de 2024

Nuevo - Añadido soporte para 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 composer.json tiene lo siguiente en el nivel raíz: "minimum-stability": "beta".
Nuevo - (Beta) Capacidad añadida para crear reglas de producto relacionadas informado por las audiencias.

2.1.0

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

24 de enero de 2024

Nuevo - Se ha actualizado el Panel de audiencias de Real-Time CDP para incluir los sitios web que contienen las audiencias y especificar qué bloques dinámicos y reglas de precios del carro de compras están configuradas para utilizar esas audiencias.

2.0.1

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

16 de noviembre de 2023

Fix - Mayor estabilidad.

2.0.0

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

10 de octubre de 2023

Nuevo - Se ha agregado compatibilidad con OAuth 2.0 al configurar la extensión de Audience Activation.
Fix - Mayor estabilidad.

1.2.0

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

15 de agosto de 2023

Fix : se ha actualizado la versión de los componentes de IU.

1.1.0

30 de mayo de 2023

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

Nuevo - Se ha agregado compatibilidad con bloques dinámicos en una tienda sin encabezado.

1.0.1

11 de mayo de 2023

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

Fix - Se ha corregido un problema por el cual una regla de precio de carro o bloque dinámico no se aplicaba a la tienda.
Fix - Se ha corregido un problema por el cual 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 el Audience Activation Extensión en el administrador
  • Configurar el Audience Activation Extensión en el administrador

Instalación de la extensión

Instale el Audience Activation extensión desde el mercado, o ejecute el siguiente comando:

composer require magento/audiences

Configuración de la extensión

Después de instalar el Audience Activation Con la extensión, debe iniciar sesión en el administrador de Commerce y completar los pasos siguientes:

  1. En el Administrador barra lateral, vaya a System > Services>Commerce Services Connector.

  2. Iniciar sesión a su cuenta de Adobe y seleccione su ID de organización.

  3. En el Administrador barra lateral, vaya a System > Services>Data Connection.

  4. En el Datastream ID , pegue el ID de la secuencia de datos que creó al activado 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 todavía no ha creado un conjunto de datos, crear uno en Experience Platform, añadir al destino de Commerce en Real-Time CDP y al de Data Connection en el Administrador de.

    note note
    NOTE
    Al especificar un ID de secuencia de datos, asociarlo a un sitio web específico en el Data Connection extensión. Si su tienda de Commerce tiene varios sitios web, crear un destino para cada sitio web en Real-Time CDP y utilice un ID de flujo de datos diferente para cada uno.
  5. En el Administrador barra lateral, vaya a Stores > Settings>Configuration.

  6. Expandir Services y seleccione Data Connection.

  7. Añadir cuenta de servicio y detalles de credenciales.

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

Con el Audience Activation con la extensión habilitada, puede:

TIP
Para obtener un caso de uso completo e integral sobre cómo exportar Commerce datos en Real-Time CDP, cree una audiencia y actívela para que Commerce, consulte Creación de una audiencia en Real-Time CDP con Commerce datos de evento.

Panel de audiencias de Real-Time CDP

Puede ver todos los activo audiencias que están disponibles para personalizar en la instancia de Adobe Commerce mediante el Audiencias de Real-Time CDP panel.

Para acceder a Audiencias de Real-Time CDP panel, vaya a Administrador barra lateral y vaya 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 el Origin, Websites, Dynamic Blocks, Cart Price Rules, y Last updated columnas.

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 de carro de compras y las reglas de productos relacionadas, una tienda sin encabezado se comunica al Experience Platform a través de la 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 una tienda sin encabezado al servidor

Después de usted instalar y configurar Con 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 lo siguiente 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, GraphQL dynamicBlocks las consultas pueden contener el audience_id atributo de entrada. Si especifica una o más audience_id valores en una dynamicBlocks consulta, devuelve 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 dynamicBlocks Consulta de GraphQL en 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, puede utilizarlos para crear audiencias informadas reglas de precios de carrito, bloques dinámicos y reglas de producto relacionadas en la aplicación de 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:

  • Tipo de autenticación incorrecto seleccionado en la Conexión de datos página de configuración
  • 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 el Administrador barra lateral, vaya a Stores > Settings>Configuration.
  3. Expandir Services y seleccione Data Connection.
  4. Asegúrese del método de autorización de servidor a servidor especificado en la Authentication Type El campo es correcto. Adobe recomienda utilizar 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. Añada la función que contiene Manage destinations permiso.
  8. Clic Save.
  9. Regenerar el token de acceso en la consola.
  10. Compruebe que el token proporciona una respuesta válida utilizando API de conexiones de Target.
recommendation-more-help
09e7db7e-4210-474a-8bbf-c72a92c7537c