当前位置：首页 > news >正文

Heya配置完全指南：从基础设置到高级优化的10个技巧

news 2026/7/4 6:33:30

Heya配置完全指南：从基础设置到高级优化的10个技巧

【免费下载链接】heyaHeya 👋 is a campaign mailer for Rails. Think of it like ActionMailer, but for timed email sequences. It can also perform other actions like sending a text message.项目地址: https://gitcode.com/gh_mirrors/he/heya

Heya 👋 是一个专为Rails设计的定时邮件序列发送工具，可以看作是ActionMailer的增强版，专门用于管理复杂的邮件营销活动。这个终极指南将带您从基础配置到高级优化，掌握Heya的全部功能。无论您是Rails新手还是有经验的开发者，这10个技巧都能帮助您快速上手并优化您的邮件营销策略。

🎯 1. 快速入门：5分钟完成基础配置

Heya的安装和配置非常简单，只需几个步骤即可开始使用。首先，在您的Gemfile中添加Heya gem：

gem "heya"

然后运行安装命令：

bundle install rails generate heya:install rails db:migrate

安装完成后，系统会自动创建以下关键文件：

config/initializers/heya.rb- 主要配置文件
app/campaigns/application_campaign.rb- 基础campaign类
数据库迁移文件

⚙️ 2. 核心配置详解：定制您的邮件营销环境

Heya的核心配置集中在config/initializers/heya.rb文件中。以下是主要配置选项：

Heya.configure do |config| # 指定用户模型（默认为"User"） config.user_type = "User" # 设置默认邮件选项 config.campaigns.default_options = { from: "support@example.com", layout: "mailer" } # 设置campaign优先级（按顺序执行） config.campaigns.priority = [ "WelcomeCampaign", "OnboardingCampaign", "EngagementCampaign" ] end

关键配置说明：

user_type: 如果您的用户模型不是User，请修改此项
default_options: 所有campaign的默认邮件设置
priority: 当用户同时加入多个campaign时的执行顺序

📧 3. 创建您的第一个邮件营销活动

使用Heya生成器快速创建campaign：

rails generate heya:campaign Onboarding welcome:0 reminder:2 followup:5

这个命令会创建：

app/campaigns/onboarding_campaign.rb- campaign定义文件
app/views/heya/campaign_mailer/onboarding_campaign/- 邮件模板目录
预览文件（用于开发环境预览邮件）

生成的campaign结构如下：

class OnboardingCampaign < ApplicationCampaign step :welcome, subject: "欢迎加入我们！", wait: 0.days step :reminder, subject: "别忘了完成设置", wait: 2.days step :followup, subject: "使用体验如何？", wait: 5.days end

⏱️ 4. 时间控制技巧：精准安排发送时机

Heya的wait参数让您精确控制邮件发送时间：

class ProductLaunchCampaign < ApplicationCampaign # 立即发送 step :announcement, wait: 0.hours # 1天后发送 step :tutorial, wait: 1.day # 3天后发送 step :feedback, wait: 3.days # 1周后发送 step :promotion, wait: 1.week # 1个月后发送 step :renewal, wait: 1.month end

时间单位支持：

seconds、minutes、hours
days、weeks、months、years
也可以使用数字组合：2.days + 3.hours

🎯 5. 用户分段策略：精准定位目标群体

通过segment参数实现精细化用户分组：

class TargetedCampaign < ApplicationCampaign # 方法符号形式 step :premium_offer, segment: :premium_user? # Lambda表达式形式 step :inactive_reminder, segment: ->(user) { user.last_login_at < 30.days.ago } # 复杂条件组合 step :upsell, segment: ->(user) { user.subscription_type == "basic" && user.usage_count > 10 } end

Campaign级别的分段：

class TrialCampaign < ApplicationCampaign # 整个campaign只针对试用用户 segment :trial? step :day1, wait: 1.day step :day3, wait: 3.days step :day7, wait: 7.days end

🔧 6. 高级定制：个性化邮件内容

Heya支持多种个性化邮件内容的方式：

动态邮件主题

class PersonalizedCampaign < ApplicationCampaign step :welcome, subject: ->(user) { "欢迎，#{user.first_name}！" } step :recommendation, subject: ->(user) { "为您推荐的#{user.favorite_category}相关内容" } end

