(Alfa) Ponto de extremidade da API de atributos calculados

IMPORTANTE

A funcionalidade de atributo calculado descrita neste documento está atualmente em alfa e não está disponível para todos os usuários. A documentação e a funcionalidade estão sujeitas a alterações.

Atributos calculados são funções usadas para agregar dados no nível do evento em atributos no nível do perfil. Essas funções são calculadas automaticamente para que possam ser usadas na segmentação, ativação e personalização. Este guia inclui exemplos de chamadas de API para executar operações básicas de CRUD usando o /computedAttributes endpoint .

Para saber mais sobre atributos calculados, comece lendo a variável visão geral dos atributos calculados.

Introdução

O endpoint da API usado neste guia faz parte do API de perfil do cliente em tempo real.

Antes de continuar, reveja o Guia de introdução à API de perfil para obter links para a documentação recomendada, um guia para ler as chamadas de API de exemplo que aparecem neste documento e informações importantes sobre os cabeçalhos necessários para fazer chamadas com êxito para qualquer API do Experience Platform.

Configurar um campo de atributo calculado

Para criar um atributo calculado, primeiro é necessário identificar o campo em um schema que manterá o valor do atributo calculado.

Consulte a documentação em configuração de um atributo calculado para obter um guia completo sobre a criação de um campo de atributo calculado em um schema.

AVISO

Para prosseguir com o guia da API, você deve ter um campo de atributo calculado configurado.

Criar um atributo calculado

Com o campo de atributo calculado definido no esquema Perfil ativado, agora é possível configurar um atributo calculado. Se ainda não tiver feito isso, siga o fluxo de trabalho descrito na configuração de um atributo calculado documentação.

Para criar um atributo calculado, comece fazendo uma solicitação de POST para o /config/computedAttributes endpoint com corpo de solicitação contendo os detalhes do atributo calculado que você deseja criar.

Formato da API

POST /config/computedAttributes

Solicitação

curl -X POST \
  https://platform.adobe.io/data/core/ups/config/computedAttributes \
  -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}' \
  -d '{
        "name": "birthdayCurrentMonth",
        "path": "_{TENANT_ID}",
        "description": "Computed attribute to capture if the customer birthday is in the current month.",
        "expression": {
            "type": "PQL",
            "format": "pql/text",
            "value": "person.birthDate.getMonth() = currentMonth()"
        },
        "schema":
          {
            "name":"_xdm.context.profile"
          }

      }'
Propriedade Descrição
name O nome do campo de atributo calculado, como uma string.
path O caminho para o campo que contém o atributo calculado. Esse caminho é encontrado dentro do properties do schema e NÃO deve incluir o nome do campo no caminho. Ao gravar o caminho, omita os vários níveis de properties atributos.
{TENANT_ID} Se você não estiver familiarizado com a ID do locatário, consulte as etapas para encontrar a ID do locatário no Guia do desenvolvedor do Registro de Schema.
description Uma descrição do atributo calculado. Isso é especialmente útil depois que vários atributos calculados tiverem sido definidos, pois ajudará outros na organização IMS a determinar o atributo calculado correto a ser usado.
expression.value Um Profile Query Language Expressão (PQL). Os atributos calculados atualmente suportam as seguintes funções: soma, contagem, mín, máx e booleano. Para obter uma lista de expressões de amostra, consulte exemplos de expressões PQL documentação.
schema.name A classe na qual o schema que contém o campo de atributo calculado é baseado. Exemplo: _xdm.context.experienceevent para um esquema com base na classe XDM ExperienceEvent.

Resposta

Um atributo calculado criado com êxito retorna o Status HTTP 200 (OK) e um corpo de resposta contendo os detalhes do atributo calculado recém-criado. Esses detalhes incluem somente leitura, gerado pelo sistema id que pode ser usado para referenciar o atributo calculado durante outras operações de API.

