RapidMiner からFacebook Ads データに連携

こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。

この記事では、CData JDBC Driver for FacebookAds をRapidMiner のプロセスと簡単に統合する方法を示します。この記事では、CData JDBC Driver for FacebookAds を使用してFacebook Ads をRapidMiner のプロセスに転送します。

RapidMiner のFacebook Ads にJDBC Data Source として接続する

以下のステップに従ってFacebook Ads へのJDBC 接続を確認できます。

1. Facebook Ads 用の新しいデータベースドライバーを追加します。［Connections］->［Manage Database Drivers］とクリックします。
2. 表示されるウィザードで［Add］ボタンをクリックし、接続に名前を入力します。
3. JDBC URL のプレフィックスを入力します。 jdbc:facebookads:
4. インストールディレクトリのlib サブフォルダにあるcdata.jdbc.facebookads.jar ファイルにパスを入力して下さい。
5. ドライバークラスを入力します。 cdata.jdbc.facebookads.FacebookAdsDriver
6. 新しいFacebook Ads 接続を作成します。［Connections］->［Manage Database Connections］とクリックします。
7. 接続の名前を入力します。
8. データベースシステムの場合は、以前構成したFacebook Ads ドライバーを選択します。
9. Host ボックスで接続文字列を入力します。

   Facebook Ads 接続プロパティの取得・設定方法

   ほとんどのテーブルで、アプリケーション認証と同様にユーザー認証を必要とします。Facebook Ads はユーザー認証にOAuth 標準を使用しています。Facebook への認証には、組み込み認証を使用してブラウザ経由で完結することもできますし、Facebook にアプリを登録することで独自のOAuthClientId、OAuthClientSecret、CallbackURL を取得することもできます。

   の設定方法については、ヘルプドキュメントの「OAuth」セクションを参照してください。

   任意で以下の項目を設定して、フィルタリングや集計を行うもできます。必要に応じてご利用ください。

   • Target：Facebook データのテーブルのいくつかはターゲットでフィルタリングできます。例えば、動画のコメントを取得するにはターゲットに動画のID を指定します。このプロパティは、クエリ結果を指定されたターゲットに合致するレコードにフィルタリングします。Target カラムを使ってクエリ毎にこの制限をかけることができます。
   • AggregateFormat：CData 製品は、いくつかのカラムを文字列集合として返します。例えば、エンティティのいいねデータは集計されて返されます。デフォルトでは、CData 製品はJSON で集計カラムを返します。集計をXML で返すことも可能です。
   • RetryLevel：このプロパティを使用して、特定の広告インサイトのクエリとエラーに対するクエリの自動再試行を制御します。

   ビルトイン接続文字列デザイナ

   JDBC URL の構成については、Facebook Ads JDBC Driver に組み込まれている接続文字列デザイナを使用してください。JAR ファイルのダブルクリック、またはコマンドラインからJAR ファイルを実行します。

   java -jar cdata.jdbc.facebookads.jar

   接続プロパティを入力し、接続文字列をクリップボードにコピーします。

   以下は一般的な接続文字列です。

   InitiateOAuth=GETANDREFRESH
10. 必要であればユーザー名とパスワードを入力します。

プロセス内の様々なRapidMiner オペレーターとのFacebook Ads 接続を使用できます。Facebook Ads を取得するには、［Operators］ビューから［Retrieve］をドラッグします。 ［Retrieve］オペレータを選択した状態で、［repository entry］の横にあるフォルダアイコンをクリックして［Parameters］ビューで取得するテーブルを定義できます。表示されるRepository ブラウザで接続ノードを展開し、目的のサンプルセットを選択できます。

最後に、［Retrieve］プロセスから結果に出力をワイヤリングし、プロセスを実行してFacebook Ads を確認します。