API de migração de decisão decisioning-migration-api

Nesta página: use a API do Serviço de Migração de Decisão para mover objetos de Gerenciamento de decisão entre sandboxes com análise de dependência automatizada e suporte de reversão, para que você possa fazer a transição de conteúdo de decisão entre ambientes, preservando a integridade dos dados.

A API do serviço de migração de decisão permite migrar objetos de Gestão de decisões de uma sandbox para outra. O processo de migração é executado como fluxos de trabalho assíncronos que incluem análise de dependência, execução e recursos opcionais de reversão.

Essa API permite fazer a transição perfeita do conteúdo de decisão entre ambientes , mantendo a integridade dos dados e as relações.

Para saber mais sobre os benefícios e recursos do Decisioning em comparação ao Gerenciamento de decisão, consulte esta página.

Recursos capabilities

A API do Serviço de migração do Decisioning fornece os seguintes recursos:

Pré-requisitos prerequisites

Permissões necessárias permissions

Para usar a API de migração, você precisa das permissões apropriadas nas sandboxes de origem e destino:

Sandbox do Source - Acesso de leitura a objetos de Gestão de decisões

Sandbox do Target - Criar e editar o acesso a objetos do Decisioning

As permissões típicas incluem:

Preparar sua sandbox de destino target-sandbox-preparation

Antes de executar uma migração, verifique se a sandbox de destino está configurada corretamente:

Para obter mais informações sobre o gerenciamento de sandboxes, consulte Usar e atribuir sandboxes.

Pré-requisitos de migração entre sandboxes cross-sandbox-prerequisites

Quando a sandbox de origem ≠ sandbox de destino, os seguintes itens são necessários:

Noções básicas sobre API api-basics

URL base base-url

Use o seguinte URL base:

Autenticação authentication

Todas as solicitações de API exigem os seguintes cabeçalhos:

Para obter instruções detalhadas sobre como configurar a autenticação, consulte o guia de autenticação do Journey Optimizer.

Fluxo de trabalho de migração migration-workflow

O processo de migração consiste em duas etapas principais: analisar dependências e executar a migração. Siga estas etapas para garantir uma migração bem-sucedida.

Etapa 1: Analisar dependências analyze-dependencies

Antes de migrar, use o fluxo de trabalho de dependência para identificar o que precisa ser mapeado da Gestão de decisões para a Decisão na sandbox de destino. Essa análise ajuda a entender as relações entre objetos e preparar os mapeamentos necessários.

Criar um fluxo de trabalho de dependência create-dependency-workflow

Use a chamada de API a seguir para criar um fluxo de trabalho de análise de dependência.

Formato da API

POST /workflows/generate-dependencies

Dependência em nível de sandbox (recomendada primeiro)

Comece com uma análise em nível de sandbox para obter uma visualização completa de todas as dependências:

curl --request POST \
  --url "https://decisioning-migration.adobe.io/workflows/generate-dependencies?request-level=sandbox" \
  --header "Authorization: Bearer <IMS_ACCESS_TOKEN>" \
  --header "x-gw-ims-org-id: <IMS_ORG_ID>" \
  --header "Content-Type: application/json" \
  --data '{
    "imsOrgId": "<IMS_ORG_ID>",
    "sourceSandboxDetails": { "sandboxName": "<SOURCE_SANDBOX_NAME>" },
    "targetSandboxDetails": { "sandboxName": "<TARGET_SANDBOX_NAME>" }
  }'

Dependência no nível da oferta

Para analisar dependências somente para ofertas específicas, chame o mesmo ponto de extremidade com request-level=offer na cadeia de caracteres de consulta e forneça uma matriz offersList no corpo com as IDs de oferta que você deseja analisar.

Dependência de nível de decisão

Para analisar dependências somente para decisões específicas, use request-level=decision na cadeia de caracteres de consulta e forneça uma matriz decisionsList no corpo com as IDs de decisão que você deseja analisar.

Verificar status do fluxo de trabalho de dependência poll-dependency-status

Consulte o fluxo de trabalho de dependência para verificar quando a análise é concluída.

Formato da API

GET /workflows/generate-dependencies/{id}

Solicitação

curl --request GET \
  --url "https://decisioning-migration.adobe.io/workflows/generate-dependencies/<WORKFLOW_ID>" \
  --header "Authorization: Bearer <IMS_ACCESS_TOKEN>" \
  --header "x-gw-ims-org-id: <IMS_ORG_ID>"

Quando o campo status mostra Completed, a análise de dependência está pronta. Use a saída do fluxo de trabalho para criar os mapeamentos de dependência de migração:

Você fornece esses mapeamentos no objeto dependency da solicitação de migração na Etapa 2.

Etapa 2: Executar a migração execute-migration

Depois de analisar as dependências e preparar os mapeamentos, você pode executar a migração.

Criar um fluxo de trabalho de migração create-migration-workflow

Use os mapeamentos de dependência da Etapa 1 para configurar e executar a migração.

Formato da API

POST /workflows/migration

Migração no nível da sandbox

Para migrar todos os objetos de decisão de uma sandbox para outra:

curl --request POST \
  --url 'https://decisioning-migration.adobe.io/workflows/migration?request-level=sandbox' \
  --header 'Authorization: Bearer <IMS_ACCESS_TOKEN>' \
  --header 'Content-Type: application/json' \
  --header 'x-gw-ims-org-id: <IMS_ORG_ID>' \
  --data '{
    "imsOrgId": "<IMS_ORG_ID>",
    "sourceSandboxDetails": { "sandboxName": "<SOURCE_SANDBOX_NAME>" },
    "targetSandboxDetails": { "sandboxName": "<TARGET_SANDBOX_NAME>" },
    "createDataStream": true,
    "dependency": {
      "profileAttributes": {
        "sourceAttr1": "targetAttr1"
      },
      "segments": {
        "sourceSegmentKey1": {
          "namespace": "<TARGET_SEGMENT_NAMESPACE>",
          "id": "<TARGET_SEGMENT_ID>"
        }
      },
      "contextAttributes": {
        "sourceCtx1": "targetCtx1"
      },
      "datasetName": "<TARGET_DATASET_NAME>"
    }
  }'

Migração no nível da oferta

Para migrar somente ofertas específicas, use request-level=offer na cadeia de caracteres de consulta e adicione uma matriz offersList ao corpo:

"offersList": ["offer-id-1", "offer-id-2"]

Migração de nível de decisão

Para migrar apenas decisões específicas, use request-level=decision na cadeia de caracteres de consulta e adicione uma matriz decisionsList ao corpo:

"decisionsList": ["decision-id-1", "decision-id-2"]

Solicitar campos

Monitorar status da migração poll-migration-status

Consulte o fluxo de trabalho de migração para acompanhar seu progresso.

Formato da API

GET /workflows/migration/{id}

Solicitação

curl --request GET \
  --url "https://decisioning-migration.adobe.io/workflows/migration/<WORKFLOW_ID>" \
  --header "Authorization: Bearer <IMS_ACCESS_TOKEN>" \
  --header "x-gw-ims-org-id: <IMS_ORG_ID>"

Resultados da migração

Quando o campo status mostra Completed, a migração foi bem-sucedida. O fluxo de trabalho result inclui:

Quando o campo status mostrar Failed, revise a matriz errors[] e o campo result.error para obter detalhes sobre o que deu errado.

Cada fluxo de trabalho (dependência, migração e reversão) retorna os mesmos campos de recurso:

Validar sua migração validate-migration

Depois que a migração for concluída com êxito, verifique se todos os objetos foram migrados corretamente.

Lista de verificação de validação validation-checklist

Exemplo test-runtime-delivery

Se a migração criou um fluxo de dados, você pode testar a entrega de ofertas usando o seguinte exemplo:

curl --request POST \
  --url "https://edge.adobedc.net/ee/or2/v1/interact?configId=<DATASTREAM_ID>" \
  --header "Content-Type: application/json" \
  --header "x-request-id: <uuid>" \
  --data '{ "events": [ ... ] }'