{
    "id": "2afcf410-450e-4a39-984d-2de99ab58877",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "{SANDBOX_ID}",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "name": "birthdayCurrentMonth",
    "path": "_{TENANT_ID}",
    "positionPath": [
        "_{TENANT_ID}"
    ],
    "description": "Computed attribute to capture if the customer birthday is in the current month.",
    "expression": {
        "type": "PQL",
        "format": "pql/text",
        "value": "person.birthDate.getMonth() = currentMonth()"
    },
    "schema": {
        "name": "_xdm.context.profile"
    },
    "returnSchema": {
        "meta:xdmType": "string"
    },
    "definedOn": [
        {
            "meta:resourceType": "unions",
            "meta:containerId": "tenant",
            "$ref": "https://ns.adobe.com/xdm/context/profile__union"
        }
    ],
    "encodedDefinedOn":"?\b?VR)JMS?R?())(????+?KL?OJ?K???H??O??+I?(?/(?O??I??/????S?8{?E:",
    "dependencies": [],
    "dependents": [],
    "active": true,
    "type": "ComputedAttribute",
    "createEpoch": 1572555223,
    "updateEpoch": 1572555225
}
Propriedade Descrição
id Uma ID exclusiva, somente leitura, gerada pelo sistema, que pode ser usada para fazer referência ao atributo calculado durante outras operações da API.
imsOrgId A Organização IMS relacionada ao atributo calculado deve corresponder ao valor enviado na solicitação.
sandbox O objeto sandbox contém detalhes da sandbox na qual o atributo calculado foi configurado. Essas informações são obtidas do cabeçalho da sandbox enviado na solicitação. Para obter mais informações, consulte o visão geral das sandboxes.
positionPath Um array contendo o desconstruído path para o campo que foi enviado na solicitação.
returnSchema.meta:xdmType O tipo de campo onde o atributo calculado será armazenado.
definedOn Uma matriz mostrando os esquemas de união sobre os quais o atributo calculado foi definido. Contém um objeto por esquema de união, o que significa que pode haver vários objetos na matriz se o atributo calculado tiver sido adicionado a vários esquemas com base em classes diferentes.
active Um valor booleano exibindo se o atributo calculado está ou não ativo no momento. Por padrão, o valor é true.
type O tipo de recurso criado, neste caso "ComputedAttribute" é o valor padrão.
createEpoch e updateEpoch A hora em que o atributo calculado foi criado e atualizado pela última vez, respectivamente.

Criar um atributo calculado que faça referência aos atributos calculados existentes

Também é possível criar um atributo calculado que faz referência aos atributos calculados existentes. Para fazer isso, comece fazendo uma solicitação POST para o /config/computedAttributes endpoint . O corpo da solicitação conterá referências aos atributos calculados na variável expression.value como mostrado no exemplo a seguir.

Formato da API

POST /config/computedAttributes

Solicitação

Neste exemplo, dois atributos calculados já foram criados e serão usados para definir um terceiro. Os atributos calculados existentes são:

  • totalSpend: Captura o valor total em dólares que um cliente gastou.
  • countPurchases: Conta o número de compras que um cliente fez.

A solicitação abaixo faz referência aos dois atributos calculados existentes, usando PQL válido para dividir para calcular o novo averageSpend atributo calculado.

curl -X POST \
  https://platform.adobe.io/data/core/ups/config/computedAttributes \
  -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}' \
  -d '{
        "name": "averageSpend",
        "path": "_{TENANT_ID}.purchaseSummary",
        "description": "Computed attribute to capture the average dollar amount that a customer spends on each purchase.",
        "expression": {
            "type": "PQL",
            "format": "pql/text",
            "value": "_{TENANT_ID}.purchaseSummary.totalSpend/_{TENANT_ID}.purchaseSummary.countPurchases"
        },
        "schema":
          {
            "name":"_xdm.context.profile"
          }

      }'
