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

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. キャンペーンイベントを変換に正しくマッチングするための顧客識別子を選択します。識別子として、生のメールアドレスまたはハッシュ化（SHA-256）されたメールアドレスを使用することをお勧めします。

      注記

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

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

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

<script type="module">
  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";
  target.appendChild(script);
  await new Promise((resolve) =>
    window.Rokt
      ? resolve()
      : document
          .getElementById("rokt-launcher")
          .addEventListener("load", () => resolve())
  );

  const launcher = await window.Rokt.createLauncher({
    accountId: "roktAccountId",
  });

  await launcher.selectPlacements({
    attributes: {
      //customer identifier - at least one required
      email: "john.smith@gmail.com",
      emailsha256: "",
      passbackconversiontrackingid: "",

      //推奨されるコンテキスト属性
      firstname: "",
      lastname: "",
      conversiontype: "",
      amount: "",
      currency: "",
      quantity: "",
      paymenttype: "",
      margin: "",
      confirmationref: "",
    },
  });
</script>

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

注意

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

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

    1. 統合コードは、通常は確認ページまたはお礼のページに続くページに直接HTMLの<head></head>タグの間に貼り付ける必要があります。統合コードをページに直接貼り付けます。

    2. 統合がサイト上のすべての変換を記録するようにしてください。Roktは、Roktキャンペーンイベントからどの変換が生じたかを判断するための帰属プロセスを処理できます。

      タグマネージャー

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

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

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

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

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

イベントAPI​

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

コンバージョンデータのスタンドアロン統合としてイベントAPIを使用すると、以下の利点があります：

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

イベントAPIの追加​

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

  2. my.rokt.comからApp IDとApp Secretを取得してください。イベントAPIを認証するためにこの情報が必要です。資格情報の取得手順を参照してください。

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

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

    2. objectDataに関連するキーバリューペアを含めてください。関連するコンテキストデータを提供することで、Roktは将来のキャンペーンをより良く最適化することができます。

      Roktは、少なくとも1つのメール（email）、SHA-256ハッシュ化されたメール（emailsha256）、またはRokt ID（passbackconversiontrackingid）のいずれかを必要とします。これにより、Roktが顧客を識別できます。提案される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 オブジェクトは、イベントに関するメタデータを含むキーと値のペアで構成されています。変換を正しく帰属させるためには、objectData にメールアドレス (email)、SHA-256 ハッシュ化されたメールアドレス (emailsha256)、または Rokt ID (passbackconversiontrackingid) のいずれかを含める必要があります。これにより、Rokt が顧客を識別できます。

変換レポートのユースケースでは、以下の属性を含めることを推奨します。

フィールド名説明例
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とイベントAPIの組み合わせ​

可能であれば、Web SDKとイベントAPIの両方を使用して変換レポートを設定することをお勧めします。これにより、フロントエンドまたはバックエンドに問題がある場合に異常を特定し、冗長性を提供できます。

両方の統合を設定する場合は、Web SDKとイベントAPIの両方でtransactionidまたはconfirmationrefのいずれかを入力することを確認してください。Roktはこれらの変数を使用して受信する変換イベントを重複排除し、報告が正確であることを保証します。

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