Adobe Target Módulos

Em um cenário Adobe Workfront Fusion, você pode automatizar fluxos de trabalho que usam Adobe Target, bem como conectá-los a vários aplicativos e serviços de terceiros. Os módulos do Adobe Target permitem criar, ler, atualizar ou excluir registros, listar todos os registros de um determinado tipo, pesquisar registros com base nos critérios especificados ou executar uma chamada de API personalizada para a API do Adobe Target.

Se você precisar de instruções sobre como criar um cenário, consulte Criar um cenário.

Para obter informações sobre módulos, consulte Módulos em Adobe Workfront Fusion.

Requisitos de acesso

Você deve ter o seguinte acesso para usar a funcionalidade neste artigo:

Adobe Workfront plano*
Pro ou superior
Adobe Workfront licença*
Plano, Trabalho
Adobe Workfront Fusion licença**

Requisito de licença atual: nenhum requisito de licença Workfront Fusion.

Ou

Requisito de licença herdada: Workfront Fusion para Automação e Integração do Trabalho

Produto

Requisito atual do produto: se você tiver o plano Select ou Prime Adobe Workfront, sua organização deve comprar Adobe Workfront Fusion e Adobe Workfront para usar a funcionalidade descrita neste artigo. Workfront Fusion está incluído no plano Workfront do Ultimate.

Ou

Requisito de produto herdado: sua organização deve comprar o Adobe Workfront Fusion e o Adobe Workfront para usar a funcionalidade descrita neste artigo.

Para saber que plano, tipo de licença ou acesso você tem, contate o administrador do Workfront.

Para obter informações sobre Adobe Workfront Fusion licenças, consulte Adobe Workfront Fusion licenças.

Pré-requisitos

Antes de usar o conector Adobe Target, verifique se os seguintes pré-requisitos foram atendidos:

  • Você deve ter uma conta Adobe Target ativa.

Informações da API do Adobe Target

O conector do Adobe Target usa o seguinte:

Tag da API
v1.7.33

Criar uma conexão com Adobe Target

IMPORTANT
As conexões criadas após 3 de junho de 2024 exigem uma conexão de servidor para servidor do Adobe Target.
  • As conexões da Conta de serviço existentes continuarão funcionando até janeiro de 2025. Você deve substituir suas conexões de Conta de serviço pelas conexões servidor a servidor do Adobe Target até janeiro de 2024.
  • Você deve ser um desenvolvedor para que sua organização crie uma conexão de servidor para servidor do Adobe Target. A função de desenvolvedor é definida na Adobe Admin Console.

Para criar uma conexão para seus módulos do Adobe Target:

  1. Clique em Adicionar ao lado da caixa Conexão.

  2. Preencha os seguintes campos:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 layout-auto html-authored no-header
    Nome da Conexão Insira um nome para esta conexão.
    Tipo de conexão

    Selecione se você está criando uma conexão de Conta de Serviço ou uma conexão de Servidor para Servidor do Adobe Target.

    IMPORTANTE: as conexões criadas após 3 de junho de 2024 exigem uma conexão de servidor para servidor do Adobe Target. As conexões da Conta de serviço existentes continuarão funcionando até janeiro de 2025. Você deve substituir suas conexões de Conta de serviço pelas conexões servidor a servidor do Adobe Target até janeiro de 2024.

    Ambiente Selecione se você está se conectando a um ambiente de produção ou não produção.
    Tipo Selecione se você está se conectando a uma conta de serviço ou a uma conta pessoal.
    ID do Cliente Insira sua ID de cliente do Adobe. Isso pode ser encontrado na seção Credentials details do Adobe Developer Console.
    Segredo do Cliente Insira seu Segredo do Cliente do Adobe. Isso pode ser encontrado na seção Credentials details do Adobe Developer Console.
    ID da conta técnica Insira sua ID de conta técnica do Adobe. Isso pode ser encontrado na seção Credentials details do Adobe Developer Console.
    ID da Organização Insira sua ID da organização Adobe. Isso pode ser encontrado na seção Credentials details do Adobe Developer Console.
    Locatário

    Para localizar seu Locatário, faça logon no Adobe Experience Cloud, abra o Target e clique no cartão Target. Use o valor da ID do locatário conforme observado no subdomínio do URL.

    Por exemplo, se a URL ao fazer logon no Adobe Target for <https://mycompany.experiencecloud.adobe.com/...>, sua ID de Locatário será "mycompany".

    Metaescopos Inserir ent_marketing_sdk
    Chave privada

    Insira a chave privada gerada quando suas credenciais foram criadas no Adobe Developer Console.

    Para extrair sua chave privada ou certificado:

    1. Clique em Extract.

    2. Selecione o tipo de arquivo que você está extraindo.

    3. Selecione o arquivo que contém a chave privada ou o certificado.

    4. Digite a senha do arquivo.

    5. Clique em Salvar para extrair o arquivo e retornar à configuração de conexão.

  3. Clique em Continuar para salvar a conexão e retornar ao módulo.