Reverter uma migração rollback

Se você descobrir problemas durante a validação, poderá reverter uma migração concluída para restaurar a sandbox de destino ao seu estado anterior.

Criar um fluxo de trabalho de reversão create-rollback-workflow

Inicie uma reversão criando um fluxo de trabalho de reversão que faça referência à migração que você deseja reverter.

Formato da API

POST /workflows/rollback

Solicitação

curl --request POST \
  --url "https://decisioning-migration.adobe.io/workflows/rollback" \
  --header "Authorization: Bearer <IMS_ACCESS_TOKEN>" \
  --header "x-gw-ims-org-id: <IMS_ORG_ID>" \
  --header "Content-Type: application/json" \
  --data '{ "rollbackWorkflowId": "<MIGRATION_WORKFLOW_ID>" }'

Substitua <MIGRATION_WORKFLOW_ID> pela ID do fluxo de trabalho de migração que você deseja reverter.

Monitorar status de reversão poll-rollback-status

Consulte o workflow de reversão para acompanhar seu progresso.

Formato da API

GET /workflows/rollback/{rollbackWorkflowId}

Solicitação

curl --request GET \
  --url "https://decisioning-migration.adobe.io/workflows/rollback/<ROLLBACK_WORKFLOW_ID>" \
  --header "Authorization: Bearer <IMS_ACCESS_TOKEN>" \
  --header "x-gw-ims-org-id: <IMS_ORG_ID>"

Lidar com fluxos de trabalho simultâneos handle-concurrency

A API de migração permite que apenas um fluxo de trabalho seja executado por vez por organização. Se você tentar criar um novo fluxo de trabalho enquanto outro estiver em andamento, você receberá uma resposta de erro 409 Conflito (“Um fluxo de trabalho já está em andamento…”).

Nesse caso, aguarde a conclusão do workflow em andamento ou recupere a ID do workflow e sonde seu status. Quando o fluxo de trabalho atual for concluído, você poderá criar um novo.

Escopo e cobertura da migração migration-scope

Compreender o escopo da migração ajuda a planejar e validar a transição da Gestão de decisões para a Decisão. Esta seção descreve o que é abordado pelo processo de migração e o que requer ação manual.

Dentro do escopo: o que é coberto in-scope

A API de migração lida com os seguintes itens e recursos:

Fora do escopo: o que não é coberto ou requer ação manual out-of-scope

Os seguintes itens exigem ação manual ou não são suportados pelas ferramentas de migração:

Referência de mapeamento de entidade entity-mapping

Ao migrar da Gestão de decisões para o Decisioning, as entidades são mapeadas de acordo com a tabela a seguir. Os mapeamentos incluem as entidades Decisioning principais e entidades associadas adicionais criadas ou usadas durante a migração.

Gestão de decisões para Mapeamento de entidades de decisão

Convenções de nomenclatura

O processo de migração aplica convenções de nomenclatura usando o prefixo ExD_ para garantir a consistência e evitar conflitos de nomenclatura.

Atributos Adicionais

Modelo de solicitação e resposta request-response-model

Ao migrar da Gestão de decisões para o Decisioning, o código do aplicativo deve ser atualizado para usar os novos formatos de solicitação e resposta. Ambos os sistemas usam o endpoint do Edge Network, mas com estruturas de carga e nomes de campo diferentes.

Solicitação Edge do Gerenciamento de decisão (Atual) dm-request

A solicitação atual do Edge de Gestão de decisão segue esta estrutura:

Ponto de extremidade:

POST https://edge.adobedc.net/ee/v2/interact

Cabeçalhos:
​- Authorization: Bearer <IMS_ACCESS_TOKEN>
​- x-api-key: <API_KEY> (do Developer Console)
​- x-gw-ims-org-id: <IMS_ORG_ID> (formato: {ORG_ID}@AdobeOrg)
​- x-request-id: <UNIQUE_REQUEST_ID> (para rastreamento e desduplicação)
​- Content-Type: application/vnd.adobe.xdm+json; schema="…/decision-request;version=1.0"
​- Accept: application/vnd.adobe.xdm+json; schema="…/decision-response;version=1.0"
​- x-sandbox-name: <SANDBOX_NAME> (por exemplo, prod, dev)

