本記事では CData サポート担当からこんなことを聞かれたらどこを確認すべきか?という観点で、よく頂くお問合せ内容をご紹介します。
記事はこちら →Python エコシステムには多くのモジュールがあり、システム構築を素早く効率的に行うのに役立ちます。CData Python Connector for BingAds は、pandas、Matplotlib モジュール、SQLAlchemy ツールキットから使用することで Bing Ads にデータ連携するPython アプリケーションを構築し、Bing Ads をビジュアライズできます。本記事では、pandas、SQLAlchemy、およびMatplotlib のビルトイン機能でBing Ads にリアルタイムアクセスし、クエリを実行し、結果をビジュアライズする方法を説明します。
CData Python Connector は、ビルトインされた効率的なデータプロセスにより、リアルタイムBing Ads データにPython からアクセスし、高いパフォーマンスと接続性を発揮します。Bing Ads に複雑なクエリを投げる際に、ドライバーはフィルタリング、集計などがサポートされている場合、SQL 処理を直接Bing Ads 側に行わせ、サポートされていないSQL 処理については、組み込まれたSQL エンジンによりクライアント側で処理を行います(特にJOIN やSQL 関数など)。
Bing Ads への連携は、RDB ソースへのアクセスと同感覚で行うことができます。必要な接続プロパティを使って接続文字列を作成します。本記事では、接続文字列をcreate_engine 関数のパラメータとして送ります。
Bing Ads API はOAuth 2 標準を使用します。Bing Ads への認証には、有効なBing Ads OAuth 資格情報が必要です。また開発者トークンを取得する必要があります。詳しくは、ヘルプドキュメントの「はじめに」を参照してください。
以下の手順に従い、必要なモジュールをインストールし、Python オブジェクト経由でBing Ads にアクセスします。
pip で、pandas & Matplotlib モジュールおよび、SQLAlchemy ツールキットをインストールします:
pip install pandas pip install matplotlib pip install sqlalchemy
以下のようにモジュールをインポートします:
import pandas import matplotlib.pyplot as plt from sqlalchemy import create_engine
次は、接続文字列で接続を確立します。create_engine 関数を使って、Bing Ads に連携するEngne を作成します。.
engine = create_engine("bingads:///? OAuthClientId=MyOAuthClientId& OAuthClientSecret=MyOAuthClientSecret& CallbackURL=http://localhost:portNumber& AccountId=442311& CustomerId=5521444& DeveloperToken=11112332233&InitiateOAuth=GETANDREFRESH&OAuthSettingsLocation=/PATH/TO/OAuthSettings.txt")
pandas のread_sql 関数を使って好きなSQL を発行して、DataFrame にデータを格納します。
df = pandas.read_sql("""SELECT Id, Name FROM AdGroups WHERE CampaignId = '234505536'""", engine)
DataFrame に格納されたクエリ結果に対して、plot 関数をつかって、Bing Ads data をグラフで表現してみます。show メソッドはグラフを新しいウィンドウに表示します。
df.plot(kind="bar", x="Id", y="Name") plt.show()
Bing Ads Python Connector の30日の無償トライアル をぜひダウンロードして、Bing Ads への接続をPython アプリやスクリプトから簡単に作成しましょう。
import pandas import matplotlib.pyplot as plt from sqlalchemy import create_engin engine = create_engine("bingads:///? OAuthClientId=MyOAuthClientId& OAuthClientSecret=MyOAuthClientSecret& CallbackURL=http://localhost:portNumber& AccountId=442311& CustomerId=5521444& DeveloperToken=11112332233&InitiateOAuth=GETANDREFRESH&OAuthSettingsLocation=/PATH/TO/OAuthSettings.txt") df = pandas.read_sql("""SELECT Id, Name FROM AdGroups WHERE CampaignId = '234505536'""", engine) df.plot(kind="bar", x="Id", y="Name") plt.show()