(Alpha) Endpoint API per gli attributi calcolati

IMPORTANTE

La funzionalità dell'attributo calcolato descritta in questo documento è attualmente in alfa e non è disponibile per tutti gli utenti. La documentazione e le funzionalità sono soggette a modifiche.

Gli attributi calcolati sono funzioni utilizzate per aggregare dati a livello di evento in attributi a livello di profilo. Queste funzioni vengono calcolate automaticamente in modo che possano essere utilizzate tra segmentazione, attivazione e personalizzazione. Questa guida include chiamate API di esempio per eseguire operazioni CRUD di base utilizzando /computedAttributes punto finale.

Per ulteriori informazioni sugli attributi calcolati, inizia leggendo il panoramica degli attributi calcolati.

Introduzione

L’endpoint API utilizzato in questa guida fa parte del API del profilo cliente in tempo reale.

Prima di continuare, controlla la Guida introduttiva all’API per profili per i collegamenti alla documentazione consigliata, una guida alla lettura delle chiamate API di esempio visualizzate in questo documento e informazioni importanti sulle intestazioni richieste necessarie per effettuare chiamate a qualsiasi API di Experience Platform.

Configurare un campo attributo calcolato

Per creare un attributo calcolato, devi innanzitutto identificare il campo in uno schema che contenga il valore dell'attributo calcolato.

Fai riferimento alla documentazione su configurazione di un attributo calcolato per una guida completa end-to-end alla creazione di un campo attributo calcolato in uno schema.

AVVERTENZA

Per procedere con la guida API è necessario che sia configurato un campo attributo calcolato.

Creare un attributo calcolato

Con il campo dell’attributo calcolato definito nello schema abilitato per il profilo, ora puoi configurare un attributo calcolato. Se non lo hai già fatto, segui il flusso di lavoro descritto in configurazione di un attributo calcolato documentazione.

Per creare un attributo calcolato, inizia effettuando una richiesta di POST al /config/computedAttributes endpoint con un corpo della richiesta contenente i dettagli dell'attributo calcolato che si desidera creare.

Formato API

POST /config/computedAttributes

Richiesta

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"
          }

      }'
Proprietà Descrizione
name Nome del campo dell'attributo calcolato come stringa.
path Percorso del campo contenente l'attributo calcolato. Questo percorso si trova all'interno del properties Attributo dello schema e NON deve includere il nome del campo nel percorso. Quando si scrive il percorso, omettere i diversi livelli di properties attributi.
{TENANT_ID} Se non conosci il tuo ID tenant, fai riferimento ai passaggi per trovare l’ID tenant nel Guida per gli sviluppatori del Registro di sistema dello schema.
description Descrizione dell'attributo calcolato. Questa funzione è particolarmente utile quando sono stati definiti più attributi calcolati, in quanto aiuterà gli altri utenti dell’organizzazione IMS a determinare l’attributo calcolato corretto da utilizzare.
expression.value Una valida Profile Query Language (PQL) espressione. Gli attributi calcolati supportano attualmente le seguenti funzioni: sum, count, min, max e booleano. Per un elenco delle espressioni di esempio, consulta espressioni PQL di esempio documentazione.
schema.name Classe su cui si basa lo schema contenente il campo dell'attributo calcolato. Esempio: _xdm.context.experienceevent per uno schema basato sulla classe ExperienceEvent XDM.

Risposta

Un attributo calcolato creato correttamente restituisce HTTP Status 200 (OK) e un corpo di risposta contenente i dettagli dell'attributo calcolato appena creato. Questi dettagli includono un unico, di sola lettura, generato dal sistema id che può essere utilizzato per fare riferimento all’attributo calcolato durante altre operazioni 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
}
Proprietà Descrizione
id ID univoco generato dal sistema, di sola lettura, che può essere utilizzato per fare riferimento all'attributo calcolato durante altre operazioni API.
imsOrgId L’organizzazione IMS relativa all’attributo calcolato deve corrispondere al valore inviato nella richiesta.
sandbox L'oggetto sandbox contiene i dettagli della sandbox in cui è stato configurato l'attributo calcolato. Queste informazioni sono tratte dall’intestazione della sandbox inviata nella richiesta. Per ulteriori informazioni, consulta la sezione panoramica sulle sandbox.
positionPath Matrice contenente la struttura decostruita path al campo inviato nella richiesta.
returnSchema.meta:xdmType Il tipo di campo in cui verrà memorizzato l'attributo calcolato.
definedOn Matrice che mostra gli schemi dell'unione su cui è stato definito l'attributo calcolato. Contiene un oggetto per schema di unione, il che significa che possono essere presenti più oggetti all'interno dell'array se l'attributo calcolato è stato aggiunto a più schemi in base a classi diverse.
active Un valore booleano che indica se l'attributo calcolato è attualmente attivo o meno. Per impostazione predefinita, il valore è true.
type Il tipo di risorsa creata, in questo caso "ComputedAttribute", è il valore predefinito.
createEpoch e updateEpoch Data e ora di creazione dell'attributo calcolato e dell'ultimo aggiornamento, rispettivamente.

Crea un attributo calcolato che fa riferimento ad attributi calcolati esistenti

È inoltre possibile creare un attributo calcolato che faccia riferimento ad attributi calcolati esistenti. Per farlo, inizia effettuando una richiesta POST al /config/computedAttributes punto finale. Il corpo della richiesta conterrà riferimenti agli attributi calcolati nel expression.value come illustrato nell’esempio seguente.

Formato API

POST /config/computedAttributes

Richiesta

In questo esempio, sono già stati creati due attributi calcolati e verranno utilizzati per definire un terzo. Gli attributi calcolati esistenti sono:

  • totalSpend: Acquisisce l'importo totale in dollari speso da un cliente.
  • countPurchases: Conta il numero di acquisti effettuati da un cliente.

La richiesta seguente fa riferimento ai due attributi calcolati esistenti, utilizzando un PQL valido per suddividere per calcolare il nuovo averageSpend attributo calcolato.

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"
          }

      }'
Proprietà Descrizione
name Nome del campo dell'attributo calcolato come stringa.
path Percorso del campo contenente l'attributo calcolato. Questo percorso si trova all'interno del properties Attributo dello schema e NON deve includere il nome del campo nel percorso. Quando si scrive il percorso, omettere i diversi livelli di properties attributi.
{TENANT_ID} Se non conosci il tuo ID tenant, fai riferimento ai passaggi per trovare l’ID tenant nel Guida per gli sviluppatori del Registro di sistema dello schema.
description Descrizione dell'attributo calcolato. Questa funzione è particolarmente utile quando sono stati definiti più attributi calcolati, in quanto aiuterà gli altri utenti dell’organizzazione IMS a determinare l’attributo calcolato corretto da utilizzare.
expression.value Un'espressione PQL valida. Gli attributi calcolati supportano attualmente le seguenti funzioni: sum, count, min, max e booleano. Per un elenco delle espressioni di esempio, consulta espressioni PQL di esempio documentazione.

In questo esempio, l'espressione fa riferimento a due attributi calcolati esistenti. Gli attributi sono referenziati utilizzando il path e name dell'attributo calcolato come visualizzato nello schema in cui sono stati definiti gli attributi calcolati. Ad esempio, il path del primo attributo calcolato a cui si fa riferimento è _{TENANT_ID}.purchaseSummary e name è totalSpend.
schema.name Classe su cui si basa lo schema contenente il campo dell'attributo calcolato. Esempio: _xdm.context.experienceevent per uno schema basato sulla classe ExperienceEvent XDM.

Risposta

