Last updated 2025年4月9日

ConversionAttribution

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

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

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

Shopify ストアのオーナーは、Rokt ショッピングアプリをワンクリックでインストールして、コンバージョンデータのレポートを開始できます。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）顧客のメールアドレスを識別子として使用することをお勧めします。
  注記
  許容される永続的識別子は、メール、名、姓、請求先郵便番号の組み合わせ、または携帯電話番号です。
7. 関連するデータ属性を追加します。コンテキストデータは、どのキャンペーンやオーディエンスがあなたのビジネスにとって最も効果的であるかについて、Rokt にさらに情報を提供します。これらの知見を使って、獲得を最適化し、将来のキャンペーンのパフォーマンスを向上させます。
  あなたの統合コードは以下のようになるでしょう:

<!DOCTYPE html>
<html lang="ja">
<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 ライブラリのドキュメントで見つけることができます。

注意

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

確認ページに統合コードを追加します。
1. 通常、確定イベントに続くページ、典型的には確認ページまたはサンクスページに統合コードを配置する必要があります。提案された構造に従って、ページのHTMLに直接統合コードを貼り付けてください。
2. サイト上のすべての確定を記録するように統合を確実にしてください。これにより、Roktは、Roktキャンペーンイベントからのはしめときを決定することができます。
  タグマネージャー
  サイトにRokt統合コードをタグマネージャーを使用して追加できますが、一部の確定イベントが失われるためパフォーマンスが低下する可能性があります。最良の結果を得るためには、本ページで説明されている直接統合をお勧めします。
データ属性を設定します。少なくとも顧客の識別子（メールまたはRokt ID）が正しいデータで設定されていることを確認してください。また、すべてのデータ属性を設定してください。
1. ハッシュ化メールアドレスを識別子として使用したい場合は、Roktのあらかじめ構築されたハッシュ関数を使用できます。詳細情報はハッシュページで確認できます。
統合が効果的に行われ、正しいデータが含まれているかをテストします。テスト手順を参照してください。

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

イベント API

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

イベント API を独立したコンバージョンデータの統合として使用することで、複数の利点があります：

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

イベント API を追加する

Rokt の my.rokt.com にログインしてアカウント ID を取得できることを確認してください。アカウントを持っていない場合は、アカウントマネージャーに連絡してください。
公開キーとシークレットキーを取得してください。このキーセットを受け取るにはアカウントマネージャーに連絡してください。
イベント API のペイロードを組み立てます。POST /v2/events エンドポイントを使用して、任意の種類のコンバージョンイベントを Rokt に送信できます。
1. このユースケースでは、常に eventType を conversion に設定して、Rokt がコンバージョン帰属プロセスをトリガーするようにします。
2. 関連するキーと値のペアを objectData に含めます。関連するコンテキストデータを提供することで、将来的に Rokt がキャンペーンをより最適化しやすくなります。
  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 によって生成された 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 とイベント API の組み合わせ

可能であれば、Web SDK とイベント API の両方を使用したコンバージョン報告の設定をお勧めします。これにより、異常を特定し、フロントエンドまたはバックエンドに問題が発生した場合にも冗長性が提供されます。

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

Web SDK​

Web SDK を追加​

イベント API​

イベント API を追加する​

サンプル​

推奨される objectData フィールド​

カスタム属性​

プレミアム統合: Web SDK とイベント API の組み合わせ​