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

ConversionAttribution

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

精度は低くなりますが、ファイル転送や手動アップロードによるコンバージョンレポートもサポートしています。

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

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

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

Web SDK​

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

Rokt 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）顧客のメールアドレスを使用することをお勧めします。

      注記

      ハッシュ化または生のメールの代替として、識別子としてRokt ID (passbackconversiontrackingid)を使用することができます。この方法は開発チームの作業が増えますが、個人を特定できる情報は必要ありません。

    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
        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 Library documentation にあります。

注意

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

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

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

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

      タグマネージャー

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

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

    1. ハッシュ化されたメールアドレスを識別子として使用したい場合は、Roktの事前構築されたハッシュ関数を使用できます。詳細は Two Step Data Integration page にあります。

  3. 統合がエンゲージメントを引き起こし、正しいデータを含んでいることをテストします。テスト手順 を参照してください。

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

イベント API​

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

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

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

イベント API の追加​

  1. Rokt の my.rokt.com にログインし、アカウント ID を取得できることを確認します。アカウントをお持ちでない場合は、アカウントマネージャーに連絡してください。

  2. my.rokt.com からアプリ ID とアプリシークレットを取得します。この情報はイベント API を認証するために必要です。資格情報の取得手順を参照してください。

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

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

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

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

    フルエンドポイントリファレンス

    イベント API の完全なリファレンス詳細を参照してください。

POST /v1/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 ID とも呼ばれます。コンバージョンイベントを元のクリックに一致させるために使用される Rokt 生成の 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はこれらの変数を使用して受信するコンバージョンイベントを重複排除し、レポートの正確性を確保します。

この記事は役に立ちましたか？