HULFT Integrate で Facebook Ads のデータに接続

Jerod Johnson
Director, Technology Evangelism

HULFT Integrate で Facebook Ads に JDBC データソースとして接続

HULFT Integrate は、ドラッグ＆ドロップのユーザーインターフェースでコーポレーションフロー、データ変換、処理を簡単に作成できる最新のデータ連携プラットフォームです。CData JDBC Driver for Facebook Ads と組み合わせることで、HULFT Integrate からリアルタイムの Facebook Ads のデータを扱うことができます。この記事では、Facebook Ads への接続方法と、データを CSV ファイルに出力する手順をご紹介します。

CData JDBC ドライバーは、最適化されたデータ処理機能を備えており、リアルタイムの Facebook Ads のデータとの連携において比類のないパフォーマンスを発揮します。Facebook Ads に対して複雑な SQL クエリを発行すると、ドライバーはフィルタや集計などのサポートされている SQL 操作を直接 Facebook Ads にプッシュし、サポートされていない操作（主に SQL 関数や JOIN 操作）は内蔵の SQL エンジンでクライアント側で処理します。また、動的なメタデータクエリ機能により、ネイティブなデータ型を使用して Facebook Ads のデータを操作・分析できます。

Facebook Ads へのアクセスを有効化

HULFT Integrate プロジェクトから Facebook Ads のデータへのアクセスを有効にするには、以下の手順で設定します：

CData JDBC Driver の JAR ファイル（およびライセンスファイルがある場合はそれも）、cdata.jdbc.facebookads.jar（および cdata.jdbc.facebookads.lic）を、Integrate Server の jdbc_adapter サブフォルダにコピーします
HULFT Integrate Server を再起動し、HULFT Integrate Studio を起動します

Facebook Ads のデータにアクセスするプロジェクトの作成

JAR ファイルをコピーしたら、Facebook Ads のデータにアクセスするプロジェクトを作成できます。まず、Integrate Studio を開いて新しいプロジェクトを作成しましょう。

プロジェクト名を入力します
「スクリプトを作成」チェックボックスがオンになっていることを確認します
「次へ」をクリックします
スクリプト名を入力します（例：FacebookAdstoCSV）

プロジェクトを作成したら、Facebook Ads のデータを CSV ファイルにコピーするためのコンポーネントをスクリプトに追加します。

Execute Select SQL コンポーネントの設定

ツールパレット（Database -> JDBC）から「Execute Select SQL」コンポーネントをスクリプトワークスペースにドラッグします。

「必須設定」タブの接続先で、「追加」をクリックして Facebook Ads 用の新しい接続を作成します。以下のプロパティを設定します：
- 名前：Facebook Ads Connection Settings
- ドライバークラス名：cdata.jdbc.facebookads.FacebookAdsDriver
- URL：jdbc:facebookads:
  
  組み込みの接続文字列デザイナー
  
  JDBC URL の構築には、Facebook Ads JDBC Driver に組み込まれている接続文字列デザイナーをご利用ください。JAR ファイルをダブルクリックするか、コマンドラインから JAR ファイルを実行します。
```
		java -jar cdata.jdbc.facebookads.jar
		
```
  接続プロパティを入力し、接続文字列をクリップボードにコピーします。
  
  Facebook Ads 接続プロパティの取得・設定方法
  
  ほとんどのテーブルで、アプリケーション認証と同様にユーザー認証を必要とします。Facebook Ads はユーザー認証にOAuth 標準を使用しています。Facebook への認証には、組み込み認証を使用してブラウザ経由で完結することもできますし、Facebook にアプリを登録することで独自のOAuthClientId、OAuthClientSecret、CallbackURL を取得することもできます。
  
  の設定方法については、ヘルプドキュメントの「OAuth」セクションを参照してください。
  
  任意で以下の項目を設定して、フィルタリングや集計を行うもできます。必要に応じてご利用ください。
  - Target：Facebook データのテーブルのいくつかはターゲットでフィルタリングできます。例えば、動画のコメントを取得するにはターゲットに動画のID を指定します。このプロパティは、クエリ結果を指定されたターゲットに合致するレコードにフィルタリングします。Target カラムを使ってクエリ毎にこの制限をかけることができます。
  - AggregateFormat：CData 製品は、いくつかのカラムを文字列集合として返します。例えば、エンティティのいいねデータは集計されて返されます。デフォルトでは、CData 製品はJSON で集計カラムを返します。集計をXML で返すことも可能です。
  - RetryLevel：このプロパティを使用して、特定の広告インサイトのクエリとエラーに対するクエリの自動再試行を制御します。
SQL ステートメントを記述します。例：
```
SELECT AccountId, Name FROM AdAccounts
```
「抽出テスト」をクリックして、接続とクエリが正しく設定されていることを確認します
「SQL を実行して出力スキーマを設定」をクリックします
「完了」をクリックします