Adobe Target moduli

In uno scenario Adobe Workfront Fusion, puoi automatizzare i flussi di lavoro che utilizzano Adobe Target, nonché collegarli a più applicazioni e servizi di terze parti. I moduli Adobe Target consentono di creare, leggere, aggiornare o eliminare record, elencare tutti i record di un determinato tipo, cercare i record in base ai criteri specificati o eseguire una chiamata API personalizzata all’API Adobe Target.

Se hai bisogno di istruzioni per la creazione di uno scenario, consulta gli articoli in Creare uno scenario: indice articolo.

Per informazioni sui moduli, consulta gli articoli in Moduli: indice degli articoli.

Requisiti di accesso

Espandi per visualizzare i requisiti di accesso per la funzionalità descritta in questo articolo.
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Pacchetto Adobe Workfront

Qualsiasi pacchetto Workflow di Adobe Workfront, e qualsiasi pacchetto Automation and Integration di Adobe Workfront.

Workfront Ultimate

Pacchetti Workfront Prime e Select, con un ulteriore acquisto di Workfront Fusion.

Licenze Adobe Workfront

Standard

Work o successiva

Licenza di Adobe Workfront Fusion

Basata sulle operazioni: nessun requisito di licenza Workfront Fusion

Basata su connettore (precedente): Workfront Fusion for Work Automation and Integration

Prodotto Se la tua organizzazione dispone di un pacchetto Workfront Select o Prime che non include Workfront Automation and Integration, dovrà acquistare Adobe Workfront Fusion.

Per ulteriori dettagli sulle informazioni contenute in questa tabella, consulta Requisiti di accesso nella documentazione.

Per informazioni sulle licenze di Adobe Workfront Fusion, consulta Licenze di Adobe Workfront Fusion.

Prerequisiti

Prima di poter utilizzare il connettore Adobe Target, è necessario verificare che siano soddisfatti i seguenti prerequisiti:

  • Devi avere un account Adobe Target attivo.

Informazioni API di Adobe Target

Il connettore Adobe Target utilizza quanto segue:

Tag API
v1.7.33

Creare una connessione ad Adobe Target

IMPORTANT
Le connessioni create dopo il 3 giugno 2024 richiedono una connessione server-to-server di Adobe Target.
  • Le connessioni degli account di servizio esistenti continueranno a funzionare fino a gennaio 2025. È necessario sostituire le connessioni dell’account di servizio con le connessioni server-to-server di Adobe Target entro gennaio 2024.
  • Per creare una connessione server-to-server di Adobe Target, è necessario essere uno sviluppatore dell’organizzazione. Il ruolo sviluppatore è impostato in Adobe Admin Console.

Per creare una connessione per i moduli Adobe Target:

  1. In qualsiasi modulo, fai clic su Aggiungi accanto alla casella Connessione.

  2. Compila i seguenti campi:

    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 (Nome della connessione) Specifica un nome per questa connessione.
    Connection type (Tipo di connessione)

    Specificare se si sta creando una connessione dell'account di servizio o una connessione server-to-server di Adobe Target.

    IMPORTANTE: le connessioni create dopo il 3 giugno 2024 richiedono una connessione server-to-server di Adobe Target. Le connessioni degli account di servizio esistenti continueranno a funzionare fino a gennaio 2025. È necessario sostituire le connessioni dell’account di servizio con le connessioni server-to-server di Adobe Target entro gennaio 2024.

    Ambiente Seleziona se ti connetti a un ambiente di produzione o non di produzione.
    Tipo Specifica se ti connetti a un account di servizio o a un account personale.
    ID client Immetti l'ID client Adobe. È disponibile nella sezione Credentials details (Dettagli delle credenziali) di Adobe Developer Console.
    Client Secret (Segreto client) Immetti il segreto client Adobe. È disponibile nella sezione Credentials details (Dettagli delle credenziali) di Adobe Developer Console.
    ID account tecnico Immetti l'ID account tecnico Adobe. È disponibile nella sezione Credentials details (Dettagli delle credenziali) di Adobe Developer Console.
    ID organizzazione Immetti l'ID organizzazione Adobe. È disponibile nella sezione Credentials details (Dettagli delle credenziali) di Adobe Developer Console.
    Tenant

    Per individuare il tenant, accedere a Adobe Experience Cloud, aprire Target e fare clic sulla scheda Target. Utilizza il valore ID tenant indicato nel sottodominio URL.

    Ad esempio, se l'URL al momento dell'accesso a Adobe Target è <https://mycompany.experiencecloud.adobe.com/...>, l'ID tenant sarà "mycompany".

    Ambiti Meta Immetti ent_marketing_sdk
    Chiave privata

    Immettere la chiave privata generata al momento della creazione delle credenziali in Adobe Developer Console.

    Per estrarre la chiave privata o il certificato:

    1. Fai clic su Estrai.

    2. Seleziona il tipo di file da estrarre.

    3. Seleziona il file che contiene la chiave privata o il certificato.

    4. Inserisci la password per il file.

    5. Fai clic su Salva per estrarre il file e tornare alla configurazione della connessione.

  3. Fai clic su Continue (Continua) per salvare la connessione e tornare al modulo.

