pythonパッケージyadirstatの概要-YandexDirectAPIから統計を取得する最も簡単な方法

こんにちは、Yandex Directから統計を収集する必要があります。作業を簡素化するために、これを非常に簡単に実行できるpythonパッケージを公開しました。



まず、アカウントのトークンを取得する必要があります(詳細はこちら



。yadirstatパッケージはすでにpypiで公開されています。pipを使用してインストールできます。



pip install yadirstat


このパッケージを使用すると、次の統計を取得できます。



  • キャンペーン統計
  • インプレッション用語(キーワードやオーディエンスなど)に関する統計
  • クエリ統計の検索


統計の要求方法:




yadirstat.yadirstat. ( ,  ,  ,  )


このようなものは、検索クエリの統計を取得するためのリクエストのように見えます




query_report =yadirstat.yadirstat.query('','-1245234','2020-05-10','2020-07-15')
print(query_report)




そして、キャンペーンの統計を取得するためのリクエストは次のとおりです。


campaign_report = yadirstat.yadirstat.campaign('','-1245234','2020-05-10','2020-07-15')
print(campaign_report)


そして、これがインプレッションの状態に関する統計を取得するためのリクエストです:




criteria_report = yadirstat.yadirstat.criteria('','-1245234','2020-05-10','2020-07-15')
print(criteria_report)


私のリクエストの例:




from yadirstat import yadirstat
x = yadirstat.yadirstat.campaign('AgAAAxxxxxxxXXXXXXxxxxxXXXXXcI','BxxxxXXXX','2020-05-10','2020-07-15')
print(x)


出力は次のよう







になります。出力中にデータが収まらない場合は、次を使用できます。




import pandas as pd
pd.set_option('display.max_columns', None)
pd.set_option('display.expand_frame_repr', False)
pd.set_option('max_colwidth', 80)
pd.set_option('max_rows', 600000)


出力で、DataFrameを取得します。



完全に使用するには、「-」を「0」に置き換えます



データ構造



検索:



  • キャンペーン名
  • クエリ
  • 印象
  • クリック数
  • センター
  • 費用
  • AvgCpc
  • 変換速度
  • CostPerConversion
  • コンバージョン


キャンペーン*:



  • 日付
  • キャンペーン名
  • 印象
  • クリック数
  • センター
  • 費用
  • AvgCpc
  • BounceRate
  • AvgPageviews
  • 変換速度
  • CostPerConversion
  • コンバージョン
  • 日付


表示条件:



  • キャンペーン名
  • 基準
  • 印象
  • クリック数
  • センター
  • 費用
  • AvgCpc
  • 日付


*-最後の列として日付を追加すると、DataFrameを転送するときに日付ごとにデータが失われることはありません(たとえば、BigQueryに転送する場合、インデックスが付けられているために日付のある列が失われます。問題を回避するために、この列を単純に複製しました)。



なぜそのような構造?これは、統計を収集してGoogle BigQueryに送信し、GoogleDataStudioで視覚化できるようにする方法です。



このパッケージの開発に関する提案と、統計収集の経験を聞いていただければ幸いです。



PS:



  • これは、エージェントアカウントでも機能します。
  • そしてElamaアカウントで



All Articles