MailChimpベースのセグメントメーリング

こんにちは、Habr！ 今日は、サイトでmailchimpメーリングサービスを統合する方法について説明します。
このサービスは多くの機会を提供します：
-高度な追跡;
-ユーザーの選択。
-美しいレターテンプレート。
-ソーシャルネットワークとの統合。
-Google Analyticsとの統合。
-プロジェクトの開発時間を節約します。
このサービスに基づいて、ターゲットスライス（特定のベンダーと製品カテゴリ）による特別オファーの自動配布を行いました。 実装のいくつかの機能について簡単に話してみましょう。


ユーザーのリストを作成します。
mailchimpのメーリングリストはユーザーのリストに基づいて構築されているため、まず個人アカウントmailchimp.comで次のリストを作成します。リスト-リストの作成。 私のリストは「特別オファー」と呼ばれ、オンラインストアのニュースやプロモーションを購読しているユーザーが含まれています。 リストを作成したら、その固有の番号を見つける必要があります：API-このリストを使用するには、リスト-特別オファー-設定-リスト設定と一意のID。



リストにユーザーグループを作成してみましょう。私の場合、これらはベンダーとカテゴリです。リスト-特別オファー-グループ-ビューグループ

ここで、たとえば、ベンダーセクション：


グループを作成するときは、名前に加えて追加のパラメーターがないことを考慮する必要があり、これにより接続の作成が複雑になります
グループとデータベース。 グループの複合名、最初の部分-番号-データベース内のベンダー/カテゴリコード、2番目-ベンダー/カテゴリの表示名を決定しました。

ところで、グループ自体は60個を超えて作成することはできません。この重要な情報は、APIメソッドの1つに対するコメントとして保存されます。

ユーザーをメーリングリストにインポートします。
通常、ユーザーはサブスクリプションフォームからメーリングリストにアクセスしますが、インポートメカニズムを使用してバンドルでダウンロードできます。 （リスト-特別オファー-インポート。）「場所」の可能性は非常に大きく、ファイル、Googleの連絡先、ドキュメントなどからインポートできます。特定のグループにすぐにインポートできます。



無料版の登録者数は2000人に制限されているため、さらに多くの電子メールアドレスをアップロードすると、「送信制限に達しました。 Forever Freeプランは、合計サブスクライバー数（すべてのリストを組み合わせた）が2000以下の場合にのみ送信できます。アップグレードを再度有効にします」。

また、インポート後、「私たちのレビューチームが最近、いくつかの質問をメールで送信しました。 メールキャンペーンを送信するためのアカウントを承認する前に、返信が必要です。」 会社について教えて、ユーザーリストの取得元を示すように求められます。一般に、一種の検証を行います。 このようなチェックが必要な理由の説明は次のとおりです。kb.mailchimp.com / article / why-is-my-account-under-review

MailChimp API
ユーザーのリストを作成したら、最初のメーリングリストの作成を開始できます。 自動システムが必要なため、mailchimpコントロールパネルからメーリングを作成して実行することは興味がありません。 したがって、すぐにMailChimp APIを調査します。
現在、APIにはバージョン1.3があり、 apidocs.mailchimp.com / api / 1.3にあります。

コントロールパネルを介して実行できるほとんどすべてがAPIメソッドで実装され、さまざまな言語用の既製のラッパークラスのセットがあります。 phpの場合： apidocs.mailchimp.com/api/downloads/#php

APIを使用するには、アカウントで作成できるキーが必要です。



APIの使用例：

<?php require_once('MCAPI.class.php'); // API $apiKey = 'd43a8xxxxxxxxxxxxxxxxxc6867cbd-us4'; //ID   $listId = '8e2xxxxx44'; $mailchimpAPI = new MCAPI($apiKey); //      $groups = $mailchimpAPI->listInterestGroupings($listId); print_r($groups); 

セグメント。
セグメントは、リスト上のすべてのユーザーではなく、グループ、ユーザー名、または場所などの特定の条件を満たすユーザーのみにニュースレターを開始するための素晴らしい機会です。


スクリーンショットは、グループ、言語、場所の3つの異なるセグメントのユーザーのサンプルを示しています。 一般に、選択は非常に複雑になる可能性があり、そのような選択を作成するための別のツールが作成されました-HairBall、詳細はこちら： blog.mailchimp.com/introducing-hairball-an-air-app-for-really-complicated-mailchimp-lists

