segmenting-datacloud

Acerca de segmenting-datacloud

Es una habilidad destinada a la fase de Segmentación de Salesforce Data Cloud, encargada de las tareas relacionadas con el público objetivo y los análisis: creación y publicación de segmentos, gestión de insights calculados, inspección del número de miembros o su pertenencia a un segmento, y resolución de problemas en las consultas SQL relacionadas con el público objetivo. Se utiliza a través de los comandos sf data360 segment y sf data360 calculated-insight, y es aplicable en tareas como la creación de segmentos, la publicación de flujos de trabajo, el conteo de miembros o la resolución de problemas en los segmentos. De forma explícita, delega en otras habilidades las tareas relacionadas: las tareas de DMO, mapeo y resolución de identidades se asignan a harmonizing-datacloud, la activación posterior a los segmentos a activating-datacloud, las consultas SQL de solo lectura y búsquedas en índices a retrieving-datacloud, y el análisis del Modelo de Datos Estándar o del seguimiento de sesiones a observing-agentforce.

Antes de actuar, esta habilidad recopila la información necesaria, como el alias de la organización objetivo, el nombre de la entidad DMO unificada o base, si el usuario desea crear, publicar, inspeccionar o resolver problemas, si el elemento es un segmento o un insight calculado, y el indicador de éxito esperado (número de miembros, valor agregado o estado de publicación). Sus reglas operativas tratan las consultas SQL de los segmentos de Data Cloud como algo distinto a las consultas SOQL del CRM; ejecutan un clasificador de preparación compartido proveniente de la habilidad orchestrating-datacloud (diagnose-org.mjs con --phase segment) antes de modificar los elementos, prefieren definiciones JSON reutilizables para una creación reproducible, utilizan --api-version 64.0 cuando la creación de segmentos resulta inestable con las configuraciones predeterminadas más recientes, verifican los resultados mediante conteos o consultas SQL después de la publicación o ejecución en lugar de asumir que todo ha funcionado correctamente, y optan por uniones SQL en lugar de consultar los miembros del segmento cuando se necesitan detalles legibles sobre ellos.

El flujo de trabajo recomendado consiste en clasificar el nivel de preparación, inspeccionar los segmentos y insights calculados existentes, crear nuevos segmentos a partir de definiciones en JSON, publicarlos o ejecutarlos de forma explícita, y finalmente verificar los resultados mediante conteos o consultas SQL. Entre los puntos importantes que deben tenerse en cuenta se encuentran: la creación de segmentos puede requerir la versión API 64.0, los miembros de un segmento devuelven identificadores opacos, las operaciones de publicación o ejecución pueden activar tareas asíncronas incluso cuando la respuesta del comando es rápida, y que una lista vacía suele indicar que el módulo es accesible pero no está configurado, y no que esté fuera de servicio. Un formato de salida definido informa sobre la tarea realizada, la acción ejecutada, la organización objetivo, los archivos generados, la verificación realizada y el siguiente paso a seguir. Esta habilidad requiere un plugin CLI externo de la comunidad sf data360 y una organización habilitada para Data Cloud, y hace referencia a plantillas de definiciones compartidas y a referencias contenidas en la habilidad orchestrating-datacloud.

Preguntas frecuentes

¿Qué tareas realiza esta habilidad y cuáles delega?

Realiza las tareas relacionadas con los segmentos, los insights calculados, los flujos de trabajo de publicación, el conteo de miembros y la resolución de problemas en las consultas SQL de los segmentos. Delega en harmonizing-datacloud las tareas de DMO, mapeo y resolución de identidades; en activating-datacloud la activación de los segmentos; en retrieving-datacloud las consultas SQL de solo lectura y búsquedas en índices; y en observing-agentforce el análisis del Modelo de Datos Estándar o del seguimiento de sesiones.

¿Qué se necesita para que funcione?

Se requiere un plugin CLI externo de la comunidad sf data360 y una organización habilitada para Data Cloud. Además, ejecuta un clasificador de preparación compartido (diagnose-org.mjs con --phase segment) proveniente de la habilidad orchestrating-datacloud antes de modificar los elementos del público objetivo.

¿Por qué podría ser necesaria una versión específica de la API para crear segmentos?

El comportamiento al crear segmentos puede ser inestable con las configuraciones predeterminadas más recientes, por lo que esta habilidad recomienda utilizar la versión --api-version 64.0 al crear segmentos para garantizar un funcionamiento fiable.

¿Cómo obtengo detalles legibles sobre los miembros de un segmento?

Se deben utilizar uniones SQL en lugar de la orden segment members, ya que esta última devuelve identificadores opacos. Recuerde que las consultas SQL de los segmentos de Data Cloud son diferentes de las consultas SOQL del CRM.

¿Cómo se debe confirmar el éxito tras la publicación o ejecución?

Es necesario verificar los resultados mediante conteos de miembros o consultas SQL en lugar de asumir que todo ha funcionado correctamente, ya que las operaciones de publicación o ejecución pueden iniciar tareas asíncronas incluso cuando la respuesta del comando es rápida.