Solicitar Parâmetros de Corpo:
​- xdm:dryRun (verdadeiro/falso) - Testar solicitações sem poluir relatórios
​- xdm:propositionRequests[] - Matriz de solicitações de decisão:
​- activityId - Identificador de atividade de decisão
​- placementId - Identificador de posicionamento
​- itemCount - Número máximo de ofertas a serem retornadas
​- xdm:profiles[].xdm:identityMap - Mapeamento de identidade (email, ECID etc.)
​- xdm:validateContextData - Sinalizador de validação de dados de contexto restrito
​- xdm:responseFormat.xdm:includeContent - Incluir conteúdo real vs. somente IDs

Exemplo de corpo de solicitação:

{
  "xdm": {
    "dryRun": false,
    "propositionRequests": [
      { "activityId": "<ACTIVITY_ID>", "placementId": "<PLACEMENT_ID>", "itemCount": 3 }
    ],
    "profiles": [
      { "identityMap": { "ECID": [ { "id": "<ECID>", "primary": true } ] } }
    ],
    "validateContextData": true,
    "responseFormat": { "includeContent": true }
  }
}

Solicitação Edge de decisão (após a migração) decisioning-request

Após a migração, use o formato de solicitação de Decisão por meio do mesmo endpoint do Edge Network.

Ponto de extremidade:

POST https://edge.adobedc.net/ee/v2/interact

Campos-chave de solicitação:
​- query.identity.fetch - Matriz de tipos de identidade para resolver (por exemplo, ["ECID"])
​- event.xdm.environment.type - Tipo de ambiente: "browser", "app" ou "server"
​- event.xdm.environment.browserDetails - Metadados do navegador (viewportWidth, viewportHeight, userAgent)
​- event.xdm.identityMap - Mesmo mapeamento de identidade da Gestão de decisões
​- event.xdm.timestamp - Carimbo de data/hora ISO 8601
​- query.personalization.surfaces - Matriz de superfícies de destino (por exemplo, ["web://site.com/homepage"]) — substitui decisionScope
​- query.personalization.schemas - Esquemas de conteúdo a serem retornados (por exemplo, ["json-content-item", "html-content-item"])
​- data.__adobe.ajo.allowDuplicateDecisionItems - Controle de desduplicação (o padrão é true; defina false para que um item que se qualifique para várias superfícies seja retornado apenas uma vez, com as outras superfícies recebendo um item de fallback/vazio). Substitui o Gerenciamento de decisão allowDuplicatePropositions.
​- data.__adobe.ajo.dryRun - Sinalizador de teste; suprime eventos de feedback para contadores de relatório e limite. Substitui o Gerenciamento de decisão xdm:dryRun. Remover antes da produção.

Exemplo de corpo de solicitação (lado do servidor):

{
  "events": [
    {
      "query": {
        "identity": { "fetch": ["ECID"] },
        "personalization": {
          "surfaces": ["web://my-web/IP_NLI_HP_GET_LOAN_WIDGET"],
          "schemas": [
            "https://ns.adobe.com/personalization/json-content-item",
            "https://ns.adobe.com/personalization/html-content-item"
          ]
        }
      },
      "xdm": {
        "eventType": "decisioning.propositionFetch",
        "environment": {
          "type": "browser",
          "browserDetails": { "viewportWidth": 1280, "viewportHeight": 900, "userAgent": "<USER_AGENT>" }
        },
        "identityMap": {
          "ECID": [ { "id": "<ECID>", "authenticatedState": "ambiguous", "primary": true } ]
        },
        "timestamp": "2025-09-08T12:00:00.000Z"
      },
      "data": {
        "__adobe": { "ajo": { "allowDuplicateDecisionItems": false } }
      }
    }
  ],
  "meta": {
    "state": {
      "domain": "my-web",
      "cookiesEnabled": true,
      "entries": [
        { "key": "kndctr_<ORG>_AdobeOrg_identity", "value": "<identity-cookie>" },
        { "key": "kndctr_<ORG>_AdobeOrg_cluster", "value": "<cluster-cookie>" }
      ]
    }
  }
}

