Last updated 2024年12月5日

ConversionAttribution

自動変換報告の設定は、Rokt Ads クライアントがキャンペーンのビジネスへの影響を測定するのに役立ちます。Rokt は、変換データを統合するためのさまざまな方法を提供しています。最も正確性が高い方法として、Web SDK または Event API の使用を推奨します。それぞれの方法に関する指示は以下に記載されています。

正確性は低いですが、ファイル転送および手動アップロードを通じた変換報告もサポートしています。

コード不要の変換報告

Shopify ストアのオーナーは、Rokt Shopify アプリをワンクリックでインストールして、変換データの報告を開始できます。Shopify オプションを検討したい場合は、アカウントマネージャーにお問い合わせください。

詳細な統合手順については、Rokt Ads 統合ハブをご覧ください。

Web SDK

Rokt の Web SDK は、ウェブサイトのフロントエンドから自動的に変換を報告できる JavaScript ライブラリです。

Web SDKの追加

あなたのRoktアカウントマネージャーからユニークな統合コードを取得するか、my.rokt.comで自分で生成します。
1. my.rokt.comにログインします。
2. あなたのアカウントをクリックします。
3. Integrationsをクリックします。
4. Set up the Snippetをクリックします。
5. Record conversionsを選択します。
6. Roktがキャンペーンイベントをコンバージョンに正しく一致させるために、顧客識別子を選んでください。生のまたはハッシュ化された（SHA-256）顧客メールアドレスを識別子として使用することをお勧めします。
  注記
  ハッシュ化されたり生のメールの代わりに、識別子としてRokt ID（passbackconversiontrackingid）を使用することもできます。この方法は開発チームにとってより多くの作業が必要ですが、個人を特定できる情報は必要ありません。
7. 関連するデータ属性を追加します。コンテキストデータは、Roktがあなたのビジネスに対して最も効果的なキャンペーンとオーディエンスについて学ぶのに役立ちます。私たちはこれらの学びを使用して、獲得の最適化を行い、将来的にあなたのキャンペーンのパフォーマンスを向上させます。
  あなたの統合コードはこのようになります:

<!DOCTYPE html>
<html lang="en">
<head>
  <!-- メタタグ -->

  <!-- パート #1 - Web SDKを読み込む -->
  <script type="module">
     window.RoktLauncherScriptPromise = new Promise((resolve, reject) => {
        const target = document.head || document.body;
        const script = document.createElement("script");
        script.type = "text/javascript";
        script.src = "https://apps.rokt.com/wsdk/integrations/launcher.js";
        script.fetchpriority = "high";
        script.crossOrigin = "anonymous";
        script.async = true;
        script.id = "rokt-launcher";

        script.addEventListener('load', () => resolve());
        script.addEventListener('error', (error) => reject(error));

        target.appendChild(script);
     });
  </script>

  <!-- 他のスクリプトとメタタグ -->
</head>
<body>
  <!-- あなたのHTMLコンテンツここに -->

  <!-- パート #2 - データ属性が利用可能になるとすぐに、以下のスクリプトを実行してRoktプレースメントを表示します -->
  <script type="module">
    await window.RoktLauncherScriptPromise;

    const launcher = await window.Rokt.createLauncher({
      accountId: "rokt-account-id"
    });

    await launcher.selectPlacements({
      attributes: {
        //顧客識別子 - 少なくとも1つは必要
        email: "john.smith@gmail.com",
        emailsha256: "",
        passbackconversiontrackingid: "",
        firstname: "",
        lastname: "",
        conversiontype: "",
        billingzipcode: "",
        amount: "",
        mobile: "",
        currency: "",
        quantity: "",
        paymenttype: "",
        margin: "",
        confirmationref: "",
      },
    });
  </script>

  <!-- あなたのHTMLコンテンツはここに -->
</body>
</html>

コード例のさまざまな部分の説明は、Web SDK Library documentationで見ることができます。

注意

上記の例をコピーする場合は、次のステップに進む前に rokt-account-id をあなたのアカウントのユニークIDに置き換えることを確認してください。あなたの rokt-account-id は、アカウントマネージャーから取得するか、my.rokt.comから得ることができます。

