# Lytics

Pushly は Audience Trigger Webhook を使用して Lytics と統合します。

Lytics での手順ごとの webhook 設定フローについては、以下に従ってください [Lytics のドキュメント](https://docs.lytics.com/docs/webhooks#configuration) を参照しつつ、以下の Pushly 固有の要件を適用してください。

### 前提条件

始める前に、次のものがあることを確認してください:

1. Pushly API キー: 以下を使用して生成します [Pushly の API アクセス管理ドキュメント](https://documentation.pushly.com/pushly-ja/integration-1/api).
2. Pushly の webhook URL: Pushly のアカウントマネージャーが提供します。
3. Lytics のプロファイルスキーマから選択した、ユーザー識別子が一致するもの この識別子は次の条件を満たす必要があります:
   * ユーザーごとに一意である
   * 時間が経っても変わらない
   * プライバシーに配慮している
   * Pushly が照合に使用するのと同じ識別子である

重要: 統合を機能させる前に、どの Lytics プロファイルフィールドを照合に使用するかを Pushly と確認する必要があります。Lytics でどのフィールドを使うべきかわからない場合は、Lytics のアカウントマネージャーにお問い合わせください。

### Pushly 固有の設定

#### Authorization ヘッダー

Webhook がこのヘッダーを送信するように設定します:

```
X-API-KEY: <your Pushly API key>
```

#### Webhook URL

Pushly のアカウントマネージャーから提供された Pushly の webhook URL を使用します。

#### トリガータイプ

Lytics で webhook を Audience Trigger Webhook として設定し、Pushly に受信させたいオーディエンスイベントタイプを選択します:

* 入場
* 退出

また、Lytics がすでに選択したオーディエンスに含まれているユーザーをバックフィルしたい場合は、Existing Users を有効にすることもできます。Lytics はそれらを `entered` イベントとして送信します。

{% hint style="info" %}
統合が期待どおりに機能していることを確認するため、内部ユーザープロファイルでテストを行うまでは Existing Users を有効にしないでください。
{% endhint %}

### エクスポートフィールド

Lytics で Export Fields を設定する際は、以下を含めてください:

* 選択した照合用識別子フィールド
* `segment_events`

これは重要です。Lytics は Export Fields で選択したフィールドのみを送信します。Export Fields を空欄のままにしないでください。

### オプション設定

Lytics は Fields to Trigger もサポートしており、選択したユーザーフィールドが変更されたときに webhook イベントを送信します。これはオプションであり、オーディエンスへの入場・退出イベントとは別です。標準的な Pushly のオーディエンストリガー統合では、通常これは設定不要です。

### 検証

セットアップ後、Lytics で実際のオーディエンスイベントを発生させて統合を検証してください。

これは次の方法で行えます:

* テストユーザーを追加または更新して、そのユーザーをオーディエンスに入場させる
* そのユーザーを削除または更新して、オーディエンスから退出させる

### 完了前に

統合が有効化される前に、照合用識別子として使用される正確な Lytics フィールドを Pushly に提供してください。