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

# Amplitudeコホート同期

> Amplitudeで作成したコホートをNotiflyのユーザーグループに同期し、キャンペーンの配信対象にできます。

> [!TIP]
>
> Amplitude連携は、NotiflyのProプランとEnterpriseプランで利用できます。利用できる同期頻度は、[Amplitudeのプラン](https://amplitude.com/docs/data/destinations/syncs)によって異なります。

Amplitudeのコホートを同期すると、Notiflyでユーザーグループとして使えます。Amplitude公式ドキュメントの [Notifly (Cohort Sync)](https://amplitude.com/docs/data/destination-catalog/notifly-cohort-sync) も参照してください。

* カートに商品を残したユーザーに、割引を添えたリマインドを送れます。
* 新機能をまだ試していないユーザーに、アプリ内ポップアップやプッシュ通知で使い方を案内できます。
* 30日以上アプリを開いていないユーザーには、関心に合ったコンテンツや特典、更新情報を数回に分けて送り、再訪を促せます。

## 設定前の確認事項

* AmplitudeのユーザーIDまたは指定したユーザー属性を、Notiflyの `external_user_id` に対応付けます。
* ユーザーを特定するには、AmplitudeとNotiflyの両方でユーザーIDが必要です。匿名ユーザーは同期の対象外です。
* Notiflyではコホートごとに1つのユーザーグループを作成します。新しい送信先を追加して同じコホートを同期すると、Notiflyは既存のユーザーグループをリセットします。同期する前に、新しい送信先でユーザーIDの対応付けを確認してください。

## 1. Notiflyの認証情報を確認する

1. Notiflyコンソールで **設定** > **製品とプロジェクト情報** を開きます。
2. **プロジェクトID** をコピーします。
3. **API認証情報** で **Access Key** をコピーします。**Secret Key** は、発行または更新時に表示されるダイアログからコピーします。発行済みのキーが必要な場合は、社内の開発チームに確認してください。

> [!NOTE]
>
> Secret Keyはサーバー側でのみ管理してください。キーを更新する場合は、事前に社内の開発チームへ連絡してください。

## 2. Amplitudeで送信先を追加する

1. Amplitudeの **Data** で **Catalog** > **Destinations** に進みます。
2. **Cohort** セクションで **Notifly** を選択します。

   > [!NOTE]
   >
   > Notiflyが表示されない場合は、Amplitudeにお問い合わせください。

![Amplitudeのコホート送信先一覧](https://mintcdn.com/notifly/BljWoGqDT6exoK9p/images/i18n/ja/amplitude/amplitude-catalog.png?fit=max\&auto=format\&n=BljWoGqDT6exoK9p\&q=85\&s=056e5aa6f2bbe4f04e93533dc4d7db92)

3. **Name** に送信先の名前を入力します。NotiflyのAccess Keyを **API Key** に、Secret Keyを **Secret Key** に、プロジェクトIDを **Project Id** に貼り付けます。

   > [!NOTE]
   >
   > 発行または更新時のダイアログを閉じると、NotiflyでSecret Keyを再表示できません。既存のキーは社内の開発チームに確認してください。

![AmplitudeでNotiflyをコホートの送信先に設定するダイアログ](https://mintcdn.com/notifly/BljWoGqDT6exoK9p/images/i18n/ja/amplitude/amplitude-connect-notifly-modal.png?fit=max\&auto=format\&n=BljWoGqDT6exoK9p\&q=85\&s=63a001c6730823275dca0be7fb8a5e26)

4. AmplitudeのユーザーIDをNotiflyの `external_user_id` に対応付けます。Amplitudeの定義済みユーザー属性またはカスタムユーザー属性のうち、1つをユーザーIDに指定できます。

> [!NOTE]
>
> 同期するユーザーについて、Amplitudeで選んだ項目の値が、Notiflyの `external_user_id` と一致することを確認してください。

5. **Save** をクリックします。

## 3. コホートを送信する

1. AmplitudeでNotiflyに送信するコホートを開きます。
2. コホートの同期メニューを開き、同期先として **Notifly** を選びます。

![コホートの同期先としてNotiflyを選択](https://mintcdn.com/notifly/BljWoGqDT6exoK9p/images/i18n/ja/amplitude/amplitude-select-notifly-sync.png?fit=max\&auto=format\&n=BljWoGqDT6exoK9p\&q=85\&s=4ff93d26f94ac8a29574a1a0791361ca)

3. **Select an API target to sync to** で作成した送信先を選び、**Next** をクリックします。

![設定済みのNotifly送信先を選択](https://mintcdn.com/notifly/BljWoGqDT6exoK9p/images/i18n/ja/amplitude/amplitude-cohort-sync-type.png?fit=max\&auto=format\&n=BljWoGqDT6exoK9p\&q=85\&s=7c7bffdc31c896ee6f4ce3648b760a93)

4. プランと同期先に応じて、利用できる同期頻度を選びます。
   * **One-Time Sync** は1回だけ同期します。
   * **Scheduled Sync** は1時間ごと、または1日ごとに同期します。
   * **Real-Time Sync** が表示される場合は、1分ごとに更新を送信できます。

![コホートの同期頻度を選択](https://mintcdn.com/notifly/BljWoGqDT6exoK9p/images/i18n/ja/amplitude/amplitude-cohort-sync-cadence.png?fit=max\&auto=format\&n=BljWoGqDT6exoK9p\&q=85\&s=16855fd86229ea7be63fbfad2963b1c3)

> [!NOTE]
>
> 定期同期の初回は、Amplitudeがコホート全体を送信します。2回目以降は、前回の同期から追加されたユーザーと外れたユーザーの情報だけを送信します。

5. **Sync** をクリックして同期を開始します。

## 4. Notiflyでコホートを確認する

同期したコホートを確認するには、Notiflyコンソールで **ユーザー管理** > **ユーザーグループ** を開きます。

![Notiflyのユーザーグループ一覧に表示されたAmplitudeコホート](https://mintcdn.com/notifly/BljWoGqDT6exoK9p/images/i18n/ja/amplitude/notifly-user-group-amplitude.png?fit=max\&auto=format\&n=BljWoGqDT6exoK9p\&q=85\&s=a0914fe9225ec8f478f600e380177c01)

Amplitudeから送信されたコホートは、名前の末尾に `(Amplitude)` が付きます。

![Amplitudeから同期したユーザーグループの詳細](https://mintcdn.com/notifly/BljWoGqDT6exoK9p/images/i18n/ja/amplitude/notifly-user-group-amplitude-details.png?fit=max\&auto=format\&n=BljWoGqDT6exoK9p\&q=85\&s=0cbcfd0b96c9f3e29e5e469028dc9fb2)

> [!WARNING]
>
> Notiflyは、Amplitudeで選んだ項目の値と `external_user_id` が一致するユーザーだけをグループに追加します。
>
> 例えば、Cohort 1にユーザーA、B、Cが含まれているとします。Notiflyに一致する `external_user_id` があるのがAとCだけなら、グループに追加されるのはAとCです。

## よくある質問

> [accordion] コホート同期とイベントストリーミングを併用できますか？
>
> はい。コホート同期とイベントストリーミングは個別に設定でき、両方を同時に利用できます。

> [accordion] 同期後のユーザー数がAmplitudeと異なるのはなぜですか？
>
> Notiflyのユーザーグループに追加されるのは、AmplitudeのIDとNotiflyの `external_user_id` が一致するユーザーだけです。Amplitude側でユーザーIDに使う項目を確認してください。

> [accordion] どのくらいの頻度で同期すればよいですか？
>
> * カートに商品を残したユーザーに早めにリマインドを送る場合は、Amplitudeのプランと同期先で選べる最短の同期間隔を指定します。
> * しばらく利用していないユーザーに再訪を促すキャンペーンでは、プランと同期先が対応していれば、1日1回の同期で十分な場合があります。
>
> 同期間隔を短くすると、ユーザーグループを更新する回数が増えます。Amplitudeの利用量が増える場合もあります。

> [accordion] 複数のコホートを同期できますか？
>
> はい。Amplitudeのコホートごとに、Notiflyで個別のユーザーグループが作成されます。

> [accordion] 同期済みのユーザーグループを手動で編集できますか？
>
> ユーザーグループは自動管理されるため、Notiflyで直接編集することはできません。変更する場合は、Amplitudeでコホートを編集して再同期してください。


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