確認ページに統合コードを追加します。
1. 統合コードは、通常は確認またはお礼のページである、変換イベントの直後に続く任意のページに配置する必要があります。提案された構造に従って、ページのHTMLに直接統合コードを貼り付けます。
2. 統合があなたのサイトのすべての変換を記録することを確認します。その後、RoktがRoktキャンペーンイベントによって発生した変換を特定するためのアトリビューションプロセスを処理できます。
  タグマネージャー
  あなたのサイトにRokt統合コードをタグマネージャーを使用して追加することができますが、いくつかの変換イベントが失われるため、パフォーマンスが低下する可能性があります。最高の結果を得るためには、このページで説明されている直接統合をお勧めします。
データ属性を設定します。少なくとも顧客識別子（メールまたはRokt ID）が正しいデータで設定されていることを確認してください。また、任意のデータ属性も設定します。
1. ハッシュ化されたメールアドレスを識別子として使用したい場合、Roktの事前構築されたハッシュ関数を使用できます。追加情報は、Two Step Data Integration pageで確認できます。
統合が適切に動作し、正しいデータを含んでいるかテストします。テスト手順を参照してください。

最適なパフォーマンスを実現するために、Event APIとWeb SDKの両方を統合することを考慮してください。両方の方法を使用することで冗長性が生まれ、ブラウザやサーバーで発生する可能性のある異常を特定するのに役立ちます。

Event API

Event APIは、Roktとコンバージョンデータを統合しようとする広告主にとって別の選択肢を提供します。Event APIを使用すると、バックエンドサーバーがRoktに安全に接続し、リアルタイムでコンバージョンデータを送信できます。

Event APIをコンバージョンデータのための単独統合として使用することには、いくつかの利点があります：

速度：完全に自動化された、ほぼリアルタイムのデータ交換を可能にし、Roktの自動最適化ツールの潜在能力を最大化します。
カバレッジ：すべてのチャネルとデバイス間でイベントを統合することを許可し、ウェブ、モバイル、店舗でのコンバージョンに対するカバレッジを実現します。
信頼性：サーバー間の統合として、Event APIはブラウザや広告ブロックなどのウェブテクノロジーによる干渉を受けません。また、エラーハンドリングをサポートしており、データが失われることはありません。

イベントAPIを追加する

Roktの my.rokt.com にログインできることを確認し、アカウントIDを取得してください。アカウントがない場合は、アカウントマネージャーにお問い合わせください。
公開鍵と秘密鍵を取得します。この鍵のセットを受け取るには、アカウントマネージャーにお問い合わせください。
イベントAPI用のペイロードを組み立てます。POST /v2/events エンドポイントを使用して、あらゆる種類のコンバージョンイベントをRoktに送信できます。
1. このユースケースでは、常に eventType を conversion に設定して、Roktがコンバージョン帰属プロセスをトリガーできるようにします。
2. objectData に関連するキーと値のペアを含めます。関連するコンテキストデータを提供することで、将来のキャンペーンを最適化するのに役立ちます。
  Roktは、顧客を特定するために、メール（email）、SHA-256ハッシュ化されたメール（emailsha256）、またはRokt ID（passbackconversiontrackingid）のいずれかを少なくとも1つ必要とします。推奨される objectData フィールドは、下の表で確認できます。
完全なエンドポイントリファレンス
イベントAPIの完全なリファレンス詳細を参照してください。

サンプル

POST /v2/events
{
    "accountId": "12345",
    "events": [
        {
            "clientEventId": "ff3bd69c-ca74-4337-af91-4d5d0bd00e38",
            "eventTime": "2020-05-22T10:21:29.339Z",
            "eventType": "conversion",
            "objectData": [
                {
                    "name": "email",
                    "value": "email123@emailserver.com"
                },
                {
                    "name": "transactionid",
                    "value": "123456789"
                },
                {
                    "name": "amount",
                    "value": "99.80"
                },
                  {
                    "name": "currency",
                    "value": "USD"
                },
                {
                    "name": "quantity",
                    "value": "2"
                },
                {
                    "name": "conversiontype",
                    "value": "hotel_booking"
                },
                {
                    "name": "margin",
                    "value": "10"
                },
            ]
        }
    ]

提案された `objectData` フィールド

objectDataオブジェクトは、イベントに関するメタデータを含むキーと値のペアで構成されています。コンバージョンを適切に帰属させるためには、Roktが顧客を識別できるように、objectDataにメールアドレス（email）、SHA-256ハッシュ化されたメールアドレス（emailsha256）、またはRokt ID（passbackconversiontrackingid）のいずれかを含める必要があります。

コンバージョンレポートのユースケースについては、以下の属性を含めることをお勧めします。

フィールド名	説明	例
`email`	プレーンテキストで小文字、かつトレーリングスペースのないメール	`john@email.com`
`emailsha256`	メールアドレスのSHA256ハッシュ。ハッシュ化する前に小文字でトレーリングスペースを除去してください。	`fab1e2e699b3b927cbf875046a64f222` `5df02d5cb306f3857424c2bbb87be61f`
`passbackconversiontrackingid`	Rokt IDとも呼ばれます。コンバージョンイベントを元のクリックにマッチさせるために使用されるRokt生成ID。別の統合が必要です。	`1bc29b36f623ba82aaf6724fd3b16718`
`amount`	取引の値（小数点を許可）	`100.25`
`currency`	通貨コード	`USD`
`quantity`	特定のコンバージョン内のアイテムの数量（整数）	`4`
`conversiontype`	異なるコンバージョンイベントを区別するために使用されます。注: デフォルトのコンバージョンイベントタイプが提供された場合のみ適用されます。	`ticketpurchase`, `seatupgrade`, `signup`
`productname`	購入された商品の名前。複数のアイテムはカンマで区切ることができます。	`Maroon 5 t-shirt, Warriors vs. Raptors`
`sku`	購入された商品の識別子（注: 一つのSKUのみ受け付けます）	`230847`, `tshirt-blue-39487`, `398fhdnff`
`paymenttype`	取引中に使用された支払い方法	`VISA`, `American Express`
`margin`	コンバージョンの利益率	`10`
`transactionid`	ユニークな取引を識別するために使用されるトランザクションID。注: 提供された場合、Roktはこの識別子を使用してチャンネル間のコンバージョンイベントを重複排除します。	`ABC789`
`confirmationref`	確認参照ID。ユニークな取引を識別し、または注文確認を追跡するために使用される代替識別子。注: 提供された場合、Roktはこの識別子を使用してコンバージョンイベントの重複排除を行い、`transactionid`が利用できない場合があります。	`XYZ123`
`firstname`	顧客の名	`John`
`lastname`	顧客の姓	`Smith`
`mobile`	コンバージョン顧客の携帯電話番号	`3053211654`, `+1 (323) 867-5309`
`ipaddress`	顧客のIPアドレス	`172.3.51.182`

カスタム属性

Roktには、提供されたフィールド名を私たちの内部データフィールドにマッピングできるデータマッピングシステムがあります。ただし、この記事の後半で推奨されるフィールド名とフォーマット要件があります。代替フィールド名を使用したい場合は、お知らせください。あなたのフィールドが適切に管理されるようにします。さらに、レポート目的で提供したい追加のフィールドも受け付けることができます。

プレミアム統合: Web SDK と Event API の統合

可能であれば、Web SDK と Event API の両方を通じてコンバージョンレポートを設定することをお勧めします。これにより、異常を特定するのに役立ち、フロントエンドまたはバックエンドに問題が発生した場合の冗長性が提供されます。

両方の統合を設定することを選択した場合は、Web SDK および Event API 統合のいずれかで transactionid または confirmationref のいずれかを入力してください。これにより、Roktはこれらの変数を使用してあなたのコンバージョンイベントの重複を排除し、レポートが正確であることを保証します。

Web SDK​

Web SDKの追加​

Event API​

イベントAPIを追加する​

サンプル​

提案された objectData フィールド​

カスタム属性​

プレミアム統合: Web SDK と Event API の統合​