Moduli Adobe Target e relativi campi

Quando configuri i moduli Adobe Target, in Workfront Fusion vengono visualizzati i campi elencati di seguito. Insieme a questi, potrebbero essere visualizzati altri campi di Adobe Target, a seconda di fattori quali il tuo livello di accesso nell’app o nel servizio. Un titolo in grassetto in un modulo indica un campo obbligatorio.

Se visualizzi il pulsante Map (Mappa) sopra un campo o una funzione, puoi utilizzarlo per impostare variabili e funzioni per tale campo. Per ulteriori informazioni, consulta Mappare le informazioni da un modulo a un altro.

Pulsante di attivazione/disattivazione Mappa

Azioni

Crea un record

Questo modulo di azione crea un’attività AB o XT, un’offerta o un pubblico.

Connessione
Per istruzioni sulla creazione di una connessione a Adobe Target, consulta Creare una connessione a Adobe Target in questo articolo.
Tipo di record

Seleziona il tipo di ambiente da creare.

Campi di attività XT
Nome
Immetti o mappa un nome per questa attività. Il nome non può contenere più di 250 caratteri.
Opzioni

Per ogni opzione che si desidera aggiungere all'attività, fare clic su Aggiungi elemento e compilare i campi seguenti:

  • Option Local ID

    Immetti o mappa una stringa da utilizzare per tenere traccia dell’opzione nelle diverse richieste API.

  • Nome

    Immetti o mappa un nome per l’opzione. Il nome non può contenere più di 250 caratteri.

  • ID offerta

  • Seleziona o mappa l’Offerta associata all’opzione.

Percorsi

Per ogni Mbox che desideri aggiungere all'attività, fai clic su Aggiungi elemento e compila i campi seguenti:

  • ID pubblico

    Per ogni pubblico che desideri aggiungere alla Mbox, fai clic su Add item e seleziona l'ID pubblico.

  • Location Local ID

    Immetti o mappa una stringa da utilizzare per monitorare la posizione nelle diverse richieste API.

  • Nome

    Immetti o mappa un nome per la posizione. Il nome non può contenere più di 250 caratteri.

Esperienze

Un elenco di posizioni sulla pagina in cui viene distribuita l’offerta di contenuti. Una posizione contiene quanto segue:

  • ID Experience Local

    Inserisci o mappa l'ID dell'esperienza

  • Nome

    Inserisci o mappa il nome dell’esperienza

  • Audience IDs

    Per ogni pubblico che desideri visualizzare l'esperienza, fai clic su Aggiungi elemento e immetti l'ID del pubblico.

  • Percentuale Visitatore

    Immetti o mappa la percentuale di visitatori allocata all'esperienza

Metrics
Third Party ID
Immetti o mappa un ID per identificare questa attività. Puoi scegliere questo ID. Questo ID non deve essere lo stesso di un’altra attività e non può superare i 250 caratteri.
inizia da
Immettere o mappare la data e l'ora di inizio dell'attività nel formato YYYY-MM-DD hh:mm:ss.z.
termina alle
Immettere o mappare la data e l'ora di fine dell'attività nel formato YYYY-MM-DD hh:mm:ss.z.
Stato

Inserisci o mappa lo stato dell’attività.

  • approvato

  • Disattivato

  • In Pausa

  • Salvato

  • eliminato

Priorità
Immetti un numero che definisce la priorità dell’attività. I numeri più alti hanno priorità più alta. Questo valore deve essere compreso tra 0 e 999. Il valore predefinito è 5.
Allocazione automatica traffico

Abilita questa opzione per allocare automaticamente il traffico. L’allocazione automatica invia più traffico all’esperienza di maggior successo.

Seleziona o mappa i criteri di valutazione in base ai quali giudicare quale esperienza ha più successo.

Area di lavoro
Inserisci o mappa l’area di lavoro a cui è associata l’attività
ID proprietà
Per ogni proprietà che si desidera aggiungere all'attività, fare clic su Add item e selezionare o mappare l'ID della proprietà.
Tipi di pubblico per reportistica

Per ogni pubblico di reportistica che si desidera aggiungere all'attività, fare clic su Aggiungi elemento e immettere le informazioni seguenti:

  • ID locale pubblico di reporting

    Immetti o mappa una stringa da utilizzare per monitorare il pubblico di reportistica nelle diverse richieste API.

  • ID pubblico

    Inserisci o mappa il segmento da utilizzare nel reporting

  • Metric Local ID

    Inserisci o mappa una stringa da utilizzare per monitorare la metrica nelle richieste API.

Campi offerta
Nome
Immetti o mappa un nome per questa attività. Il nome non può contenere più di 250 caratteri.
Content
Inserisci o mappa il contenuto dell’offerta che verrà mostrato all’utente.
Area di lavoro
Inserisci o mappa l’ID dell’area di lavoro associata all’offerta. Se non specificata, l’offerta viene associata all’area di lavoro predefinita dell’account. Questa funzionalità si applica solo agli account Premium Target.
Area di lavoro
Immetti o mappa la data e l’ora in cui l’offerta è stata modificata.

