Connessione Mailchimp Interest Categories
Mailchimp è una piattaforma di automazione del marketing e un servizio di marketing via e-mail utilizzato dalle aziende per gestire e comunicare con i contatti (clienti, clienti o altre parti interessate) tramite mailing list e campagne di marketing via e-mail. Utilizza questo connettore per ordinare i contatti in base ai loro interessi e preferenze.
Mailchimp Interest Categories utilizza tipi di pubblico, gruppi e categorie di interesse (noti anche come nomi di gruppi o titoli di gruppi). Ogni gruppo Mailchimp è un elenco di categorie di interesse. I contatti sono associati a una categoria di interesse quando si sottoscrivono una o più categorie di interesse tramite un modulo di iscrizione sul sito Web. All’interno di un pubblico, puoi anche organizzare i contatti in gruppi e associarli a categorie di interesse, che possono quindi essere utilizzate per creare segmenti. Puoi utilizzare questi tipi di pubblico per trasmettere e-mail di campagne mirate ai contatti abbonati.
Questa Adobe Experience Platform destinazione utilizza l'API Mailchimp batch subscribe or unsubscribe API per creare categorie di interesse e quindi aggiungere i contatti di ciascuno dei tipi di pubblico di Platform selezionati in una categoria di interesse corrispondente. È possibile aggiungere nuovi contatti o aggiornare le informazioni di Mailchimp contatti esistenti, quindi aggiungerli o rimuoverli dai gruppi desiderati all'interno di un pubblico Mailchimp esistente dopo averli attivati all'interno di un nuovo segmento. Mailchimp Interest Groups utilizza i nomi del pubblico selezionati da Platform come categorie di interesse in Mailchimp.
Casi d’uso use-cases
Per aiutarti a capire meglio come e quando utilizzare la destinazione Mailchimp Interest Categories, ecco un esempio di caso d'uso che i clienti Adobe Experience Platform possono risolvere utilizzando questa destinazione.
Invia e-mail ai contatti per campagne di marketing use-case-send-emails
Il reparto vendite di un sito Web di articoli sportivi vuole trasmettere una campagna di marketing via e-mail a un elenco di contatti che si sono identificati come interessati al calcio. Gli elenchi dei contatti sono separati come batch nell’esportazione dei dati ricevuti dal team di sviluppo del sito web e devono quindi essere tracciati. Il team identifica un pubblico Mailchimp esistente e inizia a creare i tipi di pubblico Experienci Platform in cui vengono aggiunti i contatti di ogni elenco. Dopo aver inviato questi tipi di pubblico a Mailchimp Interest Categories, se non esistono contatti nel pubblico Mailchimp selezionato, questi vengono aggiunti a un gruppo con il nome del pubblico a cui appartiene il contatto. Se esistono già contatti nel pubblico o nel gruppo Mailchimp, le relative informazioni vengono aggiornate. Una volta inviati i dati a Mailchimp Interest Categories, il team vendite può selezionare e inviare l'e-mail della campagna di marketing al gruppo di interesse di calcio all'interno del pubblico Mailchimp.
Prerequisiti prerequisites
Consultare le sezioni seguenti per eventuali prerequisiti da impostare in Experience Platform e Mailchimp e per informazioni da raccogliere prima di utilizzare la destinazione Mailchimp Interest Categories.
Prerequisiti in Experience Platform prerequisites-in-experience-platform
Prima di attivare i dati nella destinazione Mailchimp Interest Categories, è necessario disporre di uno schema, un set di dati e segmenti creati in Experience Platform.
Prerequisiti per la destinazione Mailchimp Interest Categories prerequisites-destination
Per esportare i dati da Platform al tuo account Mailchimp, tieni presente i seguenti prerequisiti:
Devi avere un account Mailchimp prerequisites-account
Prima di poter creare una destinazione Mailchimp Interest Categories, è necessario assicurarsi di disporre di un account Mailchimp. Se non ne hai già una, visita la Mailchimp pagina di iscrizione per registrarti e creare il tuo account.
Raccogli la chiave API Mailchimp gather-credentials
È necessaria la Mailchimp chiave API per autenticare la destinazione Mailchimp Interest Categories in base all'account Mailchimp. La chiave API funge da password quando autentichi la destinazione.
Se non disponi della tua chiave API, accedi al tuo account e fai riferimento alla Mailchimp documentazione di generazione della chiave API per crearne una.
Esempio di chiave API: 0123456789abcdef0123456789abcde-us14
.
Identificare il data center Mailchimp identify-data-center
Successivamente, è necessario identificare il data center Mailchimp. Per eseguire questa operazione, accedere all'account Mailchimp e passare alla sezione delle chiavi API dell'account.
Il valore è la prima parte dell’URL visualizzato nel browser. Se l'URL è https://us14
.mailchimp.com/account/api/, il datacenter è us14
.
È inoltre aggiunto alla chiave API nel formato key-dc; se la chiave API è 0123456789abcdef0123456789abcde-us14
, il datacenter è us14
.
Annotare il valore del datacenter (us14
in questo esempio), è necessario questo valore quando si compilano i dettagli della destinazione.
Per ulteriori informazioni, consulta la Mailchimp documentazione di base.
Guardrail guardrails
Ciascuno dei tipi di pubblico di Mailchimp può contenere fino a 60 nomi di gruppo (o categorie di interesse) in un singolo gruppo o in più gruppi all'interno dello stesso pubblico. Per eventuali chiarimenti richiesti, consulta Mailchimp gruppi. Quando si raggiunge questo limite, viene visualizzato un messaggio di errore 400 BAD_REQUEST Cannot have more than 60 interests per list (Across all categories)
dall'API Mailchimp.
Per informazioni dettagliate sui limiti imposti dall'API Mailchimp, consultare inoltre Mailchimp limiti di tariffa.
Identità supportate supported-identities
Mailchimp supporta l'attivazione delle identità descritte nella tabella seguente. Ulteriori informazioni su identità.
Tipo e frequenza di esportazione export-type-frequency
Per informazioni sul tipo e sulla frequenza di esportazione della destinazione, consulta la tabella seguente.
- Stai esportando tutti i membri di un segmento, insieme ai campi dello schema desiderati (ad esempio: indirizzo e-mail, numero di telefono, cognome), in base al mapping dei campi.
- Per ogni pubblico selezionato in Platform, lo stato del segmento Mailchimp Interest Categories corrispondente viene aggiornato da Platform in base allo stato del pubblico.
Connettersi alla destinazione connect
Per connettersi a questa destinazione, seguire i passaggi descritti nell'esercitazione sulla configurazione della destinazione. Nel flusso di lavoro di configurazione della destinazione, compila i campi elencati nelle due sezioni seguenti.
In Destinazioni > Catalogo, cerca Mailchimp Interest Categories. In alternativa, puoi trovarlo nella categoria E-mail marketing.
Autenticarsi nella destinazione authenticate
Per eseguire l'autenticazione nella destinazione, compilare i campi obbligatori e selezionare Connetti alla destinazione.
La chiave API assume la forma di
{KEY}-{DC}
, dove la parte {KEY}
fa riferimento al valore annotato nella sezione Mailchimp Chiave API e la parte {DC}
fa riferimento al Mailchimp datacenter.È possibile fornire la porzione
{KEY}
o l'intero modulo.Ad esempio, se la chiave API è
0123456789abcdef0123456789abcde-us14
,puoi fornire *
0123456789abcdef0123456789abcde
*o *0123456789abcdef0123456789abcde-us14
*come valore.
Se i dettagli forniti sono validi, nell'interfaccia utente viene visualizzato lo stato Connesso con un segno di spunta verde. A questo punto è possibile procedere al passaggio successivo.
Inserire i dettagli della destinazione destination-details
Per configurare i dettagli per la destinazione, compila i campi obbligatori e facoltativi seguenti. Un asterisco accanto a un campo nell’interfaccia utente indica che il campo è obbligatorio.
data center
. Per ulteriori informazioni, consulta la sezione Identificare Mailchimp il centro dati.No options are available. Please verify the values selected for the following dependent fields: dataCenter
come illustrato di seguito. In questo caso, non puoi selezionare un valore dal campo Nome pubblico (seleziona prima il centro dati). Per correggere questo errore, specifica i valori corretti.Abilita avvisi enable-alerts
Puoi abilitare gli avvisi per ricevere notifiche sullo stato del flusso di dati verso la tua destinazione. Seleziona un avviso dall’elenco per abbonarti e ricevere notifiche sullo stato del flusso di dati. Per ulteriori informazioni sugli avvisi, consulta la guida su abbonamento a destinazioni avvisi tramite l'interfaccia utente.
Dopo aver fornito i dettagli per la connessione di destinazione, seleziona Avanti.
Attivare tipi di pubblico in questa destinazione activate
-
Per attivare i dati, è necessario Visualizza destinazioni, Attiva destinazioni, Visualizza profili e Visualizza segmenti Autorizzazioni di controllo di accesso. Leggi la panoramica sul controllo degli accessi o contatta l'amministratore del prodotto per ottenere le autorizzazioni necessarie.
-
Per esportare identità, è necessario disporre dell'autorizzazione Visualizza grafo identità Controllo di accesso.
Leggi Attivare profili e tipi di pubblico nelle destinazioni di esportazione del pubblico di streaming per le istruzioni sull'attivazione dei tipi di pubblico in questa destinazione.
Considerazioni sulla mappatura ed esempio mapping-considerations-example
Per inviare correttamente i dati sul pubblico da Adobe Experience Platform alla destinazione Mailchimp Interest Categories, è necessario eseguire il passaggio di mappatura dei campi. La mappatura consiste nella creazione di un collegamento tra i campi dello schema Experience Data Model (XDM) nell’account Platform e i corrispondenti equivalenti dalla destinazione.
Per mappare correttamente i campi XDM ai campi di destinazione Mailchimp Interest Categories, effettua le seguenti operazioni:
-
Nel passaggio Mapping, seleziona Aggiungi nuovo mapping. Ora è possibile visualizzare una nuova riga di mappatura sullo schermo.
-
Nella finestra Seleziona campo di origine, scegli la categoria Seleziona attributi e seleziona l'attributo XDM oppure scegli lo spazio dei nomi Seleziona identità e seleziona un'identità.
-
Nella finestra Seleziona campo di destinazione, scegli Seleziona spazio dei nomi identità e seleziona un'identità oppure scegli Seleziona attributi categoria e seleziona dall'elenco di attributi popolati dall'API Mailchimp. Tutti gli attributi personalizzati aggiunti al pubblico Mailchimp selezionato saranno disponibili per la selezione come campi di destinazione.
Di seguito sono indicate le mappature disponibili tra lo schema del profilo XDM e Mailchimp Interest Categories:
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 Campo origine Campo di destinazione Note IdentityMap: Email
Identity: email
Obbligatorio: sì xdm: person.name.firstName
Attribute: FNAME
xdm: person.name.lastName
Attribute: LNAME
xdm: person.birthDayAndMonth
Attribute: BIRTHDAY
Inoltre,
ADDRESS
è un campo di destinazione speciale noto comemerge field
all'interno del tuo pubblico Mailchimp. La Mailchimp documentazione definisce le chiavi richieste comeaddr1
,city
,state
ezip
e le chiavi facoltativeaddr2
ecountry
. I valori per questi campi devono essere stringhe. Se è presente uno dei mapping di campiADDRESS
, la destinazione passa l'oggettoADDRESS
all'API Mailchimp per l'aggiornamento. Il valore predefinito di qualsiasi campoADDRESS
non mappato èNULL
, ad eccezione del paese che utilizzaUS
come impostazione predefinita.Le mappature disponibili per il campo
ADDRESS
sono le seguenti:table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 Campo origine Campo di destinazione xdm: workAddress.street1
Attribute: ADDRESS.addr1
xdm: workAddress.street2
Attribute: ADDRESS.addr2
xdm: workAddress.city
Attribute: ADDRESS.city
xdm: workAddress.state
Attribute: ADDRESS.state
xdm: workAddress.postalCode
Attribute: ADDRESS.zip
xdm: workAddress.country
Attribute: ADDRESS.country
Ad esempio, si desidera aggiornare il valore per
country
con i valori del campo indirizzo esistente del contattoaddr1
,city
,state
ezip
come132, My Street, Kingston
,New York
,New York
e12401
. Per aggiornarecountry
è necessario passare i valori esistenti con le modifiche (se presenti) e il nuovo valore per paese. I valori nel set di dati devono essere132, My Street, Kingston
,New York
,New York
,12401
eUS
. Per ripetere, se passi solocountry
e non fornisci valori peraddr1
,city
,state
ezip
, verranno sovrascritti daNULL
.Di seguito è riportato un esempio con le mappature completate:
Dopo aver fornito le mappature per la connessione di destinazione, seleziona Avanti.
Convalidare l’esportazione dei dati exported-data
Per verificare di aver impostato correttamente la destinazione, segui i passaggi seguenti:
- Accedi al tuo account Mailchimp. Passare quindi alla pagina Audience. Espandere il menu Manage Contacts e selezionare Groups.
- Seleziona il Gruppo e controlla se i tipi di pubblico selezionati sono creati come categorie con il nome del pubblico di Platform, che può essere seguito da un suffisso generato automaticamente.
- Questa destinazione utilizza i nomi dei segmenti selezionati per creare la categoria di interesse utilizzando l'Mailchimp Aggiungi API categoria di interesse. Se crei una nuova destinazione e attivi di nuovo gli stessi tipi di pubblico, Mailchimp aggiunge un suffisso per distinguere i segmenti esistenti da quelli nuovi.
- I contatti le cui e-mail non esistevano nel gruppo vengono aggiunti alla categoria appena creata.
- Per i contatti già presenti nel gruppo, i dati del campo attributo vengono aggiornati e il contatto viene aggiunto alla categoria appena creata.
Utilizzo dei dati e governance data-usage-governance
Tutte le destinazioni Adobe Experience Platform sono conformi ai criteri di utilizzo dei dati durante la gestione dei dati. Per informazioni dettagliate su come Adobe Experience Platform applica la governance dei dati, vedi Panoramica sulla governance dei dati.
Errori e risoluzione problemi errors-and-troubleshooting
Errore riscontrato se la chiave API Mailchimp o i valori del centro dati non sono corretti incorrect-credentials-error
Se la chiave API fornita nel campo Password o il valore Data center non sono corretti, l'interfaccia utente visualizza una risposta di errore API Mailchimp: No options are available. Please verify the values selected for the following dependent fields: dataCenter
come illustrato di seguito. In questo caso, non è possibile selezionare un valore dal campo Nome pubblico (selezionare prima il centro dati).
Per correggere questo errore e procedere al passaggio successivo, è necessario fornire i valori corretti. Consulta Identificare Mailchimp il centro dati e
Raccogli Mailchimp le sezioni della chiave API se hai bisogno di assistenza.
Errore riscontrato se viene superato il limite di nomi di gruppo Mailchimp group-name-limits-error
Durante la creazione della destinazione, è possibile che vengano visualizzati i seguenti messaggi di errore: Cannot have more than 60 interests per list (Across all categories)
o 400 BAD_REQUEST
. Ciò si verifica quando si superano i 60 nomi di gruppo (o categorie di interesse) in un singolo gruppo o in più gruppi all'interno dello stesso limite di pubblico, come descritto nella sezione guardrail. Per correggere questo errore, assicurarsi di non superare il limite di nomi di gruppo in Mailchimp.
Mailchimp codici di stato ed errore
Per un elenco completo dei codici di stato e di errore con relative spiegazioni, consultare la Mailchimp pagina errori.
Risorse aggiuntive additional-resources
Di seguito sono riportate ulteriori informazioni utili dalla documentazione di Mailchimp: