リファラルデータへのアクセス
あなたはいつでも、Roktを介してリファラルデータにアクセスすることができます。これは、あなたとあなたのビジネスに最も適した方法で行うことができます。これには以下のオプションがあります：
メタデータ
以下の表には、Roktのキャンペーンタイプの両方において、顧客がキャンペーンにオプトインした後に、利用可能であれば広告主がリクエストしたアクセス可能なデータ属性のリストが含まれています。ただし、広告主はいかなる状況でもパートナーデータにアクセスすることはありません。
利用可能な属性のリストは、オファーが表示されたパートナーサイトによって異なる場合があります。
| 属性 | データ形式 | 説明 | 例 |
|---|---|---|---|
| ZIP/郵便番号 | 整数 | 顧客のZIPコードまたは郵便番号 | 10010 |
| 国 | テキスト | 顧客の国 | Australia |
| 性別 | テキスト | 顧客の性別 | Male |
| 年齢 | 整数 | 顧客の年齢 | 25 |
| 日付/時刻 | 日付/時刻 | 顧客がオファーにオプトインした日時 | 43765.07083 |
| 州 | テキスト | 顧客の州 | CA |
| 郊外 | テキスト | 顧客の都市 | Seattle |
| 入札価格 | 小数 | クライアントが紹介に対して請求された金額 | 2.50 |
| 誕生日 | 日付/時刻 | 顧客の誕生日 | 33569 |
| 広告の応答 | テキスト | 顧客がオファーにオプトインするためにクリックした肯定的な応答テキスト | Yes, please |
| 広告テキスト | テキスト | 顧客に提示されたオファーテキスト | Receive a call today to hear about our great value. |
| 広告テキスト（HTML） | テキスト | HTML形式のオファーテキスト | <p>Receive a call today to hear about our great value.<p> |
| オーディエンスID | 整数 | 顧客が所属していたオーディエンスのRokt内部識別子 このIDの長さと形式は変更される可能性があります。 | 2581697744617019994 |
| オーディエンス名 | テキスト | 顧客が所属しているオーディエンスの名前 | M/F: 25+ |
| ブラウザ | テキスト | 顧客のブラウザ | Chrome Mobile |
| ブラウザバージョン | 整数 | 顧客のブラウザバージョン（メジャーリリース） | 52 |
| ブラウザバージョン（フル） | 小数 | 顧客のブラウザバージョン（メジャーおよびマイナーリリース情報を含む） | 52.109 |
| キャンペーンID | 整数 | 顧客がオプトインしたオファーのRokt内部識別子 このIDの長さと形式は変更される可能性があります。 | 1112223334445556667 |
| キャンペーン名 | テキスト | 顧客がオプトインしたオファーの名前 | Brand name, Rokt, Hybrid, 2019 |
| 国コード | テキスト | 顧客の国（ISOの2桁形式） | AU |
| クーポンコード | テキスト | 顧客に発行されたクーポンコード（キャンペーンにクーポンが含まれている場合のみ適用） | ROKT1234 |
| クリエイティブID | 整数 | 顧客がオプトインしたクリエイティブのRokt内部識別子 このIDの長さと形式は変更される可能性があります。 | 2.26E+18 |
| 日付/時刻（UTC） | 日付/時刻 | 顧客がオファーにオプトインした日時（UTCタイムゾーン） | 43765.2375 |
| デバイス | テキスト | 顧客がオファーにオプトインしたときのデバイスプラットフォーム | Mobile |
| デバイスメーカー | テキスト | 顧客がオファーにオプトインしたデバイスの製造元 デバイスがMobileの場合にのみ適用されます。 | Samsung |
| 環境 | テキスト | パートナーのウィジェットが表示された環境 | Purchase |
| エクスペリエンス | テキスト | パートナーのウィジェットが表示されたエクスペリエンス | Overlay |
| 配置 | テキスト | 顧客がオプトインしたオファーの配置 | Prime |
| リファラルタイプ | テキスト | 顧客がオプトインしたオファーのリファラルタイプ | Email |
| Rokt識別子 | テキスト | 特定のリファラルのためのRokt内部識別子 このIDの長さと形式は変更される可能性があります。 | aa169abb-6552-3638-82b1-224b389fce5b |
リファラルエクスポートテンプレートとカスタムフィールド
このオプションは、メールとSFTPリファラルエクスポートオプションと併用して使用できます。
以下の手順に従って、リファラルエクスポートのテンプレートを作成および管理できます。
テンプレートの作成
左のナビゲーションメニューからキャンペーン > 顧客データページに移動し、リファラルタブにいることを確認します。
テンプレートドロップダウンメニューからカスタムテンプレートを作成を選択します。
- カスタムテンプレートの名前を入力します。
- テンプレートに必要なフィールドを選択します。
- テンプレート内のフィールドを必要に応じて並べ替えます。
- 保存をクリックします。
- テンプレートのドロップダウンメニューから新しいカスタムテンプレートを選択します。
テンプレートの編集
編集したいカスタムテンプレートを選択します。
既存のテンプレートを編集 をクリックします。
既存のカスタムテンプレートにフィールドを追加または削除します。
テンプレート内のフィールドを希望の順序で並べ替えます。
保存 をクリックします。
テンプレートのドロップダウンから新しいカスタムテンプレートを選択します。
カスタムフィールド
リファラルのエクスポート用にカスタムフィールドを作成するには、次の手順を実行してください：
左側のナビゲーションメニューから、キャンペーン > 顧客データに移動し、リファラルタブにいることを確認します。
フィールドをカスタマイズをクリックします。
新しいカスタムフィールドをクリックします。
変換するフィールドを選択し、カスタムフィールドの名前を入力します。
条件を選択します：等しいまたは含む。
マッピングしたい値と新しいフィールド名を入力します。
カスタムフィールドが空の場合の処理方法を選択します。
一致が見つからない場合のデフォルト値を選択します。
保存をクリックします。
APIを介して
当社のデータ管理プラットフォームでは、キャンペーンの紹介データに安全にアクセスする機能を提供しています。人気のあるオプションの1つは、APIを介して直接CRMと統合することです。
APIは、Roktが紹介データを効率的に提供する最も効果的な方法です。これは、リアルタイムで動作するため、キャンペーンのために紹介が生成されるとすぐにRoktがリードを通知できるということです。以下に、これを完了するために必要ないくつかの技術的な要素があります。
要件
APIのセットアップを開始するには、Roktはいくつかの情報が必要です。
以下の詳細は、アカウントマネージャーに送信してください：
- システム内でサブスクライバーを作成する方法に関する完全なAPIドキュメント。
- セットアップのクエリのトラブルシューティングを支援するための技術連絡先の詳細。
- 関連する環境（本番、テスト、ステージングなど）のエンドポイント。
- メソッド（例：GET、POST、PUT）。
- 認証（あれば）。
- リクエストボディのエンコーディング（例：JSON、XML、URLエンコード）。
- 必須のAPIパラメータ（Roktが共有できる属性について学ぶ）。
- Roktが正確にリードを正常に配信したものと拒否したものを分類するのに役立つ予想されるAPIレスポンス。
APIドキュメント
APIドキュメントは、以下の要件のいくつかまたはすべてを含むことがあります：
- エンドポイント
- メソッド
- リクエストボディ
これにより、Roktがリードをシステムに配信する方法が詳細に説明されます。
APIドキュメントと技術担当者の連絡先があれば、APIのセットアッププロセスを開始するのに十分です。
APIドキュメントの良い例として、Mailchimp APIドキュメントを参照してください。
技術担当者の連絡先詳細
APIのセットアッププロセスに関する質問に対応できる関連する連絡先（あなた自身またはチームの他のメンバー）を提供してください。
技術担当者は以下のことに対応できるはずです：
- テストリードがシステムに正常に記録されているか確認すること
- レスポンスステータスが403である理由を説明すること
例：
John Smith
技術サポート
エンドポイント
これは、Roktがデータを配信する場所です。ステージングやテスト用のエンドポイントがある場合、これはセットアップおよびテストプロセス中のRoktチームに役立ちます。これにより、テストリードがライブCRMに配信されないようになります。
例:
https://us9.api.mailchimp.com/3.0/lists/abcdefghij/members
メソッド
これは、Roktがデータをリストに配信するために使用するHTTPリクエストの種類です。ほとんどの場合、これはPOSTリクエストです。
Roktは以下の送信メソッドをサポートしています:
- GET
- POST
- PUT
認証
RoktがAPIを呼び出すために必要な認証の詳細を提供してください。これには、次のような形式があります：
- ユーザー名とパスワードの組み合わせ
- APIキー
- クライアントIDとシークレット
APIパラメータ
Roktが各APIリクエストに含めるためのパラメータのリストを提供してください。可能であれば、次のことを指定してください：
- 必須属性（リクエストが成功するために送信する必要がある属性）
- オプションの属性
- 各属性のパラメータ名（例えば、
firstname、FirstName、またはfirst-nameのどれを使用するか）
一般的な属性には次のものがあります：
- メール
- 名
- 姓
- ソース
- 国
参考のために、Roktはこれらの属性のいずれかを共有できます。
Roktは次のボディエンコーディングをサポートしています：
- JSON
- URLエンコード
- プレーンテキスト
- XML
予想されるAPIのレスポンス
Roktは、可能なAPIのレスポンスのリストを提供することで、配信に成功したリードと、配信に失敗したか重複としてラベル付けされたリードを迅速に特定するためのレスポンス処理ロジックを設定できます。
レスポンス処理は、受け取ったステータスコードまたはレスポンスボディに基づいて作成することができます。これは、APIの設定によって異なります。
例えば、以下のようなステータスコードがあります：
- 201（リードが正常に作成されました）
- 400（認証されていません）
- 500（サーバーエラー）
また、以下のようなレスポンスボディの値があります：
"successfully delivered"{"status": "duplicate"}{"success": false}
以下に説明されているAPIの設定プロセスを完了するために、Roktのアカウントマネージャーと連携してください。
API接続の設定
One Platformにログインし、ホームページでアカウントをクリックします。
左のナビゲーションメニューでIntegrations > Connectionsページに移動します。
Add connectionをクリックします。
Referralsの下で、APIをクリックします。
接続に名前を付けます。
接続のエンドポイントを入力します。
Authorization、Headers、Bodyの下に必要な情報をすべて入力します。
Response handlingのルールをすべて入力します。
API接続のテスト
API接続が設定されたら（エンドポイント、認証、ヘッダー、ボディ、およびレスポンスの処理）、設定をクリックします。
テストの設定をテストの基準に従って編集します。
保存をクリックします。
テストをクリックします。
テスト結果を確認します。
必要な結果が得られるまでテストを繰り返します。
API接続にキャンペーンをリンクする方法
リアルタイム紹介 ページに移動します。
リンクしたい接続を展開します。
リンクされていないものを表示 をクリックします。
接続にリンクしたいキャンペーンを見つけ、リンク をクリックします。
キャンペーンが接続にリンクされました。
API接続からキャンペーンのリンクを解除する方法
リアルタイム紹介ページに移動します。
リンクを設定したい接続を展開します。
接続からリンクを解除したいキャンペーンを見つけ、リンク解除をクリックします。
リンク解除済みを表示をクリックします。
キャンペーンが接続から正常にリンク解除されたことを確認します。
SFTP経由で
セキュアファイル転送プロトコル（FTP）接続を使用すると、紹介の配信を自動化し、設定にはほとんど努力が必要ありません。必要なのはSFTPの資格情報だけです。
SFTP接続を設定すると、新しい紹介と関連するメタデータが含まれた.csvファイルが定期的にメールで受け取れます。
自分自身のSFTP接続を使用するか、Roktの接続を使用することもできます。
RoktのFTP接続
開始する前に
Rokt SFTPにアクセスできることを確認してください。できない場合は、アカウントマネージャーに連絡してアクセスを設定してもらってください。
Rokt SFTPへの接続を設定する前に、以下の情報を準備しておく必要があります：
- 配信頻度 - 紹介をSFTPサーバーにアップロードする頻度と時間。
- 必要なパラメーター - メール、名前、姓、ソース、州などが一般的です。Roktが提供できるメタデータについて詳しくはこちらをご覧ください。
ホストコンピューター（例：ラップトップ）からセキュアFTPサーバーへの接続を確立するには、サードパーティのクライアントソフトウェアが必要です。このチュートリアルでは、Windows、Mac、Linuxのオペレーティングシステムで利用可能な人気のある無料クライアントソフトウェアであるFileZillaを使用することをおすすめします。
- ブラウザでhttps://filezilla-project.org/にアクセスし、**FileZilla Clientをダウンロード**をクリックします。
- FileZillaをコンピューターにインストールします。すでにFileZillaがインストールされている場合は、最新バージョンを実行していることを確認してください。
- Roktアカウントマネージャーに連絡して、Rokt SFTPへのアクセスをリクエストします。アクセスが許可されると、Roktから「RoktのSFTPサーバーへのアクセスが許可されました」という件名のメールが届くはずです。
- 添付ファイルをダウンロードし、2番目のメール「指示のためのファイルのパスワードのメール」で提供されたパスワードを使用して暗号化されたファイルを解凍します。
- 解凍した暗号化ファイルには、RoktのSFTPフォルダにアクセスするためのキーファイルである
.pemファイルが含まれています。
以下の手順は、Windows、Mac、Linuxのオペレーティングシステムにおいて同じであり、最新バージョンのFileZillaを基にしています。
- FileZillaを開き、「ファイル > サイトマネージャー」に移動します。
- 左側で新しいサイトをクリックし、以下の情報を入力します：
プロトコル: SFTP - SSHファイル転送プロトコル
ホスト: ftp.rokt.com
ポート: 22
キーファイル: ローカルのキーファイル（
.pem）に移動し、ローカルドライブから選択します（以下の画像を参照）。
- 接続をクリックします。接続が確立され、アップロードするフォルダが表示されます。
ファイルパスと要件
紹介ファイルは次のファイルパスに配置されています。
| ファイルパス | 目的 |
|---|---|
| /downloads | Roktによって提供された紹介データをダウンロードする |
紹介ファイルは、このフォルダから14日後に自動的に削除されます。
独自のSFTP接続を使用する
接続の確立
One Platformにログインし、ホームページでアカウントをクリックします。
左側のナビゲーションメニューからIntegrations > Connectionsページに移動します。
Add connectionをクリックします。
Referralsの下でFTPを選択します。
この接続のCampaignとTemplateを選択し、接続に名前を付けます。
Directory and file nameを入力します。
FTPサーバーのホストの詳細とポートを入力します。
希望のFTPメソッドを選択します。
ユーザー名とパスワードを入力するか、SFTPを使用する場合はユーザー名を入力し、キーファイルをアップロードします。
スケジュールを選択し、Saveをクリックします。
接続が作成されました。#### FTP接続の無効化
接続タブに移動し、左側のドロップダウンメニューからスケジュールを選択します。
アクションの下で、一時停止アイコンをクリックします。
接続が無効になります。
接続を有効にするには、これらの手順を逆に行います。
メール経由での配信
Roktは、紹介ファイル（.csv形式）をメールで配信することができます。この方法はセキュリティが低く、メールアカウントからファイルを手動でダウンロードする必要がありますが、One Platformからの紹介データを取得するための便利な方法です。将来的にはSFTPまたはAPIソリューションに切り替えることもできます。
開始する前に
メール配信の設定には、次の情報のみが必要です：
- 紹介が配信されるメールアドレス（または複数のメールアドレスのリスト）。
- 配信頻度 - いつ、どのようなタイミングで紹介メールを受け取りたいかを指定します。
- 必要なパラメータ - メール、名前、姓、ソース、および州などが一般的です。Roktが提供できる属性について詳しくはこちらをご覧ください。
メール接続の設定
One Platformのアカウントに移動します。
左のナビゲーションでIntegrations > Connectionsに移動します。
接続を追加をクリックします。
リファラルの下で、メールをクリックします。
この接続のキャンペーンとテンプレートを選択します。
- 接続に名前を付けて、次へをクリックします。
- 宛先のメールアドレスを入力し、次へをクリックします。
- 希望するスケジュールを選択し、保存をクリックしてメール接続を作成します。
- リンクされたキャンペーンのためにメール接続が作成されました。
メール接続の無効化
左側のナビゲーションメニューから、Integrations > Connections ページに移動し、ドロップダウンメニューから Scheduled を選択します。
一時停止アイコンをクリックします。
3. メール接続が無効になります。
- これらの手順を逆に行うと、接続を有効にすることができます。
メールチンプ経由
メールチンプとRoktを統合することができます。メールチンプは、eコマース企業を専門としたメールサービスプロバイダーおよびマーケティングオートメーションプラットフォームです。これにより、Mailchimp CRMデータを可能な限り最新の状態に保つことができます（Roktは新しい紹介を5分ごとに投稿します）。そのため、キャンペーンの戦略立案により多くのエネルギーを注ぎ、管理にはそれほど時間を費やす必要がありません。
MailchimpからAPIキーを取得する方法
Mailchimpアカウントにログインします。右上隅にある名前をクリックします。ドロップダウンメニューからプロフィールを選択します。
エクストラのドロップダウンメニューに移動し、APIキーを選択します。
既に作成したAPIキーを使用するか、キーを作成をクリックして新しいAPIキーを作成することができます。
- Mailchimpが生成したAPIキーをメモしておきます。
Roktのアカウントマネージャーに連絡してセットアップを完了させます。
手動で
あなたのデータは常にRoktプラットフォームでアクセス可能です。これは、特定の期間内のすべての紹介を確認したい場合や、アドホックなトラブルシューティングを行う必要がある場合に便利です。
既存の接続に何か問題が発生した場合（APIの障害や削除されたメールなど）、心配しないでください！いつでもRoktプラットフォームにログインしてキャンペーンの紹介データをダウンロードすることができます。
Roktプラットフォーム内で紹介データにアクセスするための設定は簡単で直感的です：
- アカウントマネージャーにアクセスを希望することを伝え、招待状をメールアドレスに送ってもらいます。
- プラットフォームにログインし、ホームページでアカウントをクリックします。
- 左側のナビゲーションメニューでキャンペーン > カスタマーデータに移動します。
- 紹介タブで、表示したい時間範囲、キャンペーン、またはデータ属性などのフィルタを選択します。
- エクスポートをクリックしてデータをダウンロードします。紹介ファイルのダウンロードを待つことなく、メール経由でエクスポートも選択できます。Roktは完了後に
.csvファイルをメールで送信します。
一度にダウンロードできるレコード数は最大100,000件です。
::