Un attributo calcolato creato correttamente restituisce HTTP Status 200 (OK) e un corpo di risposta contenente i dettagli dell'attributo calcolato appena creato. Questi dettagli includono un unico, di sola lettura, generato dal sistema id che può essere utilizzato per fare riferimento all’attributo calcolato durante altre operazioni 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
}
Proprietà Descrizione
id ID univoco generato dal sistema, di sola lettura, che può essere utilizzato per fare riferimento all'attributo calcolato durante altre operazioni API.
imsOrgId L’organizzazione IMS relativa all’attributo calcolato deve corrispondere al valore inviato nella richiesta.
sandbox L'oggetto sandbox contiene i dettagli della sandbox in cui è stato configurato l'attributo calcolato. Queste informazioni sono tratte dall’intestazione della sandbox inviata nella richiesta. Per ulteriori informazioni, consulta la sezione panoramica sulle sandbox.
positionPath Matrice contenente la struttura decostruita path al campo inviato nella richiesta.
returnSchema.meta:xdmType Il tipo di campo in cui verrà memorizzato l'attributo calcolato.
definedOn Matrice che mostra gli schemi dell'unione su cui è stato definito l'attributo calcolato. Contiene un oggetto per schema di unione, il che significa che possono essere presenti più oggetti all'interno dell'array se l'attributo calcolato è stato aggiunto a più schemi in base a classi diverse.
active Un valore booleano che indica se l'attributo calcolato è attualmente attivo o meno. Per impostazione predefinita, il valore è true.
type Il tipo di risorsa creata, in questo caso "ComputedAttribute", è il valore predefinito.
createEpoch e updateEpoch Data e ora di creazione dell'attributo calcolato e dell'ultimo aggiornamento, rispettivamente.

Accedere agli attributi calcolati

Quando lavori con gli attributi calcolati utilizzando l’API, sono disponibili due opzioni per accedere agli attributi calcolati definiti dall’organizzazione. La prima consiste nell'elencare tutti gli attributi calcolati, la seconda consiste nel visualizzare un attributo calcolato specifico in base alla sua univocità id.

I passaggi per entrambi i pattern di accesso sono descritti in questo documento. Seleziona una delle seguenti opzioni per iniziare:

Elencare tutti gli attributi calcolati

L’organizzazione IMS può creare più attributi calcolati ed eseguire una richiesta di GET al /config/computedAttributes l’endpoint ti consente di elencare tutti gli attributi calcolati esistenti per la tua organizzazione.

Formato API

GET /config/computedAttributes

Richiesta

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}' \

Risposta

Una risposta corretta include un _page attributo che fornisce il numero totale di attributi calcolati (totalCount) e il numero di attributi calcolati sulla pagina (pageSize).

La risposta include anche un children array composto da uno o più oggetti, ciascuno contenente i dettagli di un attributo calcolato. Se la tua organizzazione non dispone di attributi calcolati, la totalCount e pageSize sarà 0 (zero) e il children array vuoto.

{
    "_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": {}
    }
}
Proprietà Descrizione
_page.totalCount Il numero totale di attributi calcolati definiti dall’organizzazione IMS.
_page.pageSize Il numero di attributi calcolati restituiti in questa pagina di risultati. Se pageSize è uguale a totalCount, ciò significa che esiste una sola pagina di risultati e che sono stati restituiti tutti gli attributi calcolati. Se non sono uguali, è possibile accedere ad altre pagine di risultati. Vedi _links.next per i dettagli.
children Matrice composta da uno o più oggetti, ognuno contenente i dettagli di un singolo attributo calcolato. Se non sono stati definiti attributi calcolati, la variabile children array vuoto.
id Valore univoco generato dal sistema, di sola lettura, assegnato automaticamente a un attributo calcolato al momento della creazione. Per ulteriori informazioni sui componenti di un oggetto attributo calcolato, consulta la sezione su creazione di un attributo calcolato precedente in questa esercitazione.
_links.next Se viene restituita una singola pagina di attributi calcolati, _links.next è un oggetto vuoto, come illustrato nella risposta di esempio precedente. Se la tua organizzazione dispone di molti attributi calcolati, questi verranno restituiti su più pagine a cui puoi accedere effettuando una richiesta di GET al _links.next valore.

Visualizza un attributo calcolato

Puoi visualizzare un attributo calcolato specifico effettuando una richiesta di GET al /config/computedAttributes e che include l'ID attributo calcolato nel percorso della richiesta.

Formato API

GET /config/computedAttributes/{ATTRIBUTE_ID}
Parametro Descrizione
{ATTRIBUTE_ID} ID dell'attributo calcolato che si desidera visualizzare.

Richiesta

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}' \

Risposta

{
    "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
}

Aggiornare un attributo calcolato

Se hai bisogno di aggiornare un attributo calcolato esistente, puoi farlo effettuando una richiesta di PATCH al /config/computedAttributes e l’ID dell’attributo calcolato che desideri aggiornare nel percorso della richiesta.