Adobe Target módulos e seus campos

Ao configurar módulos do Adobe Target, o Workfront Fusion exibe os campos listados abaixo. Junto com esses, campos Adobe Target adicionais podem ser exibidos, dependendo de fatores como seu nível de acesso no aplicativo ou serviço. Um título em negrito em um módulo indica um campo obrigatório.

Se você vir o botão de mapa acima de um campo ou função, poderá usá-lo para definir variáveis e funções para esse campo. Para obter mais informações, consulte Mapear informações de um módulo para outro em Adobe Workfront Fusion.

Ações

Criar um registro

Esse módulo de ação cria uma atividade AB ou XT, uma oferta ou um público-alvo.

Conexão
Para obter instruções sobre como criar uma conexão com Adobe Target, consulte Criar uma conexão com Adobe Target neste artigo.
Tipo de registro

Selecione o tipo de registro que deseja criar.

  • Propriedade

    Para obter detalhes sobre campos, consulte Criar uma propriedade na documentação da API do Adobe Target.

  • Recomendação da oferta

    Para obter detalhes sobre campos, consulte Criar uma nova oferta recs na documentação da API do Adobe Target.

  • Oferta JSON

    Continue para Campos de oferta.

  • Conteúdo da Oferta

    Continue para Campos de oferta.

  • Ambiente

    Para obter detalhes sobre campos, consulte Criar ambiente na documentação da API do Adobe Target.

  • Público-alvo

    Para obter detalhes sobre campos, consulte Criar público-alvo na documentação da API do Adobe Target.

  • Atividade AB

    Para obter detalhes sobre campos, consulte Criar atividade AB na documentação da API do Adobe Target.

  • Atividade XT

    Prossiga para Campos de atividade XT.

  • Atividade AP

    Para obter detalhes sobre campos, consulte Criar atividade AP na documentação da API do Adobe Target.

  • Token de Resposta

    Para obter detalhes sobre campos, consulte Criar token de resposta na documentação da API do Adobe Target.

Campos de atividade de XT
Nome
Insira ou mapeie um nome para esta atividade. O nome não pode ter mais de 250 caracteres.
Opções

Para cada opção que você deseja adicionar à atividade, clique em Adicionar item e preencha os seguintes campos:

  • ID de Opção local

    Insira ou mapeie uma string a ser usada para rastrear a opção nas solicitações da API.

  • Nome

    Insira ou mapeie um nome para a opção. O nome não deve ter mais de 250 caracteres.

  • ID da oferta

  • Selecione ou mapeie a Oferta associada à opção.

Locais

Para cada Mbox que você deseja adicionar à atividade, clique em Adicionar item e preencha os seguintes campos:

  • IDs de público-alvo

    Para cada público-alvo que você deseja adicionar à Mbox, clique em Adicionar item e selecione a ID de público-alvo.

  • ID Local do Local

    Insira ou mapeie uma string a ser usada para rastrear o local nas solicitações da API.

  • Nome

    Insira ou mapeie um nome para o Local. O nome não deve ter mais de 250 caracteres.

