Audience Activation

A variável Audience Activation A extensão permite ativar os públicos da Real-Time CDP no Adobe Commerce para criar ofertas exclusivas no carrinho. Essas ofertas e incentivos incluem técnicas comuns de comercialização por comércio eletrônico, como comprar 2 obter 1 grátis, banners ilustrativos direcionados a 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-alvo em uma loja Luma ou headless vitrine eletrônica. 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-alvo 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 aprimoramentos
- Problemas conhecidos

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

Consulte a documentação do desenvolvedor para saiba mais sobre a compatibilidade do 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.1.1

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

4 de abril de 2024

- Adição de suporte 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 composer.json O arquivo tem o seguinte no nível raiz: "minimum-stability": "beta".
- (Beta) Adição da capacidade de criar regras de produto relacionadas informados pelos públicos-alvo.

2.1.0

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

24 de janeiro de 2024

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

2.0.1

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

16 de novembro de 2023

- Maior estabilidade.

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.
- Maior estabilidade.

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

- Correção de um problema em que uma regra de preço de carrinho ou bloco dinâmico não era aplicada à loja.
- Correção de um problema em que 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 o Audience Activation extensão do marketplaceou execute o seguinte comando:

composer require magento/audiences

Configurar a extensão

Depois de instalar o Audience Activation você deve fazer logon no Administrador do Commerce e concluir o seguinte:

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

Com o Audience Activation extensão ativada, é possível:

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

É possível exibir todos ativo públicos-alvo disponíveis para personalizar na instância do Adobe Commerce usando o Públicos da Real-Time CDP painel.

Para acessar o Públicos da Real-Time CDP painel, vá para a página Admin barra lateral e 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 produto 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 do público-alvo, 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 que você instalar e configurar Na 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 esta trecho de código.

Após recuperá-los, você pode passar esses segmentos para o Commerce dentro do 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, GraphQL dynamicBlocks as consultas podem conter a variável audience_id atributo de entrada. Se você especificar um ou mais audience_id valores em uma dynamicBlocks , ele 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 o dynamicBlocks consulta do GraphQL no documentação do desenvolvedor.

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 do forem recuperados, você poderá usá-los para criar conjuntos de relatórios regras de preço do carrinho, blocos dinâmicos e regras de produto relacionadas no aplicativo Commerce.

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

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

As duas seções a seguir descrevem como solucionar problemas em ambos os casos.

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: