This page is also available in English.
お知らせ: この機能は廃止予定になりました。今後の使用は推奨されません。
Constant Contact インテグレーションモジュールにより、コンタクトフォーム経由で集められた連絡先データを Constant Contact API に送ることが可能になります。信頼性の高いメール購読サービスをほんのわずかな手順で立ち上げられるようになります。
このインテグレーションの利用には Constant Contact のユーザーアカウントが必要になります。まだアカウントを持っていないなら、先に進む前にユーザー登録してアカウントを取得しましょう。
API に接続する
このインテグレーションモジュールは Constant Contact V3 API を利用します。あなたの WordPress ウェブサイトからこの API の利用を開始するにあたって、まず最初にアプリケーションを登録して、この後の段階で必要になる API キーと App シークレットを取得する必要があります。
アプリケーションを登録するには、まず app.constantcontact.com の My Applications ページに移動して、右上にある “New Application” ボタンをクリックします。
そこで最初にアプリケーションの名前を質問されます。この名前は後でいつでも変えられるので、とりあえず差し当たっては “Contact Form 7 Integration for (あなたのサイトのタイトル)” とでもしときましょう。
“Save” をクリックすると Details ページに移動します。
Details ページの最初の項目として “API Key” があるはずです。API Key 項目の隣にある “Generate Secret” ボタンをクリックすると App シークレットが生成されます。この API キーと App シークレットをどこかにコピーしておいてください。これらは次の段階で必要になります。
次に、ブラウザの別のタブにあなたの WordPress ウェブサイトの管理画面を開いてください。そこで お問い合わせ > インテグレーション のメニューページに移動します。”Constant Contact” と書いてあるボックスがあるはずです。
「インテグレーションのセットアップ」ボタンをクリックします。いくつかの入力項目が表示されるでしょう。前の段階でコピーしておいた API キーと App シークレットをそれぞれの項目にペーストしてください。
「リダイレクト URI」という変更不可の項目がその下にあるでしょう。この項目の値をコピーして、app.constantcontact.com の Details ページの “Redirect URI” 項目にペーストしてください。
Details ページの項目の値を変更したら、右上にある “Save” ボタンをクリックするのを忘れずに。
ここまで来たらもう必要な設定はほとんど完了したも同然です。WordPress 管理画面の お問い合わせ > インテグレーション メニューページに戻って、「Constant Contact API に接続」ボタンをクリックします。すると認可プロセスが開始されます。
ここまですべて正しく設定できていれば、あなたは Constant Contact のログインページにリダイレクトされ(まだログインしていなければ)、あなたが登録したアプリケーションがあなたの Constant Contact アカウントにアクセスすることについて認可することを求められます。
それが済んだら、あなたはまた WordPress にリダイレクトされ、そこでボックスのボーダーラインが青色に変わっていることに気づくでしょう。青のボーダーは API への接続が確立されたことを示しています。
連絡先プロパティとのマッピング
今やあなたのコンタクトフォームと Constant Contact API の間の接続は確立されています。
正しいフォーム送信を受信するたびに、Contact Form 7 は Constant Contact API にリクエストを送り、Constant Contact のデータベースに送信内容に基づいた連絡先データを追加するよう求めます。
Constant Contact の連絡先データはさまざまなタイプのプロパティで構成されます。例えば、名前、姓、メールアドレス、電話番号、仕事上の肩書き、誕生日、などのプロパティがあります。API へのリクエストを作成するためには、Contact Form 7 はコンタクトフォームのどの入力項目が Constant Contact の連絡先データのどのプロパティに対応するのかを知る必要があります。
Contact Form 7 は以下に示す名前ベースのマッピングテーブルを使用して、入力項目と連絡先プロパティの対応づけを決定します。例えば、フォームに [email* your-email] というフォームタグ (名前: your-email) があるなら、この項目に入力される値は連絡先データの email_address プロパティに使われる、といった具合です。
| Form Field Name | Contact Property |
|---|---|
your-first-name | first_name |
your-last-name | last_name |
your-name | first_name and last_name (*1) |
your-email | email_address |
your-job-title | job_title |
your-company-name | company_name |
your-birthday-month | birthday_month |
your-birthday-day | birthday_day |
your-birthday | birthday_month and birthday_day (*2) |
your-anniversary | anniversary |
your-phone-number | phone_numbers |
your-address-street | street_addresses.street |
your-address-city | street_addresses.city |
your-address-state | street_addresses.state |
your-address-postal-code | street_addresses.postal_code |
your-address-country | street_addresses.country |
*1 — もしフォームに your-first-name も your-last-name もなく、代わりに your-name 項目があるなら、your-name 項目の値の最初の単語が first_name 連絡先プロパティに使用され、残りが last_name プロパティに使用されます。
*2 — フォーム中に your-birthday-month と your-birthday-day のどちらもがなく、しかし your-birthday 項目ならあってそれが YYYY-MM-DD フォーマットの日付の値をとる場合、その月と日の部分がそれぞれ連絡先プロパティの birthday_month と birthday_day プロパティに使用されます。
このマッピングではあなたの実際のフォームの項目にうまく当てはまらないと感じるケースもあるでしょう。そういう場合のために Contact Form 7 は wpcf7_constant_contact_contact_post_request_builder フィルターフックを用意しています。フィルター関数を作成するのにいくらか PHP のコーディングが必要になりますが、このフィルターを使えば連絡先作成リクエストの何から何まですべてのカスタマイズが可能です。
同意を得る
コンタクトフォーム送信者の連絡先データを購読リストに追加する前に、その本人からの明確な同意を得ることを強く推奨します。個人データを同意なしに収集し利用することが違法になるという理由もありますが、望んでいない対象にメールを送りつけることがスパムの苦情の増加につながるということも考えるべきです。
Constant Contact の購読リストに連絡先データを追加しても構わないか、それについての送信者の同意を確認するためのフォーム項目のために、Contact Form 7 はフォームタグのオプションとして consent_for:constant_contact を用意しています。このオプションは次の例のように使います:
[acceptance your-consent optional consent_for:constant_contact] 私を Constant Contact の購読リストに追加してください。 [/acceptance]
このフォームタグ(承諾確認チェックボックス)がコンタクトフォームの中で使われている場合、フォーム送信者がこのチェックボックスを選択して同意を確認した場合に限って、Contact Form 7 は Constant Contact API に対し連絡先データを送信します。
連絡先リストを指定する
Constant Contact ではあなたが集めた連絡先データを連絡先リスト(またの名を「メールリスト」あるいは単に「リスト」)にグループ分けすることが可能です。
Contact Form 7 の Constant Contact インテグレーションは、コンタクトフォーム経由で得られる新しい連絡先のための連絡先リストの指定をサポートしています。
まだ連絡先リストがない場合は Constant Contact のダッシュボードで最初のリストを作ってみましょう。それから WordPress の管理画面に戻ります。コンタクトフォームの編集画面に Constant Contact タブパネルが追加されています。このコンタクトフォーム経由の新規連絡先をあなたの連絡先リストに追加したいなら、連絡先リストのチェックボックスを選択しましょう。それから追加するリストを選択してください。
