DocumentaçãoAEMGuia do AEM Screens

Configuração do ContextHub no AEM Screens :headding-anchor:configuring-contexthub-in-aem-screens

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Intermediário
  • Desenvolvedor

Esta seção enfatiza a criação e o gerenciamento de alterações de ativos orientados por dados usando um armazenamento de dados.

Termos principais :headding-anchor:key-terms

Antes de entrar nos detalhes de criação e gerenciamento de canais orientados por inventário no seu projeto do AEM Screens, aprenda alguns dos termos principais para os diferentes cenários.

Marca - Sua descrição de projeto de alto nível.

Área - O nome do seu projeto do AEM Screens, como Sinalização Digital de Anúncio

Atividade - Define as regras de categoria, como Orientado a Inventário, Orientado ao Clima ou Orientado à Disponibilidade do Departamento.

Público-alvo - Define a regra.

Segmento - A versão de um ativo para reproduzir para a regra especificada. Por exemplo, se a temperatura estiver abaixo de 50 graus Fahrenheit, a tela exibe uma imagem de uma bebida quente, caso contrário, uma bebida fria.

O diagrama a seguir fornece uma representação visual de como as configurações do ContextHub coincidem com a Atividade, o Público-alvo e os Canais.

screen_shot_2019-05-29at53729pm

Pré-condições :headding-anchor:preconditions

Antes de começar a definir as configurações do ContextHub para um projeto do AEM Screens, configure o Google Sheets (para fins de demonstração).

IMPORTANT
O Google Sheets é usado no exemplo a seguir como um sistema de banco de dados de amostra de onde os valores são buscados e é exclusivamente para fins educacionais. A Adobe não endossa o uso do Google Sheets em ambientes de produção.
Para obter mais informações, consulte Obter chave de API na documentação da Google.

Etapa 1: configuração de um armazenamento de dados :headding-anchor:step-setting-up-a-data-store

Você pode configurar o armazenamento de dados como um evento de E/S local ou como um evento de banco de dados local.

O exemplo de acionadores de dados a seguir mostra um evento de banco de dados local. O evento configura um armazenamento de dados, como uma planilha do Excel que permite usar as configurações do ContextHub e o caminho dos segmentos para o canal do AEM Screens.

Depois de configurar a planilha google corretamente, conforme mostrado no exemplo abaixo:

imagem

A validação a seguir é o que você vê ao verificar sua conexão inserindo os dois valores, *google sheet ID* e *API key* no formato abaixo:

https://sheets.googleapis.com/v4/spreadsheets/<your sheet id>/values/Sheet1?key=<your API key>

imagem

NOTE
O exemplo específico abaixo mostra as Google Sheets como um armazenamento de dados que aciona uma alteração de ativo se o valor for maior que 100 ou menor que 50.

Etapa 2: definição das configurações de armazenamento :headding-anchor:step-setting-store-configurations

  1. Navegando até o ContextHub

    Navegue até a instância do AEM e clique no ícone de ferramentas na barra lateral esquerda. Clique em Sites > ContextHub, conforme mostrado na figura abaixo.

    imagem

  2. Criando uma configuração de armazenamento do ContextHub

    1. Navegue até o contêiner de configuração denominado telas.

    2. Clique em Criar > Criar Contêiner de Configuração e insira o título como ContextHubDemo.

      imagem

    3. Navegue até ContextHubDemo > Criar Configuração do ContentHub e clique em Salvar.

      note note
      NOTE
      Depois de clicar em Salvar, você estará na tela Configuração do ContextHub.

    4. Na tela Configuração do ContextHub, clique em Criar > Configuração de Armazenamento do ContentHub

    imagem

    note caution
    CAUTION
    Como parte do AEM 6.5 Feature Pack 4 ou AEM 6.4 Feature Pack 8, os clientes devem atualizar o /conf/screens/settings/cloudsettings para sling:Folder.
    Siga as etapas abaixo:
    1. Navegue até o CRXDE Lite e, em seguida, até /conf/screens/settings/cloudsettings.
    2. Verifique se cloudsettings jcr:primaryType está em sling:Folder. Se o jcr:primaryType não estiver em sling:folder, continue com as próximas etapas.
    3. Clique com o botão direito do mouse em /conf/screens/settings, crie um nó com name como cloudsettings1 e Type como sling:Folder e salve as alterações.
    4. Mover todos os nós em /conf/screens/settings/cloudsettings para cloudsettings1.
    5. Exclua cloudsettings e salve.
    6. Renomeie cloudsettings1 como cloudsettings e salve.
    7. Observe que /conf/screens/settings/cloudsettings tem jcr:primaryType como sling:Folder.
    Siga estas etapas em Autor e Publish antes ou depois da atualização.

    1. Insira o Título como Google Sheets, Nome do Repositório como googlesheets e Tipo de Repositório como contexthub.generic-jsonp e clique em Avançar.

      note caution
      CAUTION
      Se você estiver usando o Adobe Experience Manager (AEM) 6.4, insira o Título da Configuração como googlesheets e o Tipo de Loja como contexthub.generic-jsonp.

      imagem

    2. Insira sua configuração json específica. Por exemplo, você pode usar o seguinte json para fins de demonstração e clicar em Salvar. Você vê a configuração de armazenamento intitulada como Google Sheets na configuração do ContextHub.

      note important
      IMPORTANT
      Substitua o código por *<Sheet ID>* e *<API Key>*, que você buscou ao configurar o Google Sheets.
      code language-none 
       {
  "service": {
  "host": "sheets.googleapis.com",
  "port": 80,
  "path": "/v4/spreadsheets/<your google sheets id>/values/Sheet1",
  "jsonp": false,
  "secure": true,
  "params": {
  "key": "<your Google API key>"
 }
},
"pollInterval": 10000
}
      note note
      NOTE
      No código de exemplo acima, pollInterval define a frequência com que os valores são atualizados (em milissegundos).
      Substitua o código por seus *<Sheet ID>* e *<API Key>*, que você buscou ao configurar o Google Sheets.
      note caution
      CAUTION
      Se você criar suas Planilhas do Google para armazenar configurações fora da pasta global (por exemplo, em sua própria pasta de projeto), o direcionamento não funcionará imediatamente.

  3. Configurando a Segmentação de Repositório

    1. Navegue até Configuração de armazenamento do ContentHub e crie outra configuração de armazenamento no contêiner de configuração do AEM Screens e defina o Título como segmentation-contexthub, Nome do armazenamento como segmentação e Tipo de armazenamento como aem.segmentation.

      imagem

    2. Clique em Avançar e depois em Salvar.

      note note
      NOTE
      Ignore o processo de definição do json e deixe-o em branco.

Etapa 3: Configuração de segmentos no Audience :headding-anchor:setting-up-audience

  1. Criando segmentos em públicos-alvo

    1. Navegue da sua instância do AEM para Personalization > Públicos-alvo > telas.

    2. Clique em Criar > Criar segmento do ContextHub. A caixa de diálogo Novo segmento do ContextHub é aberta.

    3. Insira o Título como **Higherthan50** e clique em Criar. Da mesma forma, crie outro segmento intitulado como **Lowerthan50**.

      imagem

    4. Clique no segmento **Higherthan50** e clique em Propriedades na barra de ações.

      imagem

    5. Clique na guia Personalization em Propriedades do segmento. Defina o Caminho do ContextHub como /conf/screens/settings/cloudsettings/ContextHubDemo/contexthub configurations e Caminho de Segmentos como /conf/screens/settings/wcm/segments e clique em Salvar, conforme mostrado na figura abaixo.

    imagem

    1. Da mesma forma, defina também o Caminho do ContextHub e o Caminho de Segmentos para o segmento **Lowerthan50**.

Etapa 4: configuração da marca e da área :headding-anchor:setting-brand-area

Siga as etapas abaixo para criar uma marca em suas atividades e áreas sob a marca:

  1. Criando uma Marca nas Atividades

    1. Navegue da sua instância do AEM para Personalization > Atividades.

    2. Clique em Criar > Criar Marca.

    3. Clique em Marca no assistente Criar Página e clique em Avançar.

    4. Insira o Título como MarcaDaTela e clique em Criar. Sua marca agora é criada conforme mostrado abaixo.

      imagem

      note caution
      CAUTION
      Problema conhecido:
      Para adicionar uma área, remova a principal do URL, como
      http://localhost:4502/libs/cq/personalization/touch-ui/content/v2/activities.html/content/campaigns/screensbrand/master.

  2. Criando uma Área em sua Marca

    Siga as etapas abaixo para criar uma área na marca:

    1. Clique em Criar e depois em Criar área.

      imagem

    2. Clique em Área do assistente Criar Página e clique em Avançar.

    3. Insira o Title como ScreensValue e clique em Criar.
      Uma área é criada na sua marca.

