segmenting-datacloud

Sobre o segmenting-datacloud

Uma habilidade voltada para a fase de Segmentação do Salesforce Data Cloud, responsável por tarefas relacionadas ao público-alvo e a análises: criação e publicação de segmentos, gerenciamento de insights calculados, verificação do número de membros em um segmento ou de sua participação, além de solução de problemas em consultas SQL relacionadas ao público-alvo. Ela é aplicada por meio dos comandos sf data360 segment e sf data360 calculated-insight, sendo utilizada em situações como criação de segmentos, publicação de fluxos de trabalho, contagem de membros ou resolução de problemas em segmentos. Trabalhos relacionados, como mapeamento e resolução de identidades, são delegados a harmonizing-datacloud; ativações subsequentes são realizadas por activating-datacloud; consultas SQL de leitura apenas e buscas em índices são tratadas por retrieving-datacloud; e tarefas relacionadas ao Modelo de Dados Padrão ou ao rastreamento de sessões são realizadas por observing-agentforce.

Antes de agir, a habilidade coleta os dados necessários, como o alias da organização-alvo, o nome da entidade unificada DMO ou base, se o usuário deseja criar, publicar, verificar ou solucionar problemas, se o recurso é um segmento ou um insight calculado, e a métrica de sucesso esperada (número de membros, valor agregado ou status de publicação). Suas regras operacionais tratam as consultas SQL de segmentos do Data Cloud como distintas das consultas SOQL do CRM, executam um classificador de prontidão compartilhado vindo da habilidade orchestrating-datacloud (diagnose-org.mjs com --phase segment) antes de modificar os recursos, preferem definições JSON reutilizáveis para criações repetíveis, utilizam a versão --api-version 64.0 quando a criação de segmentos apresenta instabilidade nas configurações padrão mais recentes, verificam os resultados por meio de contagens ou consultas SQL após a publicação ou execução, em vez de assumir sucesso automaticamente, e preferem junções SQL em vez de listar os membros do segmento quando são necessários detalhes legíveis sobre eles.

O fluxo de trabalho recomendado consiste em classificar a prontidão, verificar os segmentos e insights calculados atuais, criar novos segmentos a partir de definições em JSON, publicá-los ou executá-los explicitamente, e finalmente confirmar os resultados por meio de contagens ou consultas SQL. Avisos importantes destacam que a criação de segmentos pode exigir a versão 64.0 da API, que os membros de um segmento retornam IDs opacos, que a publicação ou execução pode iniciar tarefas assíncronas mesmo quando o comando retorna rapidamente, e que uma lista vazia geralmente indica que o módulo está acessível, mas não configurado, e não que esteja indisponível. Um formato de saída definido informa sobre a tarefa realizada, a ação executada, a organização-alvo, os recursos utilizados, a verificação realizada e o próximo passo a ser seguido. A habilidade requer um plugin CLI externo da comunidade sf data360 e uma organização habilitada para o Data Cloud, além de se basear em modelos e referências de definições compartilhados disponíveis na habilidade orchestrating-datacloud.

Perguntas Frequentes

Quais tarefas essa habilidade realiza diretamente e quais delega?

Ela é responsável por segmentos, insights calculados, fluxos de trabalho de publicação, contagem de membros e solução de problemas em consultas SQL relacionadas a segmentos. As tarefas de mapeamento, resolução de identidades e ativação são delegadas a harmonizing-datacloud, activating-datacloud, retrieving-datacloud e observing-agentforce, respectivamente.

O que é necessário para que ela funcione?

É preciso um plugin CLI externo da comunidade sf data360 e uma organização habilitada para o Data Cloud. Além disso, ela executa um classificador de prontidão compartilhado (diagnose-org.mjs com --phase segment) vindo da habilidade orchestrating-datacloud antes de modificar os recursos relacionados ao público-alvo.

Por que a criação de segmentos pode exigir uma versão específica da API?

O comportamento de criação de segmentos pode ser instável nas configurações padrão mais recentes. Por isso, a habilidade recomenda a utilização da versão --api-version 64.0 na criação de segmentos, a fim de garantir um funcionamento mais confiável.

Como obter detalhes legíveis sobre os membros de um segmento?

Utilize junções SQL em vez da instrução segment members, já que esta última retorna IDs opacos. Lembre-se de que as consultas SQL de segmentos do Data Cloud são distintas das consultas SOQL do CRM.

Como confirmar o sucesso após a publicação ou execução?

Verifique os resultados por meio de contagens de membros ou consultas SQL, em vez de assumir automaticamente que a operação foi bem-sucedida, já que as etapas de publicação e execução podem iniciar tarefas assíncronas mesmo quando o comando retorna rapidamente.

Todos os Arquivos

3 arquivosCREDITS.md0,3 KBVisualizarREADME.md1,2 KBVisualizarSKILL.md4,8 KBVisualizar