lazyad 0.0.44__py3-none-any.whl → 0.0.46__py3-none-any.whl

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.dist-info → lazyad-0.0.46.dist-info}/METADATA

@@ -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.dist-info → lazyad-0.0.46.dist-info}/RECORD

@@ -1,13 +1,13 @@
 lazyad/__init__.py,sha256=tnVTFEgdzgMWQI0mZqy3DAueMJjpypPb15DdxJ-9TiU,41
 lazyad/crawlers/__init__.py,sha256=GK3GGpiUJbESc1uGTwSmEnsSUwYDNZfJCxeLYB4CpS4,68
 lazyad/crawlers/chuangliang.py,sha256=nU57GkUGAXcu8TquqB9hg8Ysvl5E3ZlGX6pedj_nIwo,24830
-lazyad/crawlers/mintegral.py,sha256=vgF1TwnvvqAVvZPqRRJyZ0qo1_9ARVt2f2brKjdkyvU,7043
+lazyad/crawlers/mintegral.py,sha256=mtHp-CbCiUsVKaj199-5waJ7QHLwLHUDcWdrMvctYgk,8893
 lazyad/crawlers/oceanengine.py,sha256=kjBEpCb_h5OpodCTqzvXd5MBBwAuw3Oq5UKWoTCXrQM,4540
 lazyad/crawlers/qq.py,sha256=X_VjdgzAcDfckEAHrvdqBLtnmAuCBHPJVWu2H-IHZBA,5649
 lazyad/open/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 lazyad/open/mintegral.py,sha256=iybtS0u9WFbZwEXnIKeFzDth4peqOfFqZUSl0oKLkiM,11581
 lazyad/open/qq.py,sha256=pru1p4LCjURD9N5ukx-OStYAmDCvrTW4VMB2N0-3i5Q,6904
-lazyad-0.0.44.dist-info/METADATA,sha256=xTxAVtdtUPbKET979M0Lf1whm7eGxD2rca0cKjTFjZg,1884
-lazyad-0.0.44.dist-info/WHEEL,sha256=yQN5g4mg4AybRjkgi-9yy4iQEFibGQmlz78Pik5Or-A,92
-lazyad-0.0.44.dist-info/top_level.txt,sha256=RAPjtj4gZYpsKAM3fAQrWyyn84xjdRuaiUS76gx6eNs,7
-lazyad-0.0.44.dist-info/RECORD,,
+lazyad-0.0.46.dist-info/METADATA,sha256=k302kw1MnLKS6b-Wcb4qXpGGi8Zc2wSWfVkZsytZu6w,1918
+lazyad-0.0.46.dist-info/WHEEL,sha256=yQN5g4mg4AybRjkgi-9yy4iQEFibGQmlz78Pik5Or-A,92
+lazyad-0.0.46.dist-info/top_level.txt,sha256=RAPjtj4gZYpsKAM3fAQrWyyn84xjdRuaiUS76gx6eNs,7
+lazyad-0.0.46.dist-info/RECORD,,