サーバーサイドタグ付け
Rokt Ads クライアントは、Google Tag Manager を介してサーバーサイドタグ付けを設定することで、Rokt の Event API を活用してリアルタイムでコンバージョンデータを統合できます。
サーバーサイドタグ付けは、フロントエンドアプリケーションからの分離のため、コンバージョンレポート用に広告主のみに適用されます。
コンバージョンレポート用の識別子
広告主は、永続的な識別子（例: メールまたはハッシュ化されたメールの値）を使用してループを閉じることを強く推奨します。永続的な識別子を使用することで、Rokt は時間の経過とともにチャネルを越えてコンバージョンを元のリファラーイベントにより正確に帰属させることができます。
ただし、PII なしでのコンバージョンレポートが必要な場合は、識別子として Rokt ID を使用することについてアカウントマネージャーに相談してください。
推奨される統合アプローチ
サーバーサイドコンテナからEvent APIを使用してコンバージョンを報告するには、上の図の番号に対応する次のステップが含まれます。
以下のステップ1と2は、クライアントサイドアプリからサーバーサイドコンテナへ、帰属に必要な識別子を最初に渡す必要があることを前提としています。サーバーサイドに既に識別子が存在する場合、これらのステップを省略できます。
[ クライアントサイド ] 選択した識別子をコンバージョンイベントまで保持します。
- 識別子（例：メール、Rokt ID）は、ランディングページでその値をクライアントサイドdataLayerにプッシュすることで保持できます。
- その後、各コンバージョン時にその値をGA4イベントパラメータとして組み込み、サーバーサイドコンテナに送信します。
[ クライアント → サーバー ] コンバージョン時に、識別子をGA4イベントを介してサーバーコンテナに送信します。
- GA4イベントのトリガールールはコンバージョンイベントに結びつけられるべきです。
[ サーバーサイド ] GA4クライアントを使用してRTIDを含むリクエストを取得します。
[ サーバーサイド ] 入ってくるGA4イベント名に基づいて、RoktのイベントAPIエンドポイント(https://api.rokt.com/v2/events)にPOSTリクエストを送信するためのHTTPリクエストタグを条件付きで発火します。APIとの認証やインターフェース、さらに有効なペイロードの構築方法については[Event APIドキュメント](https://docs.rokt.com/developers/api-reference/event-api/)を参照してください。
- 成功した場合、タグは
{"data":{"unprocessedRecords":[]}}という本文が付いた200レスポンスを受け取るべきです。
QAプロセスの一環として、あなたのアカウントマネージャーがRoktによってすべてのコンバージョンが正しく受信されたことを確認します。
コンバージョンレポートAPI
いかなる種類のPIIも含まないユースケースの場合、Roktはコンバージョンレポート用にGETエンドポイント（https://apps.rokt.com/api/conv）を公開しており、以下のクエリパラメータを期待します。可能であれば、セキュリティと柔軟性がより優れているため、コンバージョンレポートAPIよりもEvent APIを優先して使用するべきです。
| パラメータ | 定義 | 必須 | 例 |
|---|---|---|---|
| id | あなたのRoktアカウントID | True | 3051387316918867566 |
| passbackconversiontrackingid | PIIを含まないコンバージョンレポート用の32文字のID | True | qjkp3xy7dtf9wvneazc5r2bh8ls1m06g |
| conversiontype | 異なるコンバージョンイベントを区別するための文字列 | オプション（複数のイベントを報告しない限り） | signup, purchase, freetrial |