DocumentazioneWorkfrontAdobe Workfront Fusion

Adobe Target moduli

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

In uno scenario Adobe Workfront Fusion, è possibile automatizzare i flussi di lavoro che utilizzano Adobe Target e collegarlo 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, vedere gli articoli in Moduli: indice articolo.

Requisiti di accesso

Per utilizzare le funzionalità di questo articolo, è necessario disporre dei seguenti diritti di accesso:

Adobe Workfront piano*
Pro o superiore
Adobe Workfront licenza*
Plan, Work
Adobe Workfront Fusion licenza**

Requisiti di licenza correnti: nessun requisito di licenza Workfront Fusion.

Oppure

Requisiti di licenza legacy: Workfront Fusion per automazione e integrazione del lavoro

Prodotto

Fabbisogno prodotto corrente: se si dispone del piano Select o Prime Adobe Workfront, è necessario acquistare Adobe Workfront Fusion e Adobe Workfront per utilizzare le funzionalità descritte in questo articolo. Workfront Fusion è incluso nel piano Ultimate Workfront.

Oppure

Requisiti del prodotto legacy: la tua organizzazione deve acquistare Adobe Workfront Fusion e Adobe Workfront per utilizzare le funzionalità descritte in questo articolo.

Per conoscere il piano, il tipo di licenza o l'accesso disponibili, contattare l'amministratore Workfront.

Per informazioni sulle Adobe Workfront Fusion licenze, vedere Adobe Workfront Fusion licenze.

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

Crea una connessione a 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. Fare clic su Add accanto alla casella Connessione.

  2. Compila i campi seguenti:

    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 Immettere un nome per la connessione.
    Connection type

    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.
    Environment Seleziona se ti connetti a un ambiente di produzione o non di produzione.
    Type Specificare se ci si connette a un account di servizio o a un account personale.
    Client ID Immetti l'ID client Adobe. È disponibile nella sezione Credentials details di Adobe Developer Console.
    Client Secret Immetti il segreto client Adobe. È disponibile nella sezione Credentials details di Adobe Developer Console.
    Technical account ID Immetti l'ID account tecnico Adobe. È disponibile nella sezione Credentials details di Adobe Developer Console.
    Organization ID Immetti l'ID organizzazione Adobe. È disponibile nella sezione Credentials details 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".
    Meta Scopes Immetti ent_marketing_sdk
    Private key

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

    Per estrarre la chiave privata o il certificato:

    1. Fare clic su Extract.

    2. Selezionare il tipo di file da estrarre.

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

    4. Immettere la password per il file.

    5. Fare clic su Save per estrarre il file e tornare alla configurazione della connessione.

  3. Fare clic su Continue per salvare la connessione e tornare al modulo.

Adobe Target moduli e relativi campi

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

Se viene visualizzato il pulsante Mappa sopra un campo o una funzione, è possibile utilizzarlo per impostare variabili e funzioni per tale campo. Per ulteriori informazioni, vedere Mappare le informazioni da un modulo a un altro.

Attiva/Disattiva mappa

Azioni

Create a record

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

Connection
Per istruzioni sulla creazione di una connessione a Adobe Target, vedere Creare una connessione a Adobe Target in questo articolo.
Record type

Selezionare il tipo di record da creare.

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

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

  • Option local ID

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

  • Name

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

  • Offer ID

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

Locations

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

  • Audience IDs

    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.

  • Name

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

Experiences

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

  • Experience local ID

    Inserisci o mappa l'ID dell'esperienza

  • Name

    Inserisci o mappa il nome dell’esperienza

  • Audience IDs

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

  • Visitor Percentage

    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.
Starts at
Immettere o mappare la data e l'ora di inizio dell'attività nel formato YYYY-MM-DD hh:mm:ss.z.
Ends at
Immettere o mappare la data e l'ora di fine dell'attività nel formato YYYY-MM-DD hh:mm:ss.z.
State

Inserisci o mappa lo stato dell’attività.

  • Approved

  • Deactivated

  • Paused

  • Saved

  • Deleted

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

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.

Workspace
Inserisci o mappa l’area di lavoro a cui è associata l’attività
Property IDs
Per ogni proprietà che desideri aggiungere all'attività, fai clic su Add item e seleziona o mappa l'ID della proprietà.
Reporting audiences

Per ogni pubblico di reportistica che desideri aggiungere all'attività, fai clic su Add item e immetti le seguenti informazioni:

  • Reporting Audience local ID

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

  • Audience ID

    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
Name
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.
Workspace
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.
Workspace
Immetti o mappa la data e l’ora in cui l’offerta è stata modificata.

Make a custom API call

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

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

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 x-api-key.

Query String
Immettere la stringa di query richiesta.
Body

Aggiungi il contenuto body per la chiamata API sotto forma di oggetto JSON standard.

Nota:

Quando si utilizzano istruzioni condizionali come if nel JSON, inserire le virgolette al di fuori dell'istruzione condizionale.

Delete a record

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

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

Read a record

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

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

Update a record

Questo modulo di azione aggiorna un record in Target.

Connection
Per istruzioni sulla creazione di una connessione a Adobe Target, vedere Creare una connessione a Adobe Target in questo articolo.
Record type
Selezionare il tipo di record da aggiornare.
Field names

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

Get records

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

Connection
Per istruzioni sulla creazione di una connessione a Adobe Target, vedere Creare una connessione a Adobe Target in questo articolo.
Record type
Selezionare il tipo di record da aggiornare.
Sort by
Per ogni campo in base al quale si desidera eseguire l'ordinamento, fare clic su Add item e selezionare il campo e specificare se i risultati restituiti devono essere in ordine crescente o decrescente.
Starts At

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

Per un elenco dei formati di data e ora supportati, vedere Tipo di coercizione in Adobe Workfront Fusion.

Ends At

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

Per un elenco dei formati di data e ora supportati, vedere Tipo di coercizione in Adobe Workfront Fusion.

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

Connection
Per istruzioni sulla creazione di una connessione a Adobe Target, vedere Creare una connessione a Adobe Target in questo articolo.
Record type
Selezionare il tipo di record da aggiornare.
Sort by
Per ogni campo in base al quale si desidera eseguire l'ordinamento, fare clic su Add item e selezionare il campo e specificare se i risultati restituiti devono essere in ordine crescente o decrescente.
Search criteria
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. Utilizzare questo campo in combinazione con il campo Maximum number of returned results per impaginare le risposte.

Ad esempio, per visualizzare la terza pagina di risposte, quando ogni pagina contiene dieci risposte, impostare Offset su 20 e Maximum number of returned risultati su 10.

Limit

Immettere o mappare il numero massimo di record che il modulo deve restituire durante ogni 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 contiene dieci risposte, impostare Offset su 20 e Maximum number of returned risultati su 10.

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