Soomgo-gather 2.1

No project description provided

Soomgo-gather

Soomgo-gather는 (주)브레이브모바일에서 서비스 중인 숨고 에서 데이터 수집을 위해 구현한 통합 패키지입니다.

데이터 파이프라인을 구축하다보면 다양한 플랫폼에서 데이터를 수집해야하는 경우가 있습니다. 플랫폼마다 프로토콜도 다르고, API 명세도 일원화되지 않다보니 실제로 수집하기까지 오랜시간이 소요됩니다. 또한, 대부분 수집을 위한 플랫폼들은 어느 조직이든 비슷합니다. 예로, 마케팅 데이터를 수집하기 위해서는 GA, 네이버검색광고시스템 겠죠.

Soomgo-gather 는 최소한의 시간으로 최대한 빨리 데이터를 수집할 수 있도록 심플한 인터페이스를 제공합니다.

---

Read the documentation on ReadTheDocs!

---

Supported platform

• Naver Search AD
  • Bizmoney
  • RelKwdStat
  • MasterReport
  • StatReport
• Google Search Console
• Google Ads
• Kakao Keyword AD

Installation and usage

Installation

Soomgo-gather 는 pip install soomgo-gather 로 설치할 수 있고, Python 3.6 이상부터 지원하고 있습니다.

Usage

Soomgo-gather 를 사용하는 방법은 간단합니다.

아래는 Naver Search AD.Bizmoney 를 수집하는 예시입니다.

from soomgogather.naver import Bizmoney

bizmoney = Bizmoney(api_key='_', secret_key='_', customer_id='_')

r = bizmoney.exhaust(params={
    'search_start_dt': '20211118',
    'search_end_dt': '20211118',
 })

if r.status_code == 200:
     print(r.json())

아래는 Kakao Keyword AD의 리포트를 수집하는 예시입니다.

from soomgogather.kakao import KeywordReport

k = KeywordReport(
  path='adAccounts',
  access_token='_',
  ad_account_id='_'
)
r = k.report()
if r.status_code == 200:
  print(r.json())

# access_token이 유요하지 않다면 갱신이 필요합니다.

k = KeywordReport(
  path='adAccounts',
  access_token='_',
  ad_account_id='_',
  user_refresh_token='_',
  rest_api_key='_',
)
r = k.report()

License

MIT

Contributing

환영합니다! 프로젝트에 기여하고 싶다면 가이드를 읽어주세요.

방법은 어렵지 않습니다. 이슈를 생성하고, feature 브랜치에 작업하여 main 브랜치를 타겟으로 PR을 보내주시면 됩니다.

• CONTRIBUTING.md

Changelog

• CHANGELOG.md

soomgo-gather는 Simple Versioning <https://simver.org//>_ 을 준수합니다.

Simple Versioning 은 기본적으로 x.y 처럼 두 파트로 구성되고, 각 파트마다 아래의 규칙이 있습니다.

• Major(x): 변경사항이 이전 버전과 호환되지 않는 경우.
• Minor(y): 변경사항이 이전 버전과 호환되는 경우.

• Major 가 버전업이 되면 Minor 가 0으로 초기화한다.

이를 기준으로 soomgo-gather는 아래 규칙으로 버전관리를 합니다.

• Major(x): 새로운 수집 대상이 추가되는 경우. (ex. Naver SearchAd, Google search console, Google Ads, Facebook Business 등 )
• Minor(y): 기존 수집 대상의 하위 기능이 변경(추가,수정,삭제)되는 경우.

---

Changes에는 총 5가지의 유형이 있습니다.

• New: 새로운 데이터 수집 기능 릴리즈.
• Changes: 기존에 배포된 기능의 변경.
• Deprecations: 기존에 배포된 기능중 더 이상 지원되지 않음.
• Doc only changes: 코드의 변경 없이 doc 만 수정.
• Contributors: 작업 참여자.

Version 2.1

released: 2023-03-23

Changes

• Naver SearchAd - API 도메인 변경

Contributors

• Daisy Kim

Version 2.0

released: 2022-03-30

New

• Kakao KeywordAd - Report 배포

Contributors

• Daisy Kim

Version 1.3

released: 2021-12-22

New

• Naver SearchAd - StatReport 배포
• Naver SearchAd - MasterReport 배포
• Google Ads - stream_request 배포

Contributors

• Daisy Kim
• Paul Cho
• Rosa Kim

Version 1.2

released: 2021-12-07

Changes

• Google service name 변경

Contributors

• Rosa Kim

Version 1.1

released: 2021-12-06

Doc only changes

• pypi upload 변경

Contributors

• Paul Cho

Version 1.0

released: 2021-11-23

New

• Naver SearchAd - Bizmoney 배포
• Naver SearchAd - RelKwdStat 배포
• Google Searchconsole - query 배포

Contributors

• Paul Cho
• Rosa Kim