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