Propriedade Descrição
name O nome do campo de atributo calculado, como uma string.
path O caminho para o campo que contém o atributo calculado. Esse caminho é encontrado dentro do properties do schema e NÃO deve incluir o nome do campo no caminho. Ao gravar o caminho, omita os vários níveis de properties atributos.
{TENANT_ID} Se você não estiver familiarizado com a ID do locatário, consulte as etapas para encontrar a ID do locatário no Guia do desenvolvedor do Registro de Schema.
description Uma descrição do atributo calculado. Isso é especialmente útil depois que vários atributos calculados tiverem sido definidos, pois ajudará outros na organização IMS a determinar o atributo calculado correto a ser usado.
expression.value Uma expressão PQL válida. Os atributos calculados atualmente suportam as seguintes funções: soma, contagem, mín, máx e booleano. Para obter uma lista de expressões de amostra, consulte exemplos de expressões PQL documentação.

Neste exemplo, a expressão faz referência a dois atributos calculados existentes. Os atributos são referenciados usando o path e name do atributo calculado, conforme aparecem no esquema em que os atributos calculados foram definidos. Por exemplo, a variável path do primeiro atributo calculado referenciado é _{TENANT_ID}.purchaseSummary e name é totalSpend.
schema.name A classe na qual o schema que contém o campo de atributo calculado é baseado. Exemplo: _xdm.context.experienceevent para um esquema com base na classe XDM ExperienceEvent.

Resposta

Um atributo calculado criado com êxito retorna o Status HTTP 200 (OK) e um corpo de resposta contendo os detalhes do atributo calculado recém-criado. Esses detalhes incluem somente leitura, gerado pelo sistema id que pode ser usado para referenciar o atributo calculado durante outras operações de API.

{
    "id": "2afcf410-450e-4a39-984d-2de99ab58877",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "{SANDBOX_ID}",
        "sandboxName": "{SANDBOX_NAME}",
        "type": "production",
        "default": true
    },
    "name": "averageSpend",
    "path": "_{TENANT_ID}.purchaseSummary",
    "positionPath": [
        "_{TENANT_ID}",
        "purchaseSummary"
    ],
    "description": "Computed attribute to capture the average dollar amount that a customer spends on each purchase.",
    "expression": {
            "type": "PQL",
            "format": "pql/text",
            "value":  "_{TENANT_ID}.purchaseSummary.totalSpend/_{TENANT_ID}.purchaseSummary.countPurchases"
    },
    "schema": {
        "name": "_xdm.context.profile"
    },
    "returnSchema": {
        "meta:xdmType": "number"
    },
    "definedOn": [
        {
          "meta:resourceType": "unions",
          "meta:containerId": "tenant",
          "$ref": "https://ns.adobe.com/xdm/context/profile__union"
        }
    ],
    "encodedDefinedOn":"\bVR)JMSR())(+KLOJKկHO+I(/(OI/S8{E:",
    "dependencies": [
        "c08a92f3-2418-4a3d-89d0-96f15fda3e5d",
        "4ed9e3aa-57ae-4705-9e8a-7fba9a6a7010"
    ],
    "dependents": [],
    "active": true,
    "evaluationInfo": {
        "batch": {
          "enabled": false
        },
        "continuous": {
          "enabled": true
        },
        "synchronous": {
          "enabled": false
        }
      },
    "type": "ComputedAttribute",
    "createEpoch": 1613696592,
    "updateEpoch": 1613696593
}
Propriedade Descrição
id Uma ID exclusiva, somente leitura, gerada pelo sistema, que pode ser usada para fazer referência ao atributo calculado durante outras operações da API.
imsOrgId A Organização IMS relacionada ao atributo calculado deve corresponder ao valor enviado na solicitação.
sandbox O objeto sandbox contém detalhes da sandbox na qual o atributo calculado foi configurado. Essas informações são obtidas do cabeçalho da sandbox enviado na solicitação. Para obter mais informações, consulte o visão geral das sandboxes.
positionPath Um array contendo o desconstruído path para o campo que foi enviado na solicitação.
returnSchema.meta:xdmType O tipo de campo onde o atributo calculado será armazenado.
definedOn Uma matriz mostrando os esquemas de união sobre os quais o atributo calculado foi definido. Contém um objeto por esquema de união, o que significa que pode haver vários objetos na matriz se o atributo calculado tiver sido adicionado a vários esquemas com base em classes diferentes.
active Um valor booleano exibindo se o atributo calculado está ou não ativo no momento. Por padrão, o valor é true.
type O tipo de recurso criado, neste caso "ComputedAttribute" é o valor padrão.
createEpoch e updateEpoch A hora em que o atributo calculado foi criado e atualizado pela última vez, respectivamente.

