DocumentazioneExperience PlatformTag

Panoramica dell’estensione per l’inoltro di eventi Mailchimp

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Principiante
  • Utente
  • Sviluppatore
  • Amministratore
NOTE
Adobe Experience Platform Launch è stato ridefinito come suite di tecnologie di raccolta dati in Adobe Experience Platform. Di conseguenza, sono state introdotte diverse modifiche terminologiche nella documentazione del prodotto. Consulta questo documento come riferimento consolidato delle modifiche terminologiche.

L'estensione Mailchimp event forwarding invia eventi all'API Mailchimp Marketing che può attivare le e-mail per campagne di marketing, percorsi o transazioni Mailchimp.

Questo documento illustra come impostare l’estensione e configurare le regole utilizzando l’azione Aggiungi evento.

Prerequisiti

In questo documento si presuppone che tu abbia familiarità con i prodotti Mailchimp rilevanti utilizzati dall’estensione. Per ulteriori informazioni, consulta la guida di Mailchimp per campagne, percorsi e transazioni.

Per utilizzare questa estensione è necessario un account Mailchimp. È possibile registrarsi a un account qui. Nel dashboard dell’account Mailchimp, annota i seguenti valori da utilizzare in questa guida:

  • Prefisso del dominio Mailchimp
  • Chiave API
  • L’ID del pubblico
  • L’indirizzo e-mail predefinito del mittente

A seconda del piano dell’account Mailchimp, puoi avere un accesso limitato agli strumenti di Percorso del cliente Mailchimp.

TIP
Se utilizzi automazioni Mailchimp come e-mail transazionali o Percorsi di clienti, i passaggi e le schermate potrebbero essere leggermente diversi da quelli elencati. Tuttavia, per utilizzare questa estensione ti servono ancora le stesse informazioni descritte in precedenza. Per informazioni dettagliate su ciascuno di questi valori per l'account e il piano specifici, vedere il Centro assistenza Mailchimp.

Prefisso dominio

Dopo aver effettuato l'accesso a Mailchimp e aver effettuato l'accesso alla visualizzazione Dashboard, nella barra degli indirizzi del browser dovrebbe essere visualizzato un URL simile a https://us11.admin.mailchimp.com o semplicemente a us11.admin.mailchimp.com. In questo esempio, il prefisso us11 è solo un segnaposto e il valore sarà diverso. Registra l’URL con il prefisso per un passaggio successivo.

Chiave API

Per trovare la chiave API per l'account, seleziona l'icona del tuo profilo nell'interfaccia utente di Mailchimp, quindi seleziona Profilo. Dovresti visualizzare un URL come https://us11.admin.mailchimp.com/account/profile/ ma con il tuo prefisso invece di us11.

Seleziona Extra, quindi Chiavi API:

Menu Extra, collegamento alle chiavi API

In Chiavi API, puoi scegliere una chiave esistente oppure selezionare Crea una chiave per crearne una nuova. Puoi creare una nuova chiave da utilizzare specificamente con questa estensione. Copia la chiave API e salvala per un passaggio successivo. Per ulteriori dettagli, consulta la documentazione di Mailchimp su come generare la chiave API.

ID pubblico e indirizzo mittente

Seleziona Pubblico nell'area di navigazione a sinistra, quindi Dashboard pubblico. Quindi, seleziona il pubblico che intendi utilizzare con questa estensione. Per ulteriori informazioni, consulta il documento Mailchimp su creazione di un pubblico.

Dopo aver creato e selezionato il pubblico, seleziona il menu a discesa Gestisci pubblico e scegli Impostazioni. Questa schermata mostra varie impostazioni per il pubblico.

Nella parte inferiore della schermata Settings, dovresti vedere Unique id for audience [audience name] dove [audience name] è il nome del pubblico effettivo. Copia l’ID pubblico e salvalo per un passaggio successivo.

Seleziona Nome pubblico e impostazioni predefinite e verifica che Indirizzo e-mail Da predefinito abbia il valore corretto per le campagne. Tieni presente che anche l’ID pubblico è elencato nella parte superiore di questa pagina e corrisponde al valore copiato nell’ultimo passaggio.

Automazioni Mailchimp

A seconda del piano Mailchimp e dell’utilizzo di e-mail transazionali, Percorsi di clienti o altre automazioni di Mailchimp, le impostazioni di percorso specifiche possono variare.

IMPORTANT
Il nome dell’evento scelto per attivare l’automazione o il percorso in Mailchimp è lo stesso nome che devi inviare con questa estensione. Prendi nota del nome dell’evento nell’automazione Mailchimp e salvalo per un passaggio successivo.

Installazione e configurazione

In questa sezione sono elencati i passaggi per installare e configurare l’estensione. Per salvare in modo sicuro la chiave API Mailchimp, è necessario utilizzare l'inoltro eventi secrets.

Creare un elemento segreto e dati

In una proprietà di inoltro eventi, crea un Token segreto denominato Mailchimp API Key.

Quindi, crea un elemento dati utilizzando l'estensione Core e un tipo di elemento dati Secret per fare riferimento al segreto Mailchimp API Key appena creato. Immetti Mailchimp Token come nome dell'elemento dati.

Installare e configurare l’estensione

Nella stessa proprietà di inoltro degli eventi, seleziona Estensioni, quindi Catalogo per visualizzare le estensioni disponibili per l'installazione. Da qui, cerca l'estensione Mailchimp e seleziona Installa.

Installa estensione Mailchimp

Viene visualizzata la schermata di configurazione. In Nome dominio prefisso server Mailchimp immettere il dominio copiato in precedenza dall'account Mailchimp, incluso il prefisso di dominio univoco.

IMPORTANT
Non includere http:// o https:// in questo campo.

Configurazione dellestensione

In Token Mailchimp, seleziona l'icona dell'elemento dati e scegli l'elemento dati Mailchimp Token creato in precedenza. Seleziona Salva per salvare le modifiche.

L'estensione è ora installata e configurata per l'utilizzo nella proprietà.

Raccolta dati

Quando si utilizza questa estensione in una regola, esistono diversi valori di dati che l'estensione invia a Mailchimp con ogni evento. Per un'implementazione tipica, è possibile configurare l'estensione Adobe Experience Platform Web SDK per inviare tali dati a Platform Edge Network per l'utilizzo da parte dell'estensione nella proprietà di inoltro degli eventi.

I dati richiesti da questa estensione possono essere inviati da Web SDK come dati XDM (utilizzando l'oggetto xdm) o come dati non XDM (utilizzando l'oggetto data).

Ad esempio, se un cliente effettua un acquisto o si registra per un evento sul sito, puoi inviare un’e-mail di conferma tramite Mailchimp con questa estensione. Dopo aver inviato le informazioni richieste da Web SDK all’Edge Network, l’estensione attiva l’e-mail con Mailchimp.

Aggiungi configurazione azione evento

Elementi dati

La schermata nella sezione precedente mostra i dati che puoi inviare con ogni evento da questa estensione a Mailchimp. Dopo aver configurato Web SDK per inviare questi dati all’Edge Network, puoi creare elementi dati nella proprietà di inoltro degli eventi in modo che l’estensione possa accedere a tali valori.

La tabella seguente fornisce maggiori dettagli per ciascun valore possibile.

Nome
Percorso di esempio
Tipo
Descrizione
Obbligatorio
Limiti
email
arc.event.xdm._tenant.emailId
o
arc.event.data._tenant.emailId
Stringa
Indirizzo che riceve l’e-mail
Sì
Deve esistere nel pubblico Mailchimp
listId
arc.event.xdm._tenant.listId
o
arc.event.data._tenant.listid
Stringa
ID pubblico
Sì
Deve corrispondere a un ID pubblico esistente
name
arc.event.xdm._tenant.name
o
arc.event.data._tenant.name
Stringa
Nome dell’evento
Sì
2-30 caratteri
properties
arc.event.xdm._tenant.properties
o
arc.event.data._tenant.properties
Oggetto
Un elenco facoltativo di proprietà in formato JSON con dettagli sull’evento
No
isSyncing
arc.event.xdm._tenant.isSyncing
o
arc.event.data._tenant.isSyncing
booleano
Gli eventi creati con is_syncing impostato su true non attiveranno le automazioni
No
occurredAt
arc.event.xdm._tenant.occuredAt
o arc.event.data._tenant.occuredAt
Stringa
Una marca temporale ISO 8601 del momento in cui si è verificato l’evento
No
IMPORTANT
I valori Esempio di percorso sopra sono solo esempi. I nomi dei campi e i percorsi a cui si fa riferimento in questi elementi dati possono essere diversi nella proprietà, a seconda di come è stato denominato e configurato Web SDK nei passaggi precedenti.

Nella proprietà di inoltro degli eventi, puoi creare un elemento dati per ciascuno dei campi descritti in precedenza. Una volta creati, puoi fare riferimento agli elementi dati nell'azione Aggiungi evento di questa estensione.

Aggiungi configurazione azione evento

Ora puoi utilizzare questa estensione e l’azione Aggiungi evento per attivare le e-mail Mailchimp per i tipi di pubblico.

Convalida dei dati

Quando si lavora con estensioni di inoltro eventi, l'Adobe Experience Platform Debugger è molto utile. Nella sezione Registri, in Registri di Edge puoi visualizzare le richieste effettuate dalle regole di inoltro degli eventi dopo che sono state attivate. Le schermate seguenti mostrano una richiesta all’API Mailchimp da parte dell’estensione.

Adobe Experience Platform Debugger

Nel dashboard Mailchimp, nella vista Feed attività del pubblico o del membro del pubblico, viene fornito un elenco di eventi per quel pubblico o membro del pubblico. Questo deve corrispondere agli eventi inviati dall'estensione e mostrare tutti i dati facoltativi inviati, insieme all'e-mail o alla campagna che hanno ricevuto. Per ulteriori informazioni, vedere le guide per l'automazione di Mailchimp.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743