DocumentazioneExperience PlatformGuida alle destinazioni

Connessione Mailchimp Interest Categories

Last update: Wed Mar 25 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Amministratore
  • Utente

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 Experience 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 Experience 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 di Experience 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 dati da Experience Platform all'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 chiave API, accedi al tuo account e consulta la Mailchimp documentazione Generate your API key per crearne una.

Esempio di chiave API: 0123456789abcdef0123456789abcde-us14.

IMPORTANT
Se generi la chiave API, annotala in quanto non potrai più accedervi dopo la generazione.

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. Consulta Mailchimp gruppi per eventuali chiarimenti richiesti. 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, vedere i ​ ​limiti di tariffaMailchimp.

Identità supportate supported-identities

Mailchimp supporta l'attivazione delle identità descritte nella tabella seguente. Ulteriori informazioni su identità.

Identità di destinazione
Descrizione
Considerazioni
E-mail
Indirizzo e-mail di contatto
Obbligatorio

Tipi di pubblico supportati supported-audiences

Questa sezione descrive quali tipi di pubblico puoi esportare in questa destinazione. Le due tabelle seguenti indicano i tipi di pubblico supportati dal connettore, per origine pubblico e tipi di profilo inclusi nel pubblico:

Origine pubblico
Supportato
Descrizione
Segmentation Service
Sì
Tipi di pubblico generati tramite Experience Platform Segmentation Service.
Tutte le altre origini del pubblico
No

Questa categoria include tutte le origini del pubblico al di fuori dei tipi di pubblico generati tramite Segmentation Service. Leggi informazioni sulle diverse origini del pubblico. Alcuni esempi includono:

  • i tipi di pubblico per caricamento personalizzati importati in Experience Platform da file CSV,
  • pubblico simile,
  • pubblico federato,
  • tipi di pubblico generati in altre app Experience Platform come Adobe Journey Optimizer,
  • e altro ancora.

Tipi di pubblico supportati per tipo di dati sul pubblico:

Tipo di dati del pubblico
Supportato
Descrizione
Casi d’uso
Tipi di pubblico per persone
Sì
In base ai profili dei clienti, consente di eseguire il targeting di gruppi specifici di persone per campagne di marketing.
Acquirenti frequenti, abbandoni del carrello
Pubblico dell'account
No
Puoi indirizzare l’attività a singoli utenti all’interno di organizzazioni specifiche per strategie di marketing basate sull’account.
Marketing B2B
Pubblico potenziale
No
Puoi indirizzare l’attività a singoli utenti che non sono ancora clienti, ma che condividono alcune caratteristiche con il tuo pubblico di destinazione.
Ricerca di dati di terze parti
Esportazioni set di dati
No
Raccolte di dati strutturati archiviati nel Data Lake Adobe Experience Platform.
Reporting, flussi di lavoro di data science

Tipo e frequenza di esportazione export-type-frequency

Per informazioni sul tipo e sulla frequenza di esportazione della destinazione, consulta la tabella seguente.

Elemento
Tipo
Note
Tipo di esportazione
Profile-based
  • 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 Experience Platform, lo stato del segmento Mailchimp Interest Categories corrispondente viene aggiornato da Experience Platform in base allo stato del pubblico.
Frequenza di esportazione
Streaming
Le destinazioni di streaming sono connessioni "sempre attive" basate su API. Quando un profilo viene aggiornato in Experience Platform in base alla valutazione del pubblico, il connettore invia l’aggiornamento a valle alla piattaforma di destinazione. Ulteriori informazioni sulle destinazioni di streaming.

Connettersi alla destinazione connect

IMPORTANT
Per connettersi alla destinazione, sono necessarie le View Destinations e le Manage Destinations autorizzazioni di controllo di accesso. Leggi la panoramica sul controllo degli accessi o contatta l'amministratore del prodotto per ottenere le autorizzazioni necessarie.

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.

Entro Destinations > Catalog, cerca Mailchimp Interest Categories. In alternativa, è possibile individuarlo nella categoria Email marketing.

Autenticarsi nella destinazione authenticate

Per eseguire l'autenticazione nella destinazione, compilare i campi obbligatori e selezionare Connect to destination.

Campo
Descrizione
Username
Nome utente Mailchimp Interest Categories.
Password
La Mailchimp chiave API, annotata nella sezione Raccogli Mailchimp credenziali.
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.

Schermata dellinterfaccia utente di Experience Platform che mostra come eseguire lautenticazione.

Se i dettagli forniti sono validi, nell'interfaccia utente viene visualizzato lo stato Connected 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.

Schermata dellinterfaccia utente di Experience Platform con i dettagli della destinazione.

Campo
Descrizione
Name
Un nome con cui riconoscerai questa destinazione in futuro.
Description
Una descrizione che ti aiuterà a identificare questa destinazione in futuro.
Data center
Il tuo account Mailchimp data center. Per ulteriori informazioni, consulta la sezione Identificare Mailchimp il centro dati.
Audience Name (Please select Data center first)
Dopo aver selezionato Data center, questo menu a discesa viene compilato automaticamente con i nomi del pubblico del tuo account Mailchimp. Seleziona il pubblico da aggiornare con i dati di Experience Platform.
Interest Category (Please select Data center and Audience Name first)
Dopo aver selezionato Audience Name, questo menu a discesa viene compilato automaticamente con i nomi delle categorie dei gruppi di interesse del tuo account Mailchimp. Seleziona il nome della categoria da aggiornare con i dati di Experience Platform.
TIP
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 Audience Name (Please select Data center first). 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 della connessione di destinazione, selezionare Next.

Attivare tipi di pubblico in questa destinazione activate

IMPORTANT

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 campi. La mappatura consiste nella creazione di un collegamento tra i campi dello schema Experience Data Model (XDM) nell’account Experience Platform e i corrispondenti equivalenti dalla destinazione.

Per mappare correttamente i campi XDM ai campi di destinazione Mailchimp Interest Categories, effettua le seguenti operazioni:

  1. Nel passaggio Mapping, selezionare Add new mapping. Ora è possibile visualizzare una nuova riga di mappatura sullo schermo.

  2. Nella finestra Select source field, scegli la categoria Select attributes e seleziona l'attributo XDM oppure scegli Select identity namespace e seleziona un'identità.

  3. Nella finestra Select target field, scegli Select identity namespace e seleziona un'identità oppure scegli la categoria Select attributes 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 come merge field all'interno del tuo pubblico Mailchimp. La Mailchimp documentazione definisce le chiavi richieste come addr1, city, state e zip e le chiavi facoltative addr2 e country. I valori per questi campi devono essere stringhe. Se è presente uno dei mapping di campi ADDRESS, la destinazione passa l'oggetto ADDRESS all'API Mailchimp per l'aggiornamento. Il valore predefinito di qualsiasi campo ADDRESS non mappato è NULL, ad eccezione del paese che utilizza US 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 contatto addr1, city, state e zip come 132, My Street, Kingston, New York, New York e 12401. Per aggiornare country è necessario passare i valori esistenti con le modifiche (se presenti) e il nuovo valore per paese. I valori nel set di dati devono essere 132, My Street, Kingston, New York, New York, 12401 e US. Per ripetere, se passi solo country e non fornisci valori per addr1, city, state e zip, verranno sovrascritti da NULL.

    Di seguito è riportato un esempio con le mappature completate:
    Esempio di schermata dellinterfaccia utente di Experience Platform che mostra le mappature dei campi.

Dopo aver fornito i mapping per la connessione di destinazione, selezionare Next.

Convalidare l’esportazione dei dati exported-data

Per verificare di aver impostato correttamente la destinazione, segui i passaggi seguenti:

  • Vai all'account Mailchimp. Passare quindi alla pagina Audience. Espandere il menu Manage Contacts e selezionare Groups.

Schermata dellinterfaccia utente Mailchimp che mostra la pagina del gruppo di tipi di pubblico.

  • Seleziona il Gruppo e controlla se i tipi di pubblico selezionati sono creati come categorie con il nome del pubblico di Experience 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.

Schermata dellinterfaccia utente di Mailchimp che mostra le categorie del gruppo di pubblico.

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 Audience Name (Please select Data center first).

Schermata dellinterfaccia utente di Experience Platform che mostra lerrore se la chiave API Mailchimp o i valori del datacenter non sono corretti.

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 mailchimp-status-error-codes

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:

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6