使用方法

「Content Channel Push」プラグインを使用すると、新しいチャンネル項目を、 新しいRockジョブを通じて、指定したグループのメンバーにメールで送信することができます。

ジョブの設定

メールを送信するジョブは「Send Push」と呼ばれます。この ジョブには、以下の設定があります：

• 通信テンプレート：プッシュ通知に使用するシステム通信。
• コンテンツチャネル：プッシュ配信する新規アイテムを監視するコンテンツチャネル。
• 通信媒体の決定基準 – この設定は、個人がどの通信媒体で送信されるべきかを決定するのに役立ちます。選択肢は以下の通りです：
  • 「ユーザーの設定」 – ここでは、そのユーザーのシステム全体のコミュニケーション手段の設定が使用されます。
  • グループメンバーの設定 – 受信者リストとして設定されたグループに対して、そのユーザーが個別に設定した設定が適用されます。
• 受信者グループ：メールを送信するグループ。
• コミュニケーションを保存：そのコミュニケーションを保存し、その人物のコミュニケーション履歴に表示するかどうか。
• 「新規アイテムのみ送信」：この設定を有効にすると、前回の送信以降にまだ送信されていないアイテムのみが対象となります。有効にしない場合は、すべてのアクティブなリクエストが送信されます。

このジョブでは、どのコンテンツ項目がすでに送信済みかを判断するために、 チャネルに「Sent」というキーを持つブール型の 属性「Item」が設定されていることが前提となっています。ジョブが初めて実行される際、 この属性が存在しない場合は、ジョブによって追加されます。

• パーソナライゼーション – これは、Rockの「コンテンツチャンネルビュー」ブロックにあるパーソナライゼーション機能を模倣したものです。「無視」を選択すると、パーソナライゼーションセグメントは考慮されません。「優先」を選択すると、そのユーザーのセグメントに一致するコンテンツチャンネル項目がリストの上位に表示され、「フィルタ」を選択すると、そのユーザーのセグメントに一致する項目のみが表示されます。

メディアの選定に関する注意事項

上記の設定で述べたように、使用する通信手段（SMSまたは Eメール）は、個人のシステム設定、あるいは グループ内の設定を確認することで設定できます。グループメンバーの設定を選択する場合は、 メンバーがグループに自ら参加する際に、この設定を変更できる方法を 用意しておく必要があります。

プラグインで使用する「システム通信」を作成する際は、 サポートしたいすべての通信手段に対応するテンプレートを 用意するようにしてください。SMS用のテンプレートを用意しない場合、 すべてのユーザーには更新情報がメールとして送信されます。このプラグインのロジックは、 ユーザーの好みに合致しない場合でも、何も送信しないよりは、 全員に何らかの通知を送信するよう設定されています。

また、SMS機能に対応していないSMS番号を登録している場合、 有効なメールアドレスがあれば、代わりにメールが送信される点にも 留意してください。

システム間の通信

メールのデザイン作成の参考として、システムメールの例をご用意しました。 これはあくまで出発点ですので、どうぞご自由に お好みに合わせて調整してください。提供されたテンプレートは、 「ウェブサイトブログ」コンテンツチャネルを想定して作成されています。

このメールでは、以下のマージオブジェクトを ご利用いただけます。

アイテム - コンテンツチャンネルのプロパティ 新しいアイテムです。これらのアイテムには、次のように「lava」を使用してアクセスします：

{% for item in Items %}     {{ item.Title }} {% endfor %}

このアイテムに共通する特性には、 次のようなものがあります：

1. タイトル
2. コンテンツチャンネル
3. 開始日時
4. コンテンツ
5. 属性 {{ item | Attribute:’key’ }}

• コンテンツチャンネル – ここには、各アイテムが属するコンテンツチャンネルに関する情報が含まれています。一般的なプロパティには、次のようなものがあります：
  • 名前
  • 説明
  • IconCssClass
  • ChannelUrl
  • ItemUrl
• Person – これは、通常のプロパティをすべて備えた完全なPersonオブジェクトです（プロパティの一覧については、「新しい通信文におけるマージフィールド」を参照してください）。

レシピ例

受信者リストはグループとして機能するため、 メンバーをグループに追加したり、グループから削除したりする方法には、いくつかの 選択肢があります。

購読 - グループへの追加

誰かをグループに追加する最良の方法は、外部ページに「Group Simple Register」または「Group Registration」ブロックを配置することです。これらの ブロックを使用すると、迅速かつ簡単に誰かをグループに追加できます。あるいは、 「Group Member Add From URL」というブロックもあり、これを使用すれば、グループIDとPerson GUIDを指定するだけで、 誰かをグループに追加することができます。

ワークフローのエントリーフォームを使って、人を グループに追加することもできます。これは、すぐにウェルカム メールを送信したい場合にも最適な方法です。

配信停止 - グループからの削除

購読を解除する（つまり、グループからメンバーを削除する）には、 メール内の購読解除リンクからワークフローを起動します（Rock v5 以降が必要です）。 ページに「ワークフローエントリ」ブロックを追加する際、 特定の種類のワークフローを起動するように指定できます。また、リンクの クエリ文字列を通じてワークフロー属性を渡すことも可能です。例えば、 クエリ文字列を通じてPersonIdを渡すことができます。

Rockには、「グループメンバーをURLから削除」というブロックもあり、 グループIDと個人のGUIDを指定します。このブロックを使用する場合は、メールの末尾に 配信停止リンクを追加する必要があります。以下に、 ご利用いただけるサンプルをいくつかご紹介します：

<a href="{{ GlobalAttribute.PublicApplicationRoot }}page/6810?PersonGuid={{ Person.Guid }}">Unsubscribe</a>

必ずページIDを更新してください。

自動購読

もし購読リストを 動的に管理したい場合は、Rockのグループ同期機能を利用すれば、 いつでも受信者リストを最新の状態に保つことができます。

リリースノート

• v2.8
  • プラグインが有効期限が切れた、または拒否されたコンテンツチャンネルのアイテムを送信してしまう可能性があったバグを修正しました。
• v2.7
  • 以下の3つの新しいジョブ設定のサポートを追加しました：
    • 「ワンクリックで購読解除」を有効にする - これにより、メールに「List-Unsubscribe=One-Click」という値を持つ「List-Unsubscribe-Post」ヘッダーが追加されます。
    • 購読解除用URL - このLava対応フィールドには、解決された文字列がList-Unsubscribeヘッダーの最初の値として含まれます（これは購読解除用メールよりも優先度が高くなります）。
    • 配信停止リクエスト用メール - このLava対応フィールドには、解決された文字列がList-Unsubscribeヘッダーの2番目の値として含まれます（Unsubscribe URLよりも優先順位が低くなります）。
• v2.6
  • Rock Mobile向けのOpenActionに対応し、クエリ文字列の値に基づいてLavaを処理するように、プッシュ通知の送信方法を更新しました。
• v2.5
  • コンテンツチャンネルのアイテムについて、Rockのパーソナライゼーション機能に基づいてプッシュされたコンテンツをフィルタリングできる新しいオプションを追加しました。
  • 「システム通信」テンプレートにメール本文やSMS本文がなく、プッシュ通知のコンテンツのみが含まれている場合に、プッシュ通知を送信する機能を追加しました。
• v2.4
  • SMSメッセージが送信されない問題、および「メール送信不可」とマークされた個人レコードを持つグループメンバーに、依然としてメールが送信されてしまう問題を修正しました。v15.0以降が必要です。