HeartCore メールマガジン管理機能操作マニュアル

HeartCore
メールマガジン管理機能操作マニュアル
October 2013 Ver1.1
-1Copyright© 2009-2013 Xyxon, Inc. All Rights Reserved
改訂履歴
改訂日
改訂内容
Ver1.0
2013 年 07 月
マニュアル改訂
Ver1.1
2013 年 10 月
行間の修正、キャプチャの差し替え
対象ライセンス項目の追加
-2Copyright© 2009-2013 Xyxon, Inc. All Rights Reserved
目次
本文書の目的と対象ライセンス ..................................................................................................... - 4 -
1.
1.1
目的 ............................................................................................................................................ - 4 -
1.2
対象ライセンス .......................................................................................................................... - 4 -
2.
モジュール導入（適応）手順 ......................................................................................................... - 4 -
3.
作成手順 ......................................................................................................................................... - 5 3.1
メールマガジングループ登録 .................................................................................................... - 5 -
3.2
メールマガジンユーザ登録 ........................................................................................................ - 6 -
3.3
メールマガジンコンテンツの作成 ............................................................................................. - 8 -
3.4
メールマガジン配信設定 ............................................................................................................ - 9 -
メールマガジンユーザ検索、CSV ダウンロード ......................................................................... - 12 -
4.
4.1
メールマガジンユーザ検索について........................................................................................ - 12 -
メールマガジンユーザの CSV インポート ................................................................................... - 13 -
5.
5.1
メールマガジンユーザの CSV インポートについて................................................................ - 13 -
メールマガジンユーザ登録コンテンツの作成 .............................................................................. - 14 -
6.
6.1
利用パラメータについて .......................................................................................................... - 14 -
6.2
コンテンツ作成 ........................................................................................................................ - 15 -
メールマガジン環境設定 .............................................................................................................. - 17 -
7.
7.1
CSV 文字コード ....................................................................................................................... - 17 -
7.2
メルマガ別最大送信数 ............................................................................................................. - 17 -
7.3
登録時におけるユーザ存在時の扱い........................................................................................ - 18 -
7.4
メールマガジングループが存在しない場合............................................................................. - 18 -
7.5
メールアドレスチェック .......................................................................................................... - 18 -
7.6
更新時パスワード認証 ............................................................................................................. - 18 -
7.7
キャプチャー認証..................................................................................................................... - 18 -
7.8
更新時に別のメルマガのユーザ情報も更新する ..................................................................... - 18 -
7.9
メルマガ登録時送信元アドレス(デフォルト) .......................................................................... - 18 -
7.10
ユーザ情報拡張項目 ................................................................................................................. - 19 -
8.
メールマガジン用変換パラメータ ................................................................................................ - 19 -
9.
メールマガジンユーザ「更新」、「削除」について ................................................................... - 19 -
10.
メールマガジンパスワード確認................................................................................................ - 20 -
11.
メールマガジンパスワード変更................................................................................................ - 20 -
12.
メールマガジンメールアドレス変更......................................................................................... - 21 -
13.
メールマガジンバリデーション機能......................................................................................... - 21 -
-3Copyright© 2009-2013 Xyxon, Inc. All Rights Reserved
1. 本文書の目的と対象ライセンス
1.1
目的
本文書は、弊社がお客様に納品する CMS パッケージ製品「HeartCore」における、メールマガジ
ン機能の操作方法を説明する文書です。
お客様が実際に本機能を利用するにあたり、本文書を参照することで、該当機能を一通り操作でき
ることを目的としております。
※ 本機能は「Suite」版以上の標準機能となります。その他のエディションではオプション機能（別
途有償）となります。
1.2
対象ライセンス
当該機能を提供しているライセンスは以下の通りです。尚、価格は価格表を参照願います。
Professional
メールマガジン機能
Enterprise
Standard
Suite
Standard
Suite
○
●
○
●
● ：標準装備 ○：オプション装備 －：設定なし
※JSP 版のみの提供となります。
2. モジュール導入（適応）手順
「Suite」版以下で利用する場合、提供モジュールをご利用の HeartCore に適応します。
※「Suite」版をご利用の場合、
『３.作成手順』をご参照下さい。
(1) ROOT ディレクトリの内容を上書きする。
(2) create.mysql.sql を実行し、mysql 用テーブルを作成する。
※すでに、Ver1.0 のテーブルが作成されている場合は update.mysql.sql を実行する。
(Ver1.0 の内容は old_create.mysql.sql になります)
(3) /webadmin/module/config.jsp にメルマガ用メニュー定義を追加する。
(module_config.jsp を参考)
<%@ include file="mailmagazine/config.jsp" %>
(4) hardcore_ja.properties に added_hardcore_ja.properties の内容を追加する。
hardcore_en.properties に added_hardcore_en.properties の内容を追加する。
※Ver1.0 とは同一キーでも内容が異なる箇所がありますので、全て置き換えてください。
-4Copyright© 2009-2013 Xyxon, Inc. All Rights Reserved
Ver1.0 との変更点
・config.static.jsp にて記載した内容は画面にて変更可能になった。
・「設定」⇒「メールマガジン管理」の構成を変更。
・ユーザ項目に最終更新日を追加
・「設定」メニュー構成の変更
メールマガジン管理メニューを 3 種類に分割
・メルマガグループ管理
・メルマガユーザ管理
・メールマガジン環境設定
3. 作成手順
3.1
メールマガジングループ登録
設定＞メルマガグループ管理＞追加 より メールマガジングループを登録します。
(1) メールグループ・・・メールマガジン管理グループ名を任意名で登録します。
(2) 送信元アドレス・・・送信されるメールアドレスを登録します。
(3) 送信者名・・・表示される送信者名を登録します。
-5Copyright© 2009-2013 Xyxon, Inc. All Rights Reserved
登録後、保存ボタンを押下すると登録されます。
「削除」
「更新」する場合は「更新または削除」リ
ンクより変更が可能です。
3.2
メールマガジンユーザ登録
設定＞メルマガユーザ管理 の「追加」ボタンを押下します。
-6Copyright© 2009-2013 Xyxon, Inc. All Rights Reserved
メルマガユーザ登録画面を開き、メルマガユーザを登録します。
(1) 名前・・・対象ユーザの名前を入力。
(2) メールアドレス・・・対象ユーザのメールアドレスを入力。
(3) メールグループ・・・登録するメールグループ名を指定。
(4) 性別・・・対象ユーザの性別を入力。
「1:男性、2:女性」
(5) 生年月日・・・対象ユーザの生年月日を入力。(「-」区切り)
※生年月日は『yyyy-mm-dd』形式の入力となります。
(6) パスワード・・・対象ユーザのパスワードを指定。
-7Copyright© 2009-2013 Xyxon, Inc. All Rights Reserved
登録後、
「保存」ボタンを押下し、登録したユーザを検索して確認して下さい。
検索する場合は必ずキーワードをひとつ選んで下さい。下記は「男性」を選択後、検索しておりま
す。
3.3
メールマガジンコンテンツの作成
配信するコンテンツを任意のグループ（タイプ）に作成します。
-8Copyright© 2009-2013 Xyxon, Inc. All Rights Reserved
3.4
メールマガジン配信設定
ウェブサイトコンテンツ＞メールマガジン 「追加」ボタンを押下します。
メールマガジン登録画面を開き、メール配信コンテンツを登録します。
(1) コンテンツ・・・配信するコンテンツを選択します。
(2) メールグループ・・・メールグループを選択します。
(3) タイトル出力内容・・・
「コンテンツのタイトルを使用」または「直接入力」を選択します。
(4) メールタイトル・・・
「直接入力」を選択した場合、入力可能となる。
(5) テキスト出力内容・・・
「コンテンツのサマリーを使用」または「直接入力」を選択します。
(6) テキストメール本文・・・・
「直接入力」を選択した場合、入力可能となる。
(7) 配信スケジュール・・・配信日を設定します
-9Copyright© 2009-2013 Xyxon, Inc. All Rights Reserved
保存後は下記のようになりますので、次に「配信予約」リンクを押下します。
メールマガジン配信予約画面では、配信予約前にテストメールを送信確認する事が可能です。
「送信先アドレス」
「送信先ユーザ名」を入力後、
「テストメール送信」ボタンを押下する事で配信
前にテストする事が可能となります。
テスト確認後、
「予約する」ボタンを押下します。
- 10 Copyright© 2009-2013 Xyxon, Inc. All Rights Reserved
「配信予約状況」が「配信予約中」のステータスになっている事が確認できます。
こちらの状態で、
「配信スケジュール」を経過した後は、メール配信が行われます。
配信スケジュール経過後、
「配信終了」となります。
受信されたメールデータ
※メールマガジン配信予約を行うと、以後のコンテンツ更新は無効となる。
よって、コンテンツの変更、およびメルマガ配信の変更(配信日等)する場合は配信予約をしてい
ない状態で行うこと。(配信予約をしても、実際の配信前であれば、予約の取り消しは可能)
※メールマガジンの配信は HeartCore 上で別スレッドを起動する方法で行われます。
その為、配信予約は Tomcat の再起動等が行われると失われるため、改めて配信予約を
設定しなおす必要がございます。
- 11 Copyright© 2009-2013 Xyxon, Inc. All Rights Reserved
4. メールマガジンユーザ検索、CSV ダウンロード
4.1
メールマガジンユーザ検索について
設定＞メールマガジン管理＞「ユーザ確認」ボタンを押下します。
下記図は、
「男性」を選択実行した結果となります。
また、登録ユーザを「ユーザ CSV 出力」ボタンより CSV 形式でダウンロード可能となります。
ダウンロードする際は、文字コードを選択後に実行して下さい。
ダウンロードした結果
- 12 Copyright© 2009-2013 Xyxon, Inc. All Rights Reserved
5. メールマガジンユーザの CSV インポート
5.1
メールマガジンユーザの CSV インポートについて
設定＞メールマガジン管理＞「ユーザ確認」ボタンを押下します。
メールマガジン登録ユーザを CSV ファイルでインポートする事が可能です。
インポートする際は、参照ボタンより、インポートする CSV ファイルを選択した後、CSV ファイ
ルの文字コードを文字コードを選択して、CSV インポートボタンを実行して下さい。
※csv ファイル以外をアップした場合は、何も処理を行いません。
- 13 Copyright© 2009-2013 Xyxon, Inc. All Rights Reserved
6. メールマガジンユーザ登録コンテンツの作成
通常のコンテンツページよりメルマガユーザを登録する場合には「mailmagazine.jsp」を利用し
ます。
6.1
利用パラメータについて
登録されるパラメータ
パラメータ名
内容
username
ユーザの名前
email
メールアドレス
groupname
メールグループ名
備考
複数パラメータ送付時は各グル
ープに同一内容を登録
sex
性別
birthday
生年月日
password
パスワード
男性:1、女性:2
制御パラメータ
パラメータ名
redirect
内容
登録後に表示させるコンテン
ツ ID
- 14 Copyright© 2009-2013 Xyxon, Inc. All Rights Reserved
備考
6.2
コンテンツ作成
以下、作成例となります。
<form action="/mailmagazine.jsp" method="POST">
メルマガ登録<br />
<p>購読内容</p>
<p><input type="checkbox" name="groupname" value="mailmagaG" />メールマガジン
</p>
<p>メールアドレス</p>
<p><input type="text" name="email" /></p>
<p>名前</p>
<p><input type="text" name="username" /></p>
<p>性別</p>
<p>
<select name="sex">
<option value="1">男性</option>
<option value="2">女性</option>
</select></p>
<p>生年月日</p>
<p><input type="text" name="birthday" /></p>
<p>パスワード</p>
<p><input type="text" name="password" /></p>
<br />
<input type="submit" value="登録" />
<input type="hidden" name="redirect" value="ID" />
</form>
- 15 Copyright© 2009-2013 Xyxon, Inc. All Rights Reserved
上記作成した、コンテンツでユーザ登録を行います。
送信したデータは、メールマガジンユーザ登録画面で確認する事ができます。
- 16 Copyright© 2009-2013 Xyxon, Inc. All Rights Reserved
7. メールマガジン環境設定
メールマガジン機能に関する環境設定を行います。
7.1
CSV 文字コード
エクスポートする文字コードを指定する。
V1.0 を使用されていた場合は、
「config.static.jsp」の下記項目内容が反映される為、管理画面上
で設定する場合は、削除して下さい。また、有効な文字コードを設定しない場合は文字化けが発生
しますので注意下さい。
myconfig.setTemp("mailmagazine_csv_charset", "windows-31j");
myconfig.setTemp("mailmagazine_minite_max_send", "2");
7.2
メルマガ別最大送信数
(1) グループ単位： 1 分当たりの同一メールマガジンの最大メール送信の上限値
(2) メルマガ全体： 1 分当たりの全メールマガジンの最大メール送信の上限値
※入力値は半角数字のみ有効です。それ以外を入力すると設定が無効になります。
- 17 Copyright© 2009-2013 Xyxon, Inc. All Rights Reserved
7.3
登録時におけるユーザ存在時の扱い
(1) 更新しない(追加のみ行う)：存在する場合はエラーとし、更新しない
(2) 更新する：存在する場合は入力パラメータで上書きする
7.4
メールマガジングループが存在しない場合
(1) 登録する：存在しないメールグループでも登録可能。
(2) 登録しない：存在しない場合は無視
(複数グループ登録の場合、別のグループは登録される)
7.5
メールアドレスチェック
(1) javamail:JavaMail における InternetAddress クラスでのチェック
(2) javamail 以外の場合:E メール形式チェック用パターン文字列として、Java 正規表現を記入す
る。
7.6
更新時パスワード認証
(1) チェックしない：パスワードの確認は行いません。
(2) チェックする(不正時はエラー)： 更新時、および削除時には password パラメータと実際の
ユーザパスワードが等しくなければなりません。(注：パスワード変更時は old_password パ
ラメータ)password パラメータと DB 上のパラメータを比較します
7.7
キャプチャー認証
(1) 行わない：キャプチャー認証を行いません。
(2) 行う：キャプチャー認証を必須とします。(@@@capcha@@@関数を用いて画面に配置する
必要があります)
7.8
更新時に別のメルマガのユーザ情報も更新する
(1) 更新しない：送付パラメータの更新は対象メールグループのみ
(2) 更新する：送付されたパラメータにてユーザ情報を一括更新
7.9
メルマガ登録時送信元アドレス(デフォルト)
(1) メールアドレス：送信元アドレス
(2) 名前：送信者名
(3) 利用時には、パラメータとして、
「email_template」を送付する(value はコンテンツの ID)
<input type="hidden" value="ID" name= "email_template">
- 18 Copyright© 2009-2013 Xyxon, Inc. All Rights Reserved
(1) オプションパラメータ
(省略時は「メールマガジン環境設定」⇒メルマガ登録時送信元アドレスが適用される)
A) email_from_address：送信元のメールアドレス
B) email_from_name：送信元のユーザ名
7.10 ユーザ情報拡張項目
オプションより項目名を設定することにより、ユーザ情報として保存される。
なお、登録する場合は同一の Request パラメータ名で送付すれば登録される。
8. メールマガジン用変換パラメータ
メールテンプレートなどで使用可能となります。
パラメータ名
内容
@@@mailmagazine:username@@@
ユーザの名前
@@@mailmagazine:email@@@
メールアドレス
@@@mailmagazine:password@@@
パスワード
@@@mailmagazine:groupname@@@
メールグループ名
@@@mailmagazine:birthday@@@
生年月日
@@@mailmagazine:created@@@
登録日
@@@mailmagazine:updated@@@
最終更新日
@@@mailmagazine:<< 拡 張 項 目 名
その他拡張項目
備考
>>@@@
※生年月日、登録日、最終更新日は format 指定が可能
例：生年月日の場合
@@@mailmagazine:birthday:format=%Y 年%m 月%d 日@@@
9. メールマガジンユーザ「更新」、「削除」について
mailmagazine.jsp に mode パラメータを送信すると機能の変更を可能とする。
(1) create：今までの機能と同じ
A) 対象メールグループにメールアドレスが存在しない場合は作成
B) 対象メールグループにメールアドレスが存在する場合は「メールマガジングループが
存在しない場合の扱い設定」による。
- 19 Copyright© 2009-2013 Xyxon, Inc. All Rights Reserved
例：<input type="hidden" value="create" name="mode">
(2) update：対象のメールアドレス、メールグループのレコードを更新する。
「情報更新時に同一メールアドレスのレコードについて更新の指定可能」が更新するの場
合は同一メールアドレス全て更新される。
例：<input type="hidden" value="update" name="mode">
(3) delete：対象のメールアドレス、メールグループのレコードを削除する。
(物理削除のため復元はできません)
例：<input type="hidden" value="delete" name="mode">
※ mode パラメータ無し、または不正(create|update|delete 以外)の場合は create となる)
10.メールマガジンパスワード確認
password_confirm パラメータを送付すると、password パラメータと等しいかをチェックす
る
例：
パスワード：<input name=" password_confirm " type="text">
パスワード（再入力）
：<input name="password" type="text">
11.メールマガジンパスワード変更
old_password パラメータを送付すると、old_password にて現在のパスワードと認証し、正
常の場合は password パラメータの値に更新する。
※mailmagazine.jsp の mode=update 時となります。
※「更新時パスワード認証」の設定が「チェックする(不正時はエラー)」の場合チェックし
ます。
例：
旧パスワード：<input name="old_password" type="text">
新パスワード：<input name="password" type="text">
- 20 Copyright© 2009-2013 Xyxon, Inc. All Rights Reserved
12.メールマガジンメールアドレス変更
old_email パラメータを送付すると、old_email にて現在のメールアドレスと認証し、正常の
場合は email パラメータの値に更新する。
※mailmagazine.jsp の mode=update 時となります。
例：
旧メールアドレス：<input name="old_email" type="text">
新メールアドレス：<input name="email" type="text">
13.メールマガジンバリデーション機能
name：validate_項目名を指定する事でバリデーション機能が使用できます。
例：
<input value="ID" name="redirect_invalid" type="hidden">
※ID はエラーページのコンテンツ ID となります。コンテンツ内容は [###error###]
となります。
旧パスワード：<input name="old_password" type="text">
<input name="validate_old_password" value="text" type="hidden">
新パスワード：<input name="password" type="text">
<input name="validate_password" value="text" type="hidden">
以 上
- 21 Copyright© 2009-2013 Xyxon, Inc. All Rights Reserved