自定义收件人格式

step :newsletter, to: ->(user) { ActionMailer::Base.email_address_with_name( user.email, user.nickname || user.first_name ) }

多语言支持（I18n）

# 在campaign中 step :welcome # 不指定subject，使用I18n # 在locales文件中 zh: personalized_campaign: welcome: subject: "欢迎，%{first_name}！"

🚀 7. 性能优化：队列管理与并发控制

队列配置

class ApplicationCampaign < Heya::Campaigns::Base default queue: "heya_low_priority" end class UrgentCampaign < ApplicationCampaign default queue: "heya_high_priority" step :alert, queue: "immediate" end

并发控制

# 默认：顺序执行（一个完成后才开始下一个） WelcomeCampaign.add(user) OnboardingCampaign.add(user) # 并发执行：同时发送多个campaign FlashSaleCampaign.add(user, concurrent: true) LimitedOfferCampaign.add(user, concurrent: true)

Sidekiq集成示例

# 启动Sidekiq处理heya队列 bundle exec sidekiq -q default -q heya_low_priority -q heya_high_priority

📊 8. 监控与调试：确保邮件发送成功

邮件预览功能

Heya自动生成邮件预览，访问http://localhost:3000/rails/mailers/即可预览所有campaign邮件。

错误处理

class OnboardingCampaign < ApplicationCampaign rescue_from Postmark::InactiveRecipientError, with: :handle_inactive_recipient rescue_from Net::SMTPError, with: :handle_smtp_error private def handle_inactive_recipient(error) Rails.logger.error("无效收件人: #{error.message}") # 可以标记用户或执行其他操作 end def handle_smtp_error(error) Rails.logger.error("SMTP错误: #{error.message}") retry_later if error.temporary? end end

质量监控

step :new_feature_announcement, subject: "新功能上线！", bcc: "quality@example.com" # 抄送质量监控邮箱

🔄 9. 生命周期管理：用户添加与移除策略

智能添加用户

# 在用户模型中自动添加 class User < ApplicationRecord after_create_commit do WelcomeCampaign.add(self) OnboardingCampaign.add(self) end after_update_commit do if saved_change_to_subscription_type? UpgradeCampaign.add(self) if premium? DowngradeCampaign.add(self) if basic? end end end

灵活的用户管理

# 添加用户到campaign OnboardingCampaign.add(user) # 重新开始campaign（重新发送所有邮件） OnboardingCampaign.add(user, restart: true) # 从campaign中移除用户 OnboardingCampaign.remove(user) # 检查用户状态 OnboardingCampaign.in_campaign?(user) OnboardingCampaign.completed?(user)

事件驱动添加

# 响应Stripe事件 ActiveSupport::Notifications.subscribe("stripe.subscription.created") do |event| user = User.find_by(stripe_customer_id: event.data.object.customer) PremiumWelcomeCampaign.add(user) if user end

🏆 10. 生产环境最佳实践

1. 数据库优化

# 定期清理旧数据（添加到schedule.rb） every :day, at: '2:00 am' do runner "Heya::CampaignReceipt.where('created_at < ?', 1.year.ago).delete_all" end

2. 监控集成

# 集成Sentry或Honeybadger class ApplicationCampaign < Heya::Campaigns::Base after_action :track_delivery private def track_delivery Honeybadger.notify( "Heya邮件发送成功", context: { campaign: params[:step].campaign.name, step: params[:step].name, user_id: params[:user].id } ) end end

3. 性能调优

# 批量处理用户 User.where(created_at: 1.day.ago..Time.current) .find_each(batch_size: 100) do |user| OnboardingCampaign.add(user) end # 使用后台任务处理大量用户 class AddUsersToCampaignJob < ApplicationJob queue_as :low_priority def perform(campaign_name, user_ids) campaign = campaign_name.constantize User.where(id: user_ids).find_each do |user| campaign.add(user) end end end

4. 测试策略

# 测试campaign test "发送欢迎邮件" do user = users(:active) assert_enqueued_jobs 1 do WelcomeCampaign.add(user) end # 模拟时间前进 travel 1.day do Heya::Campaigns::Scheduler.new.call assert_equal 1, ActionMailer::Base.deliveries.count end end