ウェブプッシュ

※こちらエンジニア向けの説明となります。予めご了承ください

ブラウザに対して、通知を出すことが可能になります。
メールの開封率が年々低下している中、新たなタッチポイントとして注⽬されており、ブラウザ単位でのアプローチが可能なため、汎⽤性が⾼いこともポイントです。

※別オプションの課金となります。ご利用希望の場合はサポートチームにご連絡ください

1.設置準備

お申し込みの際に、貴社サイトに合わせて下記のユーザが通知を購読するパターン1～3を選択してください。
パターン1：お客様サイト表⽰時に許諾バルーンを表⽰する
パターン2：お客様サイト上で許諾する(ボタンクリックで許諾バルーンを表示)
パターン3： GENIEE MA（以下MA）と表記しますの許諾画面で許諾する。お客様サイトがHTTPS⾮対応の場合でもご利⽤いただけます

※パターン1、パターン2は、いずれも以下の制約がございます
・プッシュ通知受信時にユーザに表⽰される配信元ドメインはお客様サイトのドメインとなります
・お客様サイトがHTTPSでアクセス可能である必要があります
・お客様サイト上のルートディレクトリにファイルを設置する必要があります（後述）
※パターン3は、以下の制約がございます
・プッシュ通知受信時にユーザに表⽰される配信元ドメインは"subdomain.push.MA.jp"となります
（配信元ドメイン内の"subdomain"は任意にご指定いただくことが可能です）
※お客さまサイトへの設置が必要なファイルはこちらに格納しております
pushworker.js

1. パターン1
   1.以下の情報をMAサポートチームまでご連絡下さい。
   ・クライアントID：
   ・サイト名：
   ・サイトURL：
   ・通知許諾のパターン：1 or 2
   
   2.3営業日以内に、「購読用計測タグ」・「管理画面URL」「Pushworker」を送付します。
   
   3.お客様サイトにpushworker.jsを設置します。
   pushworker.jsは、以下の例のように"/"(root)直下で参照できる必要があります。
   
   例: お客様サイトのドメインがokyakusama.comの場合の pushworker.js の設置先
   https://okyakusama.com/pushworker.js
   
   4.購読許諾のバルーンを表⽰する画⾯に購読タグを埋め込みます。
   ※既にMAの計測タグが設置されている場合、購読タグに差し替えて下さい。
   
   MA購読計測タグ
   <script src="https://log.ma-jin.jp/ma.js?acid=2&appid=123" >
2. パターン2
   1.パターン1の⼿順を実施してください。
   2.お客様サイト上に任意の「購読ボタン」と「購読解除ボタン」を設置してください。
   3.購読ボタンおよび購読解除ボタンをクリックした際のJavaScriptの処理を組み込んで完了です。
   
   ・ma.push.SubscribeNotification()
   WebPushの購読処理を実⾏します。
   
   戻り値
   ユーザの購読状態をresolveするPromise
   
   使⽤例
   

   $('.subscribe').on('click', function() {
   ma.push.SubscribeNotification().then(
   function() {
   alert('Push通知を購読しました');
   },
   function() {
   alert('Push通知の購読に失敗しました');
   }
   );
   });
   

   
   
   ・ma.push.UnsubscribeNotification()
   WebPushの購読キャンセル処理を実⾏します。
   
   戻り値
   ユーザの購読状態をresolveするPromise
   
   使⽤例
   

   $('.unsubscribe').on('click', function (e) {
   ma.push.UnsubscribeNotification().then(
   function() {
   alert('Push通知の購読を解除しました');
   },
   function() {
   alert('Push通知の購読の解除に失敗しました');
   }
   );
   });

3. パターン3
   1.以下の情報をMAサポートチームまでご連絡下さい。
   ・クライアントID：
   ・サイト名：
   ・サイトURL：
   ・通知許諾のパターン：3
   ・MAの通知購読画面のサブドメイン：subdomain.push.MA.jp
   ※subdomainは好きな文字列に変更して下さい。
   
   2.3営業日以内に、「購読用計測タグ」・「管理画面URL」を送付します。
   
   3.お客様サイト上に、MAのWebPush購読画⾯のURLへのリンクを設置して下さい。
   例: MAのWebPush購読画⾯URL
   https://subdomain.push.ma-jin.jp/push/registration?appid=＜お客様サイトID＞
   
   4.上記の＜お客様サイトID＞を別途ご連絡するお客様サイトIDに置き換えて完了です。

2.セグメント作成

［来訪者管理］＞［セグメンテーション］＞［ウェブアクセス］より、ウェブプッシュの配信対象のセグメントを作成できます。
詳細は基本操作の、セグメンテーション「ウェブアクセス」をご確認ください。

※セグメントで抽出されるリストはセグメント「Process」クリック時点で条件に合致するリストであり、後で新たに条件に合致したとしても自動的に追加されることはありません

3.コンテンツ作成

配信するウェブプッシュのコンテンツを作成します。
1.でお渡ししたURLから、［コンテンツ作成］をクリックします。

コンテンツ一覧画面から［新規作成］をクリックします。
既存のウェブプッシュコンテンツを編集したい場合はリスト一覧の右側にある［編集］をクリックしてください。
以下の項目を設定することで、許諾を得たブラウザに対して配信されるウェブプッシュ通知のコンテンツを作成することができます。

※コンテンツ作成画面右下にあるプレビューボタンを押して、表示されるプッシュ通知を確認してから保存してください

4.キャンペーン作成

配信するウェブプッシュキャンペーンを作成します。
1.でお渡ししたURLから、［キャンペーン作成］をクリックします。

コンテンツ一覧画面から［新規作成］をクリックします。
既存のウェブプッシュキャンペーンを編集したい場合はリスト一覧の右側にある［編集］をクリックしてください。

※キャンペーンの削除は作成から5分間ほど経過してから実行してください。作成直後に削除すると削除に失敗する場合があります

5.CSVレポートのダウンロード

1.でお渡ししたURLから、［CSVレポートのダウンロード］をクリックします。
対象のウェブサイトで取得した許諾数やウェブプッシュのクリック数などのデイリーレポート（CSVファイル）をダウンロードします。
ログイン中のMAユーザーのメールアドレス宛にCSVファイルが送信されます。

※レポートの更新頻度は1時間に1回となります