TikTokの配信と視聴レポート

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

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

メッセージ状態レポートの仕組み [#how-message-status-reporting-works]

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

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

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

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

配信レポート [#delivery-reports]

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

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

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

もっと詳しく知る

配信イベントの受信方法の詳細については、「 TikTok配信レポートの受信」を参照してください。

TikTokメッセージが失敗したり配信されなかったりした場合は、応答ステータスとエラーコードのドキュメントを確認して、考えられる原因と推奨されるアクションを理解してください。

表示されたレポート [#seen-reports]

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

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

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

もっと詳しく知る

視聴イベントの受信方法の詳細については、「 TikTok視聴レポートの受信」を参照してください。

レポートと送信メッセージの関連付け [#correlate-reports-with-outbound-messages]

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

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

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

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

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

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

もっと詳しく知る

TikTokメッセージログの取得を使用してメッセージログを調べます。