连接您的Alchemer和MailChimp帐户以自动创建和管理联系人。您还可以使用MailChimp订户的详细信息将数据填充到您的Alchemer调查中（这是保持联系人记录最新的好方法）。
alchemer mailchimp行动允许您：
1。使用Alchemer调查提交在MailChimp中创建或更新联系人MailChimp推动动作. 有三种推送方法：
- 插入- - - - - -一个upsert是一个有条件的行动：更新如果存在记录，插入如果没有。联系人电子邮件地址将用于查找MailChimp中的匹配记录。如果列表中已存在的电子邮件地址，则将更新现有的联系人记录。如果MailChimp中没有匹配电子邮件地址，将创建新的联系人记录。
- 插入- 插入是用于创建新联系人的术语。
- 更新- 更新是现有联系人的更新。
2。使用a将联系信息（MailChimp订阅者细节）拉入炼金术家调查中的问题/字段中mailchimp拉动．
集成设置
在您开始之前，请注意您需要您的MailChimpAPI键在炼金术器中设置集成。参观MailChimp API关键文档有关获取钥匙的说明。
- 要开始在炼金术机中连接MailChimp帐户，请转至集成>数据连接器在左侧导航菜单上，找到mailchimp集成．点击配置按钮开始。
- 在这一点认证选项卡，提供一个帐户标签（这只是你和你的炼金术同行用户内部帐户的名称）和MailChimpAPI键(两个字段都是必需的)。如果您没有现成的API密钥，请访问MailChimp API关键文档有关说明。
- 完成集成设置后，单击保存．你会看到一个状态启用．一旦启用了集成，您就可以添加mailchimp.行动您的调查推动/拉动联系数据。
MailChimp推送操作：将Info从Alchemer调查推到MailChimp列表字段
alchemer的MailChimp操作的推送方法允许您自动执行联系人创建和管理过程。使用您的alchemer调查收集联系方式，然后将它们同步到MailChimp联系人列表。您可以使用推送方法更新，插入或upsert。
推送操作需要收集和向MailChimp收集和发送电子邮件地址，以创建新的联系人或更新现有联系人。如果您的推送操作将导致创建新的联系人（inserts和Upserts都会创建新的联系人），您还需要推动该新用户的状态。状态有可能的订阅，取消订阅，挂起和清洁值。
MailChimp动作推送设置
您的推送操作必须位于遵循任何将发送到MailChimp的调查问题的页面上。我们建议您对调查的推动行动谢谢Page.．
- 创建一个调查，并添加必要的问题/字段，以便在MailChimp中推送到联系人。至少，添加一个电子邮件问题您的调查（在MailChimp中创建和更新联系人都需要电子邮件地址）。
- 点击行动页面上的链接，您希望在其中放置操作并找到mailchimp.行动内部整合部分。点击+添加按钮
- 提供集成标题对于您的行动（这是您和您的炼金术同行用户的内部标题；它应该代表行动的目的。）
- 在下面选择MailChimp集成您在连接MailChimp和Alchemer帐户时提供的帐户标签将识别您的集成整合页选择一个。
- 使用S.选举一个对象下拉菜单，选择要推送的MailChimp列表。目前，列表对象是唯一可用的对象类型。
- 选择将数据推到MailChimp在方法节。选择要使用的推送方法：
- 插入- - - - - -如果MailChimp中存在提供的电子邮件地址，则将使用调查响应与该电子邮件更新现有的联系人记录。如果未存在电子邮件地址，将使用提供的电子邮件地址创建新的联系人记录。需要电子邮件地址才能在MailChimp中插入。状态也是MailChimp中的必填字段。
- 插入-插入是用于创建新联系人记录的术语。在MailChimp中插入新联系人需要电子邮件地址和状态。
- 更新-更新是对现有联系人记录的更新。引用应更新的联系人记录需要电子邮件地址（唯一标识符）。
- 下一步需要在调查中识别包含应答者电子邮件地址的问题/字段，因为这是所有push方法所需要的。电子邮件地址必须通过或收集调查，并存储在一个问题或隐藏的价值动作. 使用下面的下拉列表问题包含MailChimp联系邮件选择包含受访者电子邮件的调查问题/字段。
- 如果您需要将电子邮件地址传递为URL变量或通过合并代码引用它，请选择静态值(合并代码等)选项。您将看到一个附加字段，可以输入静态值或使用合并代码帮助器来引用电子邮件地址：
- 此外，如果您插入新联系人，请务必将此电子邮件问题/字段映射到MailChimp中的电子邮件字段（请参阅下面的步骤8）。
- 如果您需要将电子邮件地址传递为URL变量或通过合并代码引用它，请选择静态值(合并代码等)选项。您将看到一个附加字段，可以输入静态值或使用合并代码帮助器来引用电子邮件地址：
- 接下来，将您的alchemer字段映射到您的MailChimp领域地图字段部分。
- 如果您选择插入或Upsert方法，MailChimp必填字段(电子邮件地址和状态)将被默认添加。
- 对于电子邮件地址，只需选择收集/存储电子邮件地址以完成映射的alchemer字段。
- 状态已准备就绪，但您可以将默认值更改为除订阅者以外的东西（即取消订阅，挂起或清理。）
- 将您希望作为按钮的一部分发送的其余字段映射。
- 在左侧列中，选择要从中发送数据的alchemer问题/字段。
- 在右边的列中，选择要将问题数据发送到的相应MailChimp List Field。
- 使用默认值字段，用于在炼金术师字段为空时将信息传递给MailChimp。合并代码在第一个下拉菜单中的静态值选项配对时也支持此字段。
- 使用添加另一个映射链接以根据需要添加更多字段对。
- 见映射字段组本教程有关向MailChimp发送数据的其他详细信息。
- 如果您选择插入或Upsert方法，MailChimp必填字段(电子邮件地址和状态)将被默认添加。
- 一旦完成映射您的字段，请转到逻辑选项卡，如果您只希望在特定条件下触发MailChimp推送。确保保存动作完成后。
MailChimp Pull操作：将MailChimp列表字段中的信息拉入炼金术调查
alchemer的MailChimp操作的拉动方法允许您在炼金术机调查中使用MailChimp联系人的订阅者详细信息。
MailChimp行动拉安装：将信息MailChimp列表字段拉入炼金术商调查中
将从MailChimp中的联系数据从MailChimp中拉到炼金术机时，调查需要能够识别应签署信息的联系人。这是通过提供联系人的电子邮件地址来完成的。
拉动动作放置要求：
- 拉动动作必须位于遵循包含电子邮件地址的调查中的字段的页面上．
- 拉动动作还必须在任何将填充的字段之前．拉动操作可以与它们填充的字段相同，但它们必须在页面上的这些字段之前。
- 在满足上述放置要求的页面上，单击行动链接并定位mailchimp.行动内部整合部分。点击+添加按钮
- 提供集成标题对于您的行动（这是您和您的炼金术同行用户的内部标题；它应该代表行动的目的。）
- 在下面选择MailChimp集成您的集成将通过您在上提供的帐户标签进行标识整合连接帐户时页面。选择一个。
- 使用S.选举一个对象下拉菜单，选择要从的MailChimp列表。目前，列表对象是唯一可用的对象类型。
- 选择从MailChimp中提取数据在方法部分。
- 一个电子邮件地址是必需的参考MailChimp中的现有联系人记录。
- 此电子邮件地址必须在调查中传递或收集，并存储在问题或表格中隐藏的价值动作．
- 使用下面的下拉列表问题包含MailChimp联系邮件选择捕获受访者电子邮件的调查问题/字段。此字段必须位于您正在设置的拉操作之前的页面上。
- 如果您需要将电子邮件地址传递为URL变量或通过合并代码引用它，请选择静态值(合并代码等)选项。您将看到一个附加字段，可以输入静态值或使用合并代码帮助器来引用电子邮件地址：
- 接下来，将MailChimp字段映射到下面的炼金术字段地图字段部分。
- 在左列中，选择要填充的炼金术问题/字段。
- 在右列中，选择要从中拉数据的相应MailChimp列表字段。
- 使用默认值在MailChimp中为该记录的字段为空白时，字段将默认值传递到alchemer中。合并代码在第一个下拉菜单中的静态值选项配对时也支持此字段。
- 使用添加另一个映射链接以根据需要添加更多字段对。
- 完成字段映射后，您可以选择应用条件来触发MailChimp push逻辑标签。确保保存动作完成后。
地图字段
将alchemer问题映射到MailChimp列表字段时，有几个要求以确保您的集成正常工作。
Push Action:必需的MailChimp列表字段
MailChimp中有两个默认的必填字段。此外，列表创建者还可以根据需要在MailChimp中设置列表字段。
MailChimp中默认的必填字段是Email Address和Status。Status可能有订阅、未订阅、挂起和清理的值。当您的MailChimp操作可能导致创建新记录(插入和upsert)时，我们将默认添加这些字段。
- 对于电子邮件地址，只需选择收集/存储电子邮件地址以完成映射的alchemer字段即可。
- 状态为“准备就绪”，但您可以将默认值更改为“已订阅”以外的内容（即“取消订阅”、“挂起”或“已清除”）。
推动：匹配MailChimp列表字段类型
对于推动和拉动，确保您的炼金术家很重要报告价值和问题验证设置与列表字段类型在MailChimp。
例如，MailChimp的默认生日列表字段仅包括月和日（MM/DD或DD/MM格式）。因此，您不能将生日字段映射到炼金术的日期问题．相反，你应该把这些信息文本框题。如果您需要在此字段上验证，则需要使用要验证的正则表达式用于月和日（或日和月）。
推送到MailChimp组和从MailChimp组拉出（又名兴趣）
如果您正在使用MailChimp组（又名兴趣）你也可以推动和拉动！您可以将数据推向或将数据拉到a中隐藏的或复选框团体。您可以将数据从（或将数据拉到）推送炼金术器单选按钮或复选框对兴趣的问题。
支持以下映射：
- 从alchemer按钮复选框问题到mailchimp复选框组或隐藏组
- 从多个alchemer单选按钮问题（每组名称一个）到MailChimp复选框组或隐藏组
- 从MailChimp复选框组或隐藏组中拉入alchemer复选框问题
- 从MailChimp复选框组或隐藏组拉入多个炼金术单选按钮问题（每个组名一个）
从alchemer按钮复选框问题到mailchimp复选框组或隐藏组
让我们以MailChimp中的以下示例组为例：捐赠、志愿服务、活动。注意，这是MailChimp中的复选框组，意味着一封电子邮件可以有多个组。这也适用于MailChimp中的隐藏组，因为它允许多种选择。
我们可以从类似格式格式化的炼金术家临时数据复选框问题。
将alchemer复选框的映射到MailChimp复选框/隐藏组将如下所示：
从多个alchemer单选按钮问题（每组名称一个）到MailChimp复选框组或隐藏组
让我们以MailChimp中的以下示例组为例：捐赠、志愿服务、活动。注意，这是MailChimp中的复选框组，意味着一封电子邮件可以有多个组。这也适用于MailChimp中的隐藏组，因为它允许多种选择。
我们可以推动三个炼金术家单选按钮问题，每组一个，如下面的例子。在MailChimp中，您不能将多个单选按钮问题推给一个组。
对MailChimp的单独炼金机单选按钮问题的映射复选框/隐藏组将如下所示：
单选按钮问题的要求
- 你必须有一个分离MailChimp中每组的单选按钮问题
- 这报告价值对于每个单独的单选按钮，问题必须采用以下格式之一：
- 0，1
- True，False（不区分大小写）
- 是、否(不区分大小写)
从MailChimp复选框组或隐藏组中拉入alchemer复选框问题
您可以从复选框或隐藏的兴趣中提取数据以填充单选按钮或复选框题。
让我们参加MailChimp中的以下示例组：捐赠，志愿服务，活动。
这些可以填充类似格式的复选框问题。
MailChimp复选框/隐藏组到Alchemer复选框问题的映射如下所示：
从MailChimp复选框组或隐藏组中拉入多Alchemer单选按钮问题(每组一个)
您可以从复选框或隐藏的兴趣中提取数据以填充单选按钮或复选框题。
让我们参加MailChimp中的以下示例组：捐赠，志愿服务，活动。
为了将三个组填充到单选按钮问题中，我们必须填充到三个独立的单选按钮问题，每组一个通过拉动（见下文示例）。
MailChimp复选框/隐藏组到单独的炼金术单选按钮问题的映射如下所示：
单选按钮问题的要求
- 在MailChimp中，你必须为每个组设置一个单独的单选按钮问题
- 您的报告价值对于每个单独的单选按钮，问题必须采用以下格式之一：
- 0，1
- True，False（不区分大小写）
- 是、否(不区分大小写)
常见问题＆疑难解答
在此集成中使用了哪个版本的MailChimp API？
我们使用MailChimp API的3.0版。
我正在使用INSERT或UPSERT PUSH方法，未创建联系人。
至少，电子邮件地址和状态（具有订阅，取消订阅，待定，清除的值，必须在MailChimp中创建新的联系人记录。
确保您的调查中提供了电子邮件地址，并将电子邮件地址映射到MailChimp中的电子邮件地址列表字段。确保您也通过了状态。了解更多内容映射字段组这是本教程的一部分。
你的影响力包括生日吗?
MailChimp的默认生日列表字段仅包括仅一个月和日（以mm / dd或dd / mm）格式。因此，您无法将此字段拉入炼金术家日期问题．相反，你应该把这些信息文本框题。如果您需要在此字段上验证，则需要使用要验证的正则表达式用于月和日（或日和月）。
我的一个或多个领域未传递给mailchimp。
alchemer验证您尝试推送到MailChimp的数据，以确保它按MailChimp预期的格式推送。
如果您尝试推送MailChimp不期望的值，则无法成功推送该值。这不会影响整个推送动作，只影响特定值。
例如，假设您将URL /网站传递给来自Alchemer的MailChimp。在这种情况下，MailChimp期望以Text.text格式的数据（注意点'）。因此，试图通过“炼金工”将失败，而“alchemer.com”会成功。
我的MailChimp操作没有拉/推数据。
如果您的MailChimp操作未能推动或拉动数据，请检查动作日志查询相关的调查答复。
- 去结果>个体反应，然后单击与失败操作关联的响应之一。
- 在这一点动作日志标签，找到你的MailChimp行动(由你在行动中提供的整合标题识别)。在这里，您可以查看操作输入/输出，并引用可能出现的任何错误。如果你正在使用推，但没有数据被传递到MailChimp，这可能是由于一个意外的值被推到一个特定的字段(例如文本被推到一个数字字段)。