Acessar atributos calculados

Ao trabalhar com atributos calculados usando a API, há duas opções para acessar atributos calculados que foram definidas pela organização. O primeiro é listar todos os atributos calculados, o segundo é visualizar um atributo calculado específico por seu exclusivo id.

As etapas para ambos os padrões de acesso são descritas neste documento. Selecione uma das opções a seguir para começar:

Listar todos os atributos calculados

Sua Organização IMS pode criar vários atributos calculados e executar uma solicitação GET para a /config/computedAttributes O endpoint permite listar todos os atributos calculados existentes para sua organização.

Formato da API

GET /config/computedAttributes

Solicitação

curl -X GET \
  https://platform.adobe.io/data/core/ups/config/computedAttributes/ \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \

Resposta

Uma resposta bem-sucedida inclui uma _page que fornece o número total de atributos calculados (totalCount) e o número de atributos calculados na página (pageSize).

A resposta também inclui um children matriz composta de um ou mais objetos, cada um contendo os detalhes de um atributo calculado. Se sua organização não tiver atributos calculados, a variável totalCount e pageSize será 0 (zero) e a variável children A matriz ficará vazia.

{
    "_page": {
        "totalCount": 2,
        "pageSize": 2
    },
    "children": [
        {
            "id": "2afcf410-450e-4a39-984d-2de99ab58877",
            "imsOrgId": "{ORG_ID}",
            "sandbox": {
                "sandboxId": "ff0f6870-c46d-11e9-8ca3-036939a64204",
                "sandboxName": "prod",
                "type": "production",
                "default": true
            },
            "name": "birthdayCurrentMonth",
            "path": "person._{TENANT_ID}",
            "positionPath": [
                "person",
                "_{TENANT_ID}"
            ],
            "description": "Computed attribute to capture if the customer birthday is in the current month.",
            "expression": {
                "type": "PQL",
                "format": "pql/text",
                "value": "person.birthDate.getMonth() = currentMonth()"
            },
            "schema": {
                "name": "_xdm.context.profile"
            },
            "returnSchema": {
                "meta:xdmType": "string"
            },
            "definedOn": [
                {
                    "meta:resourceType": "unions",
                    "meta:containerId": "tenant",
                    "$ref": "https://ns.adobe.com/xdm/context/profile__union"
                }
            ],
            "encodedDefinedOn":"?\b?VR)JMS?R?())(????+?KL?OJ?K???H??O??+I?(?/(?O??I??/????S?8{?E:",
            "dependencies": [],
            "dependents": [],
            "active": true,
            "type": "ComputedAttribute",
            "createEpoch": 1572555223,
            "updateEpoch": 1572555225
        },
        {
            "id": "ae0c6552-cf49-4725-8979-116366e8e8d3",
            "imsOrgId": "{ORG_ID}",
            "sandbox": {
                "sandboxId": "",
                "sandboxName": "",
                "type": "production",
                "default": true
            },
            "name": "productDownloads",
            "path": "_{TENANT_ID}",
            "positionPath": [
                "_{TENANT_ID}"
            ],
            "description": "Calculate total product downloads.",
            "expression": {
                "type": "PQL",
                "format": "pql/text",
                "value":  "let Y = xEvent[_coresvc.event.subType = \"DOWNLOAD\"].groupBy(_coresvc.attributes[name = \"product\"].value).map({
                  \"downloaded\": this.head()._coresvc.attributes[name = \"product\"].head().value,
                  \"downloadsSum\": this.count(),
                  \"downloadsToday\": this[timestamp occurs today].count(),
                  \"downloadsPast30Days\": this[timestamp occurs < 30 days before now].count(),
                  \"downloadsPast60Days\": this[timestamp occurs < 60 days before now].count(),
                  \"downloadsPast90Days\": this[timestamp occurs < 90 days before now].count() }) in { \"uniqueProductDownloadSum\": Y.count(), \"products\": Y }"
            },
            "returnSchema": {
                "meta:xdmType": "string"
            },
            "definedOn": [
                {
                    "meta:resourceType": "unions",
                    "meta:containerId": "tenant",
                    "$ref": "https://ns.adobe.com/xdm/context/profile__union"
                }
            ],
            "schema": {
                "name": "_xdm.context.profile"
            },
            "encodedDefinedOn": "\u001f?\b\u0000\u0000\u0000\u0000\u0000\u0000\u0000?VR)JMS?R?())(????+?KL?OJ?K???H??O??+I?(?/(?O??I??/????S?\u0005\u00008{?E:\u0000\u0000\u0000",
            "dependencies": [],
            "dependents": [],
            "active": true,
            "type": "ComputedAttribute",
            "createEpoch": 1571945277,
            "updateEpoch": 1571945280
        }
    ],
    "_links": {
        "next": {}
    }
}
Propriedade Descrição
_page.totalCount O número total de atributos calculados definidos pela Organização IMS.
_page.pageSize O número de atributos calculados retornados nesta página de resultados. If pageSize é igual a totalCount, isso significa que há apenas uma página de resultados e todos os atributos calculados foram retornados. Se não forem iguais, há páginas adicionais de resultados que podem ser acessadas. Consulte _links.next para obter detalhes.
children Uma matriz composta de um ou mais objetos, cada um contendo os detalhes de um único atributo calculado. Se nenhum atributo calculado tiver sido definido, a variável children A matriz está vazia.
id Um valor exclusivo, somente leitura, gerado pelo sistema, atribuído automaticamente a um atributo calculado quando ele é criado. Para obter mais informações sobre os componentes de um objeto de atributo calculado, consulte a seção em criação de um atributo calculado anteriormente neste tutorial.
_links.next Se uma única página de atributos calculados for retornada, _links.next é um objeto vazio, como mostrado na resposta de amostra acima. Se sua organização tiver muitos atributos calculados, eles serão retornados em várias páginas que você pode acessar fazendo uma solicitação GET para a _links.next valor.

Exibir um atributo calculado

Você pode visualizar um atributo calculado específico fazendo uma solicitação do GET para o /config/computedAttributes endpoint e incluindo a ID de atributo calculada no caminho da solicitação.

Formato da API

GET /config/computedAttributes/{ATTRIBUTE_ID}
Parâmetro Descrição
{ATTRIBUTE_ID} A ID do atributo calculado que você deseja visualizar.

Solicitação

curl -X GET \
  https://platform.adobe.io/data/core/ups/config/computedAttributes/2afcf410-450e-4a39-984d-2de99ab58877 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \

Resposta

{
    "id": "2afcf410-450e-4a39-984d-2de99ab58877",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "ff0f6870-c46d-11e9-8ca3-036939a64204",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "name": "birthdayCurrentMonth",
    "path": "_{TENANT_ID}",
    "positionPath": [
        "_{TENANT_ID}"
    ],
    "description": "Computed attribute to capture if the customer birthday is in the current month.",
    "expression": {
        "type": "PQL",
        "format": "pql/text",
        "value": "person.birthDate.getMonth() = currentMonth()"
    },
    "schema": {
        "name": "_xdm.context.profile"
    },
    "returnSchema": {
        "meta:xdmType": "string"
    },
    "definedOn": [
        {
            "meta:resourceType": "unions",
            "meta:containerId": "tenant",
            "$ref": "https://ns.adobe.com/xdm/context/profile__union"
        }
    ],
    "encodedDefinedOn":"?\b?VR)JMS?R?())(????+?KL?OJ?K???H??O??+I?(?/(?O??I??/????S?8{?E:",
    "dependencies": [],
    "dependents": [],
    "active": true,
    "type": "ComputedAttribute",
    "createEpoch": 1572555223,
    "updateEpoch": 1572555225
}

