DocumentaçãoAdobe Workfront Fusion

Adobe Target Módulos

Last update: Thu Jan 23 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

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 os artigos em Criar um cenário: índice do artigo.

Para obter informações sobre módulos, consulte os artigos em Módulos: índice do artigo.

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*
Plan, Work
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 o Adobe Workfront Fusion e o Adobe Workfront para usar a funcionalidade descrita neste artigo. Workfront Fusion está incluído no plano Ultimate Workfront.

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 Add 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
    Connection name Insira um nome para esta conexão.
    Connection type

    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.
    Environment Selecione se você está se conectando a um ambiente de produção ou não produção.
    Type Selecione se você está se conectando a uma conta de serviço ou a uma conta pessoal.
    Client ID Insira sua ID de cliente do Adobe. Isso pode ser encontrado na seção Credentials details de Adobe Developer Console.
    Client Secret Insira seu Segredo do Cliente do Adobe. Isso pode ser encontrado na seção Credentials details de Adobe Developer Console.
    Technical account ID Insira sua ID de conta técnica do Adobe. Isso pode ser encontrado na seção Credentials details de Adobe Developer Console.
    Organization ID Insira sua ID da organização Adobe. Isso pode ser encontrado na seção Credentials details de Adobe Developer Console.
    Tenant

    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".
    Meta Scopes Inserir ent_marketing_sdk
    Private key

    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 Save para extrair o arquivo e retornar à configuração de conexão.

  3. Clique em Continue 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.

Alternância de mapa

Ações

Create a record

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

Connection
Para obter instruções sobre como criar uma conexão com Adobe Target, consulte Criar uma conexão com Adobe Target neste artigo.
Record type

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.

  • Offer JSON

    Continue para Campos de oferta.

  • Offer Content

    Continue para Campos de oferta.

  • Ambiente

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

  • Audience

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

  • AB Activity

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

  • XT Activity

    Prossiga para Campos de atividade XT.

  • AP Activity

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

  • Response Token

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

Campos de atividade de XT
Name
Insira ou mapeie um nome para esta atividade. O nome não pode ter mais de 250 caracteres.
Options

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

  • Option local ID

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

  • Name

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

  • Offer ID

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

Locations

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

  • Audience IDs

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

  • Location local ID

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

  • Name

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

Experiences

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

  • Experience local ID

    Insira ou mapeie a ID da experiência

  • Name

    Insira ou mapeie o nome da experiência

  • Audience IDs

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

  • Visitor Percentage

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

Metrics
Third Party ID
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.
Starts at
Insira ou mapeie a data e a hora para iniciar a atividade no formato YYYY-MM-DD hh:mm:ss.z.
Ends at
Insira ou mapeie a data e a hora para terminar a atividade no formato YYYY-MM-DD hh:mm:ss.z.
State

Insira ou mapeie o estado da atividade.

  • Approved

  • Deactivated

  • Paused

  • Saved

  • Deleted

Priority
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.
Auto-allocate traffic

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
Property IDs
Para cada propriedade que você deseja adicionar à atividade, clique em Add item e selecione ou mapeie a ID da propriedade.
Reporting audiences

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

  • Reporting Audience local ID

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

  • Audience ID

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

  • Metric local ID

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

Campos de oferta
Name
Insira ou mapeie um nome para esta atividade. O nome não pode ter mais de 250 caracteres.
Content
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.

Make a custom API call

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

Connection
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.
Path
Insira um caminho relativo a {baseURL}/
Method
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.
Headers

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.

Query String
Insira a string de consulta da solicitação.
Body

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.

Delete a record

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

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

Read a record

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

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

Update a record

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

Connection
Para obter instruções sobre como criar uma conexão com Adobe Target, consulte Criar uma conexão com Adobe Target neste artigo.
Record type
Selecione o tipo de registro que deseja atualizar.
Field names

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

Get records

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

Connection
Para obter instruções sobre como criar uma conexão com Adobe Target, consulte Criar uma conexão com Adobe Target neste artigo.
Record type
Selecione o tipo de registro que deseja atualizar.
Sort by
Para cada campo pelo qual você deseja classificar, clique em Add item e selecione o campo e se os resultados retornados devem ser crescentes ou decrescentes.
Starts At

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.

Ends At

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.

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

Connection
Para obter instruções sobre como criar uma conexão com Adobe Target, consulte Criar uma conexão com Adobe Target neste artigo.
Record type
Selecione o tipo de registro que deseja atualizar.
Sort by
Para cada campo pelo qual você deseja classificar, clique em Add item e selecione o campo e se os resultados retornados devem ser crescentes ou decrescentes.
Search criteria
Para cada regra que você deseja configurar, selecione o campo, o operador e o valor. Clique em Add AND rule para criar regras adicionais.
Offset

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 Maximum number of returned results para paginar as respostas.

Por exemplo, para ver a terceira página de respostas, quando cada página tem dez respostas, defina Offset como 20 e Maximum number of returned os resultados como 10.

Limit

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 Offset para paginar as respostas.

Por exemplo, para ver a terceira página de respostas, quando cada página tem dez respostas, defina Offset como 20 e Maximum number of returned os resultados como 10.

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3