Experiências

Uma lista de locais na página onde a oferta de conteúdo é apresentada. Um local contém o seguinte:

  • ID de Experiência local

    Insira ou mapeie a ID da experiência

  • Nome

    Insira ou mapeie o nome da experiência

  • Audience IDs

    Para cada público-alvo que você deseja ver a experiência, clique em Adicionar item e insira a ID de público-alvo.

  • Porcentagem de Visitantes

    Insira ou mapeie a porcentagem de visitantes alocada para a experiência

Métricas
ID de Terceiros
Insira ou mapeie uma ID para identificar esta atividade. Você pode escolher essa ID. Essa ID não deve ser igual a outra atividade e não pode ter mais de 250 caracteres.
Inicia às
Insira ou mapeie a data e a hora para iniciar a atividade no formato YYYY-MM-DD hh:mm:ss.z.
Termina em
Insira ou mapeie a data e a hora para terminar a atividade no formato YYYY-MM-DD hh:mm:ss.z.
Estado

Insira ou mapeie o estado da atividade.

  • Aprovado

  • Desativado

  • Pausado

  • Salvo

  • Excluído

Prioridade
Insira um número que defina a prioridade da atividade. Números mais altos têm prioridade mais alta. Esse valor deve estar entre 0 e 999. O valor padrão é 5.
Alocar tráfego automaticamente

Ative essa opção para alocar o tráfego automaticamente. A alocação automática envia mais tráfego para a experiência mais bem-sucedida.

Selecione ou mapeie os critérios de avaliação pelos quais julgar qual experiência é mais bem-sucedida.

Workspace
Insira ou mapeie o espaço de trabalho ao qual a atividade está associada
IDs de Propriedades
Para cada propriedade que você deseja adicionar à atividade, clique em Adicionar item e selecione ou mapeie a ID da propriedade.
Relatórios de públicos-alvo

Para cada público-alvo de relatório que você deseja adicionar à atividade, clique em Adicionar item e insira as seguintes informações:

  • ID de Público-alvo local do Relatório

    Insira ou mapeie uma cadeia de caracteres a ser usada para rastrear o Público-alvo do relatório nas solicitações da API.

  • ID de Público

    Inserir ou mapear o segmento a ser usado no relatório

  • ID de Métrica local

    Insira ou mapeie uma string a ser usada para rastrear a métrica nas solicitações da API.

Campos de oferta
Nome
Insira ou mapeie um nome para esta atividade. O nome não pode ter mais de 250 caracteres.
Conteúdo
Insira ou mapeie o conteúdo da oferta que será exibido para o usuário.
Workspace
Insira ou mapeie a ID do espaço de trabalho associado à oferta. Se deixado em branco, a oferta é associada ao espaço de trabalho padrão da conta. Essa funcionalidade aplica-se somente a contas do Target Premium.
Workspace
Insira ou mapeie a data e a hora em que esta oferta foi modificada.

Fazer uma chamada de API personalizada

Este módulo faz uma chamada de API personalizada para a API Adobe Target.

Conexão
Para obter instruções sobre como criar uma conexão com Adobe Target, consulte Criar uma conexão com Adobe Target neste artigo.
Target URL Base
Insira ou mapeie sua URL de base Target.
Caminho
Insira um caminho relativo a {baseURL}/
Método
Selecione o método de solicitação HTTP necessário para configurar a chamada de API. Para obter mais informações, consulte Métodos de solicitação HTTP em Adobe Workfront Fusion.
Cabeçalhos

Adicione os cabeçalhos da solicitação no formulário de um objeto JSON padrão.

Por exemplo, {"Content-type":"application/json"}

Workfront Fusion O adiciona cabeçalhos de autorização e cabeçalhos x-api-key automaticamente.

Cadeia de Consulta
Insira a string de consulta da solicitação.
Corpo

Adicione o conteúdo do corpo para a chamada à API na forma de um objeto JSON padrão.

Nota:

Ao usar instruções condicionais como if em seu JSON, coloque as aspas fora da instrução condicional.

Excluir um registro

Esse módulo de ação exclui uma única atividade AB, atividade XT, Oferta ou Público-alvo.

Conexão
Para obter instruções sobre como criar uma conexão com Adobe Target, consulte Criar uma conexão com Adobe Target neste artigo.
Tipo de registro
Selecione o tipo de registro que deseja excluir.
ID de Registro
Informe ou mapeie a ID do registro que deseja deletar.

Ler um registro

Este módulo de ação recupera dados para uma única Atividade, Oferta, Público-alvo, Propriedade ou Relatório.

Conexão
Para obter instruções sobre como criar uma conexão com Adobe Target, consulte Criar uma conexão com Adobe Target neste artigo.
Tipo de registro
Selecione o tipo de registro que deseja ler.
ID de Registro
Insira ou mapeie a ID do registro que deseja ler.

Atualizar um registro

Este módulo de ação atualiza um registro no Target.

Conexão
Para obter instruções sobre como criar uma conexão com Adobe Target, consulte Criar uma conexão com Adobe Target neste artigo.
Tipo de registro
Selecione o tipo de registro que deseja atualizar.
Nomes de campos

Selecione os campos que deseja atualizar. Os campos são exibidos abaixo de.

Para obter detalhes sobre campos, consulte a documentação da API do Adobe Target.

Pesquisas

Obter registros

Este módulo de pesquisa recupera uma lista de registros do tipo selecionado.

Conexão
Para obter instruções sobre como criar uma conexão com Adobe Target, consulte Criar uma conexão com Adobe Target neste artigo.
Tipo de registro
Selecione o tipo de registro que deseja atualizar.
Classificar por
Para cada campo pelo qual você deseja classificar, clique em Adicionar item e selecione o campo e se os resultados retornados devem ser crescentes ou decrescentes.
Inicia Em

Insira a data mais antiga para a qual você deseja recuperar registros.

Para obter uma lista de formatos de data e hora com suporte, consulte Coerção de tipo em Adobe Workfront Fusion.

Termina Em

Insira a última data para a qual deseja recuperar registros.

Para obter uma lista de formatos de data e hora com suporte, consulte Coerção de tipo em Adobe Workfront Fusion.

Pesquisa

Este módulo de pesquisa pesquisa por Atividades, Ofertas ou Públicos-alvo com base nos critérios especificados.

Conexão
Para obter instruções sobre como criar uma conexão com Adobe Target, consulte Criar uma conexão com Adobe Target neste artigo.
Tipo de registro
Selecione o tipo de registro que deseja atualizar.
Classificar por
Para cada campo pelo qual você deseja classificar, clique em Adicionar item e selecione o campo e se os resultados retornados devem ser crescentes ou decrescentes.
Pesquisar critérios
Para cada regra que você deseja configurar, selecione o campo, o operador e o valor. Clique em Adicionar regra AND para criar regras adicionais.
Deslocamento

Insira o número da primeira resposta que você deseja que o módulo retorne. A primeira resposta retornada tem um deslocamento de 0. Use este campo em combinação com o campo Número máximo de resultados retornados para paginar as respostas.

Por exemplo, para ver a terceira página de respostas, quando cada página tiver dez respostas, defina Deslocamento como 20 e Número máximo de resultados retornados como 10.

Limite

Insira ou mapeie o número máximo de registros que deseja que o módulo retorne durante cada ciclo de execução de cenário. Use este campo em combinação com o campo Deslocamento para paginar as respostas.

Por exemplo, para ver a terceira página de respostas, quando cada página tiver dez respostas, defina Deslocamento como 20 e Número máximo de resultados retornados como 10.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43