DocumentazioneJourney OptimizerGuida di Journey Optimizer

[Disponibilità limitata]{class="badge informative"}

Configurare un canale personalizzato create-custom-channel

Ultimo aggiornamento: 31 luglio 2026

Creato per:

  • Experienced
  • Admin

In questa pagina: scopri come creare un canale personalizzato in Adobe Journey Optimizer utilizzando il Generatore di canali, definendo l’URL dell’endpoint, le intestazioni, l’autenticazione, i criteri di limitazione e la struttura del payload dei messaggi.

style
shade-box

Per poter utilizzare un canale personalizzato in campagne e percorsi, un amministratore deve prima crearlo. Ciò comporta la definizione dell’endpoint, dell’autenticazione, dei criteri di limitazione e della struttura del payload dei messaggi.

La sezione Channel Builder è l’interfaccia centrale per la definizione di nuovi canali personalizzati. Consente di creare e configurare canali personalizzati, ma anche di gestire le credenziali API e delegare i sottodomini.

IMPORTANT
Per accedere a Channel Builder, creare e gestire canali personalizzati, è necessario disporre delle autorizzazioni Visualizza canali personalizzati e Gestisci canali personalizzati concesse. Scopri come gestire le autorizzazioni in questa sezione.

Accedere e gestire i canali personalizzati access-channel-builder

Per accedere a Channel Builder e gestire i tuoi canali personalizzati, segui la procedura riportata di seguito.

  1. Vai a Amministrazione > Canali nella barra di navigazione a sinistra.

  2. Seleziona Canali personalizzati nella sezione Generatore di canali.

    Inventario canali personalizzato {width="100%"}

  3. L’inventario elenca tutti i canali personalizzati nella sandbox, compreso il loro stato corrente e il tipo di autenticazione utilizzato per connettersi all’endpoint esterno.

  4. Puoi filtrare i canali personalizzati in base allo stato (Bozza, Attivo o Archiviato), chi li ha creati e cercare per nome.

  5. Per modificare un canale, fai clic sul nome nell’inventario, apporta le modifiche e salva. Per i canali attivi, puoi modificare solo alcuni campi - ulteriori informazioni.

    note caution
    CAUTION
    La modifica delle impostazioni di limitazione o di nuovo tentativo su un canale attivo ha effetto immediato per tutte le esecuzioni in volo e future.

  6. Per archiviare un canale, aprirlo dall’inventario e fare clic su Archivia.

    Quando si archivia un canale attivo, questo viene rimosso da tutti i menu a discesa di selezione: selettore delle azioni della campagna, palette delle azioni di percorso, configurazioni del canale e modelli di contenuto. I percorsi e le campagne esistenti che utilizzano già il canale continuano a funzionare normalmente.

Creare un canale personalizzato create-channel

Per creare un nuovo canale personalizzato, segui la procedura riportata di seguito.

  1. Fai clic sul pulsante Crea canale personalizzato per aprire il modulo di creazione del canale. Inizia definendo le impostazioni generali per il canale personalizzato.

    Impostazioni generali {width="70%"}

  2. Nella sezione Proprietà, immetti un Nome per il tuo canale personalizzato. Questo nome verrà visualizzato nell’area di lavoro percorsi e nel selettore di azioni della campagna.

    note
    NOTE
    Il nome deve essere univoco, iniziare con una lettera (A-Z), includere solo caratteri alfanumerici o caratteri speciali ( _, ., -) e deve essere maggiore di 1 carattere.

  3. È possibile selezionare un’icona dalla libreria di icone predefinita oppure selezionare un file SVG dal computer.

    note
    NOTE
    Il file non deve superare i 150 KB.

    Questa icona verrà visualizzata accanto al nome del canale nell’area di lavoro del percorso. Se non viene caricata alcuna icona, viene utilizzata quella predefinita.

  4. Immettere una Descrizione facoltativa.

Impostare la configurazione dell’endpoint endpoint-configuration

Devi configurare l’endpoint, che è l’URL HTTP del sistema di messaggistica esterno. Journey Optimizer invia una richiesta POST a questo endpoint con il payload personalizzato quando un profilo è idoneo in una campagna o in un percorso.

Configurazione endpoint {width="80%"}

  1. Nella sezione Configurazione endpoint, immetti l’host URL del sistema di messaggistica esterno. Ad esempio: https://api.my-messaging-provider.com/v1/messages.

    note important
    IMPORTANT
    Il sistema di messaggistica esterno deve esporre un endpoint HTTPS che Journey Optimizer può chiamare tramite HTTP POST. L’endpoint deve:
    • Accetta il formato di payload definito dal canale (JSON).
    • Supporta uno dei metodi di autenticazione disponibili nel Channel Builder. Ulteriori informazioni
    • Restituisce una risposta HTTP 2xx per confermare la ricezione della richiesta.

  2. Aggiungi Intestazioni in base alle esigenze. Le intestazioni sono coppie chiave-valore trasmesse a livello di richiesta HTTP. Vengono inviate insieme a ogni richiesta all’endpoint e vengono in genere utilizzate per token di autenticazione, specifiche del tipo di contenuto o altri metadati richiesti dal sistema esterno.

    Configurazione intestazioni {width="60%"}

    Per ogni intestazione, puoi definire se il relativo valore è:

    • Costante - Valore statico impostato una volta e incluso in ogni richiesta. Ad esempio, è possibile definire il parametro Content-Type con il valore application/json o il parametro Charset con il valore UTF-8.
    • Variabile - Se viene immesso un valore predefinito, questo viene utilizzato a meno che non venga sostituito nella configurazione del canale. Ad esempio, puoi definire una variabile per l’ID utente che viene risolta in fase di esecuzione. Ulteriori informazioni

  3. Se necessario, aggiungere Parametri query utilizzando lo stesso pattern costante/variabile. I parametri di query vengono aggiunti all’URL dell’endpoint al momento della consegna. I parametri costanti vengono sempre aggiunti con lo stesso valore; i parametri variabili vengono risolti al momento dell’invio, ad esempio per trasmettere un identificatore utente dal profilo.

    Parametri query {width="60%"}

  4. Nella sezione Configurazione dei criteri, definire il modo in cui Journey Optimizer gestisce la velocità effettiva delle richieste e gli errori. Questo è importante per garantire che il sistema esterno possa gestire il volume di richieste ed evitare di sovraccaricarlo.

    Configurazione criterio {width="70%"}

    • Abilita limitazione - Disabilitata per impostazione predefinita. Imposta il numero massimo di richieste al secondo (impostazione predefinita: 5.000c). Una volta raggiunto il limite, le richieste vengono messe in coda e inviate il prima possibile.
    • Abilita nuovo tentativo - Abilitato per impostazione predefinita. Impostare il numero massimo di tentativi (impostazione predefinita: 3, intervallo configurabile: 0-10) per le richieste non riuscite. Questo aiuta a evitare di sopraffare l’endpoint durante errori transitori.
    • Timeout - Impostazione predefinita: 5.000 millisecondi. Imposta il tempo massimo di attesa di una risposta dall’endpoint prima di considerare la richiesta non riuscita.

Impostazioni di autenticazione authentication-settings

Selezionare il tipo di autenticazione da utilizzare per questo canale. Le opzioni disponibili dipendono dai metodi di autenticazione supportati dal sistema di messaggistica esterno.

Tipo di autenticazione {width="85%"}

Fornisci i dettagli di autenticazione richiesti dall’endpoint.

  • Nessuno - La richiesta viene inviata senza credenziali.
  • Chiave API - Fornisci il nome, il valore e la posizione della chiave (parametro o intestazione di query).
  • Autenticazione di base - Specificare nome utente e password.
  • OAuth 2.0 - Configura il payload per l’autenticazione OAuth 2.0.

Se il tipo di autenticazione è diverso da None, Journey Optimizer genera automaticamente un set iniziale di credenziali API per questo canale quando viene attivato. Puoi modificare queste credenziali e crearne di nuove nell’inventario delle credenziali API. Ulteriori informazioni

Tuttavia, i dettagli di autenticazione sono necessari qui per testare la connessione all’endpoint prima di attivare il canale. È disponibile un pulsante Verifica connessione per convalidare la configurazione dell’autenticazione. Ulteriori informazioni

Configurazione payload payload-configuration

Il payload viene inviato all’endpoint quando un profilo si qualifica in una campagna o in un percorso.

Nella configurazione del payload, definisci la struttura del payload del messaggio e quali campi gli addetti al marketing possono creare e personalizzare.

  1. Fare clic su Definisci payload e scegliere come definire il payload:

    • Incolla payload JSON di esempio. Incolla un oggetto JSON rappresentativo e Journey Optimizer ne deduce automaticamente uno schema. Ad esempio:

      code language-json 
      {
  "channelId": "KakaoTalk08",
  "title": "Flash Sale: 48 Hours Only",
  "body": "New arrivals just dropped. Shop now before they're gone!",
  "image": "https://demo-system-next.s3.amazonaws.com/assets/luma/luma-flash-sale-banner.jpg"
}

    • Importa schema JSON (disponibile a breve). Carica un file di schema JSON completo.

      note availability
      AVAILABILITY
      Questa funzionalità non è ancora disponibile. Sarà aggiunto in una versione futura.

  2. Dopo la generazione dello schema, Journey Optimizer visualizza tutti i campi rilevati in una visualizzazione modulo.

    Configurazione payload {width="80%"}

  3. Per ogni campo, configura le seguenti impostazioni:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Impostazione Descrizione
    Valore predefinito Facoltativo. Utilizzato se non viene fornito un valore personalizzato al momento dell’authoring.
    Tipo Di sola lettura, derivato dal payload. Tipi supportati: string, integer, decimal, boolean, dateTime, dateTimeOnly, dateOnly, listObject, listString, listInteger, listDecimal, listBoolean, listDateTime, listDateTimeOnly, listDateOnly.
    Obbligatorio Se abilitato, il campo deve contenere un valore quando il canale viene utilizzato in una campagna o in un percorso. I campi obbligatori mancanti causano un errore di convalida che impedisce l’attivazione.
    Configurazione canale Se attivato, il campo viene visualizzato nella configurazione del canale, consentendo agli amministratori di impostare valori diversi per configurazione (ad esempio, un ID mittente diverso per marchio o area geografica). Scopri come

    I campi nidificati sono rappresentati utilizzando la notazione del punto (ad esempio, image.id).

Test e attivazione test-activate

Mentre il canale è nello stato Bozza, utilizza il pulsante Verifica connessione nella parte superiore dello schermo per inviare una richiesta di test all’endpoint e convalidare la connessione end-to-end.

Verifica pulsante connessione {width="70%"}

Controlla i registri del sistema esterno per verificare che la richiesta sia stata ricevuta con l’autenticazione e il payload previsti.

Una volta che il test è riuscito, puoi salvare o attivare il canale.

  • Fai clic su Salva come bozza per salvare l’avanzamento senza rendere disponibile il canale.
  • Fai clic su Attiva per rendere il canale disponibile per l’utilizzo in configurazioni di canale, campagne e percorsi.
IMPORTANT
Dopo l’attivazione di un canale, rimangono modificabili solo i seguenti campi: nome, descrizione, icona, limitazione e configurazione di un nuovo tentativo. L'URL dell'endpoint, le intestazioni, i parametri di query, l'autenticazione e la struttura del payload sono bloccati.

Passaggi successivi next-steps

È stato creato il tuo canale personalizzato. Completa la configurazione seguendo i passaggi rimanenti:

recommendation-more-help
journey-optimizer-help