メインコンテンツまでスキップ

サーバーサイドタグ付け

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

ユースケースの制限事項

サーバーサイドタグ付けは、フロントエンドアプリケーションからの分離により、コンバージョンレポート用の広告主にのみ適用されます

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

広告主は、ループを閉じるために永続的な識別子(例: メールまたはハッシュ化されたメール値)を使用することを強く推奨されます。永続的な識別子を使用すると、Roktはチャネルをまたいで長期間にわたり、元の紹介イベントにコンバージョンをより正確に帰属させることができます。

しかし、PIIなしのコンバージョンレポートが必要な場合は、識別子としてRokt Click ID を使用することについてアカウントマネージャーにご相談ください。

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

sGTM integration swimlanes diagram

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

識別子の位置

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

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

    • 識別子(例:メール、RoktクリックID)は、ランディングページのクライアントサイドのdataLayerにその値をプッシュすることで保持できます。
    • その後、各コンバージョン時に、値をGA4イベントパラメータとして組み込み、それをサーバーサイドコンテナに送るようにします。
  2. [ クライアント → サーバー ] コンバージョン時に、GA4イベントを通じて識別子をサーバーコンテナに送信します。

    • sGTM GA4 Event Config
    • GA4イベントのトリガールールはコンバージョンイベントに結びつけるべきです。
  3. [ サーバーサイド ] GA4クライアントを用いてRCLIDを含むリクエストをクレームします。

  4. [ サーバーサイド ] 入力された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":[]}}
    • sGTM HTTP Request
コンバージョン受取検証

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

コンバージョンレポート API

PII を含まないユースケースの場合、Rokt はコンバージョンレポート用に GET エンドポイント (https://apps.rokt.com/api/conv) も公開しており、以下のクエリパラメーターを期待しています。可能であれば、Event API の方がコンバージョンレポート API よりもセキュリティと柔軟性があるため、推奨されます。

パラメーター定義必須
idあなたの Rokt アカウント ID必須3051387316918867566
passbackconversiontrackingidPII を含まないコンバージョンレポートに使用される32文字の ID必須qjkp3xy7dtf9wvneazc5r2bh8ls1m06g
conversiontype異なるコンバージョンイベントを区別するための文字列任意(複数のイベントを報告しない限り)signup, purchase, freetrial
この記事は役に立ちましたか?