[Ruby + Rails] Lorsque vous souhaitez vous inscrire dans la liste de diffusion de Mailchimp avec l'enregistrement de l'utilisateur

Contexte

Lors du développement du service, il a été décidé de gérer la distribution de la newsletter par e-mail avec Mailchimp.

À ce moment-là, en accédant à l'API fournie par Mailchimp au moment de l'enregistrement de l'utilisateur,

Implémentation du processus d'inscription à la liste de diffusion côté Mailchimp.

Il existe peu de documents japonais pouvant être utilisés comme référence pour l'API Mailchimp, donc

J'espère que vous trouverez cet article utile.

Configuration de l'application

Langage de programmation: Ruby

Cadre: Rails

C'est un environnement Ruby + Rails très général.

Paramètres de l'API Mailchimp

Installer Gem

Décrivez ce qui suit dans le Gemfile

gem "mailchimp-api", require: "mailchimp"

Obtenir la clé API

Préparez votre clé API pour utiliser l'API Mailchimp.

Tout d'abord, cliquez sur votre propre icône Mailchimp.

Un menu apparaîtra, alors cliquez sur "Compte".

Cliquez sur "Extras" sur l'écran suivant.

Appuyez sur "Clés API".

Appuyez sur "Créer une clé" sur l'écran qui apparaît après cela.

Enregistrez la "clé API" qui est sortie.

Obtention d'un identifiant Audiens

Mailchimp a le concept d'une liste pour enregistrer les informations de messagerie de l'utilisateur.

C'est ce qu'on appelle "Audience".

Par conséquent, quelle liste devez-vous enregistrer? Doit être spécifié.

Pour ce faire, nous obtenons l'ID de la liste, le "Audiens ID".

De là aussi, c'est une opération de console tick et Mail chimp.

Tout d'abord, appuyez sur "Audience" dans l'en-tête. Appuyez ensuite sur "Tableau de bord Audience".

Cliquez ensuite sur "Gérer l'audience" -> "Paramètres".

Cliquez sur "Paramètres" → "Nom de l'audience et paramètres par défaut".

C'était finalement fait. ID d'audience. Prenez-en note.

Définition des variables d'environnement

Entrez la clé API et l'ID d'audience obtenus dans .env.

.env

# Mailchimp
MAILCHIMP_API_KEY= #Clé API
MAILCHIMP_LIST_ID= # Audience ID

la mise en oeuvre

Créez un modèle pour Mailchimp.

Commencez par créer une classe.

J'ai référencé une partie de cet article (https://qiita.com/kon_yu/items/372bba35e60744633c94).

qiita.rb

class MailMagazine
  #Initialisation de l'API Mailchimp
  def initialize
    @mailchimp = Mailchimp::API.new(ENV['MAILCHIMP_API_KEY'])
  end

  #Ajouter à la liste
  #Reportez-vous à la balise de fusion du compte pour la valeur de hachage du troisième argument(lists/settings/merge-tags?id=XXX)
  def add_member(email, first_name, last_name)
    @mailchimp.lists.subscribe(
      ENV['MAILCHIMP_LIST_ID'],
      {email: email},
      {FNAME: first_name, LNAME: last_name},
      "html",
      false
    )
  end
end

Créez une méthode appelée ʻadd_member` et enregistrez-la.

Le premier argument est l'adresse e-mail.

Le deuxième argument est le nom.

Le troisième argument est le nom de famille.

est.

lists. Subscribe dans ʻadd_member` est une méthode API,

Il enregistrera votre adresse e-mail dans Mailchimp.

Le premier argument est «ID de l'audience».

Le deuxième argument est la valeur de hachage de l'adresse e-mail que vous souhaitez enregistrer.

Le troisième argument est des informations auxiliaires qui peuvent être définies avec Mailchimp. Vous pouvez enregistrer votre nom et votre anniversaire.

Pour le contenu, consultez la console Mailchimp

「Audience」→「Settings」→「Audience fields and * |MERGE| * tags」

Veuillez vous référer au.

Vous pouvez vérifier et enregistrer des informations autres que votre adresse e-mail de cette manière.

Comme pour votre adresse e-mail, entrez une valeur de hachage saisie par Mergetag.

Enregistrez votre adresse e-mail dans Mailchimp

Incorporer dans le processus d'enregistrement des utilisateurs comme celui-ci.

mailchimp = MailMagazine.new
mailchimp.add_member(@user.email, @user.first_name, @user.last_name)

Étonnamment facile ^^

Bonne vie de chimpanzé Mail ~