Effettua chiamata API personalizzata

Questo modulo effettua una chiamata API personalizzata all’API Adobe Target.

Connessione
Per istruzioni sulla creazione di una connessione a Adobe Target, consulta Creare una connessione a Adobe Target in questo articolo.
Target URL di base
Immetti o mappa l'URL di base di Target.
Percorso
Immetti un percorso relativo a {baseURL}/
Metodo
Seleziona il metodo di richiesta HTTP necessario per configurare la chiamata API. Per ulteriori informazioni, consulta Metodi di richiesta HTTP.
Intestazioni

Aggiungi le intestazioni della richiesta sotto forma di oggetto JSON standard.

Ad esempio: {"Content-type":"application/json"}

Workfront Fusion aggiunge automaticamente le intestazioni di autorizzazione e le intestazioni di x-api-key.

Stringa di query
Inserisci la stringa di query della richiesta.
Corpo

Aggiungi il contenuto del corpo della chiamata API sotto forma di oggetto JSON standard.

Nota:

Quando utilizzi istruzioni condizionali come if nel codice JSON, racchiudi l’istruzione condizionale tra virgolette.

Eliminare un record

Questo modulo di azione elimina una singola attività AB, un’attività XT, un’offerta o un pubblico.

Connessione
Per istruzioni sulla creazione di una connessione a Adobe Target, consulta Creare una connessione a Adobe Target in questo articolo.
Tipo di record
Selezionare il tipo di record che si desidera eliminare.
ID record
Immettere o mappare l'ID del record che si desidera eliminare.

Leggi un record

Questo modulo di azione recupera i dati per una singola attività, offerta, pubblico, proprietà o rapporto.

Connessione
Per istruzioni sulla creazione di una connessione a Adobe Target, consulta Creare una connessione a Adobe Target in questo articolo.
Tipo di record
Selezionare il tipo di record che si desidera leggere.
ID record
Immetti o mappa l’ID del record da leggere.

Aggiorna un record

Questo modulo di azione aggiorna un record in Target.

Connessione
Per istruzioni sulla creazione di una connessione a Adobe Target, consulta Creare una connessione a Adobe Target in questo articolo.
Tipo di record
Selezionare il tipo di record da aggiornare.
Nomi campi

Seleziona i campi da aggiornare. I campi vengono visualizzati di seguito.

Per informazioni dettagliate sui campi, consulta la documentazione sulle API di Adobe Target.

Ricerche

Recupera record

Questo modulo di ricerca recupera un elenco di record del tipo selezionato.

Connessione
Per istruzioni sulla creazione di una connessione a Adobe Target, consulta Creare una connessione a Adobe Target in questo articolo.
Tipo di record
Selezionare il tipo di record da aggiornare.
Ordina per
Per ogni campo in base al quale si desidera ordinare, fare clic su Add item e selezionare il campo e specificare se i risultati restituiti devono essere crescenti o decrescenti.
Inizia Da

Immettere la prima data per la quale si desidera recuperare i record.

Per un elenco dei formati di data e ora supportati, consulta Coercizione del tipo.

Termina A

Immettere l'ultima data per la quale si desidera recuperare i record.

Per un elenco dei formati di data e ora supportati, consulta Coercizione del tipo.

Ricerca

Questo modulo di ricerca cerca attività, offerte o tipi di pubblico in base ai criteri specificati.

Connessione
Per istruzioni sulla creazione di una connessione a Adobe Target, consulta Creare una connessione a Adobe Target in questo articolo.
Tipo di record
Selezionare il tipo di record da aggiornare.
Ordina per
Per ogni campo in base al quale si desidera ordinare, fare clic su Add item e selezionare il campo e specificare se i risultati restituiti devono essere crescenti o decrescenti.
Criteri di ricerca
Per ogni regola che desideri impostare, seleziona il campo, l’operatore e il valore. Fare clic su Add AND rule per creare regole aggiuntive.
Offset

Immettere il numero della prima risposta che si desidera venga restituita dal modulo. La prima risposta restituita ha un offset di 0. Utilizza questo campo in combinazione con il campo Numero massimo di risultati restituiti per impaginare le risposte.

Ad esempio, per visualizzare la terza pagina di risposte, quando ogni pagina ha dieci risposte, impostare Offset su 20 e Numero massimo di risultati restituiti su 10.

Limite

Inserisci oppure mappa il numero massimo di record che il modulo potrà restituire durante ciascun ciclo di esecuzione dello scenario. Utilizzare questo campo in combinazione con il campo Offset per impaginare le risposte.

Ad esempio, per visualizzare la terza pagina di risposte, quando ogni pagina ha dieci risposte, impostare Offset su 20 e Numero massimo di risultati restituiti su 10.

recommendation-more-help
workfront-fusion-help-workfront-fusion