Etapa 5: Criação de segmentos em uma atividade :headding-anchor:step-setting-up-audience-segmentation

Depois de configurar um armazenamento de dados e definir sua atividade (marca e área), siga as etapas abaixo para criar segmentos em sua atividade.

  1. Criando segmentos em atividades

    1. Navegue da sua instância do AEM para Personalization > Atividades > ScreensBrand >ScreensValue.

    2. Clique em Criar > Criar Atividade. O Assistente para Configurar Atividade é aberto.

    3. Insira o Título como ValueCheck50 e Nome como valuecheck50. Clique no Mecanismo de direcionamento como ContextHub (AEM) no menu suspenso e clique em Avançar.

      imagem

    4. Clique em Adicionar experiência no assistente **Configure Activity**.

    5. Nos Públicos-alvo, clique em **Higherthan50**, clique em Adicionar Experiência e insira o Título como **higherthan50** Nome como **higherthan50**. Clique em Ok.

    6. Nos Públicos-alvo, clique em **Lowerthan50**, clique em Adicionar Experiência e insira o Título como **lowerthan50** Nome como **lowerthan50**. Clique em Ok.

    imagem

    1. Clique em Avançar e depois em Salvar. A atividade **ValueCheck50** foi criada e configurada.

      imagem

Etapa 5: Edição de segmentos em públicos :headding-anchor:editing-audience-segmentation

  1. Editando os Segmentos

    1. Navegue da sua instância do AEM para Personalization > Públicos-alvo > telas.

    2. Clique no segmento **Higherthan50** e em Editar na barra de ações.

    3. Arraste e solte o componente Comparação: Propriedade - Valor no editor.

    4. Clique no ícone de chave inglesa para abrir a caixa de diálogo Comparando uma propriedade com o valor.

    5. Clique em googlesheets/value/1/0 no menu suspenso em Nome da propriedade.

      note note
      NOTE
      O googlesheets/value/1/0 faz referência à linha 2 e à coluna conforme preenchido nas planilhas google na figura abaixo:

      imagem

    6. Clique no Operador como maior que no menu suspenso.

    7. Insira o Valor como 70.

      note note
      NOTE
      O AEM valida seus dados da Planilha do Google mostrando seu segmento como verde.

      imagem

    Da mesma forma, edite os valores de propriedade para **Lowerthan50**.

    1. Arraste e solte o componente Comparação: Propriedade - Valor no editor.

    2. Clique na chave inglesa.

    3. Na caixa de diálogo Comparando uma propriedade com o valor, clique em googlesheets/value/1/0 no menu suspenso em Nome da propriedade.

    4. Clique no Operador como menor que no menu suspenso.

    5. Insira o Valor como 50.

Ativação do direcionamento em canais :headding-anchor:step-enabling-targeting-in-channels

Siga as etapas abaixo para ativar o direcionamento em seus canais.

  1. Navegue até um dos canais do AEM Screens. As etapas a seguir demonstram como habilitar o direcionamento usando o DataDrivenChannel criado em um canal do AEM Screens.

  2. Clique no canal TargetChannel e clique em Propriedades na barra de ações.

    imagem

  3. Clique na guia Personalization para definir as configurações do ContextHub.

    1. Defina o Caminho do ContextHub como /conf/screens/settings/wcm/segments e o Caminho de Segmentos como /conf/screens/settings/wcm/segments.

    2. Defina a marca como ScreensBrand a partir da lista suspensa e Defina a Referência de Área como ScreensValue.

    3. Clique em Salvar e fechar.

      note note
      NOTE
      Use o ContextHub e o caminho Segmentos, onde você salvou inicialmente as configurações e os segmentos do ContextHub.

      imagem

    4. Navegue e clique no canal TargetChannel e clique em Editar na barra de ações.

      note note
      NOTE
      Se você configurou tudo corretamente, verá a opção Direcionamento no menu suspenso do editor, como mostrado na figura abaixo.

      imagem

Saiba Mais: Exemplo De Casos De Uso :headding-anchor:learn-more-example-use-cases

Depois de configurar o ContextHub para seu projeto do AEM Screens, você pode seguir os diferentes Casos de uso para entender como os ativos acionados por dados desempenham um papel vital em diferentes setores:

  1. Ativação Direcionada para Estoque de Varejo
  2. Ativação da temperatura do centro de viagens
  3. Ativação de Reserva de Hospitalidade
recommendation-more-help
adce462a-f916-4dbe-9ab5-0b62cfb0f053