Atualizar um atributo calculado

Se você precisar atualizar um atributo calculado existente, isso pode ser feito fazendo uma solicitação de PATCH para o /config/computedAttributes endpoint e incluindo a ID do atribuído computado que você deseja atualizar no caminho da solicitação.

Formato da API

PATCH /config/computedAttributes/{ATTRIBUTE_ID}
Parâmetro Descrição
{ATTRIBUTE_ID} A ID do atributo calculado que você deseja atualizar.

Solicitação

Essa solicitação usa Formatação de patch JSON para atualizar o "valor" do campo "expressão".

curl -X PATCH \
  https://platform.adobe.io/data/core/ups/config/computedAttributes/ae0c6552-cf49-4725-8979-116366e8e8d3 \
  -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}' \
  -d '[
        {
          "op": "add",
          "path": "/expression",
          "value":
          {
            "type": "PQL",
            "format": "pql/text",
            "value":  "{NEW_EXPRESSION_VALUE}"
          }
        }
      ]'
Propriedade Descrição
{NEW_EXPRESSION_VALUE} Um Profile Query Language Expressão (PQL). Os atributos calculados atualmente suportam as seguintes funções: soma, contagem, mín, máx e booleano. Para obter uma lista de expressões de amostra, consulte exemplos de expressões PQL documentação.

Resposta

Uma atualização bem-sucedida retorna o Status HTTP 204 (Sem conteúdo) e um corpo de resposta vazio. Se quiser confirmar que a atualização foi bem-sucedida, é possível executar uma solicitação do GET para exibir o atributo calculado pela ID.

Excluir um atributo calculado

Também é possível excluir um atributo calculado usando a API . Isso é feito fazendo uma solicitação de DELETE para o /config/computedAttributes endpoint e incluindo a ID do atributo calculado que você deseja excluir no caminho da solicitação.

OBSERVAÇÃO

Tenha cuidado ao excluir um atributo calculado, pois ele pode estar em uso em mais de um schema e a operação do DELETE não pode ser desfeita.

Formato da API

DELETE /config/computedAttributes/{ATTRIBUTE_ID}
Parâmetro Descrição
{ATTRIBUTE_ID} A ID do atributo calculado que você deseja excluir.

Solicitação

curl -X DELETE \
  https://platform.adobe.io/data/core/ups/config/computedAttributes/ae0c6552-cf49-4725-8979-116366e8e8d3 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}'
  -H 'x-sandbox-name: {SANDBOX_NAME}' \

Resposta

Uma solicitação de exclusão bem-sucedida retorna o Status HTTP 200 (OK) e um corpo de resposta vazio. Para confirmar que a exclusão foi bem-sucedida, é possível executar uma solicitação do GET para pesquisar o atributo calculado pela ID. Se o atributo foi excluído, você receberá um erro HTTP Status 404 (Not Found).

Criar uma definição de segmento que faça referência a um atributo calculado

O Adobe Experience Platform permite criar segmentos que definem um grupo de atributos ou comportamentos específicos a partir de um grupo de perfis. Uma definição de segmento inclui uma expressão que encapsula uma consulta escrita em PQL. Essas expressões também podem fazer referência a atributos calculados.

O exemplo a seguir cria uma definição de segmento que faz referência a um atributo calculado existente. Para saber mais sobre definições de segmentos e como trabalhar com elas na API do serviço de segmentação, consulte guia do endpoint da API de definições de segmento.

Para começar, faça uma solicitação de POST para a função /segment/definitions endpoint, fornecendo o atributo calculado no corpo da solicitação.

Formato da API

POST /segment/definitions

Solicitação

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": "downloadedInLast7Days",
        "description": "Has product been downloaded in last 7 days?",
        "schema": {
            "name": "_xdm.context.profile"
        },
        "ttlInDays": 30,
        "expression": {
            "type": "PQL",
            "format": "pql/text",
            "value": "_{TENANT_ID}.downloadsLast7Days > 0",
            "meta": "m"
        },
        "dataGovernancePolicy": {
            "excludeOptOut": true
        },
        "evaluationInfo": {
            "batch": {
                "enabled": false
            },
            "continuous": {
                "enabled": true
            },
            "synchronous": {
                "enabled": false
            }
        }
    }'
Propriedade Descrição
name Um nome exclusivo para o segmento, como uma string.
description Uma descrição legível da definição.
schema.name O esquema associado às entidades no segmento. Consiste em um dos id ou name campo.
expression Um objeto que contém campos com informações sobre a definição de segmento.
expression.type Especifica o tipo de expressão. Atualmente, somente "PQL" é compatível.
expression.format Indica a estrutura da expressão no valor. Atualmente, somente pql/text é compatível.
expression.value Uma expressão PQL válida, neste exemplo, inclui uma referência para um atributo calculado existente.

Para obter mais informações sobre atributos de definição de esquema, consulte os exemplos fornecidos na guia do endpoint da API de definições de segmento.

Resposta

Uma resposta bem-sucedida retorna o status HTTP 200 com detalhes da definição de segmento recém-criada. Para saber mais sobre objetos de resposta de definição de segmento, consulte guia do endpoint da API de definições de segmento.

{
    "id": "add3933f-ac5c-4240-8259-3a4528ee4885",
    "schema": {
        "name": "_xdm.context.profile"
    },
    "ttlInDays": 60,
    "id": "119835c3-5fab-4c18-ae01-4ccab328fc5c",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "{SANDBOX_ID}",
        "sandboxName": "{SANDBOX_NAME}",
        "type": "production",
        "default": true
    },
    "name": "segment-downloadedInLast7Days",
    "description": "Has product been downloaded in last 7 days?",
    "expression": {
        "type": "PQL",
        "format": "pql/text",
        "value": "_{TENANT_ID}.downloadsLast7Days > 0",
        "meta": "m"
    },
    "evaluationInfo": {
        "batch": {
            "enabled": false
        },
        "continuous": {
            "enabled": true
        },
        "synchronous": {
            "enabled": false
        }
    },
    "dataGovernancePolicy": {
        "excludeOptOut": true
    },
    "creationTime": 1602016581000,
    "updateEpoch": 1610609459,
    "updateTime": 1610609459000,
    "createEpoch": 1602016554,
    "_etag": "\"8b01611a-0000-0200-0000-5ffff3330000\"",
    "dependents": [
        "023d46c9-a27c-4ea9-a887-2c91ba83f2d1"
    ],
    "definedOn": [
        {
            "meta:resourceType": "unions",
            "meta:containerId": "tenant",
            "$ref": "https://ns.adobe.com/xdm/context/profile__union"
        }
    ],
    "dependencies": [
    "103d46c9-a27c-4ea9-a887-2c91ba83f2d1"
    ],
    "type": "SegmentDefinition"
}

Próximas etapas

Agora que você aprendeu as noções básicas dos atributos calculados, estará pronto para começar a defini-las para sua organização.

Nesta página