このプロジェクトでは、グループ（ベンダー/カテゴリ）ごとのセグメントのみを使用します。 グループベースのニュースレターを作成する例を次に示します。

 $opts= array( 'list_id' => $listId, 'from_email' => ' ', 'from_name' => ' ', 'tracking' => array('opens' => true, 'html_clicks' => true, 'text_clicks' => false), 'authenticate' => true, 'analytics' => array('google'=>'UA-XXXXXX-2'), 'subject' => ' ', 'title' => ' ', ); $content = array( 'html' => 'html  ', 'text' => 'plain text  ', ); $segmentGroups = array( 'match' => 'any', 'conditions' => array( array('field' => 'interests-5555', 'op' => 'all', 'value' => '17#ABBYY, 19#Adobe Systems, 20#McAfee Inc'), array('field' => 'interests-4444', 'op' => 'all', 'value' => '88#. , 99# , 77# '), ) ); //  $campaignId = $mailchimpAPI->campaignCreate('regular', $opts, $content, $segmentGroups); //  if ($campaignId) { $mailchimpAPI->campaignSendNow($campaignId); } 

$ opts配列では、配信設定が設定され、$ content配列では、メッセージ、html、およびプレーンテキストのコンテンツが設定されます。

パラメーター$ segmentGroupsには、リストのユーザーセグメントを持つ特別に形成された配列が必要です。

セグメントがグループ（私たちの場合）である場合、セグメント名はプレフィックス 'interests-' +ルートグループのID（一般にグループ化-グループ化と呼ばれる）で構成され、値はコンマでリストされたグループの名前である必要があります。

ご覧のとおり、5555と4444はルートグループのIDであり、この場合はベンダーとカテゴリです。

listInterestGroupingsメソッドを使用して、ルートグループのIDとグループのすべての情報を確認できます。

 $groups = $mailchimpAPI->listInterestGroupings($listId); print_r($groups); 

apidocs.mailchimp.com/api/1.3/listinterestgroupings.func.php

APIは複数のセグメントにわたるサンプリングをサポートしていることがわかります。 私の場合、これらは2つのグループであり、セグメント間のキーマッチ=「任意」（OR）、マッチ=「すべて」（AND）、およびセグメント内のキーop =「すべて」（完全一致）の両方で、さまざまな条件もサポートします値にリストがある場合）、op = "one"（値にあるリストと一致するものの1つ）。
apidocs.mailchimp.com/api/1.3/campaigncreate.func.php

$コンテンツ配列に戻る-手紙のテキストを取得する場所
ここにはいくつかの状況があります-たとえば、mailchimp管理パネルのマネージャーは素敵なレターテンプレートを選択できます。それらの多くは、テキストを目的のテンプレートに編集し、「マイテンプレート」に保存します。 次に、templates（）メソッド（http://apidocs.mailchimp.com/api/1.3/templates.func.php）を使用して、目的のテンプレートのIDを取得し、それに基づいてニュースレターを作成します（campaignCreate（）メソッドの$ opts配列で、指定する必要があります）キーtemplate_id）。

ただし、自動メール送信の場合、このオプションは適切ではありません。プログラムでメッセージのテキストを変更する必要がある場合だけです。そのため、必要なテンプレートのコンテンツをサーバーに保存し、Twigテンプレートエンジンのタグを追加して特別オファーのテキストを置き換えます。 これは便利です。テンプレート自体はバージョン管理システムに保存され、レイアウトを壊すことを恐れることはできません。

campaignCreate（）メソッドは、キャンペーンを作成してそのIDを返します。キャンペーン自体は、mailchimpコントロールパネルのキャンペーンのリストに表示されます。campaignSendNow（）を実行すると、メール送信が開始され、メールの送信が開始されます。



送信されたメーリングに関するレポートを見ることができます。 ここで、たとえば、テストグループの分布に関するレポート：


その結果、次のようなスクリプトを作成しました。

1.データベースから新しい特別オファーを選択します
2.特別オファーの選択に基づいてmailchimpでユーザーグループを検索します（特別オファーはベンダー/カテゴリに関連付けられています）
3.トップエンドのブロック、追加の特別オファー、マネージャーブロック、バナーなどを使用して、Twigタグがねじ込まれたレイアウトに基づいてレターのテキストを生成します。
4.ニュースレターを開始し、最後の起動時刻を記録します
5.翌日、ステップ1に進みます:)

ニュースレター購読フォーム。
このサービス自体は、ニュースレターのサブスクリプションフォームを既に提供しています。ビジュアルエディターを使用して編集し、フィールドを追加し、異なる言語に翻訳し、配色を変更し、このフォームのソースコードを取得して、サイトに貼り付けます。



しかし、それが置かれているページに応じて特定のグループにサブスクライブする動的なフォームが必要でした。

APIを使用します。
ユーザーのサブスクリプションは、2つのメソッドで表されます。listSubscribe-新しいユーザーのサブスクリプションを作成し、listUpdateMember-ユーザーのサブスクリプションを更新します。
apidocs.mailchimp.com/api/1.3/listsubscribe.func.php
apidocs.mailchimp.com/api/1.3/listupdatemember.func.php

