> ## Documentation Index
> Fetch the complete documentation index at: https://moengage.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Passkit

# はじめに

Passkit を使用すると、Apple Wallet と Google Pay のパスを顧客体験に統合することで、モバイルでのリーチを拡大できます。顧客が別のアプリを必要とすることなく、デジタルクーポン、ロイヤルティカード、会員カード、チケットなどを簡単に作成、管理、配布し、そのパフォーマンスを分析できます。

# MoEngage × Passkit

MoEngage と Passkit の統合により、Passkit で生成されたパスを MoEngage キャンペーンを通じてオーディエンスに送信し、ロイヤルティプログラムやクーポンプログラムを拡張できます。

この統合により、次のことが可能になります。

1. パスのインタラクションイベントを Passkit から MoEngage に送信する。
2. Passkit の [SmartPass Links](https://help.passkit.com/en/articles/7731041-introduction-to-smartpass-links) を使用して、その場でパスを作成する。

# 統合の前提条件

* Passkit アカウントにアクセスできることを確認してください。
* MoEngage の Data API キーを用意してください。
* Data API ID と Data API Key は、**Settings** -> **Account** -> **APIs** で確認できます。Data API ID は **Workspace ID** と同じです。Data API Key は、同じ画面の **API Keys** -> **Data** セクションで確認できます。

## パスのインタラクションイベントを Passkit から MoEngage に送信する

Passkit ダッシュボード内から MoEngage にデータを渡すことで、顧客のモバイルウォレット体験を強化できます。共有できるデータポイントの例は次のとおりです。

1. Pass created: 新しいパスが作成されたときにイベントを追跡します。
2. Pass updated: パスが更新されたときにイベントを追跡します。
3. Pass installed: ユーザーがデジタルウォレットにパスを追加したときにイベントを追跡します。
4. Pass deleted: メンバーレコードが削除されたときにイベントを追跡します。
5. Pass uninstalled: ユーザーがウォレットからパスを削除したときにイベントを追跡します。
6. Pass invalidated: パスレコードが無効化されたときにイベントを追跡します。

データが MoEngage に渡されると、これらのアクションが実行された後に、セグメントの作成、パーソナライズされたコンテンツの送信、キャンペーンのトリガーを行うことができます。

### ステップ 1: MoEngage の Data API 認証情報を取得する

MoEngage Dashboard で、Workspace ID と Data API Key を控えておきます。

| **フィールド** | **説明** |
| - | - |
| Workspace ID | MoEngage アカウントの Workspace ID は、**Settings - > Account -> APIs ->Workspace ID** で確認できます。MoEngage アカウントの Data API ID と Workspace ID は同じです。 |
| Data API Key | MoEngage アカウントの Data API key は、\*\*Settings - > Account -> APIs -> API keys \*\*>**Data** API settings で確認できます。 |

### ステップ 2: Passkit で MoEngage 統合を設定する

1. Passkit Dashboard にログインします。イベントを追跡したいキャンペーンに移動します。
2. キャンペーン内で、*Settings >> Integrations* タブ (Campaign Details の隣) に移動します。![Step1.png](https://mintcdn.com/moengage/0EdW-QMnfbsLxXT2/images/partner_7260270815636.png?fit=max\&auto=format\&n=0EdW-QMnfbsLxXT2\&q=85\&s=f4c413981e40beb415ac90fe681f7f9c)
3. 一覧から MoEngage を選択します。Configure ボタンをクリックします。 ![Step2.png](https://mintcdn.com/moengage/0EdW-QMnfbsLxXT2/images/partner_7260374336020.png?fit=max\&auto=format\&n=0EdW-QMnfbsLxXT2\&q=85\&s=0593f3e2c9fd39eded05d11f10b2b5b4)
4. フォームに入力します。
   * API キーを入力します (ステップ 1 でコピーしたもの)
   * Workspace ID を入力します (ステップ 1 でコピーしたもの)
   * MoEngage アカウントを識別するための名前を指定します
   * データセンターを選択します。MoEngage のデータセンターについては[こちら](/docs/ja/user-guide/data/key-concepts/data-centers-in-moengage)をご覧ください ![Screenshot\_2022-06-24\_at\_12.19.43\_AM.png](https://mintcdn.com/moengage/0EdW-QMnfbsLxXT2/images/partner_7267126076052.png?fit=max\&auto=format\&n=0EdW-QMnfbsLxXT2\&q=85\&s=8dc0b151eae5f02b03a654d96909b3ae)
5. Integration トグルを有効にします。
6. MoEngage でキャンペーンのトリガーやパーソナライズに使用するパスイベントを選択します。
7. "Save" をクリックします。

### ステップ 3: MoEngage でイベントを追跡する

これで、Passkit のイベントに基づいてカスタムセグメントを作成したり、MoEngage キャンペーンでイベントを使用したりできるようになりました。

![Step5.png](https://mintcdn.com/moengage/0EdW-QMnfbsLxXT2/images/partner_7260429923476.png?fit=max\&auto=format\&n=0EdW-QMnfbsLxXT2\&q=85\&s=1c4c9f14c1ea28d13048aa408da00d8f)

## Passkit の SmartPass Links を使用してその場でパスを作成する

[MoEngage のテンプレート言語](/docs/ja/user-guide/campaigns-and-channels/getting-started/message-personalization/jinja-templating-language)を使用し、Passkit が提供する SmartPass Links を呼び出すことで、ユーザー向けのパスを動的に作成できます。SmartPass Links は、特別にハッシュ化された URL を使用してその場でパスを作成するために使用されます。これらのリンクの仕組みについて詳しくは、Passkit の [Introduction to SmartPass links](https://help.passkit.com/en/articles/7731041-introduction-to-smartpass-links) をご覧ください。

### 前提条件

SmartPass Links を作成するには、次のものが必要です。

1. Passkit URL - PassKit Dashboard の Distribution >> SmartPass Settings で取得できます。
2. PassKit Secret - 各 PassKit プロジェクトには、リンクの署名 HMAC ハッシュの作成に使用される一意のシークレットがあります。これは Passkit Dashboard 内の Distribution タブ >> Generate Pass Links >> Commmand Line Tool で確認できます。
3. Program (またはプロジェクト) ID - PassKit の Program ID は、プロジェクトまたはプログラムの **Settings** タブにあります。

### ステップ 1: Passkit の Program/Project URL を取得する

Passkit の Program/Project URL は、Passkit プロジェクトの Distribution タブにあります。この URL を値とする新しい変数を作成します。

`{% set projectUrl = "https://pub1.pskt.io/c/a4hrop" %}`

### ステップ 2: ペイロードを生成する

ペイロードには、パスレコードに含める必要があるクーポン/メンバー、PII、メタデータを含めることができます。

```json JSON wrap theme={null}
{ 
    "person.externalId": "UserAttribute['MoEngage_ID']",
    "person.forename": "UserAttribute['First Name']", 
    "person.surname": "UserAttribute['Last Name']", 
    "person.emailAddress": "UserAttribute['Email (Standard)'] ",
    "person.displayName": "UserAttribute['First Name']" + " " + "UserAttribute['Last Name']", 
    "person.mobileNumber": "UserAttribute['Mobile Number (Standard)']"
}
```

*サポートされているフィールドの完全な一覧については、こちらをご覧ください: [https://github.com/PassKit/smart-pass-link-from-csv-generator#available-field-names](https://github.com/PassKit/smart-pass-link-from-csv-generator#available-field-names)*

このチュートリアルでは、上記のペイロードを使用します。次に、このペイロードを JINJA 互換の形式に変換し、別の変数に格納する必要があります。

```jinja JINJA wrap theme={null}
{% set passData = "{\"person.externalId\": \"" + UserAttribute['MoEngage_ID']|default('12345') + "\",\"person.surname\": \"" + UserAttribute['Last Name'] + "\",\"person.forename\": \"" + UserAttribute['First Name'] + "\",\"person.emailAddress\": \"" + UserAttribute['Email (Standard)'] + "\",\"person.displayName\":\"" + UserAttribute['First Name'] + " " + UserAttribute['Last Name'] + "\",\"person.mobileNumber\":\"" + UserAttribute['Mobile Number (Standard)'] + "\",}\"" %}
```

メールが正しく解析されるように、引用符と構文を再確認してください。

### ステップ 3: ペイロードをエンコードする

次のステップでは、ペイロードを base64 形式にエンコードします。

```text theme={null}
{% set base64JsonPayload = passData|base64encode %}
```

### ステップ 4: URL 文字列を作成する

エンコードされたペイロードを取得したら、最終的な URL 文字列は次の形式になります。

```text wrap theme={null}
https://pub1.pskt.io/c/{programId or campaignId}?data={base64JsonPayload}&sig={signatureHash}
```

これを行うには、テンプレート言語を使用します。

```text theme={null}
{% set url = projectUrl + "?data=" + base64JsonPayload %}
```

### ステップ 5: URL 全体のハッシュを生成する

各 PassKit プロジェクトには、リンクの署名 HMAC ハッシュの作成に使用される一意のシークレットがあります。これは Passkit Dashboard の Distribution タブで確認できます。

![Step11.png](https://mintcdn.com/moengage/skVB8Wto_b8UCyhm/images/partner_7721179467796.png?fit=max\&auto=format\&n=skVB8Wto_b8UCyhm\&q=85\&s=22a867fb1e51c07fb06f747afeb5ec79)

上記のサンプルについて、サンプルリンクの SHA256 HMAC を作成してみましょう。

```text theme={null}
{% set sig = url|convertToSHA256('{YOUR-PROJECT-SECRET} ') %}
```

### ステップ 6: 最終的な SmartPass URL を作成する

あとは、上記のすべての変数をつなぎ合わせて SmartPass URL を作成するだけです。

```text wrap theme={null}
{% set longURL = projectUrl + "?data=" + base64JsonPayload + "&sig=" + sig %}
```

### ステップ 7: キャンペーンでこのリンクを使用する

最終的なコードは次のようになります。

```jinja JINJA wrap theme={null}
{% set projectUrl = "https://pub1.pskt.io/c/a4hrop" %}
{% set passData = "{\"person.externalId\": \"" + UserAttribute['MoEngage_ID']|default('12345') + "\",\"person.surname\": \"" + UserAttribute['Last Name'] + "\",\"person.forename\": \"" + UserAttribute['First Name'] + "\",\"person.emailAddress\": \"" + UserAttribute['Email (Standard)'] + "\",\"person.displayName\":\"" + UserAttribute['First Name'] + " " + UserAttribute['Last Name'] + "\",\"person.mobileNumber\":\"" + UserAttribute['Mobile Number (Standard)'] + "\",}\"" %}
{% set base64JsonPayload = passData|base64encode %}
{% set url = projectUrl + "?data=" + base64JsonPayload %}
{% set sig = url|convertToSHA256('0WfoVtZ7MrJSfrHVuiESxZ') %}
{% set longURL = projectUrl + "?data=" + base64JsonPayload + "&sig=" + sig %}
```

[Google](https://developers.google.com/pay/passes/guides/get-started/api-guidelines/button-guidelines) (Android) と [Apple](https://developer.apple.com/wallet/Add-to-Apple-Wallet-Guidelines.pdf) (iOS) それぞれのデザイン仕様に従って、パスの保存ボタンを追加します。

1. テンプレート内に新しい画像を挿入します。
2. File Manager で "Import" をクリックし、URL を選択します。 ![importimage.png](https://mintcdn.com/moengage/7iGV38YjgdBKSU0B/images/partner_22017212132628.png?fit=max\&auto=format\&n=7iGV38YjgdBKSU0B\&q=85\&s=72658f5f96bcdb9a7c7198f5c59d1a74)

参考までに、URL は次のとおりです。

Android の場合:

```text wrap theme={null}
https://messagecontent-public.s3.amazonaws.com/wallet/add-to-wallet-buttons/Save_to_Google_Pay.svg
```

Apple の場合:

```text wrap theme={null}
https://messagecontent-public.s3.amazonaws.com/wallet/add-to-wallet-buttons/Add_to_Apple_Wallet.svg
```

3. 表示する適切な画像を選択します。
4. URL セクションに次のように入力します。

`{{longURL}}`

![Passkit](https://mintcdn.com/moengage/pjxkCVVFj_C6dGcn/images/passkit.png?fit=max\&auto=format\&n=pjxkCVVFj_C6dGcn\&q=85\&s=5e4b2ae4f67f6cd09ab3da6bee11568a)

これで準備は完了です。キャンペーンをテストして確認できます。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.