lazyad 0.0.43__py3-none-any.whl → 0.0.45__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,
@@ -143,8 +146,15 @@ def performance(
     获取广告单元列表
     需要登录：{'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 +166,40 @@ 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: 超时时间
     """
     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 +224,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 +250,17 @@ def performance(
             headers=headers,
             timeout=timeout
         )
+    elif export:
+        params["t"] = int(time.time()*1000)
+        response = lazyrequests.lazy_requests(
+            method="GET",
+            params=params,
+            url=f"{scheme}://{host}{filename_export}",
+            headers=headers,
+            timeout=timeout,
+            return_json=False
+        )
+        return xml_to_dict(response.text)
     else:
         return lazyrequests.lazy_requests(
             method="GET",
@@ -232,3 +269,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/open/mintegral.py

@@ -347,3 +347,32 @@ def update_budget(
                 "mtgid":  mtgid
             }
         )
+
+
+def get_campaign(
+        api_key: str,
+        access_key: str,
+        page: int = 1,
+        limit: int = 50
+):
+    """
+    获取广告
+    https://adv.mintegral.com/doc/cn/guide/campaign/getCampaign.html
+    :param api_key:
+    :param access_key:
+    :param page:
+    :param limit:
+    :return:
+    """
+    url = "https://ss-api.mintegral.com/api/open/v1/campaign"
+    token_info = make_token(api_key=api_key)
+    params = {"access-key": access_key}
+    params.update(token_info)
+    params["page"] = page
+    params["limit"] = limit
+    return lazyrequests.lazy_requests(
+            method="GET",
+            url=url,
+            params=params
+        )
+

{lazyad-0.0.43.dist-info → lazyad-0.0.45.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: lazyad
-Version: 0.0.43
+Version: 0.0.45
 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.43.dist-info → lazyad-0.0.45.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=vOJRZs8mspS7hKLQHBabW0UGNCvH9uCmBdMib2o2_VE,8788
 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=YJbDMyzDct8-zjJXFreOVVHKOz6xuIale3aS7HsPuSM,10917
+lazyad/open/mintegral.py,sha256=iybtS0u9WFbZwEXnIKeFzDth4peqOfFqZUSl0oKLkiM,11581
 lazyad/open/qq.py,sha256=pru1p4LCjURD9N5ukx-OStYAmDCvrTW4VMB2N0-3i5Q,6904
-lazyad-0.0.43.dist-info/METADATA,sha256=KlQ51rMyassu2-GQ_NfqaD4wSK6SNspXYeo93nHlP7Y,1884
-lazyad-0.0.43.dist-info/WHEEL,sha256=yQN5g4mg4AybRjkgi-9yy4iQEFibGQmlz78Pik5Or-A,92
-lazyad-0.0.43.dist-info/top_level.txt,sha256=RAPjtj4gZYpsKAM3fAQrWyyn84xjdRuaiUS76gx6eNs,7
-lazyad-0.0.43.dist-info/RECORD,,
+lazyad-0.0.45.dist-info/METADATA,sha256=DAArvfvaXkIOBMIlhVuwo-suU2skCBy72jJ_Vf8IRCo,1918
+lazyad-0.0.45.dist-info/WHEEL,sha256=yQN5g4mg4AybRjkgi-9yy4iQEFibGQmlz78Pik5Or-A,92
+lazyad-0.0.45.dist-info/top_level.txt,sha256=RAPjtj4gZYpsKAM3fAQrWyyn84xjdRuaiUS76gx6eNs,7
+lazyad-0.0.45.dist-info/RECORD,,