Audience Activation

A extensão Audience Activation permite ativar públicos-alvo da Real-Time CDP no Adobe Commerce para criar ofertas exclusivas no carrinho. Essas ofertas e incentivos incluem técnicas comuns de merchandising de comércio eletrônico, como comprar 2 obter 1 grátis, banners ilustrados voltados para esse cliente e preços de produtos modificados por meio de várias ofertas. Os públicos-alvo criados no Real-Time CDP são baseados em dados de vários sistemas corporativos, como ERP (Enterprise Resource Planning, planejamento de recursos corporativos), CRM (Customer Relationship Management, gerenciamento de relacionamento com o cliente), ponto de venda e sistemas de marketing. Como as informações de segmento do cliente são constantemente atualizadas, os clientes podem se tornar associados e desassociados de um segmento à medida que fazem compras em sua loja.

Você pode ativar públicos em uma loja Luma ou em uma loja headless. Em uma loja Luma, as informações do público-alvo (associação de segmento) são armazenadas em um cookie no lado do Commerce. Em uma loja headless, as informações do público são passadas no cabeçalho da API do GraphQL como um parâmetro chamado: aep-segments-membership.

Notas de versão

Esta seção contém informações sobre atualizações na extensão Audience Activation e inclui:

- Novos recursos
- Correções e melhorias
- Problemas conhecidos

Consulte Versões futuras para saber mais sobre os cronogramas de lançamento e o suporte.

Consulte a documentação do desenvolvedor para saber mais sobre compatibilidade de produto.

Atualizações de serviço compatíveis

Essas notas de versão descrevem alterações de recursos e correções relacionadas a extensões usadas pelo Audience Activation.

2.3.1

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

12 de novembro de 2024

- Corrigido um problema ao filtrar os públicos-alvo disponíveis do Real-Time CDP para escolher.

2.3.0

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

29 de julho de 2024

- Sintaxe de linha de comando adicionada para que você possa testar credenciais para determinar se elas precisam ser atualizadas para obter dados de público-alvo da Adobe Experience Platform.

2.2.0

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

12 de junho de 2024

- Versão do GA para regras de produto relacionadas informada por públicos.

2.1.1

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

4 de abril, 2024

- Suporte adicionado para PHP 8.3.

2.2.0-beta1

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

16 de fevereiro de 2024

- Se você estiver participando do beta, verifique se o arquivo composer.json tem o seguinte no nível raiz: "minimum-stability": "beta".
- (Beta) Adicionou a capacidade de criar regras de produto relacionadas informadas pelos públicos-alvo.

2.1.0

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

24 de janeiro de 2024

- O painel de Públicos-alvo da Real-Time CDP foi atualizado para incluir os sites que contêm os públicos-alvo e especificar quais blocos dinâmicos e regras de preço do carrinho estão configurados para usar esses públicos-alvo.

2.0.1

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

16 de novembro de 2023

- Estabilidade aprimorada.

2.0.0

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

10 de outubro de 2023

- Adição de suporte para OAuth 2.0 ao configurar a extensão Audience Activation.
- Estabilidade aprimorada.

1.2.0

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

15 de agosto de 2023

- Atualização da versão dos componentes da interface do usuário.

1.1.0

30 de maio de 2023

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

- Suporte adicionado para blocos dinâmicos em uma loja headless.

1.0.1

11 de maio de 2023

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

- Corrigido um problema no qual uma regra de preço de carrinho ou bloco dinâmico não era aplicada à loja.
- Corrigido um problema no qual uma instalação não configurada da extensão Audience Activation causava um erro quando um comerciante tentava criar ou atualizar um bloco dinâmico.

1.0.0

31 de março de 2023

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

- Versão de disponibilidade geral

Implementação

As tarefas a seguir se aplicam às implementações do Luma e da loja headless. Para ativar públicos no Adobe Commerce, você deve:

Instalar a extensão

Instale a extensão Audience Activation do marketplace ou execute o seguinte comando:

composer require magento/audiences

Configurar a extensão

Depois de instalar a extensão Audience Activation, faça logon no Commerce Admin e conclua o seguinte:

Onde usar os públicos-alvo da Real-Time CDP no Commerce

Com a extensão Audience Activation habilitada, você pode:

painel de públicos-alvo da Real-Time CDP

Você pode exibir todos os públicos-alvo ativos que estão disponíveis para personalização na sua instância do Adobe Commerce usando o painel Públicos-alvo da Real-Time CDP.

Para acessar o painel Públicos-alvo do Real-Time CDP, vá para a barra lateral Admin e, em seguida, vá para Customers > Real-time CDP Audience.

{width="700" modal="regular"}

O painel contém os seguintes campos:

Suporte a headless

Você pode ativar públicos-alvo em uma instância do Adobe Commerce headless, como AEM e PWA, para exibir regras de preço do carrinho, regras de produto relacionadas ou blocos dinâmicos com base nos públicos-alvo.

Regras de preço do carrinho e regras de produto relacionadas

Para regras de preço do carrinho e regras de produtos relacionadas, uma loja headless se comunica com o Experience Platform através do Commerce integration framework (CIF). A estrutura fornece uma API do lado do servidor que é implementada usando o GraphQL. As informações de público, como o segmento de um comprador, são transmitidas para o Commerce por meio de um parâmetro de cabeçalho do GraphQL chamado: aep-segments-membership.

A arquitetura geral é a seguinte:

{width="700" modal="regular"}

Depois de instalar e configurar a extensão, o SDK da Web do Experience Platform contém as informações do público-alvo na forma de associação de segmento.

Para capturar essas associações de segmento do SDK, consulte este trecho de código.

Depois de recuperá-lo, você pode passar esses segmentos para o Commerce no cabeçalho do GraphQL. Por exemplo:

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

Blocos dinâmicos

Para blocos dinâmicos, as consultas dynamicBlocks do GraphQL podem conter o atributo de entrada audience_id. Se você especificar um ou mais valores audience_id em uma consulta dynamicBlocks, ela retorna uma lista de blocos dinâmicos atribuídos a esses públicos.

Exemplo de uso

A consulta a seguir retorna todos os blocos dinâmicos associados a várias IDs de público-alvo.

Solicitação:

{
  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
  }
}

Resposta:

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

Saiba mais sobre a consulta do GraphQL dynamicBlocks na documentação para desenvolvedores.

Recuperar públicos-alvo usando o SDK do Adobe Experience Platform Mobile

Você pode recuperar públicos-alvo da Real-Time CDP usando o SDK móvel da Adobe Experience Platform.

Após concluir a configuração, use as operações do SDK móvel para recuperar os dados do público-alvo. Por exemplo:

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

Depois que os dados forem recuperados, você poderá usá-los para criar regras de preço do carrinho, blocos dinâmicos e regras de produto relacionadas informadas pelo público-alvo no aplicativo Commerce.

Os públicos-alvo não são exibidos no Commerce

Se os públicos-alvo da Real-Time CDP não estiverem sendo exibidos no Commerce, talvez seja devido a:

As seções a seguir descrevem como solucionar esses problemas.

Validar a conexão

Para validar as credenciais e a resposta do Adobe Experience Platform, execute o seguinte comando:

bin/magento audiences:config:status

Este comando retorna o status da conexão. Adicione o sinalizador -v para fornecer detalhamento extra:

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

Por exemplo:

+----------------------------------+---------------+---------------------------------------------+---------------------------------------------------------+--------------+
| 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 autenticação incorreto selecionado na configuração

Privilégios insuficientes no token gerado

Esse problema pode ser causado por privilégios insuficientes de API para o token gerado. Para garantir que o token tenha os privilégios corretos: