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

ConversionAttribution

キャンペーンがビジネスに与える影響を測定するために、Rokt Ads クライアントは自動コンバージョンレポートを設定します。Rokt は、コンバージョンデータを統合するためのさまざまな方法を提供しています。最も正確な結果を得るためには、Web SDK または Event API の使用をお勧めします。それぞれの方法の手順は以下に記載されています。

精度は劣りますが、ファイル転送 や 手動アップロード を通じたコンバージョンレポートもサポートしています。

コード不要のコンバージョンレポート

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

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

Web SDK​

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

Web SDKの追加​

  1. Roktアカウントマネージャーからユニークな統合コードを取得するか、my.rokt.comで自分で生成します。

    1. my.rokt.comにログインします。

    2. アカウントをクリックします。

    3. Integrationsをクリックします。

    4. Set up the Snippetをクリックします。

    5. Record conversionsを選択します。

    6. Roktがキャンペーンイベントをコンバージョンに正しくマッチングできるように、顧客識別子を選択します。識別子として生のまたはハッシュ化された（SHA-256）顧客のメールアドレスを使用することをお勧めします。

      注記

      許容される永続的な識別子は、メール、名前と姓および請求先郵便番号の組み合わせ、または携帯電話番号です。

    7. 関連するデータ属性を追加します。コンテキストデータは、Roktがあなたのビジネスに最も効果的なキャンペーンとオーディエンスについて学ぶのに役立ちます。これらの学びを使用して、獲得を最適化し、将来のキャンペーンのパフォーマンスを向上させます。

      統合コードは次のようになります:

<!DOCTYPE html>
<html lang="en">
<head>
  <!-- Meta tags -->

  <!-- Part #1 - Load the 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>

  <!-- Other scripts and meta tags -->
</head>
<body>
  <!-- Your HTML content here -->

  <!-- Part #2 - As soon as the data attributes are available, execute the below script to display a Rokt placement -->
  <script type="module">
    await window.RoktLauncherScriptPromise;

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

    await launcher.selectPlacements({
      attributes: {
        //customer identifier - at least one required
```html
        email: "john.smith@gmail.com",
        emailsha256: "",
        passbackconversiontrackingid: "",
        firstname: "",
        lastname: "",
        conversiontype: "",
        billingzipcode: "",
        amount: "",
        mobile: "",
        currency: "",
        quantity: "",
        paymenttype: "",
        margin: "",
        confirmationref: "",
      },
    });
  </script>

  <!-- Your HTML content here -->
</body>
</html>

コード例の各部分の説明はWeb SDKライブラリのドキュメントにあります。

注意

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

  1. 確認ページに統合コードを追加します。

    1. 統合コードは、通常、コンバージョンイベントの直後に続く確認ページやサンキューページに配置する必要があります。提案された構造に従って、ページのHTMLに直接統合コードを貼り付けてください。

    2. サイト上のすべてのコンバージョンが記録されるようにしてください。Roktはその後、Roktキャンペーンイベントから生じたコンバージョンを特定するためのアトリビューションプロセスを処理できます。

      タグマネージャー

      タグマネージャーを使用してサイトにRokt統合コードを追加することもできますが、一部のコンバージョンイベントが失われるため、パフォーマンスが低下する可能性があります。最良の結果を得るには、このページで説明されている直接統合をお勧めします。

  2. データ属性を入力します。少なくとも顧客識別子（メールまたはRokt ID）が正しいデータで入力されていることを確認してください。また、任意のデータ属性を設定します。

    1. ハッシュ化されたメールアドレスを識別子として使用したい場合は、Roktの事前構築されたハッシュ関数を使用できます。追加情報はハッシュページで見つけることができます。

  3. 統合が有効で正しいデータを含んでいることをテストします。テスト手順を参照してください。

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

### イベントAPI \{#event-api}

イベントAPIは、Roktとコンバージョンデータを統合したい広告主に別のオプションを提供します。イベントAPIを使用することで、バックエンドサーバーがRoktのサーバーと安全に接続し、リアルタイムでコンバージョンデータを送信できます。

コンバージョンデータの単独の統合としてイベントAPIを使用することには、以下のような複数の利点があります：

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

#### イベントAPIの追加

1. Roktの[my.rokt.com](https://my.rokt.com)にログインし、[アカウントIDを取得](#account-id)できることを確認してください。アカウントをお持ちでない場合は、アカウントマネージャーにお問い合わせください。

2. 公開鍵と秘密鍵を取得してください。このキーセットを受け取るには、アカウントマネージャーにお問い合わせください。

3. イベントAPI用のペイロードを組み立てます。`POST /v2/events`エンドポイントを使用して、あらゆるタイプのコンバージョンイベントをRoktに送信できます。

   1. このユースケースでは、常に`eventType`を`conversion`に設定し、Roktがコンバージョン帰属プロセスをトリガーするようにします。

   2. `objectData`に関連するキーと値のペアを含めます。関連するコンテキストデータを提供することで、Roktは将来的にキャンペーンをより最適化できます。

      Roktが顧客を識別できるように、少なくともメールアドレス（`email`）、SHA-256ハッシュ化されたメールアドレス（`emailsha256`）、またはRokt ID（`passbackconversiontrackingid`）のいずれかを含める必要があります。推奨される`objectData`フィールドは、[以下の表](#suggested-objectdata-fields)に記載されています。

   :::note[フルエンドポイントリファレンス]

   [イベントAPI](/developers/api-reference/event-api)のフルリファレンス詳細を表示します。

   :::

#### サンプル

```JSON
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
passbackconversiontrackingidRokt Click ID とも呼ばれます。コンバージョンイベントを元のクリックにマッチさせるために使用される Rokt が生成した Click ID。 別の統合 が必要です。1bc29b36f623ba82aaf6724fd3b16718
amount取引の金額（小数点を許可）100.25
currency通貨コードUSD
quantity特定のコンバージョン内のアイテムの数量（整数）4
conversiontype異なるコンバージョンイベントを区別するために使用されます。注意: デフォルトのコンバージョンイベントタイプが提供されている場合にのみ適用されます。ticketpurchase, seatupgrade signup
productname購入された製品の名前。複数のアイテムをカンマで区切ることができます。Maroon 5 t-shirt, Warriors vs. Raptors
sku購入された製品の識別子（注: 1つの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はこれらの変数を使用して受信したコンバージョンイベントを重複排除し、レポートの正確性を確保します。

この記事は役に立ちましたか？
Last updated Oct 29, 2025