Decisão da resposta do Edge decisioning-response

A resposta de Decisão contém vários identificadores organizados por tipo de preocupação: personalization:decisions (as ofertas), locationHint:result e state:store (os cookies a serem mantidos).

Estrutura de Resposta:

{
  "requestId": "<REQUEST_ID>",
  "handle": [
    {
      "type": "personalization:decisions",
      "eventIndex": 0,
      "payload": [
        {
          "id": "103ae599-e6d8-4631-baf3-51dd8c6ed4c1",
          "scope": "web://my-web/IP_NLI_HP_GET_LOAN_WIDGET",
          "scopeDetails": {
            "decisionProvider": "AJO",
            "correlationID": "<CORRELATION_ID>",
            "characteristics": {
              "eventToken": "<base64 message-level event token>",
              "subPropositions": "<base64-encoded array of decision items>"
            },
            "rank": 1,
            "activity": {
              "id": "<campaignId>#<actionId>",
              "priority": 0,
              "matchedSurfaces": ["web://my-web/IP_NLI_HP_GET_LOAN_WIDGET"]
            }
          },
          "items": [
            {
              "id": "36646bab-af1b-44c6-b632-bbfb9c357919",
              "schema": "https://ns.adobe.com/personalization/json-content-item",
              "data": { "content": "{ ...offer JSON... }" }
            }
          ]
        }
      ]
    },
    {
      "type": "locationHint:result",
      "payload": [
        { "scope": "EdgeNetwork", "hint": "ind1", "ttlSeconds": 1800 }
      ]
    },
    {
      "type": "state:store",
      "payload": [
        { "key": "kndctr_<ORG>_AdobeOrg_cluster", "value": "<cluster-cookie>", "maxAge": 1800 },
        { "key": "kndctr_<ORG>_AdobeOrg_identity", "value": "<identity-cookie>", "maxAge": 34128000 }
      ]
    }
  ]
}

Campos-chave de resposta:
​- handle[].type - Tipo de identificador (personalization:decisions, locationHint:result, state:store)
​- payload[].id - ID exclusiva da instância da proposta — eco de volta na exibição/interagir com eventos
​- payload[].scope - URI de superfície para o qual a proposta foi resolvida
​- payload[].scopeDetails.decisionProvider - Confirma que o mecanismo é AJO
​- payload[].scopeDetails.correlationID - Vincula a instância de decisão ao evento de serviço
​- payload[].scopeDetails.rank / payload[].scopeDetails.activity - Classificação e metadados de campanha/ação para a proposta
​- payload[].scopeDetails.characteristics.eventToken - Token de rastreamento em nível de mensagem
​- payload[].scopeDetails.characteristics.subPropositions - Matriz codificada na Base64 dos itens de decisão; cada item carrega seu próprio item token. Estes tokens por item são o que você passa no propositionAction.tokens em eventos de exibição/interação
​- payload[].items[].schema / payload[].items[].data.content - Esquema de conteúdo e conteúdo real da oferta (JSON/HTML) para renderizar
​- state:store carga - A identidade e os cookies de cluster para persistir e encaminhar em solicitações subsequentes (lado do servidor)

A cadeia de caracteres characteristics.subPropositions base64-decodifica para a matriz de itens servidos, cada um com seu item por item token:

