lazyad 0.0.44__tar.gz → 0.0.46__tar.gz

{lazyad-0.0.44 → lazyad-0.0.46}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: lazyad
-Version: 0.0.44
+Version: 0.0.46
 Summary: 基于Python的懒人包-适用于广告投放模块
 Home-page: https://gitee.com/ZeroSeeker/lazyad
 Author: ZeroSeeker
@@ -9,6 +9,7 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Operating System :: OS Independent
 Description-Content-Type: text/markdown
 Requires-Dist: lazysdk>=0.1.88
+Requires-Dist: xmltodict==0.14.2
 
 # lazyad
 

{lazyad-0.0.44 → lazyad-0.0.46}/lazyad/crawlers/mintegral.py

@@ -1,6 +1,8 @@
 from lazysdk import lazyrequests
 from lazysdk import lazytime
+import xmltodict
 import copy
+import time
 
 
 """
@@ -24,7 +26,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
+default_timeout = 60 * 10  # MTG下载最大超时时间为10分钟
 
 
 def auth(
@@ -124,6 +126,7 @@ def offers(
 def performance(
         cookie: str,
         total: bool = False,
+        export: bool = False,
 
         page: int = 1,
         page_size: int = 50,
@@ -137,14 +140,22 @@ def performance(
         order: str = "DESC",
         adv_campaign_id: int = None,
         promote_country_code: str = None,
-        timeout: int = default_timeout
+        timeout: int = default_timeout,
+        stream: bool = False
 ):
     """
     获取广告单元列表
     需要登录：{'code': 400, 'msg': 'Please login first', 'data': None}
     验证成功：{'code': 200, 'msg': 'success', 'data': {}
+    :param cookie: 已经登陆的cookie
+    :param total: 为True时获取总记录数
+    :param export: 为True时下载表格文件
+    :param page: 页码
+    :param page_size: 每页数量
+    :param timezone: 时区
     :param start_time: 开始日期，例如：2025-03-05
     :param end_time: 结束日期，例如：2025-03-05
+    :param show_calendar_day:
     :param breakdowns: 分组依据（高级选项）：[]
         (date：天, timestamp：小时，week：周，month：月)
         adv_offer_id：广告单元,
@@ -156,14 +167,41 @@ def performance(
         adv_campaign_id：广告
         received_price：单价
         ad_type：广告类型
+    :param metrics: 展示数据列（高级选项）：[]
+        "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
     :param sort: [可选-排序] 排序依据（高级选项）：adv_install：转化
+    :param order:
     :param adv_campaign_id: [可选-筛选]广告名称
     :param promote_country_code: [可选-筛选]投放区域
+    :param timeout: 超时时间
+    :param stream: 为True时为流式下载
     """
     scheme = "https"
     host = "ss-api.mintegral.com"
     filename = "/api/v1/reports/performance"  # 获取详细数据
     filename_total = "/api/v1/reports/performance-total"  # 获取总数据数据量，该请求优先
+    filename_export = "/api/v1/reports/performance-export"  # 导出数据
 
     if not start_time:
         start_time = lazytime.get_date_string(days=0)
@@ -188,16 +226,6 @@ def performance(
             "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,
@@ -224,6 +252,17 @@ def performance(
             headers=headers,
             timeout=timeout
         )
+    elif export:
+        params["t"] = int(time.time()*1000)
+        return lazyrequests.lazy_requests(
+            method="GET",
+            params=params,
+            url=f"{scheme}://{host}{filename_export}",
+            headers=headers,
+            timeout=timeout,
+            return_json=False,
+            stream=stream
+        )  # 直接返回，由接收数据端自行处理
     else:
         return lazyrequests.lazy_requests(
             method="GET",
@@ -232,3 +271,21 @@ def performance(
             headers=headers,
             timeout=timeout
         )
+
+
+def xml_to_dict(xml_str):
+    """
+    将MTG下载的表格内容转换为[dict]格式，方便后续处理
+    :param xml_str:
+    :return:
+    """
+    parsed_dict = xmltodict.parse(xml_str)
+
+    # 提取表格数据（根据实际结构调整路径）
+    rows = parsed_dict["Workbook"]["Worksheet"]["Table"]["Row"]
+    headers = [cell["Data"]["#text"] for cell in rows[0]["Cell"]]
+    data_list = [
+        {headers[i]: cell["Data"]["#text"] for i, cell in enumerate(row["Cell"])}
+        for row in rows[1:]
+    ]
+    return data_list

{lazyad-0.0.44 → lazyad-0.0.46}/lazyad.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: lazyad
-Version: 0.0.44
+Version: 0.0.46
 Summary: 基于Python的懒人包-适用于广告投放模块
 Home-page: https://gitee.com/ZeroSeeker/lazyad
 Author: ZeroSeeker
@@ -9,6 +9,7 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Operating System :: OS Independent
 Description-Content-Type: text/markdown
 Requires-Dist: lazysdk>=0.1.88
+Requires-Dist: xmltodict==0.14.2
 
 # lazyad
 

lazyad-0.0.46/lazyad.egg-info/requires.txt

@@ -0,0 +1,2 @@
+lazysdk>=0.1.88
+xmltodict==0.14.2

{lazyad-0.0.44 → lazyad-0.0.46}/setup.py

@@ -13,7 +13,7 @@ with open("README.md", "r", encoding='utf-8') as fh:
 
 setuptools.setup(
     name="lazyad",
-    version="0.0.44",
+    version="0.0.46",
     description="基于Python的懒人包-适用于广告投放模块",
     long_description=long_description,
     long_description_content_type="text/markdown",
@@ -28,5 +28,6 @@ setuptools.setup(
     ],
     install_requires=[
         'lazysdk>=0.1.88',
+        "xmltodict==0.14.2"
     ]
 )

lazyad-0.0.44/lazyad.egg-info/requires.txt

@@ -1 +0,0 @@
-lazysdk>=0.1.88