lazyad 0.0.40__tar.gz → 0.0.42__tar.gz

{lazyad-0.0.40 → lazyad-0.0.42}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: lazyad
-Version: 0.0.40
+Version: 0.0.42
 Summary: 基于Python的懒人包-适用于广告投放模块
 Home-page: https://gitee.com/ZeroSeeker/lazyad
 Author: ZeroSeeker

{lazyad-0.0.40 → lazyad-0.0.42}/lazyad/crawlers/mintegral.py

@@ -24,6 +24,7 @@ default_headers = {
         "TE": "trailers",
         "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:132.0) Gecko/20100101 Firefox/132.0"
     }
+default_timeout = 60
 
 
 def auth(
@@ -122,45 +123,79 @@ def offers(
 
 def performance(
         cookie: str,
+        total: bool = False,
+
         page: int = 1,
         page_size: int = 50,
         timezone: int = 8,
         start_time: str = None,
         end_time: str = None,
         show_calendar_day: int = 2,
-        total: bool = False,
         breakdowns: list = None,
-        metrics: list = None
+        metrics: list = None,
+        sort: str = None,
+        order: str = "DESC",
+        adv_campaign_id: int = None,
+        timeout: int = default_timeout
 ):
     """
     获取广告单元列表
     需要登录：{'code': 400, 'msg': 'Please login first', 'data': None}
     验证成功：{'code': 200, 'msg': 'success', 'data': {}
+    :param start_time: 开始日期，例如：2025-03-05
+    :param end_time: 结束日期，例如：2025-03-05
+    :param breakdowns: 分组依据（高级选项）：[]
+        (date：天, timestamp：小时，week：周，month：月)
+        adv_offer_id：广告单元,
+        bid_type：Bid Type,
+        country_code：国家或地区
+        app：应用id(子渠道)
+        package_name：包名(子渠道)
+        app_name：应用名称(子渠道)
+        adv_campaign_id：广告
+        received_price：单价
+        ad_type：广告类型
+    :param sort: [可选-排序] 排序依据（高级选项）：adv_install：转化
+    :param adv_campaign_id: [可选-筛选]广告名称
     """
     scheme = "https"
     host = "ss-api.mintegral.com"
-    filename = "/api/v1/reports/performance"
-    filename_total = "/api/v1/reports/performance-total"
+    filename = "/api/v1/reports/performance"  # 获取详细数据
+    filename_total = "/api/v1/reports/performance-total"  # 获取总数据数据量，该请求优先
+
     if not start_time:
         start_time = lazytime.get_date_string(days=0)
     if not end_time:
         end_time = lazytime.get_date_string(days=0)
-    if not breakdowns:
-        breakdowns = ["date", "adv_offer_id"]
-    if not metrics:
+    if not breakdowns:  # 数据维度
+        breakdowns = [
+            "date",
+            "adv_offer_id"
+        ]
+    if not metrics:  # 数据指标
         metrics = [
-            "adv_impression",
-            "adv_click",
-            "adv_install",
-            "ecpm",
-            "ecpc",
-            "ecpi",
-            "ctr",
-            "ivr",
-            "cvr",
-            "adv_original_money",
-            "iaa_d0_ad_revenue",
-            "iaa_d0_roas"
+            "adv_impression",  # 展示
+            "adv_click",  # 点击
+            "adv_install",  # 转化
+            "ecpm",  # eCPM
+            "ecpc",  # CPC
+            "ecpi",  # eCPI
+            "ctr",  # CTR
+            "ivr",  # IVR
+            "cvr",  # CVR
+            "adv_original_money",  # 花费
+            "iaa_d0_ad_revenue",  # D0 Ad Rev
+            "iaa_d0_roas",  # D0 Ad Roas
+            "iaa_d3_ad_revenue",  # D3 Ad Rev
+            "iaa_d3_roas",  # D3 Ad Roas
+            "iaa_d7_ad_revenue",  # D7 Ad Rev
+            "iaa_d7_roas",  # D7 Ad Roas
+            # "iap_d0_ad_revenue",  # D0 IAP Rev
+            # "iap_d0_roas",  # D0 IAP Roas
+            # "iap_d3_ad_revenue",  # D3 IAP Rev
+            # "iap_d3_roas",  # D3 IAP Roas
+            # "iap_d7_ad_revenue",  # D7 IAP Rev
+            # "iap_d7_roas",  # D7 IAP Roas
         ]
     params = {
         "limit": page_size,
@@ -168,26 +203,28 @@ def performance(
         "timezone": timezone,
         "start_time": start_time,
         "end_time": end_time,
-        "order": "DESC",
+        "order": order,  # 排序
         "breakdowns": ",".join(breakdowns),
         "metrics": ",".join(metrics),
         "show_calendar_day": show_calendar_day
     }
-    url = f"{scheme}://{host}{filename}"
-    url_total = f"{scheme}://{host}{filename_total}"
+    if sort:
+        params["sort"] = sort
     headers = copy.deepcopy(default_headers)
     headers["Cookie"] = cookie
     if total:
         return lazyrequests.lazy_requests(
             method="GET",
             params=params,
-            url=url_total,
-            headers=headers
+            url=f"{scheme}://{host}{filename_total}",
+            headers=headers,
+            timeout=timeout
         )
     else:
         return lazyrequests.lazy_requests(
             method="GET",
             params=params,
-            url=url,
-            headers=headers
+            url=f"{scheme}://{host}{filename}",
+            headers=headers,
+            timeout=timeout
         )

{lazyad-0.0.40 → lazyad-0.0.42}/lazyad.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: lazyad
-Version: 0.0.40
+Version: 0.0.42
 Summary: 基于Python的懒人包-适用于广告投放模块
 Home-page: https://gitee.com/ZeroSeeker/lazyad
 Author: ZeroSeeker

{lazyad-0.0.40 → lazyad-0.0.42}/setup.py

@@ -13,7 +13,7 @@ with open("README.md", "r", encoding='utf-8') as fh:
 
 setuptools.setup(
     name="lazyad",
-    version="0.0.40",
+    version="0.0.42",
     description="基于Python的懒人包-适用于广告投放模块",
     long_description=long_description,
     long_description_content_type="text/markdown",