Guia de segmentação de transmissão

Segmentação de streaming é a capacidade de avaliar audiências no Adobe Experience Platform quase em tempo real, enquanto se concentra na riqueza de dados.

Com a segmentação de streaming, a qualificação do público agora acontece à medida que os dados de streaming chegam ao Experience Platform, diminuindo a necessidade de agendar e executar tarefas de segmentação. Isso permite avaliar os dados conforme eles são transmitidos para o Experience Platform, permitindo que a associação do público-alvo seja mantida atualizada automaticamente.

Conjuntos de regras elegíveis rulesets

Um conjunto de regras será elegível para segmentação por transmissão se atender a qualquer um dos critérios descritos na tabela a seguir.

Tipo de consulta

Detalhes

Consulta

Exemplo

Evento único em uma janela de tempo de menos de 24 horas

Qualquer definição de segmento que se refira a um único evento recebido em uma janela de tempo de menos de 24 horas.

CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(today)])

Somente perfil

Qualquer definição de segmento que se refere apenas a um atributo de perfil.

homeAddress.country.equals("Canada", false)

Evento único com um atributo de perfil em uma janela de tempo relativa de menos de 24 horas

Qualquer definição de segmento que se refere a um único evento recebido, com um ou mais atributos de perfil, e ocorre em uma janela de tempo relativa de menos de 24 horas.

workAddress.country.equals("Canada", false) and CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(today)])

Vários eventos em uma janela de tempo relativa de 24 horas

Qualquer definição de segmento que se refere a vários eventos nas últimas 24 horas e (opcionalmente) tem um ou mais atributos de perfil.

workAddress.country.equals("US", false) and CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("directMarketing.emailClicked", false)) WHEN(today), C1: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(today)])

Uma definição de segmento não estará qualificada para segmentação por transmissão nos seguintes cenários:

Observe as diretrizes a seguir que se aplicam às consultas de segmentação por transmissão:

Se uma definição de segmento for modificada para não atender mais aos critérios de segmentação por transmissão, a definição de segmento mudará automaticamente de "Transmissão" para "Lote".

Além disso, a desqualificação de segmento, da mesma forma que a qualificação de segmento, acontece em tempo real. Como resultado, se um público não mais se qualificar para um segmento, ele será imediatamente desqualificado. Por exemplo, se a definição do segmento solicitar "Todos os usuários que compraram sapatos vermelhos nas últimas três horas", após três horas, todos os perfis que se qualificaram inicialmente para a definição do segmento serão desqualificados.

Combinar públicos-alvo combine-audiences

Para combinar dados de fontes de lote e de transmissão, será necessário separar os componentes de lote e transmissão em públicos separados.

Atributo de perfil e Evento de experiência profile-and-event

Por exemplo, vamos levar em consideração os dois públicos-alvo a seguir:

Se quiser usar o componente de lote no seu público de streaming, você precisará fazer uma referência ao público em lote usando o segmento de segmentos.

Portanto, um conjunto de regras de exemplo que combinasse os dois públicos-alvo teria a seguinte aparência:

inSegment("e3be6d7f-1727-401f-a41e-c296b45f607a") and
CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false))
WHEN(<= 24 hours before now)])

O público resultante será avaliado usando a segmentação de streaming, uma vez que aproveita a associação do público em lote referindo-se ao componente de público em lote.

Vários eventos de experiência two-events

Se você deseja combinar vários públicos com dados do evento, não pode apenas combinar os eventos. Você precisará criar um público-alvo para cada evento e, em seguida, criar outro público-alvo que use inSegment para fazer referência a todos os públicos-alvo.

Por exemplo, digamos que você tenha dois públicos-alvo, com ambos os públicos-alvo abrigando dados do esquema do evento de experiência:

Nessa situação, seria necessário criar um terceiro público-alvo da seguinte maneira:

inSegment("7deb246a-49b4-4687-95f9-6316df049948) and inSegment("9e1646bb-57ff-4309-ba59-17d6c5bab6a1")

Criar público-alvo create-audience

Você pode criar um público-alvo que seja avaliado usando a segmentação por transmissão usando a API do Serviço de segmentação ou o Audience Portal na interface.

Uma definição de segmento pode ser habilitada para streaming se corresponder a um dos conjuntos de regras qualificados.

POST /segment/definitions

curl -X POST https://platform.adobe.io/data/core/ups/segment/definitions
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '{
        "name": "People in the USA",
        "description: "An audience that looks for people who live in the USA",
        "expression": {
            "type": "PQL",
            "format": "pql/text",
            "value": "homeAddress.country = \"US\""
        },
        "evaluationInfo": {
            "batch": {
                "enabled": false
            },
            "continuous": {
                "enabled": true
            },
            "synchronous": {
                "enabled": false
            }
        },
        "schema": {
            "name": "_xdm.context.profile"
        }
     }'

