> For the complete documentation index, see [llms.txt](https://documentation.pushly.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.pushly.com/pushly-ja/platform/purattofmu/lytics.md).

# Lytics

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

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

### 前提条件

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

1. Pushly API キー: 以下を使用して生成します [Pushly の API アクセス管理ドキュメント](/pushly-ja/integration-1/api.md).
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 に提供してください。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://documentation.pushly.com/pushly-ja/platform/purattofmu/lytics.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
