Adobe Target moduli

Ultimo aggiornamento: 4 marzo 2025
  • 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 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 si dispone del piano Select o Prime Adobe Workfront, l'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 APIv1.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. In qualsiasi modulo, fai clic su Aggiungi accanto alla casella Connessione.

  2. Compila i campi seguenti:

    Nome connessioneImmettere 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.

    EnvironmentSeleziona se ti connetti a un ambiente di produzione o non di produzione.
    TypeSpecificare se ci si connette a un account di servizio o a un account personale.
    ID clientImmetti l'ID client Adobe. È disponibile nella sezione Credentials details di Adobe Developer Console.
    Segreto clientImmetti il segreto client Adobe. È disponibile nella sezione Credentials details di Adobe Developer Console.
    ID account tecnicoImmetti l'ID account tecnico Adobe. È disponibile nella sezione Credentials details di Adobe Developer Console.
    ID organizzazioneImmetti 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 AmbitiImmetti 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 a un altro.

Attiva/Disattiva mappa

Azioni

Crea un record

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

ConnectionPer 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
NameImmetti 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 IDImmetti 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 daImmettere o mappare la data e l'ora di inizio dell'attività nel formato YYYY-MM-DD hh:mm:ss.z.
termina alleImmettere 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.

WorkspaceInserisci 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
NameImmetti o mappa un nome per questa attività. Il nome non può contenere più di 250 caratteri.
ContentInserisci o mappa il contenuto dell’offerta che verrà mostrato all’utente.
WorkspaceInserisci 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.
WorkspaceImmetti 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.

ConnectionPer istruzioni sulla creazione di una connessione a Adobe Target, vedere Creare una connessione a Adobe Target in questo articolo.
Target URL di baseImmetti o mappa l'URL di base di Target.
PathImmettere un percorso relativo a {baseURL}/
MethodSeleziona 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.

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