{
    "id": "4afe34ae-8c98-4513-8a1d-67ccaa54bc05",
    "schema": {
        "name": "_xdm.context.profile"
    },
    "profileInstanceId": "ups",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "28e74200-e3de-11e9-8f5d-7f27416c5f0d",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "name": "People in the USA",
    "description": "An audience that looks for people who live in the USA",
    "expression": {
        "type": "PQL",
        "format": "pql/text",
        "value": "homeAddress.country = \"US\""
    },
    "evaluationInfo": {
        "batch": {
            "enabled": false
        },
        "continuous": {
            "enabled": true
        },
        "synchronous": {
            "enabled": false
        }
    },
    "dataGovernancePolicy": {
        "excludeOptOut": true
    },
    "creationTime": 0,
    "updateEpoch": 1579292094,
    "updateTime": 1579292094000
}

Recuperar públicos-alvo retrieve-audiences

Você pode recuperar todos os públicos-alvo avaliados por meio da segmentação por transmissão usando a API do serviço de segmentação ou o Audience Portal na interface do usuário.

GET /segment/definitions?evaluationInfo.continuous.enabled=true

curl -X GET 'https://platform.adobe.io/data/core/ups/segment/definitions?evaluationInfo.continuous.enabled=true' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

{
    "segments": [
        {
            "id": "15063cb-2da8-4851-a2e2-bf59ddd2f004",
            "schema": {
                "name": "_xdm.context.profile"
            },
            "ttlInDays": 30,
            "imsOrgId": "{ORG_ID}",
            "sandbox": {
                "sandboxId": "",
                "sandboxName": "",
                "type": "production",
                "default": true
            },
            "name": " People who are NOT on their homepage ",
            "expression": {
                "type": "PQL",
                "format": "pql/text",
                "value": "select var1 from xEvent where var1._experience.analytics.endUser.firstWeb.webPageDetails.isHomePage = false"
            },
            "evaluationInfo": {
                "batch": {
                    "enabled": false
                },
                "continuous": {
                    "enabled": true
                },
                "synchronous": {
                    "enabled": false
                }
            },
            "creationTime": 1572029711000,
            "updateEpoch": 1572029712000,
            "updateTime": 1572029712000
        },
        {
            "id": "f15063cb-2da8-4851-a2e2-bf59ddd2f004",
            "schema": {
                "name": "_xdm.context.profile"
            },
            "ttlInDays": 30,
            "imsOrgId": "{ORG_ID}",
            "sandbox": {
                "sandboxId": "",
                "sandboxName": "",
                "type": "production",
                "default": true
            },
            "name": "Homepage_continuous",
            "description": "People who are on their homepage - continuous",
            "expression": {
                "type": "PQL",
                "format": "pql/text",
                "value": "select var1 from xEvent where var1._experience.analytics.endUser.firstWeb.webPageDetails.isHomePage = true"
            },
            "evaluationInfo": {
                "batch": {
                    "enabled": true
                },
                "continuous": {
                    "enabled": true
                },
                "synchronous": {
                    "enabled": false
                }
            },
            "creationTime": 1572021085000,
            "updateEpoch": 1572021086000,
            "updateTime": 1572021086000
        }
    ],
    "page": {
        "totalCount": 2,
        "totalPages": 1,
        "sortField": "creationTime",
        "sort": "desc",
        "pageSize": 2,
        "limit": 100
    },
    "link": {}
}

Detalhes do público-alvo audience-details

Você pode exibir detalhes de um público específico avaliado usando a segmentação de streaming selecionando-a no Portal do Público.

Depois de selecionar um público no Portal do Público, a página de detalhes do público-alvo é exibida. Isso exibe informações sobre o público-alvo, incluindo um resumo dos detalhes do público-alvo, a quantidade de perfis qualificados ao longo do tempo, bem como os destinos para os quais o público-alvo foi ativado.

Para públicos habilitados para transmissão, o cartão Profiles over time é exibido, mostrando o total de métricas qualificadas e o novo público atualizado.

A métrica Total qualified representa o número total de públicos qualificados, com base nas avaliações em lote e de fluxo para esse público.

A métrica New audience updated é representada por um gráfico de linhas que mostra a alteração no tamanho do público-alvo por meio da segmentação por transmissão. Você pode ajustar a lista suspensa para mostrar as últimas 24 horas, a última semana ou os últimos 30 dias.

Para obter mais detalhes sobre detalhes do público-alvo, leia a Visão geral do Portal de público-alvo.

Próximas etapas

Este guia explica como as definições de segmento habilitadas para streaming funcionam no Adobe Experience Platform e como monitorar definições de segmento habilitadas para streaming.

Para saber mais sobre como usar a interface do usuário do Adobe Experience Platform, leia o Guia do usuário de segmentação.

Para perguntas frequentes sobre a segmentação por transmissão, leia a seção segmentação por transmissão das Perguntas frequentes.