サーバーサイド タグ付け

Rokt Ads クライアントは、Google Tag Manager を介してサーバーサイド タグ付けを設定し、Rokt の Event API を活用してリアルタイムでコンバージョンデータを統合できます。

使用例の制限

サーバーサイド タグ付けは、フロントエンド アプリケーションから切り離されているため、コンバージョン レポートの目的で広告主にのみ適用されます

コンバージョン レポート用の識別子

広告主は、ループを閉じるために永続的な識別子（例: メールアドレスやハッシュ化されたメールアドレスの値）を使用することを強く推奨します。永続的な識別子を使用することで、Rokt は時間をかけてチャネルを超えて元のリファラル イベントにコンバージョンをより正確に帰属させることができます。

ただし、PII（個人を特定できる情報）を使用しないコンバージョン レポートが必要な場合は、識別子として Rokt Click ID を使用することについてアカウント マネージャーにご相談ください。

推奨される統合アプローチ

サーバーサイドコンテナからEvent APIを使用してコンバージョンを報告するには、上記の図の番号に対応する以下の手順を実行します。

識別子の位置

以下のステップ1と2では、アトリビューションに必要な識別子をまずクライアントサイドアプリからサーバーサイドコンテナに渡す必要があると仮定しています。識別子が既にサーバーサイドに存在する場合、これらのステップはスキップできます。

1. [ クライアントサイド ] 選択した識別子をコンバージョンイベントに渡します。

   • 識別子（例: email, Rokt Click ID）は、ランディングページでその値をクライアントサイドのdataLayerにプッシュすることで保持できます。
   • その後、各コンバージョン時に、その値をGA4イベントパラメータとして組み込み、サーバーサイドコンテナに送信します。

2. [ クライアント → サーバー ] コンバージョン時に、識別子をGA4イベントを介してサーバーコンテナに送信します。

   • 
   • GA4イベントのトリガールールは、コンバージョンイベントに関連付けられている必要があります。

3. [ サーバーサイド ] RCLIDを含むリクエストをGA4クライアントで取得します。

4. [ サーバーサイド ] 受信したGA4イベント名に基づいて、条件付きでHTTPリクエストタグを発火し、RoktのEvent APIエンドポイント (https://api.rokt.com/v2/events) にPOSTリクエストを送信します。APIの認証およびインターフェースの詳細、また有効なペイロードの構築方法についてはEvent APIドキュメントを参照してください。

   • metaDataオブジェクトにキー/バリューペアを含めることを確認します: { "name": "source", "value": "sgtm" }
   • リクエストが成功した場合、タグは200レスポンスを受け取り、ボディは{"data":{"unprocessedRecords":[]}}となります。
   • 

コンバージョン受信の確認

QAプロセスの一環として、アカウントマネージャーがすべてのコンバージョンがRoktによって正しく受信されたことを確認します。

コンバージョンレポート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