[Beta]{class="badge informative"}
Referência de ferramentas do servidor MCP Adobe Target target-mcp-tools-reference
Esta página é uma referência completa para todas as ferramentas expostas pelo servidor MCP Adobe Target. Para cada ferramenta, você encontrará uma descrição, detalhes do parâmetro, valor de retorno e um exemplo de prompt em linguagem natural. Para obter instruções de configuração e casos de uso, consulte Introdução e Casos de uso e apresentações.
Pré-requisitos tools-prerequisites
Sua função Adobe Target determina quais ferramentas estão disponíveis para você:
- Função de Observador ou superior: acesso a todas as ferramentas somente leitura
- Função do Editor ou superior: acesso a ferramentas de leitura mais ferramentas de gravação (criar, atualizar)
- Função do Aprovador: acesso a todas as ferramentas, incluindo ativação e desativação
Para obter instruções completas sobre a configuração, consulte Introdução.
Ferramentas de atividade tools-activities
Ferramenta: list_target_activities
Listar Adobe Target atividades com filtragem e classificação do lado do servidor.
Recupera uma lista paginada de atividades. Todos os filtros são aplicados no lado do servidor pela API de Administração Target. O servidor retorna no máximo 200 atividades por página.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 16-row-4 17-row-4 18-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
limit |
número inteiro | Não | Número máximo de atividades a serem retornadas (máx. do servidor: 200) |
offset |
número inteiro | Não | Número de atividades a serem ignoradas para paginação |
sort_by |
string | Não | Campo de acordo com o qual classificar. Prefixo com - para ordem decrescente (por exemplo, -modifiedAt). Opções: id, name, state, priority, startsAt, endsAt, lifetimeStart, lifetimeEnd, createdAt, createdBy, modifiedAt, modifiedBy, type, thirdPartyId |
state |
string | Não | Filtrar por estado de atividade: approved (ativo/ativo), deactivated (inativo), paused, saved (rascunho) |
activity_type |
string | Não | Filtrar por tipo: ab (Teste A/B), xt (Direcionamento de experiência), abt (Automated Personalization) |
name_contains |
string | Não | Filtrar atividades cujo nome contém esta cadeia de caracteres (não diferencia maiúsculas de minúsculas) |
starts_after |
string | Não | Data ISO 8601 — atividades que começam após esta data |
starts_before |
string | Não | Data ISO 8601 — atividades que começam antes desta data |
modified_after |
string | Não | Data ISO 8601 — atividades modificadas após esta data |
ends_after |
string | Não | Data ISO 8601 — atividades que terminam após esta data |
ends_before |
string | Não | Data ISO 8601 — atividades que terminam antes desta data |
workspace |
string | Não | Filtrar por ID de espaço de trabalho |
segment_id |
string | Não | Filtrar por ID de segmento de público |
profile_attribute_id |
string | Não | Filtrar por ID de atributo de perfil |
priority |
número inteiro | Não | Filtrar por valor de prioridade exato (0-999) |
mbox |
string | Não | Filtrar por nome de mbox/local |
offer_id |
string | Não | Filtrar por ID de oferta |
view_id |
string | Não | Filtrar por ID de exibição de SPA |
Retorna: objeto JSON com activities (lista de objetos incluindo id, name, state, type, priority, modifiedAt, startsAt, endsAt) e total (contagem total, pode exceder o tamanho da página retornada).
Prompt de exemplo: “Lista todos os testes A/B ativos classificados pela última modificação.”
Ferramenta: get_ab_activity
Obtenha informações detalhadas sobre uma atividade A/B.
Recupera a configuração completa de um teste A/B específico, incluindo experiências, locais, métricas e regras de direcionamento.
| table 0-row-4 1-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_id |
número inteiro | Sim | O identificador exclusivo da atividade A/B |
Retorna: Detalhes completos da atividade, incluindo metadados (nome, estado, prioridade, datas), experiências, locais e ofertas, metas e métricas, além das regras de direcionamento.
Prompt de exemplo: “Obter detalhes da atividade A/B 12345”.
Ferramenta: get_xt_activity
Obtenha informações detalhadas sobre uma atividade de Direcionamento de experiência (XT).
Recupera a configuração completa de uma atividade de XT específica, incluindo mapeamentos de experiência de público-alvo, locais e métricas.
| table 0-row-4 1-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_id |
número inteiro | Sim | O identificador exclusivo da atividade de XT |
Retorna: detalhes completos da atividade, incluindo metadados, experiências com mapeamentos de público-alvo, locais e ofertas, metas e métricas.
Prompt de exemplo: “Obter detalhes da atividade de Direcionamento de Experiência 12345”.
Ferramenta: get_abt_activity
Obtenha informações detalhadas sobre uma atividade de Automated Personalization (AP).
| table 0-row-4 1-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_id |
número inteiro | Sim | O identificador exclusivo da atividade de AP |
Retorna: detalhes completos da atividade, incluindo metadados, experiências, locais e configurações algorítmicas.
Prompt de exemplo: “Obter detalhes da atividade 12345 do Personalization Automático”.
Ferramenta: create_ab_activity
Crie uma nova atividade de teste A/B.
Cria um novo teste A/B com a configuração especificada, incluindo experiências, ofertas e direcionamento.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
name |
string | Sim | Nome da atividade |
state |
string | Não | Estado inicial: approved, deactivated ou saved (padrão: saved) |
priority |
número inteiro | Não | Prioridade de atividade (0-999, padrão: 0) |
starts_at |
string | Não | Data de início da atividade (ISO 8601) |
ends_at |
string | Não | Data final da atividade (ISO 8601) |
experiences |
matriz | Sim | Lista de configurações de experiência |
locations |
matriz | Sim | Lista de configurações de local/mbox |
goals |
objeto | Não | Métricas de meta primária e secundária |
audiences |
matriz | Não | Configurações do público-alvo |
workspace_id |
string | Não | Workspace ID da atividade |
Retorna: o objeto de atividade criado com sua ID atribuída.
Prompt de exemplo: “Crie um teste A/B chamado ‘Teste de Herói da Página Inicial’ com duas experiências testando imagens herói diferentes na mbox homepage-hero.”
Ferramenta: create_xt_activity
Crie uma nova atividade de Direcionamento de experiência (XT).
Cria uma atividade de XT que fornece experiências diferentes para públicos-alvo diferentes com base nas regras de direcionamento.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
name |
string | Sim | Nome da atividade |
state |
string | Não | Estado inicial: approved, deactivated ou saved (padrão: saved) |
priority |
número inteiro | Não | Prioridade de atividade (0-999, padrão: 0) |
starts_at |
string | Não | Data de início da atividade (ISO 8601) |
ends_at |
string | Não | Data final da atividade (ISO 8601) |
experiences |
matriz | Sim | Lista de configurações de experiência com mapeamentos de público |
locations |
matriz | Sim | Lista de configurações de local/mbox |
goals |
objeto | Não | Métricas de meta primária e secundária |
workspace_id |
string | Não | Workspace ID da atividade |
Retorna: o objeto de atividade criado com sua ID atribuída.
Prompt de exemplo: “Crie uma atividade de Direcionamento de Experiência chamada ‘Geo Personalization’ que mostre conteúdo diferente para visitantes de regiões diferentes.”
Ferramenta: update_ab_activity
Atualizar uma atividade A/B existente.
Usa um padrão de leitura-modificação-gravação: busca o estado atual, mescla as alterações, valida e envia a atualização.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_id |
número inteiro | Sim | O identificador exclusivo da atividade a ser atualizada |
activity |
objeto | Sim | Campos a serem atualizados (nome, prioridade, experiências, locais, metas etc.) |
Retorna: O objeto de atividade atualizado.
Prompt de exemplo: “Atualize a atividade 12345 para alterar a alocação de tráfego para 70/30.”
Ferramenta: update_xt_activity
Atualizar uma atividade existente de Direcionamento de experiência.
Usa um padrão de leitura-modificação-gravação.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_id |
número inteiro | Sim | O identificador exclusivo da atividade de XT a ser atualizada |
activity |
objeto | Sim | Campos a serem atualizados |
Retorna: O objeto de atividade atualizado.
Prompt de exemplo: “Atualize a atividade XT 12345 para adicionar uma nova experiência para visitantes móveis.”
Ferramenta: update_abt_activity
Atualizar uma atividade existente do Automated Personalization.
Usa um padrão de leitura-modificação-gravação.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_id |
número inteiro | Sim | O identificador exclusivo da atividade de AP a ser atualizada |
activity |
objeto | Sim | Campos a serem atualizados |
Retorna: O objeto de atividade atualizado.
Prompt de exemplo: “Atualize a atividade 12345 do AutoPersonalization para alterar a meta de otimização.”
Ferramenta: update_activity_schedule
Atualize as datas de início e término da atividade.
Atualiza o agendamento de uma atividade sem modificar outras configurações.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_id |
número inteiro | Sim | O identificador exclusivo da atividade |
activity_type |
string | Sim | Tipo de atividade: ab, xt ou abt |
starts_at |
string | Não | Nova data de início (ISO 8601) |
ends_at |
string | Não | Nova data final (ISO 8601) |
Retorna: Confirmação da atualização da agenda.
Prompt de exemplo: “Atualize o agendamento da atividade A/B 12345 para execução de 1º de maio a 31 de maio”.
Ferramenta: update_activity_state
Alterar o estado da atividade (ativar, desativar ou pausar).
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_id |
número inteiro | Sim | O identificador exclusivo da atividade |
state |
string | Sim | Novo estado: approved (ativo/ativo), deactivated (inativo), paused ou saved (rascunho) |
Retorna: O estado de atividade atualizado.
Prompt de exemplo: “Ativar atividade 12345” ou “Pausar o Teste Herói da Página Inicial”.
Ferramenta: update_activity_name
Renomeie uma atividade.
Atualiza somente o nome sem modificar a configuração completa.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_id |
número inteiro | Sim | O identificador exclusivo da atividade |
name |
string | Sim | Nome da nova atividade |
Retorna: O objeto de atividade atualizado.
Prompt de exemplo: “Renomeie a atividade 12345 para ‘Teste de Herói da Campanha de Verão’.”
Ferramenta: update_activity_priority
Alterar prioridade da atividade.
Atividades de prioridade mais alta têm prioridade quando várias atividades têm como alvo o mesmo local.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_id |
número inteiro | Sim | O identificador exclusivo da atividade |
priority |
número inteiro | Sim | Novo valor de prioridade (0-999; maior = prioridade mais alta) |
Retorna: O objeto de atividade atualizado.
Prompt de exemplo: “Definir a prioridade da atividade 12345 para 100”.
Ferramenta: add_activity_variant
Adicionar uma nova experiência/variante a uma atividade.
Lida com toda a coordenação estrutural, incluindo a criação de opções, mapeamento para locais e reequilíbrio do tráfego.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_id |
número inteiro | Sim | A ID da atividade a ser modificada |
activity_type |
string | Sim | Tipo de atividade: ab, xt ou abt |
variant_name |
string | Sim | Nome da nova experiência/variante |
offer_id |
número inteiro | Não | (Baseado em formulário) ID de oferta existente para usar |
offer_content |
string | Não | (Baseado em formulário) Conteúdo do HTML para uma nova oferta em linha |
traffic_percentage |
número inteiro | Não | % de tráfego da nova variante (1-99). Se omitido, o tráfego será rebalanceado uniformemente |
audience_id |
número inteiro | Não | ID de público-alvo da variante (atividades de XT) |
modifications |
matriz | Não | (VEC) Lista de modificações baseadas no seletor de CSS |
Retorna: O objeto de atividade atualizado.
Prompt de exemplo: “Adicione uma nova variante chamada ‘Tema de Feriado’ à atividade A/B 12345 usando a oferta 67890.”
Ferramenta: update_traffic_split
Atualizar alocação de tráfego entre variantes.
As porcentagens devem somar exatamente 100.
| table 0-row-4 1-row-4 2-row-4 3-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_id |
número inteiro | Sim | A ID da atividade a ser modificada |
activity_type |
string | Sim | Tipo de atividade: ab ou abt (XT não suportado — direcionado ao público) |
splits |
objeto | Sim | Nome da experiência de mapeamento de dicionário para porcentagem. Deve incluir todas as experiências e somar até 100 |
Retorna: O objeto de atividade atualizado.
Prompt de exemplo: “Alterar a divisão de tráfego da atividade 12345 para 70% de Controle e 30% de Variante A”.
Ferramenta: update_variant_offer
Alterar a oferta de uma variante específica.
Funciona para atividades baseadas em formulário (usando offer_id) e atividades de VEC (usando modifications).
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_id |
número inteiro | Sim | A ID da atividade a ser modificada |
activity_type |
string | Sim | Tipo de atividade: ab, xt ou abt |
variant_name |
string | Sim | Nome da experiência/variante a ser atualizada |
offer_id |
número inteiro | Não | (Baseado em formulário) Nova ID de oferta |
offer_content |
string | Não | (Baseado em formulário) Conteúdo do HTML para uma nova oferta em linha |
modifications |
matriz | Não | (VEC) Nova lista de modificações baseadas em seletor de CSS |
Retorna: O objeto de atividade atualizado.
Prompt de exemplo: “Atualize a experiência ‘Variante A’ na atividade 12345 para usar a oferta 99999.”
Ferramenta: remove_activity_variant
Remover uma experiência/variante de uma atividade.
Remove a experiência, limpa opções órfãs e redistribui o tráfego de maneira uniforme entre as variantes restantes.
| table 0-row-4 1-row-4 2-row-4 3-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_id |
número inteiro | Sim | A ID da atividade a ser modificada |
activity_type |
string | Sim | Tipo de atividade: ab, xt ou abt |
variant_name |
string | Sim | Nome da experiência/variante a ser removida |
Retorna: O objeto de atividade atualizado.
Prompt de exemplo: “Remover a experiência ‘Variante de Teste’ da atividade A/B 12345.”
Ferramentas de oferta tools-offers
Ferramenta: list_target_offers
Liste todas as ofertas em seu locatário do Target.
Recupera uma lista paginada de ofertas de conteúdo com filtragem opcional.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
limit |
número inteiro | Não | Número máximo de ofertas a serem retornadas |
offset |
número inteiro | Não | Número de ofertas a serem ignoradas para paginação |
type |
string | Não | Filtrar por tipo de oferta: content (HTML), json ou redirect |
name |
string | Não | Filtrar por nome da oferta (correspondência parcial) |
Retorna: objeto JSON com offers (lista de objetos incluindo id, name, type, content, modifiedAt) e total.
Prompt de exemplo: “Listar todas as ofertas JSON”.
Ferramenta: get_target_offer
Obtenha informações detalhadas sobre uma oferta específica.
| table 0-row-4 1-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
offer_id |
número inteiro | Sim | O identificador exclusivo da oferta |
Retorna: Detalhes completos da oferta, incluindo id, name, type, content, workspace e modifiedAt.
Exemplo de prompt: “Obter detalhes da oferta 67890”.
Ferramenta: create_target_offer
Crie uma nova oferta de conteúdo do HTML.
| table 0-row-4 1-row-4 2-row-4 3-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
name |
string | Sim | Nome da oferta |
content |
string | Sim | Conteúdo de texto ou HTML para a oferta |
workspace_id |
string | Não | Workspace ID da oferta |
Retorna: a oferta criada com sua ID atribuída.
Exemplo de prompt: “Crie uma oferta do HTML chamada ‘Banner de Vendas de Verão’ com um banner promocional.”
Ferramenta: create_target_json_offer
Crie uma nova oferta JSON para fornecer dados estruturados.
| table 0-row-4 1-row-4 2-row-4 3-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
name |
string | Sim | Nome da oferta |
content |
objeto | Sim | Conteúdo JSON para a oferta |
workspace_id |
string | Não | Workspace ID da oferta |
Retorna: a oferta criada com sua ID atribuída.
Exemplo de prompt: “Crie uma oferta JSON chamada ‘Configuração de Sinalizadores de Recurso’ com configurações de alternância de recurso.”
Ferramenta: update_target_offer
Atualizar uma oferta existente.
| table 0-row-4 1-row-4 2-row-4 3-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
offer_id |
número inteiro | Sim | O identificador exclusivo da oferta a ser atualizada |
name |
string | Não | Nome da oferta atualizado |
content |
string ou objeto | Não | Conteúdo de oferta atualizado |
Retorna: O objeto de oferta atualizado.
Prompt de exemplo: “Atualizar oferta 67890 com novo conteúdo promocional.”
Ferramentas de público tools-audiences
Ferramenta: list_target_audiences
Liste todos os públicos do seu locatário do Target.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
limit |
número inteiro | Não | Número máximo de públicos-alvo a serem retornados |
offset |
número inteiro | Não | Número de públicos-alvo a serem ignorados para paginação |
Retorna: objeto JSON com audiences (lista de objetos incluindo id, name, description, origin, modifiedAt) e total.
Exemplo de prompt: “Listar todos os públicos-alvo”.
Ferramenta: get_target_audience
Obtenha detalhes do público-alvo, incluindo regras de direcionamento.
Recupera a configuração completa de um público-alvo específico, incluindo suas regras de direcionamento e condições.
| table 0-row-4 1-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
audience_id |
número inteiro | Sim | O identificador exclusivo do público-alvo |
Retorna: detalhes completos sobre o público-alvo, incluindo id, name, description, origin, regras de direcionamento e contagem de atividades associada.
Prompt de exemplo: “Obter detalhes do público-alvo 12345 e mostrar suas regras de direcionamento para mim.”
Ferramenta: create_target_audience
Crie um novo público com regras de direcionamento.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
name |
string | Sim | Nome do público |
description |
string | Não | Descrição do público |
targetRule |
objeto | Não | Regras de direcionamento (localização geográfica, navegador, atributos personalizados etc.) |
workspace_id |
string | Não | Workspace ID para o público |
Retorna: o público-alvo criado com sua ID atribuída.
Exemplo de prompt: “Crie um público chamado ‘Visitantes móveis da Califórnia’ direcionado a usuários móveis na CA.”
Ferramentas da mbox tools-mboxes
Ferramenta: list_target_mboxes
Liste todas as mboxes em seu locatário do Target.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
limit |
número inteiro | Não | Número máximo de mboxes a serem retornadas |
offset |
número inteiro | Não | Número de mboxes a serem ignoradas para paginação |
name |
string | Não | Filtrar por nome de mbox (correspondência parcial) |
status |
string | Não | Filtrar por status |
Retorna: objeto JSON com mboxes (lista de objetos incluindo name, status, lastRequestTime) e total.
Exemplo de prompt: “Listar todas as mboxes contendo ‘homepage’.”
Ferramenta: get_target_mbox
Obtenha informações detalhadas sobre uma mbox específica.
| table 0-row-4 1-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
mbox_name |
string | Sim | O nome da mbox |
Retorna: detalhes da mbox, incluindo name, status e lista de atividades usando a mbox.
Prompt de exemplo: “Obter detalhes da mbox ‘homepage-hero’.”
Ferramenta: list_target_mbox_profile_attributes
Liste todos os atributos de perfil de mbox disponíveis para direcionamento.
Nenhum parâmetro é necessário.
Retorna: matriz JSON de objetos de atributo de perfil.
Exemplo de prompt: “Quais atributos de perfil estão disponíveis para direcionamento?”
Ferramentas de propriedade tools-properties
Ferramenta: list_target_properties
Liste todas as propriedades em seu locatário do Target.
As propriedades organizam atividades e controlam o acesso.
Nenhum parâmetro é necessário.
Retorna: Lista de objetos de propriedade incluindo id, name, description e channel.
Prompt de exemplo: “Listar todas as propriedades do Target”.
Ferramentas de relatórios tools-reporting
Ferramenta: get_ab_performance_report
Obtenha um relatório de desempenho para uma atividade A/B.
Recupera taxas de conversão, aumentos e níveis de confiança.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_id |
número inteiro | Sim | O identificador exclusivo da atividade A/B |
report_interval |
string | Não | Período do relatório (por exemplo, last7days, last30days ou um intervalo de datas personalizado) |
Retorna: métricas de nível de experiência (visitantes, conversões, taxa de conversão), cálculos de aumento, níveis de confiança estatística e métricas de receita (se configuradas).
Prompt de exemplo: “Mostrar o relatório de desempenho do teste A/B 12345 dos últimos 30 dias.”
Ferramenta: get_ab_orders_report
Obtenha um relatório de pedidos/receita para uma atividade A/B.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_id |
número inteiro | Sim | O identificador exclusivo da atividade A/B |
report_interval |
string | Não | Período do relatório |
Devoluções: Contagens de pedidos, receita e valor médio de pedidos por experiência.
Exemplo de prompt: “Obter o relatório de pedidos para a atividade 12345”.
Ferramenta: get_xt_performance_report
Obtenha um relatório de desempenho para uma atividade de Direcionamento de experiência.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_id |
número inteiro | Sim | O identificador exclusivo da atividade de XT |
report_interval |
string | Não | Período do relatório |
Retorna: métricas de desempenho de nível de experiência.
Prompt de exemplo: “Mostrar desempenho para minha atividade de Direcionamento de Experiência 54321”.
Ferramenta: get_xt_orders_report
Obtenha um relatório de pedidos/receita para uma atividade de Direcionamento de experiência.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_id |
número inteiro | Sim | O identificador exclusivo da atividade de XT |
report_interval |
string | Não | Período do relatório |
Retorna: Ordenar métricas por experiência.
Exemplo de prompt: “Obter dados de pedidos para a atividade XT 54321”.
Ferramenta: get_activity_report_by_name
Procure uma atividade por nome e obtenha o relatório de desempenho.
Útil quando você sabe o nome da atividade, mas não a ID.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_name |
string | Sim | Nome da atividade a ser pesquisada |
report_interval |
string | Não | Período do relatório |
Retorna: detalhes da atividade e métricas de desempenho.
Prompt de exemplo: “Obter o relatório de desempenho da minha atividade ‘Teste de Herói da Página Inicial’.”
Ferramenta: get_a4t_report
Buscar um relatório do Analytics for Target (A4T) para uma atividade Target.
Valida a configuração A4T da atividade e executa consultas GraphQL em Adobe Analytics para recuperar métricas do lado do Analytics. Disponível somente para atividades com relatórios do A4T configurados.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_id |
número inteiro | Sim | O identificador exclusivo da atividade Target |
report_interval |
string | Não | Período do relatório (por exemplo, last7days, last30days ou um intervalo de datas personalizado) |
Retorna: métricas do lado analítico da atividade, incluindo contagens de visitantes, conversões, receita e aumento por experiência, originadas diretamente de Adobe Analytics.
Prompt de exemplo: “Puxe o relatório do A4T para meu teste de otimização de check-out e resuma os dados de conversão do lado do Analytics.”
Ferramentas de visualização tools-preview
Ferramenta: preview_activity
Gerar URLs de visualização de QA do navegador para uma atividade Target.
Cria links de visualização clicáveis que forçam a exibição de experiências específicas, ignorando as regras de direcionamento de público-alvo. Funciona para atividades A/B, XT e Automated Personalization.
| table 0-row-4 1-row-4 2-row-4 3-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
activity_id |
número inteiro | Sim | A ID da atividade Target para visualizar |
experience_index |
número inteiro | Não | Índice de experiência com base em 0. Se omitido, retorna URLs para todas as experiências |
url |
string | Não | URL da página para visualização. Obrigatório para atividades baseadas em formulário. Para atividades do VEC, substitui o local criado, se fornecido |
Retorna: informações de atividade (nome, tipo, estado), URLs de visualização para cada experiência, além de nomes e índices de experiência.
Prompt de exemplo: “Gerar URLs de visualização para a atividade 12345 para que eu possa testar cada experiência no meu navegador.”
Ferramentas de token de resposta tools-response-tokens
Ferramenta: list_target_response_tokens
Liste todos os tokens de resposta em seu locatário do Target.
Recupera todos os tokens de resposta configurados, incorporados e personalizados.
Nenhum parâmetro é necessário.
Retorna: matriz JSON de objetos de token de resposta com status name, type e enabled.
Exemplo de prompt: “Listar todos os tokens de resposta”.
Ferramenta: create_target_response_token
Crie um novo token de resposta personalizado para coletar dados adicionais em Target respostas.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
token_name |
string | Sim | Nome do token de resposta |
token_type |
string | Sim | Tipo de token: SCRIPT, ACTIVITY, MBOX, GEO ou CRS |
Retorna: o objeto de token de resposta criado.
Exemplo de prompt: “Criar um token de resposta personalizado chamado ‘campaign_id’ do tipo ACTIVITY.”
Ferramentas de revisão tools-revisions
Ferramenta: get_target_revisions
Obter o log de auditoria para um tipo de recurso.
Recupera alterações feitas em Target recursos com filtragem opcional por autor.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
revision_resource_type |
string | Sim | Tipo de recurso: activity, offer ou audience |
modified_by |
string | Não | Filtrar por usuário que fez alterações |
limit |
número inteiro | Não | Número máximo de revisões retornadas |
offset |
número inteiro | Não | Número de revisões a serem ignoradas para paginação |
Retorna: histórico de revisões com carimbos de data/hora, usuários e descrições de alterações.
Prompt de exemplo: “Mostrar o log de auditoria para alterações de atividades”.
Ferramenta: get_target_entity_revisions
Obtenha todas as revisões de uma entidade específica por ID.
| table 0-row-4 1-row-4 2-row-4 | |||
|---|---|---|---|
| Parâmetro | Tipo | Obrigatório | Descrição |
revision_resource_type |
string | Sim | Tipo de recurso: activity, offer ou audience |
entity_id |
número inteiro | Sim | O identificador exclusivo da entidade |
Retorna: a matriz JSON de todas as revisões da entidade especificada.
Prompt de exemplo: “Mostrar todas as alterações feitas na atividade 12345.”
Ferramentas de modelo tools-templates
Ferramenta: list_target_templates
Liste os recursos e modelos do MCP disponíveis para criar atividades e ofertas.
Nenhum parâmetro é necessário.
Retorna: o objeto JSON está listando os modelos e recursos disponíveis.
Exemplo de prompt: “Quais modelos estão disponíveis para criar atividades?”
Resumo das ferramentas tools-summary
list_target_activities, get_ab_activity, get_xt_activity, get_abt_activity, create_ab_activity, create_xt_activity, update_ab_activity, update_xt_activity, update_abt_activity, update_activity_schedule, update_activity_state, update_activity_name, update_activity_priority, add_activity_variant, update_traffic_split, update_variant_offer, remove_activity_variantlist_target_offers, get_target_offer, create_target_offer, create_target_json_offer, update_target_offerlist_target_audiences, get_target_audience, create_target_audiencelist_target_mboxes, get_target_mbox, list_target_mbox_profile_attributeslist_target_propertiesget_ab_performance_report, get_ab_orders_report, get_xt_performance_report, get_xt_orders_report, get_activity_report_by_name, get_a4t_reportpreview_activitylist_target_response_tokens, create_target_response_tokenget_target_revisions, get_target_entity_revisionslist_target_templates