Formato API

PATCH /config/computedAttributes/{ATTRIBUTE_ID}
Parametro Descrizione
{ATTRIBUTE_ID} ID dell'attributo calcolato che si desidera aggiornare.

Richiesta

Questa richiesta utilizza Formattazione patch JSON per aggiornare il "valore" del campo "espressione".

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}"
          }
        }
      ]'
Proprietà Descrizione
{NEW_EXPRESSION_VALUE} Una valida Profile Query Language (PQL) espressione. Gli attributi calcolati supportano attualmente le seguenti funzioni: sum, count, min, max e booleano. Per un elenco delle espressioni di esempio, consulta espressioni PQL di esempio documentazione.

Risposta

Un aggiornamento corretto restituisce lo stato HTTP 204 (nessun contenuto) e un corpo di risposta vuoto. Se desideri confermare che l'aggiornamento è stato eseguito correttamente, puoi eseguire una richiesta GET per visualizzare l'attributo calcolato in base al relativo ID.

Eliminare un attributo calcolato

È inoltre possibile eliminare un attributo calcolato utilizzando l’API. A questo scopo, invia una richiesta DELETE al /config/computedAttributes e include l'ID dell'attributo calcolato che desideri eliminare nel percorso della richiesta.

NOTA

Presta attenzione quando elimini un attributo calcolato perché potrebbe essere in uso in più schemi e l'operazione DELETE non può essere annullata.

Formato API

DELETE /config/computedAttributes/{ATTRIBUTE_ID}
Parametro Descrizione
{ATTRIBUTE_ID} ID dell'attributo calcolato che si desidera eliminare.

Richiesta

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}' \

Risposta

Una richiesta di eliminazione corretta restituisce lo stato HTTP 200 (OK) e un corpo di risposta vuoto. Per confermare che l'eliminazione è avvenuta correttamente, puoi eseguire una richiesta GET per cercare l'attributo calcolato dal relativo ID. Se l'attributo è stato eliminato, riceverai un errore di stato HTTP 404 (Non trovato).

Creare una definizione di segmento che faccia riferimento a un attributo calcolato

Adobe Experience Platform consente di creare segmenti che definiscono un gruppo di attributi o comportamenti specifici da un gruppo di profili. Una definizione di segmento include un’espressione che incapsula una query scritta in PQL. Queste espressioni possono anche fare riferimento ad attributi calcolati.

Nell'esempio seguente viene creata una definizione di segmento che fa riferimento a un attributo calcolato esistente. Per ulteriori informazioni sulle definizioni dei segmenti e su come utilizzarle nell’API del servizio di segmentazione, consulta la sezione guida all’endpoint API per le definizioni dei segmenti.

Per iniziare, invia una richiesta POST al /segment/definitions endpoint, fornendo l'attributo calcolato nel corpo della richiesta.

Formato API

POST /segment/definitions

Richiesta

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
        }
    }'
Proprietà Descrizione
name Un nome univoco per il segmento, come stringa.
description Una descrizione della definizione leggibile dall'uomo.
schema.name Lo schema associato alle entità nel segmento. È costituito da una delle due id o name campo .
expression Un oggetto contenente campi con informazioni sulla definizione del segmento.
expression.type Specifica il tipo di espressione. Attualmente, è supportato solo "PQL".
expression.format Indica la struttura dell'espressione nel valore. Attualmente, solo pql/text è supportato.
expression.value Un'espressione PQL valida, in questo esempio include un riferimento a un attributo calcolato esistente.

Per ulteriori informazioni sugli attributi di definizione dello schema, consulta gli esempi forniti nel guida all’endpoint API per le definizioni dei segmenti.

Risposta

Una risposta corretta restituisce lo stato HTTP 200 con i dettagli della nuova definizione del segmento creata. Per ulteriori informazioni sugli oggetti di risposta della definizione del segmento, consulta guida all’endpoint API per le definizioni dei segmenti.

{
    "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"
}

Passaggi successivi

Dopo aver appreso le nozioni di base degli attributi calcolati, puoi iniziare a definirli per la tua organizzazione.

In questa pagina