メソッドはほとんど同じです。たとえば、キーupdate_existing = trueを指定すると、listSubscribe（）がlistUpdateMember（）に変わります。

より完全なlistSubscribeメソッドのみを考慮します。

 $mailchimpAPI->listSubscribe($listId, $email, $mergeVars, $emailType, $doubleOptin, $updateExisting, $replaceGroups, $sendWelcome); 

重要なパラメーター：
•$ listId-ユーザーリストID
•$ email-サブスクリプションを作成または更新する必要があるユーザーの郵送先住所
•$ mergeVars-グループなどの可変データを含む配列
•$ updateExisting-サブスクリプションが既に存在する場合は更新します
•$ replaceGroups-$ mergeVarsにあるグループを置き換えるか、既存のグループとマージします

ユーザーグループを更新するには、$ mergeVarsパラメーターが必要です。idキーはルートグループ（ベンダーとカテゴリ）のIDで、groupsキーはコンマで区切られたグループ名です：

 $mergeVars = array('GROUPINGS' => array( array( 'id' => '4444', 'groups' => '99# , 77# ' ), )); 

$ replaceGroups = falseを設定して、既存のグループを$ mergeVarsの新しいグループと結合します。

グループを完全に新しいグループに置き換えるには、最初に$ replaceGroups = trueを設定し、次に$ mergeVarsで、ルートグループの配列全体をグループ自体の空の値で転送する必要があります。

 $mergeVars = array('GROUPINGS' => array( //    array( 'id' => '4444', 'groups' => '99# , 77# ' ), //  array( 'id' => '5555', 'groups' => '' ), //  array( 'id' => '7777', 'groups' => '' ), )); 

つまり、$ replaceGroups = trueパラメーターは、すべてではなく、同じルートグループ内で機能します。

この方法を使用して、2つのフォームオプションを作成しました。
1.すべてのユーザー-現在のページに応じて、電子メールフィールドと配布グループの非表示フィールドを含む通常のフォーム。
2.購読/購読解除できるグループのチェックボックスのリストが表示されるアカウントのフォーム。

listSubscribeメソッドの機能：
1.サブスクリプションが新規の場合、その処理はすべてmailchimpサービスに送られ、確認メールが送信されます。確認後、サブスクライバーのプロファイルへのリンクが提供され、データを編集できます。プロファイルは再びmailchimp Webサイトにあります。
2.ユーザーの電子メールが既にメーリングリストにある場合、メソッドはエラーを生成し、個人データとサブスクライバーグループを手動で編集することを提案します。プロファイルへのリンクは、エラー$ mailchimpAPI-> errorMessageのテキストに含まれます。 サブスクリプションを更新するには、$ updateExisting = trueを指定する必要がありますが、このキーは他の誰かのサブスクリプションを上書きするためにも使用できるため、権限のないユーザーには適していません。

その結果、2つの問題があります。
1.新しいサブスクライバーのすべての処理は私たちとは行われません。たとえば、配布グループを公開するなど、それに影響を与えることはできません。
2.許可されていないユーザーへのサブスクリプションを更新する方法は明確ではありません。指定された電子メールがそのユーザーのものであることを確認できないためです。

そのため、listSubscribeによるサブスクリプション確認レターの送信を無効にしました。パラメーターは$ doubleOptin = false、$ sendWelcome = falseで、次のメカニズムを記述しました。

1-当社のウェブサイトでサブスクリプションフォームを送信する場合、一意の確認リンクを記載したメールを送信します。
2-$ doubleOptin = false、$ sendWelcome = false、$ updateExisting = trueを使用してサブスクリプションを厳密に作成または更新するリンクハンドラー。 これで、指定された電子メールは、許可されていないユーザーのものであることが確実になりました。なぜなら、彼は手紙のリンクをクリックしたからです。

パラメーター$ doubleOptin = falseを使用すると、確認せずに任意のユーザーのサブスクリプションに署名/更新するため、この方法は、このサブスクリプションが現在のユーザーに属していることが確実な場合にのみ使用する必要があります。たとえば、個人アカウントまたは一意のリンクをクリックする。

要約すると：
mailchimpメーリングに基づいて、特定のセグメント（ベンダーグループと製品カテゴリ）の自動メーリングシステムを作成し、特定のセグメントの購読および購読解除フォームを作成し、レターテンプレートをカスタマイズできます。 サブスクリプション/サブスクライブ解除のすべてのロジックをWebサイトに転送して、独自の裁量で実装し、サービス自体に電子メールを送信して統計情報を収集させることができます。

投稿者：Andrey Ryabin-Softline Developer