[
  {
    "id": "1ae75277-8832-4c23-bbbc-09f01cfe6c8b",
    "scope": "web://my-web/IP_NLI_HP_GET_LOAN_WIDGET",
    "scopeDetails": { "decisionProvider": "EXD", "correlationID": "<CORRELATION_ID>-0", "rank": 1 },
    "items": [
      { "id": "dps:<schema>:1be64ff83a612488", "name": "ExD_Personal Loan Offer", "score": 997.0, "token": "CLaefQnVLcLbCtzEXV3Jeg" },
      { "id": "dps:<schema>:1be6516838e1248c", "name": "ExD_Home Loan Offer",     "score": 995.0, "token": "ALlB5KV1B0e+CpHoahi7Ew" },
      { "id": "dps:<schema>:1be650da3cd06e98", "name": "ExD_Auto Loan Offer",     "score": 994.0, "token": "koJTRQcwFkR92AqbZ88ytQ" },
      { "id": "dps:<schema>:1be65612d5a1248d", "name": "ExD_Fallback Offer",      "itemSelection": { "selectionDetail": { "selectionType": "fallback" } }, "token": "GHo4ow7h6iCzBOhYR1+6jg" }
    ]
  }
]

Padrões de implementação implementation-patterns

O Decisioning suporta três abordagens de implementação:

Implementação Do Lado Do Cliente (Web SDK/SDK Móvel) client-side

O Web SDK ou Mobile SDK lida com todas as solicitações e com o gerenciamento de cookies automaticamente. O SDK armazena e encaminha cookies de identidade e de cluster com cada solicitação.

Tratamento de cookies: Automático — o Web SDK gerencia cookies kndctr_<OrgId>_identity e kndctr_<OrgId>_cluster.

Implementação do lado do servidor (API do Edge Network) server-side

O servidor de aplicativos faz o POST diretamente no Edge Network e deve gerenciar manualmente o encaminhamento de cookies. O servidor extrai os cookies do navegador das solicitações recebidas e os encaminha para a Edge Network por meio de meta.state.entries[] e retorna os cookies na resposta.

Tratamento de cookies: Manual — o servidor de aplicativos deve extrair cookies da solicitação do navegador, encaminhar para o Edge Network no corpo da solicitação e definir como resposta. Os cookies devem ser explicitamente encaminhados em meta.state.entries para consistência de identidade.

Implementação híbrida hybrid

Combina a renderização do lado do servidor (carregamento inicial da página) com a SDK do lado do cliente (interações subsequentes). O servidor renderiza o conteúdo inicial por meio do Edge Network e, em seguida, o Web SDK assume o controle das solicitações de personalização subsequentes.

Tratamento de cookies: misto — o lado do servidor requer o encaminhamento manual de cookies para o Edge Network; o lado do cliente é manipulado automaticamente pelo Web SDK. Verifique se os tokens de identidade da renderização do lado do servidor estão disponíveis para o SDK do lado do cliente para resolução de identidade consistente.

Rastreamento de eventos e coleta de dados event-tracking

Para atribuir corretamente os resultados da decisão, ativar o limite de frequência e a otimização de classificação baseada em IA de energia, você deve implementar o rastreamento de eventos usando o schema de eventos Decisioning.

Campos de evento obrigatórios event-fields

eventType e _experience.decisioning.propositionEventType são obrigatórios. Se um deles estiver ausente, o contador de exibição/interação correspondente não será incrementado.

Requisitos do esquema schema-requirements

Associe o grupo de campos Decisão ao esquema do conjunto de dados do evento antes da migração:

Tratamento do token de rastreamento tracking-token

O token de rastreamento deve ser manipulado de acordo com estes requisitos:

Exemplos de eventos de decisão event-examples

Cada exemplo ecoa a proposta apresentada (incluindo seu scopeDetails, que carrega characteristics.subPropositions) e define eventType e propositionEventType. Os contadores são incrementados em relação aos itens em subPropositions; propositionAction.tokens seleciona quais itens.

Eventos de exibição

Exibir eventos notifica a Decisão quando uma oferta é exibida a um usuário. Forneça os tokens dos itens mostrados ou omita tokens para incrementar o contador de exibição para todos os itens em subPropositions:

{
  "header": {
    "imsOrgId": "YOUR_ORG_ID",
    "sandboxId": "sandbox-id",
    "sandboxName": "sandbox-name",
    "source": { "name": "ajo-inbound" }
  },
  "body": {
    "xdmEntity": {
      "identityMap": {
        "ECID": [ { "id": "ecid-123", "primary": true } ]
      },
      "eventType": "decisioning.propositionDisplay",
      "_experience": {
        "decisioning": {
          "propositionEventType": { "display": 1 },
          "propositionAction": {
            "id": "b96f842b-5dd9-4c55-9dae-647d96250028",
            "tokens": ["CLaefQnVLcLbCtzEXV3Jeg", "ALlB5KV1B0e+CpHoahi7Ew"]
          },
          "propositions": [
            {
              "id": "103ae599-e6d8-4631-baf3-51dd8c6ed4c1",
              "scope": "web://my-web/IP_NLI_HP_GET_LOAN_WIDGET",
              "scopeDetails": {
                "decisionProvider": "AJO",
                "characteristics": {
                  "eventToken": "<base64 eventToken from response>",
                  "subPropositions": "<base64 subPropositions from response>"
                }
              }
            }
          ]
        }
      }
    }
  }
}

Interagir (clicar) eventos

Os eventos do Interact rastreiam quando um usuário clica ou se envolve com uma oferta exibida. Você deve fornecer exatamente um token identificando o item clicado:

{
  "header": {
    "imsOrgId": "YOUR_ORG_ID",
    "sandboxId": "sandbox-id",
    "sandboxName": "sandbox-name",
    "source": { "name": "ajo-inbound" }
  },
  "body": {
    "xdmEntity": {
      "identityMap": {
        "ECID": [ { "id": "ecid-123", "primary": true } ]
      },
      "eventType": "decisioning.propositionInteract",
      "_experience": {
        "decisioning": {
          "propositionEventType": { "interact": 1 },
          "propositionAction": {
            "id": "b96f842b-5dd9-4c55-9dae-647d96250028",
            "tokens": ["CLaefQnVLcLbCtzEXV3Jeg"]
          },
          "propositions": [
            {
              "id": "103ae599-e6d8-4631-baf3-51dd8c6ed4c1",
              "scope": "web://my-web/IP_NLI_HP_GET_LOAN_WIDGET",
              "scopeDetails": {
                "decisionProvider": "AJO",
                "characteristics": {
                  "eventToken": "<base64 eventToken from response>",
                  "subPropositions": "<base64 subPropositions from response>"
                }
              }
            }
          ]
        }
      }
    }
  }
}

Eventos personalizados

Um evento personalizado usa um eventType definido pelo cliente (qualquer valor diferente de decisioning.proposition<Display|Interact|Dismiss>) e define todos os display/interact/dismiss como 0 em propositionEventType (classificado como OTHER). Eventos personalizados são decodificados como eventos de exibição (filtragem de vários tokens) em relação a subPropositions e avaliados por meio do PQL configurado:

{
  "header": {
    "imsOrgId": "YOUR_ORG_ID",
    "sandboxId": "sandbox-id",
    "sandboxName": "sandbox-name",
    "originalTimestamp": 1700000
  },
  "body": {
    "xdmEntity": {
      "identityMap": {
        "ECID": [ { "id": "ecid-123", "primary": true } ]
      },
      "eventType": "add-to-cart",
      "_experience": {
        "decisioning": {
          "propositionEventType": { "display": 0, "interact": 0, "dismiss": 0 },
          "propositionAction": {
            "id": "b96f842b-5dd9-4c55-9dae-647d96250028",
            "tokens": ["CLaefQnVLcLbCtzEXV3Jeg"]
          },
          "propositions": [
            {
              "id": "103ae599-e6d8-4631-baf3-51dd8c6ed4c1",
              "scope": "web://my-web/IP_NLI_HP_GET_LOAN_WIDGET",
              "scopeDetails": {
                "decisionProvider": "AJO",
                "characteristics": {
                  "eventToken": "<base64 eventToken from response>",
                  "subPropositions": "<base64 subPropositions from response>"
                }
              }
            }
          ]
        }
      }
    }
  }
}

Esses eventos permitem limitação de frequência, relatórios prontos para uso e otimização de classificação orientada por IA no Decisioning. Para enviar eventos de apresentação com o Web SDK, consulte Experiência baseada em código: implementações de decisão.

Processo de migração completo migration-process

Tópicos relacionados related-topics