lazyad 0.0.42__py3-none-any.whl → 0.0.43__py3-none-any.whl

lazyad/crawlers/mintegral.py

@@ -136,6 +136,7 @@ def performance(
         sort: str = None,
         order: str = "DESC",
         adv_campaign_id: int = None,
+        promote_country_code: str = None,
         timeout: int = default_timeout
 ):
     """
@@ -157,6 +158,7 @@ def performance(
         ad_type：广告类型
     :param sort: [可选-排序] 排序依据（高级选项）：adv_install：转化
     :param adv_campaign_id: [可选-筛选]广告名称
+    :param promote_country_code: [可选-筛选]投放区域
     """
     scheme = "https"
     host = "ss-api.mintegral.com"
@@ -210,6 +212,8 @@ def performance(
     }
     if sort:
         params["sort"] = sort
+    if adv_campaign_id:
+        params["adv_campaign_id"] = adv_campaign_id
     headers = copy.deepcopy(default_headers)
     headers["Cookie"] = cookie
     if total:

lazyad/open/mintegral.py

@@ -0,0 +1,349 @@
+from lazysdk import lazyrequests
+from lazysdk import lazytime
+import showlog
+import hashlib
+import time
+
+
+def convert_data2dict(data):
+    data_lines = data.split("\n")
+    res = list()
+    if len(data_lines) == 1:
+        return
+    else:
+        dict_key_line = data_lines[0]
+        dict_keys = dict_key_line.split("\t")
+        dict_value_lines = data_lines[1: -1]
+        for each_line in dict_value_lines:
+            each_line_values = each_line.split("\t")
+            temp_dict = dict(zip(dict_keys, each_line_values))
+            res.append(temp_dict)
+    return res
+
+
+def convert_format(data):
+    data_list = convert_data2dict(data=data)
+    for each in data_list:
+        # each["Offer_Id"] = each["Offer Id"]
+        each["Date"] = f'{each["Date"][0:4]}-{each["Date"][4:6]}-{each["Date"][6:8]}'  # 日期
+        each["Impression"] = eval(each["Impression"])
+        each["Click"] = eval(each["Click"])
+        each["Conversion"] = eval(each["Conversion"])
+        each["Ecpm"] = eval(each["Ecpm"])
+        each["Cpc"] = eval(each["Cpc"])
+        each["Ctr"] = eval(each["Ctr"])
+        each["Cvr"] = eval(each["Cvr"])
+        each["Ivr"] = eval(each["Ivr"])
+        each["Spend"] = eval(each["Spend"])
+    return data_list
+
+
+def make_token(api_key):
+    """
+    生成token算法，使用时生成
+    参考：https://adv.mintegral.com/doc/cn/guide/introduction/token.html
+    :param api_key:
+    :return:
+    """
+    timestamp = int(time.time())
+
+    # 计算时间戳的MD5哈希值
+    timestamp_md5 = hashlib.md5(str(timestamp).encode()).hexdigest()
+
+    # 将API密钥与时间戳的MD5哈希值连接，并计算最终的MD5哈希值
+    token = hashlib.md5((api_key + timestamp_md5).encode()).hexdigest()
+    return {"timestamp": timestamp, "token": token}
+
+
+def get_report(
+        api_key: str,
+        access_key: str,
+        timezone: str = "+8",
+        start_date: str = None,
+        end_date: str = None,
+        time_granularity: str = "daily",
+        req_type: int = 1,
+        dimension_option: list = None
+):
+    """
+    广告投放报表_进阶版
+    https://adv.mintegral.com/doc/cn/guide/report/advancedPerformanceReport.html
+
+    {'code': 201, 'msg': 'Successful reception'}
+    200 => 生成数据完成，可使用 type=2 获取数据。
+    201 => 接收请求成功，等待生成数据。
+    202 => 数据正在生成中。
+    10000 => 参数错误或权限缺失。
+
+    :param api_key:
+    :param access_key:
+    :param timezone: 时区
+    :param start_date: 开始日期
+    :param end_date: 结束日期
+    :param time_granularity:
+    :return:
+    """
+    url = "https://ss-api.mintegral.com/api/v2/reports/data"
+    token_info = make_token(api_key=api_key)
+    params = {"access-key": access_key}
+    params.update(token_info)
+
+    if timezone:
+        params["timezone"] = timezone
+    if not start_date:
+        start_date = lazytime.get_date_string(days=-1)
+    if not end_date:
+        end_date = lazytime.get_date_string(days=0)
+    params["start_time"] = start_date
+    params["end_time"] = end_date
+    params["time_granularity"] = time_granularity
+    params["type"] = req_type
+    if not dimension_option:
+        params["dimension_option"] = "Offer"
+    else:
+        params["dimension_option"] = ",".join(dimension_option)
+    if req_type == 1:
+        return lazyrequests.lazy_requests(
+            method="GET",
+            url=url,
+            params=params
+        )
+    elif req_type == 2:
+        return lazyrequests.lazy_requests(
+            method="GET",
+            url=url,
+            params=params,
+            return_json=False
+        )
+
+
+def get_report_until_success(
+        api_key: str,
+        access_key: str,
+        timezone: str = "+0",
+        start_date: str = None,
+        end_date: str = None,
+        time_granularity: str = "daily",
+        dimension_option: list = None
+):
+    """
+        {'code': 201, 'msg': 'Successful reception'}
+        200 => 生成数据完成，可使用 type=2 获取数据。
+        201 => 接收请求成功，等待生成数据。
+        202 => 数据正在生成中。
+        10000 => 参数错误或权限缺失。
+    """
+    req_type = 1
+    while True:
+        res = get_report(
+            api_key=api_key,
+            access_key=access_key,
+            req_type=req_type,
+            dimension_option=dimension_option,
+            start_date=start_date,
+            end_date=end_date,
+            time_granularity=time_granularity,
+            timezone=timezone
+        )
+        if res["code"] == 201:
+            showlog.info("接收请求成功，等待生成数据。")
+            lazytime.count_down(5)
+        elif res["code"] == 202:
+            showlog.info("数据正在生成中。")
+            lazytime.count_down(5)
+        elif res["code"] == 200:
+            showlog.info("生成数据完成，可使用 type=2 获取数据。")
+            req_type = 2
+            res = get_report(
+                api_key=api_key,
+                access_key=access_key,
+                req_type=req_type,
+                dimension_option=dimension_option,
+                start_date=start_date,
+                end_date=end_date,
+                time_granularity=time_granularity,
+                timezone=timezone
+            )
+            return convert_format(res.text)
+        elif res["code"] == 10000:
+            showlog.warning(res)
+            return
+
+
+def get_app_name(
+        package_name: str,
+        api_key: str,
+        access_key: str
+):
+    """
+    通过包名获取对应的 APP 名称
+    https://adv.mintegral.com/doc/cn/guide/report/acquiringAppName.html
+    :param api_key:
+    :param access_key:
+    :param package_name: 包名
+    :return:
+    """
+    url = "https://ss-api.mintegral.com/api/open/v1/target-apps/app-name"
+    token_info = make_token(api_key=api_key)
+    params = {"access-key": access_key}
+    params.update(token_info)
+
+    params["package_name"] = package_name
+
+    return lazyrequests.lazy_requests(
+            method="POST",
+            url=url,
+            params=params,
+            data={"package_name": package_name}
+        )
+
+
+def update_traffic(
+        api_key: str,
+        access_key: str,
+        offer_id: int,
+        option: str,
+        mtg_ids: list = None,
+):
+    """
+    更新流量投放状态;
+    广告单元里需要优化的流量 mtgid。如果 mtgid 传空，则清空黑白名单。多个用,号分隔，最多 3000 个。
+    https://adv.mintegral.com/doc/cn/guide/offer/updateTraffic.html
+    :param api_key:
+    :param access_key:
+    :param offer_id: 广告单元 ID
+    :param option:
+        ENABLE:表示将某个 mtgid 添加进白名单或者将某个 mtgid 从黑名单剔除
+        DISABLE:表示将某个 mtgid 添加进黑名单或者将某个 mtgid 从白名单剔除。
+        ALLOW_ALL:表示恢复所有 App 的投放状态，取消黑白名单的设置。
+    :param mtg_ids: 广告单元里需要优化的流量 mtgid。仅option 传 "ALLOW_ALL" 时，mtgid 可传空，如果 mtgid 传空，则清空黑白名单。多个用,号分隔，最多 3000 个。
+注： 该接口采取全量更新方式，请提交完整的黑白名单设置。
+    :return:
+    """
+    url = "https://ss-api.mintegral.com/api/open/v1/offer/target"
+    token_info = make_token(api_key=api_key)
+    params = {"access-key": access_key}
+    params.update(token_info)
+    mtg_ids_new = set(mtg_ids)  # 去重复
+    mtgid = ",".join(mtg_ids_new)
+    return lazyrequests.lazy_requests(
+            method="PUT",
+            url=url,
+            params=params,
+            data={
+                "offer_id": offer_id,
+                "option": option,
+                "mtgid":  mtgid
+            }
+        )
+
+
+def get_offer(
+        api_key: str,
+        access_key: str,
+        page: int = 1,
+        limit: int = 10
+):
+    """
+    获取广告单元列表
+    https://adv.mintegral.com/doc/cn/guide/offer/getOffer.html
+    :param api_key:
+    :param access_key:
+    :param page: 页数
+    :param limit: 每页数量，最大值：50；大于 50 时，接口只返回 50 个
+    :return:
+    """
+    url = "https://ss-api.mintegral.com/api/open/v1/offers"
+    token_info = make_token(api_key=api_key)
+    params = {"access-key": access_key}
+    params.update(token_info)
+
+    if page:
+        params["page"] = page
+    if limit:
+        params["limit"] = limit
+
+    return lazyrequests.lazy_requests(
+        method="GET",
+        url=url,
+        params=params
+    )
+
+
+def get_offer_all(
+        api_key: str,
+        access_key: str
+):
+    """
+    获取广告单元列表
+    :param api_key:
+    :param access_key:
+    :return:
+    """
+    page = 1
+    limit = 10
+    offers = list()
+    while True:
+        showlog.info(f"正在获取第 {page} 页的数据...")
+        temp_res = get_offer(
+            page=page,
+            limit=limit,
+            api_key=api_key,
+            access_key=access_key
+        )
+        if temp_res["code"] == 200:
+            data = temp_res["data"]
+            if not data:
+                break
+            else:
+                data_list = data["list"]
+                if data_list:
+                    offers.extend(data_list)
+                    page += 1
+                    continue
+                else:
+                    break
+        else:
+            showlog.warning(temp_res)
+            break
+    return offers
+
+
+def update_budget(
+        api_key: str,
+        access_key: str,
+        offer_id: int,
+        option: str,
+        mtg_ids: list = None,
+):
+    """
+    更新预算
+    广告单元里需要优化的流量 mtgid。如果 mtgid 传空，则清空黑白名单。多个用,号分隔，最多 3000 个。
+    https://adv.mintegral.com/doc/cn/guide/offer/updateBudget.html
+    :param api_key:
+    :param access_key:
+    :param offer_id: 广告单元 ID
+    :param option:
+        ENABLE:表示将某个 mtgid 添加进白名单或者将某个 mtgid 从黑名单剔除
+        DISABLE:表示将某个 mtgid 添加进黑名单或者将某个 mtgid 从白名单剔除。
+        ALLOW_ALL:表示恢复所有 App 的投放状态，取消黑白名单的设置。
+    :param mtg_ids: 广告单元里需要优化的流量 mtgid。仅option 传 "ALLOW_ALL" 时，mtgid 可传空，如果 mtgid 传空，则清空黑白名单。多个用,号分隔，最多 3000 个。
+注： 该接口采取全量更新方式，请提交完整的黑白名单设置。
+    :return:
+    """
+    url = "https://ss-api.mintegral.com/api/open/v1/offer/budget"
+    token_info = make_token(api_key=api_key)
+    params = {"access-key": access_key}
+    params.update(token_info)
+
+    mtgid = ",".join(mtg_ids)
+    return lazyrequests.lazy_requests(
+            method="PUT",
+            url=url,
+            params=params,
+            data={
+                "offer_id": offer_id,
+                "option": option,
+                "mtgid":  mtgid
+            }
+        )

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

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

{lazyad-0.0.42.dist-info → lazyad-0.0.43.dist-info}/RECORD

@@ -1,12 +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=GI22Eu85V76B7j8Fn8QaqyViMbBmn9IQiIpPbVowQ5s,6864
+lazyad/crawlers/mintegral.py,sha256=vgF1TwnvvqAVvZPqRRJyZ0qo1_9ARVt2f2brKjdkyvU,7043
 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/qq.py,sha256=pru1p4LCjURD9N5ukx-OStYAmDCvrTW4VMB2N0-3i5Q,6904
-lazyad-0.0.42.dist-info/METADATA,sha256=1adzHoU4rHkJ_qK4GyQCOC9N2yCMJCbZ8NFliBIufBQ,1884
-lazyad-0.0.42.dist-info/WHEEL,sha256=yQN5g4mg4AybRjkgi-9yy4iQEFibGQmlz78Pik5Or-A,92
-lazyad-0.0.42.dist-info/top_level.txt,sha256=RAPjtj4gZYpsKAM3fAQrWyyn84xjdRuaiUS76gx6eNs,7
-lazyad-0.0.42.dist-info/RECORD,,
+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,,