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 で自分で、ユニークなインテグレーションコードを取得します。
my.rokt.com にログオンします。
あなたのアカウントをクリックします。
Integrations をクリックします。
Set up the Snippet をクリックします。
Record conversions を選択します。
顧客の識別子を選択して、Rokt がキャンペーンイベントをコンバージョンに正しくマッチさせるようにします。識別子として、生またはハッシュ化された(SHA-256)顧客のメールアドレスを使用することをお勧めします。
注記ハッシュ化されたまたは生のメールアドレスの代わりに、識別子として Rokt ID (
passbackconversiontrackingid
) を使用することもできます。この方法は開発チームの手間が増えますが、個人を特定できる情報は必要ありません。関連するデータ属性を追加します。コンテキストデータ は、Rokt があなたのビジネスにとって最も効果的なキャンペーンやオーディエンスについての理解を深めるのに役立ちます。これらの学びを用いて、獲得を最適化し、将来的にキャンペーンをより良くします。
インテグレーションコードは次のようになります:
<!DOCTYPE html>
<html lang="en">
<head>
<!-- メタタグ -->
<!-- Part #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 コンテンツをここに -->
<!-- Part #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 から取得できます。
確認ページに統合コードを追加します。
統合コードを配置するのは、コンバージョンイベントに続くページ、通常は確認またはサンクスページです。ページ上で提案された構造に従ってHTMLに統合コードを直接貼り付けてください。
サイト上のすべてのコンバージョンを統合が記録するようにしてください。それにより、RoktがどのコンバージョンがRoktキャンペーンイベントの結果であるかを判断する帰属性プロセスを処理できます。
タグマネージャータグマネージャーを使用してRokt統合コードをサイトに追加できますが、一部のコンバージョンイベントが除外されるため、パフォーマンスが低下する可能性があります。最高の結果を得るためには、このページで説明されている直接統合を推奨します。
データ属性を入力します。少なくともお客様の識別子(メールまたはRokt ID)が正しいデータで入力されていることを確認してください。また、データ属性を設定してください。
- ハッシュ化されたメールアドレスを識別子として使用したい場合は、Roktの事前構築されたハッシング機能を使用できます。追加情報は データ統合の2ステップページで見つけることができます。
統合が魅力的で正しいデータを含んでいることをテストします。テスト手順を参照してください。 最適なパフォーマンスを実現するために、Event API と Web SDK の両方を統合することを検討してください。両方の方法を使用することで冗長性が生まれ、ブラウザやサーバーで発生する可能性のある異常を特定するのに役立ちます。
Event API
Event API は、Rokt とコンバージョンデータを統合しようとする広告主向けに別のオプションを提供します。Event API を使用すると、バックエンドサーバーが Rokt に安全に接続し、リアルタイムでコンバージョンデータを送信できます。
コンバージョンデータのスタンドアロン統合として Event API を使用することで、複数の利点が得られます:
- スピード: 完全に自動化された、ほぼリアルタイムのデータ交換を実現し、Rokt の自動最適化ツールの可能性を最大限に引き出します。
- カバレッジ: すべてのチャネルとデバイスを横断したイベントの統合を可能にし、Web、モバイル、店頭でのコンバージョンをカバーします。
- 信頼性: サーバー間の統合であるため、Event API はブラウザや広告ブロックなどの Web テクノロジーによる干渉を受けません。エラーハンドリングもサポートしており、データが失われることはありません。
イベントAPIを追加する
Roktのmy.rokt.comにログインし、アカウントIDを取得できることを確認してください。アカウントを持っていない場合は、アカウントマネージャーに連絡してください。
公開キーと秘密キーを取得します。このキーセットを受け取るためには、アカウントマネージャーに連絡してください。
イベントAPIのペイロードを組み立てます。
POST /v2/events
エンドポイントを使用して、あらゆる種類のコンバージョンイベントをRoktに送信できます。このユースケースでは、常に
eventType
をconversion
に設定し、Roktがコンバージョンアトリビューションプロセスをトリガーするようにします。objectData
に関連するキーと値のペアを含めます。関連するコンテキストデータを提供することで、Roktは将来的にキャンペーンをより最適化できるようになります。Roktが顧客を特定できるように、少なくともメール(
email
)、SHA-256 ハッシュ化されたメール(emailsha256
)、またはRokt ID(passbackconversiontrackingid
)のいずれかを必要とします。推奨される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 | 購入された製品の識別子(注意: 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の両方を通じてコンバージョンレポートを設定することをお勧めします。これにより、異常を特定し、フロントエンドまたはバックエンドで問題が発生した場合の冗長性を提供します。
両方の統合を設定する場合は、transactionid
またはconfirmationref
のいずれかをWeb SDKとEvent API統合の両方に入力することを確認してください。Roktはこれらの変数を使用して、入ってくるコンバージョンイベントの重複を排除し、レポートの正確性を保証します。