Domande frequenti sulle integrazioni vendor-integration-faq

Cosa fanno le integrazioni in Journey Optimizer?

Collega origini dati esterne a Journey Optimizer per consentire di richiamare contenuti e dati da sistemi di terze parti nelle campagne e nei percorsi e personalizzare i messaggi utilizzando tali dati.

➡️ Ulteriori informazioni sulla panoramica delle integrazioni

Chi configura le integrazioni e chi le utilizza nel contenuto?

Gli amministratori creano e attivano la configurazione tecnica (Configurazioni > Integrazioni > Gestione > Crea integrazione). Gli addetti al marketing utilizzano Aggiungi personalizzazione nei componenti Testo o HTML, aprono Integrazioni, scelgono un’integrazione attiva e mappano gli attributi.

➡️ Ulteriori informazioni sui flussi di lavoro dell’amministratore e dell’addetto marketing

Dove posso creare o gestire le integrazioni nell’interfaccia utente in qualità di amministratore?

Vai alla sezione Configurations nel menu a sinistra, apri Manage dalla scheda Integrazioni, quindi seleziona Create Integration.

➡️ Ulteriori informazioni sulla creazione di un’integrazione

Quali sono i casi d’uso comuni per le integrazioni?

Alcuni esempi includono punti premio da sistemi di fidelizzazione, informazioni sui prezzi dei prodotti, consigli da motori di consigli e aggiornamenti logistici come lo stato di consegna.

➡️ Ulteriori informazioni sui dati di esempio provenienti da sistemi di terze parti

➡️ Ulteriori informazioni sugli esempi di integrazione dei fornitori

Come si configura un’integrazione ad alto livello come amministratore?

Fornisci un nome e una descrizione, un URL dell’endpoint API (facoltativamente con variabili di percorso), valori del modello di percorso, GET o POST, intestazioni e parametri di query facoltativi, un metodo di autenticazione, impostazioni dei criteri (come timeout e cache facoltativa o nuovo tentativo), una risposta JSON campione ai campi mappa, quindi esegui Send test connection e Activate se valido.

➡️ Ulteriori informazioni sulla configurazione dell’integrazione

Quali tipi di autenticazione sono supportati?

Sono disponibili i seguenti tipi di autenticazione: Nessuna autenticazione, Chiave API, Autenticazione di base e OAuth 2.0 (con configurazione del payload per OAuth, se applicabile).

➡️ Ulteriori informazioni sui tipi di autenticazione

Per che cosa viene utilizzato il passaggio di payload di risposta?

Incolla una risposta JSON campione in modo che il sistema possa rilevare i tipi di dati e puoi scegliere quali campi sono esposti per la personalizzazione nei messaggi. Puoi limitare quali campi sono disponibili per gli esperti di marketing durante la creazione.

➡️ Ulteriori informazioni sulla mappatura del payload di risposta

In che modo gli esperti di marketing aggiungono un’integrazione a un messaggio?

Nel contenuto della campagna o del percorso, utilizza Aggiungi personalizzazione su un componente Testo o HTML, vai a Integrazioni, seleziona un’integrazione e salva. Con la modalità Pillole nell’editor di personalizzazione, puoi mappare i valori alle variabili nella configurazione (ad esempio parametri di intestazione o query o variabili di percorso nell’URL).

➡️ Ulteriori informazioni sulla personalizzazione con integrazioni

Posso utilizzare le integrazioni in percorsi e campagne?

Sì. La funzione è disponibile sia per i percorsi che per le campagne per canali in uscita (ad esempio e-mail, SMS e push), entro i limiti di prodotto correnti.

➡️ Ulteriori informazioni su percorsi e campagne

È possibile utilizzare le integrazioni in frammenti riutilizzabili?

La funzione Integrazioni è supportata in Frammenti.

➡️ Ulteriori informazioni sui frammenti

Quali canali supportano le integrazioni?

Sono supportati canali in uscita (ad esempio e-mail, SMS e push).

➡️ Ulteriori informazioni sui canali supportati

Quali formati di risposta API sono supportati?

Per le risposte alle chiamate API, JSON e HTML sono supportati per la mappatura dei campi. L’output di immagine binaria non elaborato e i formati che non sono JSON non sono disponibili per questo flusso di lavoro.

➡️ Ulteriori informazioni su JSON e formati di risposta

A quali pattern API posso collegarmi?

Sono supportate le API di recupero che eseguono il targeting di contenuti specifici. Le API di elenco (elenco esteso o pattern di impaginazione) non sono supportate per questo modello di integrazione.

➡️ Ulteriori informazioni sul recupero e sull’elenco delle API

Di quali autorizzazioni ho bisogno per configurare le integrazioni?

Per iniziare a utilizzare le integrazioni, è necessario concedere agli utenti le autorizzazioni Gestisci configurazione integrazione AJO e Visualizza configurazione integrazione AJO.

➡️ Ulteriori informazioni sulle autorizzazioni di integrazione

Le integrazioni sostituiscono i connettori Adobe Journey Optimizer con Origini Experience Platform?

No. Le integrazioni sono per i campi di personalizzazione nel contenuto dei messaggi che guidi dalle API. Origini e altre funzionalità di acquisizione dati hanno scopi diversi (ad esempio l’acquisizione di dati batch e l’arricchimento di profili). Utilizza ciascuna funzionalità per l’ambito previsto.

➡️ Ulteriori informazioni sulle integrazioni per

➡️ Ulteriori informazioni sulle origini di Experience Platform

Perché la connessione di prova non riesce o rimane non valida?

Verifica l’URL dell’endpoint, il metodo HTTP, i modelli di percorso, le intestazioni e i parametri di query, l’autenticazione e il timeout dei criteri. Utilizza Invia connessione di prova dopo le regolazioni. Per i problemi di payload, assicurati che l’esempio rifletta il codice JSON valido e che i campi selezionati corrispondano a quanto restituito dall’API.

➡️ Ulteriori informazioni sulla verifica della connessione e della convalida del payload

Perché gli esperti di marketing non vedono la mia integrazione nel selettore?

Le integrazioni devono essere attivate dopo un test riuscito. Quando gli addetti al marketing aprono Integrazioni vengono visualizzate solo le integrazioni attive. Se l’integrazione è ancora allo stato Bozza o Inattiva, completare prima l’attivazione.

➡️ Ulteriori informazioni sulla connessione di prova e sull’attivazione

Quali esempi di fornitori sono disponibili e chi protegge l’API?

È possibile eseguire l’integrazione con qualsiasi piattaforma di terze parti che espone un endpoint API compatibile. Illustrative modelli di fornitori ed esempi di configurazione possono aiutarti a modellare API compatibili. La responsabilità di proteggere gli endpoint è della piattaforma di terze parti e del tuo team.

➡️ Ulteriori informazioni sulle procedure di integrazione fornitore

AI Knowledge Reference

This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.

For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.

• TL;DR: This page answers frequently asked questions about Integrations in Adobe Journey Optimizer, covering configuration, authentication, supported channels and formats, API patterns, permissions, and troubleshooting.

Intents:

• Understand what Integrations do and who configures versus uses them
• Learn how administrators configure and marketers add an integration to message content
• Determine which channels, response formats, and API patterns are supported
• Find the permissions required to configure Integrations
• Troubleshoot a failing test connection or an integration missing from the marketer picker

Glossary:

• Integrations: Feature that connects external data sources so you can pull content and data from third-party systems into campaigns and journeys and personalize messages (product-specific)
• Add personalization: Action on a Text or HTML component that marketers use to open Integrations, choose an active integration, and map attributes (product-specific)
• Pills mode: Personalization editor mode used to map values to variables in the configuration, such as header or query parameters or path variables in the URL (product-specific)
• Retrieval APIs: APIs that target specific content, which are supported for this integration model (product-specific)
• Listing APIs: Broad list or pagination patterns, which are not supported for this integration model (product-specific)

Guardrails:

• Outbound channels are supported (for example email, SMS, and push).
• For API call responses, JSON and HTML are supported for field mapping; raw binary image output and formats that are not JSON are not available.
• Retrieval APIs that target specific content are supported; Listing APIs (broad list or pagination patterns) are not supported.
• To configure Integrations, users need the Manage AJO integration configuration and View AJO integration configuration permissions.
• Only active integrations appear when marketers open Integrations; the integration must be activated after a successful test.
• Supported authentication types: No Authentication, API key, Basic Auth, and OAuth 2.0.
• The Integrations feature is supported in Fragments.

Terminology:

• Canonical name: Integrations — Acronym: n/a — variants: external integrations, third-party integrations
• Synonyms: administrators “create and activate the technical configuration” = the setup marketers later select via “Add personalization”
• Do not confuse: “Integrations” (personalization fields in message content driven from APIs) ≠ “Sources” (Experience Platform data ingestion, such as batch ingestion and profile enrichment)
• Do not confuse: “Retrieval” APIs (supported) ≠ “Listing” APIs (not supported)

FAQ:

• Q: Which channels support Integrations? — Outbound channels (for example email, SMS, and push).
• Q: Which API response formats are supported? — JSON and HTML; raw binary image output and non-JSON formats are not available.
• Q: Which API patterns can I connect to? — Retrieval APIs that target specific content; Listing (broad list or pagination) APIs are not supported.
• Q: Can I use Integrations in reusable fragments? — Yes, the feature is supported in Fragments.
• Q: Do Integrations replace Experience Platform Sources? — No; Integrations drive personalization fields from APIs, while Sources handle data ingestion such as batch ingestion and profile enrichment.
• Q: Why do marketers not see my integration in the picker? — Integrations must be activated after a successful test; only active integrations appear.