​

はじめに

​

MoEngage × Skycore

1. Pass Issuance Links を使用してパスを作成する
2. ユーザーのアクション (イベント) に基づいてパスをその場で更新する

​

連携

​

Pass Issuance Links を使用してパスを作成する

​

ステップ 1: Skycore で新しい Pass Issuance Link を作成する

1. こちらの手順に従って 新しい Pass Issuance Link を作成 してください。
2. 作成すると、リンクが Pass Issuance Links タブに表示されます。注: MoEngage は SHA256 (ソルトありおよびソルトなし) 暗号化のみをサポートしています。
3. Get Link をクリックします。リンクは次のようになります。
   https://d2c.skycore.com/wallet/gc/{Unique-Link-ID}?{Paramater-1}={Value-1}&{Paramater-2}={Value-2} ... &checksum={Hashed-Value}
   

​

ステップ 2: ペイロード変数を作成してエンコードする

1. キャンペーン作成のステップ 2 に移動します。
2. テンプレート内の HTML Block で、(ステップ 1 でコピーしたリンクを使用して) passlink を作成します。
   HTML

   {% set passLink = "https://d2c.skycore.com/wallet/gc/7c59b26bcxxxxxxxxxxxxa5043bf033?user-email=" + {{UserAttribute['Email (Standard)']|default('MOE_NOT_SEND')}} + "&user-phone=" + {{UserAttribute['Mobile Number (Standard)']|default('MOE_NOT_SEND')}} + "&pass-id=MOED" + {{UserAttribute['First Name']|default('MOE_NOT_SEND')}} + "2022&barcode-value=MOED" + {{UserAttribute['First Name']|default('MOE_NOT_SEND')}} + "2022&message4=Enter this coupon code while checking out." %}
   

{% set hash = passLink|convertToSHA256NoSalt() %}

{% set finalPassLink = passLink + "&checksum=" + hash %}

​

ステップ 3: URL をプレビューする

​

ステップ 4: MoEngage キャンペーンに Save Pass オプションを追加する

1. テンプレート内に新しい画像を挿入します。
2. File Manager で Import をクリックし、URL を選択します。 参考として、URL は次のとおりです。Android の場合:
   https://messagecontent-public.s3.amazonaws.com/wallet/add-to-wallet-buttons/Save_to_Google_Pay.svg
   
   Apple の場合:
   https://messagecontent-public.s3.amazonaws.com/wallet/add-to-wallet-buttons/Add_to_Apple_Wallet.svg
   
3. 表示する適切な画像を選択します。
4. URL セクションに次のように入力します。
   {{finalPassLink}}
   
   

​

ユーザーのアクション (イベント) に基づいてパスを動的に更新する

1. Gift Card API
2. Coupon API
3. Loyalty Card API
4. Event Ticket API
5. Boarding Pass API

​

ステップ 1: 適切なペイロードを定義する

​

API エンドポイント

POST https://api.skycore.com/API/http/v3/

​

ペイロード

{
  "action": "updatepassdata",
  "pass-id": "MOED{{UserAttribute['First Name']|default('MOE_NOT_SEND')}}2022",
  "pass-template-id": "d5144e25f17*************************beaa",
  "pass-data": {
    "pass-status": "voided",
    "pass-update-notification": "Your pass has expired."
  }
}

​

ステップ 2: MoEngage でコネクターキャンペーンを作成する

1. Create Campaign > Connectors > Custom > Event triggered に移動します。
2. キャンペーンのステップ 2 で、次の操作を行います。
   • メソッドとして POST を選択します。
   • Webhook URL として https://api.skycore.com/API/http/v3/ を追加します。
   • Headers に次を追加します。
     • X-Api-Key: Skycore の Settings ページからコピーした API キー。
     • Content-Type: application/json。
   • Body で Raw を選択し、カスタマイズしたペイロードを入力します。「@」を入力すると、パーソナライズされたコンテンツを追加できます。上記の例では、ペイロードは次のようになります。
     JSON

     {
       "action": "updatepassdata",
       "pass-id": "MOED{{UserAttribute['First Name']|default('MOE_NOT_SEND')}}2022",
       "pass-template-id": "d5144e25f17*************************beaa",
       "pass-data": {
         "pass-status": "voided",
         "pass-update-notification": "Your pass has expired."
       }
     }
     
   {kkk}
   
   
3. これで、キャンペーンをテストして送信する準備が整いました。Create Connector Campaign のステップ 2 で利用できる Test 機能を使用して、コネクターの設定をテストすることもできます。

​

ステップ 3: Skycore でパスをプレビューする

1. Skycore のダッシュボード >> Mobile Wallet >> Pass Data Manager に移動します。
2. 表示するパスをクリックします。