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