Moments APIエンジンの管理

アカウントにMoments APIを有効にするには、アカウントマネージャーに連絡してください。

エンジンの作成

エンジンを作成するには、以下の手順を完了します：

1. AudienceStream > Moments APIに移動し、+ New Engineをクリックします。

2. Details画面で、以下のエンジン詳細を設定します：

   • Name: エンジンの名前を入力します。
   • Enable Engine: エンジンをオンとオフに切り替えます。エンジンエンドポイントはデフォルトでオフになっています。エンジンを有効にし、訪問者がアクティブなセッションをログし、システム内でイベントを生成すると、訪問者のデータが利用可能になります。
   • Domain Allow List: このエンドポイントを使用できるドメインを指定します。詳細については、About Moments API > Domain allow listを参照してください。

3. Nextをクリックします。

4. Response画面で、エンジンに含めるオーディエンス、バッジ、属性を選択します。Example Responseパネルを使用して選択を確認できます。

   大きなレスポンスでオーディエンス、バッジ、属性の名前を使用すると、ペイロードサイズが増える可能性があります。
   Select all current and future audiences機能を使用すると、後でオーディエンスが削除された場合でも、エンジンデータをパージするか、データが期限切れになるまでMoments APIエンジンに含まれ続ける可能性があります。

5. Nextをクリックしてエンジンを作成します。

6. Summary画面で、一意のエンドポイントURLを含むエンドポイント詳細を確認します。

7. Doneをクリックします。

訪問者のデータは、エンジンが有効になり、訪問者がアクティブなセッションを持つようになった後に収集されます。

エンジンの編集

エンジンを編集するには、Moments API画面に移動し、更新したいエンジンをクリックします。Edit Engine画面から、エンジンの詳細とレスポンス設定を更新し、エンジンデータをパージし、必要に応じてエンジンをオンとオフに切り替えることができます。

データのパージ

ユーザーがAudienceStreamのオーディエンス、バッジ、属性を削除または名前を変更し、それがエンジンでも使用されている場合、エンドポイントのレスポンスで予期しない結果が発生する可能性があります。これらの場合、エンジンデータをパージすることを検討することがあります。データのパージについての詳細は、About Moments API > Purge Dataを参照してください。

Moments APIは、必要に応じてエンジンデータをパージするための2つの方法を提供します：

1. Moments API画面で、データをパージしたいエンジンの隣にあるアクションメニューをクリックし、Purge Dataを選択します。
2. Edit Engines画面で、スライドアウトアクションからPurge Dataをクリックします。

データパージ後、以前に保存されていた訪問者のデータは利用できなくなります。