BizTalk でFacebook Ads にストアドプロシージャを実行する

こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

ストアドプロシージャは、SELECT 、INSERT 、UPDATE 、DELETE としては表すことができないFacebook Ads アクションを実装します。この記事では、ストアドプロシージャ用のスキーマを作成する方法を説明します。このスキーマを使用して、送信ポートからストアドプロシージャを実行できます。

プロジェクトにアダプターを追加する

［Add Adapter］ ウィザードから、アダプターをVisual Studio のBizTalk サーバープロジェクトに追加します。このアダプターは、ストアドプロシージャへの入力とその結果に関するメタデータを返します。このメタデータを使用してスキーマを作成します。

1. ［Solution Explorer］ の［project］ で右クリックし、［Add］ -> ［Add Generated Items］ と進みます。
2. ［resulting dialog box］ の［Add Adapter Metadata］ を選択します。
3. 表示される［Add Adapter］ ウィザードで、リストからアダプターを選択します。
4. ［Port menu］ では、選択を空白のままにします。もしくは、Facebook Ads アダプターを使用するように構成されている受信場所や送信ポートを選択します。

5. 送信ポートまたは受信場所に、認証資格情報と他の接続プロパティが構成されていない場合、［Connection String］ ページで、それらを入力します。下は一般的な接続文字列です。

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

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

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

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

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

スキーマを作成する

［Add Adapter］ ウィザードで接続プロパティを入力すると、［Schema］ ウィザードが表示されます。

1. 次の［Schema Information］ のページでは、Facebook Ads アダプターを使用するために構成した送信ポートを選択します。
2. CData Facebook Ads アダプターが要請応答送信ポートで構成されている場合、［One-Way］ オプションを無効にします。
3. ［Command Type］ メニューで、ストアドプロシージャを選択します。
4. メニューからストアドプロシージャを選択し、インプットパラメータの値を入力します。
5. ウィザードで表示される概要の設定を確認して［Finish］ をクリックし、schema.xsd ファイルを作成します。

スキーマを処理する

BizTalk アプリでスキーマを使用する際は、こちらのチュートリアルをご覧ください。