TikTokの配信と視聴レポート

このページでは、NTT CPaaSを通じて送信されたアウトバウンドTikTokメッセージの配信状況と表示状況を追跡する方法について説明します。

配信レポートと表示レポートは Webhook を介してシステムに配信され、メッセージのステータスとユーザー操作を監視できます。

---

メッセージ状態レポートの仕組み

アウトバウンドTikTokメッセージを送信すると、NTT CPaaSはリクエストに一意のメッセージ識別子を割り当てます。

メッセージが配信ライフサイクルを進めると、NTT CPaaS は 設定済みの Webhook エンドポイント にステータス更新を送信します。

メッセージステータスレポートには、次のものが含まれます。

• 配信レポート
• 表示されたレポート

---

配信レポート

配信レポートは、アウトバウンドTikTokメッセージが正常に配信されたか失敗したかを示します。これらを使用して、メッセージの成功を監視し、配信の問題を特定できます。

配信イベントが発生すると(メッセージがTikTokプラットフォームに配信された場合、または配信できずに失敗した場合)、NTT CPaaSは配信レポートをWebhookエンドポイント(/tiktok/api#configure-event-subscriptions)に送信します。

配信レポートを受け取るには、TikTok APIの設定中に配信イベントのサブスクリプションを設定してください。

---

表示されたレポート

表示されたレポートは、TikTokユーザーがアウトバウンドメッセージをいつ閲覧したかを示し、メッセージに対するユーザーのやり取りを理解するのに役立ちます。

ユーザーがメッセージを閲覧すると、NTT CPaaSはWebhookエンドポイントにレポートイベントを送信します。

表示されたレポートを受け取るには、TikTok APIの設定中に表示されたイベントのサブスクリプションを構成します。

---

レポートと送信メッセージの関連付け

配信レポートと表示レポートの両方に、メッセージの送信時に割り当てられたメッセージ識別子が含まれます。

この識別子を使用して、次のことを行います。

• レポートをアウトバウンド メッセージに一致させる
• システムのメッセージステータスを更新する
• メッセージ ライフサイクル イベントの追跡

TikTokのアウトバウンドメッセージには有効期間が制限されています。

サポートされている有効期間内に配信されなかったメッセージは送信されず、それらのメッセージに対して表示レポートは生成されません。

delivery reports を使用して、配信前に期限切れになるメッセージを検出します。

---

---