DocumentazioneWorkfrontGuida di Workfront

Adobe Target moduli

Last update: Thu Nov 21 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Utente

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 Creare uno scenario.

Per informazioni sui moduli, vedere Moduli in Adobe Workfront Fusion.

Requisiti di accesso

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

Adobe Workfront piano*
Pro o versione successiva
Adobe Workfront licenza*
Plan, Work
Adobe Workfront Fusion licenza**

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

Oppure

Requisito licenza legacy: Workfront Fusion per automazione e integrazione del lavoro

Prodotto

Fabbisogno prodotto corrente: se disponi del piano Select o Prime Adobe Workfront, la tua organizzazione deve 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. Fai clic su Aggiungi 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
    Nome connessione Immettere un nome per la connessione.
    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.
    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.
    ID client Immetti l'ID client Adobe. È disponibile nella sezione Credentials details di Adobe Developer Console.
    Segreto client Immetti il segreto client Adobe. È disponibile nella sezione Credentials details di Adobe Developer Console.
    ID account tecnico Immetti l'ID account tecnico Adobe. È disponibile nella sezione Credentials details di Adobe Developer Console.
    ID organizzazione 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 Ambiti 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. 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 Salva per estrarre il file e tornare alla configurazione della connessione.

  3. Fai clic su Continua 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 all'altro in Adobe Workfront Fusion.

Azioni

Crea un 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.
Tipo di record

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 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.
State

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.

Workspace
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
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.

Effettuare una chiamata API personalizzata

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 in Adobe Workfront Fusion.
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.

Stringa Di Query
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.

Eliminare un 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.
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.

Connection
Per istruzioni sulla creazione di una connessione a Adobe Target, vedere 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.

Connection
Per istruzioni sulla creazione di una connessione a Adobe Target, vedere 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.

Connection
Per istruzioni sulla creazione di una connessione a Adobe Target, vedere 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, vedere Tipo di coercizione in Adobe Workfront Fusion.

Termina A

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.

Ricerca

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.
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 di
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.

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 ha dieci risposte, impostare Offset su 20 e Numero massimo di risultati restituiti su 10.

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