### NPM Installation for Marketing UI

Source: https://developers.e.qq.com/mktui/start/struct

Installs the Marketing UI component packages using npm. This includes commands for both the total package and individual module packages.

```bash
// 总包
npm install https://d3g.qq.com/tsa/tencent-mktui-1.1.22.tgz

// 模块包
npm install https://d3g.qq.com/tsa/tencent-mktui-adcreative-1.1.8.tgz
npm install https://d3g.qq.com/tsa/tencent-mktui-adtargeting-1.1.4.tgz
npm install https://d3g.qq.com/tsa/tencent-mktui-report-1.1.0.tgz
npm install https://d3g.qq.com/tsa/tencent-mktui-tools-1.1.2.tgz
```

--------------------------------

### Add Conversion API Request Example

Source: https://developers.e.qq.com/v3.0/pages/conversion_link_assets

Use this example to send conversion data to the API. Ensure you replace placeholders like <ACCESS_TOKEN> with your actual credentials. The feedback_url includes various macros for tracking.

```json
{
    "account_id": "<ACCOUNT_ID>",
    "conversion_name": "测试转化",
    "access_type": "ACCESS_TYPE_API",
    "conversion_scene": "CONVERSION_SCENE_ANDROID",
    "marketing_carrier_id": "12345678",
    "app_android_channel_package_id": "0;10000534",
    "claim_type": "CLAIM_TYPE_ACTIVATION",
    "feedback_id": 12345,
    "conversion_template_id": 123,
    "custom_report_index":[1,3,4],
    "feedback_url": "http://wwww.qq.com?a=__CLICK_ID__&b=__CLICK_TIME__&c=__MUID__&d=__ACCOUNT_ID__&f=__CALLBACK__&g=__DEVICE_OS_TYPE__&h=__HASH_MAC__&i=__HASH_OAID__&j=__OAID__&k=__HASH_ANDROID_ID__&l=__PROMOTED_OBJECT_ID__&o=__AD_ID__",
    "self_attributed": true,
    "optimization_goal": "OPTIMIZATIONGOAL_APP_ACTIVATE",
    "deep_behavior_optimization_goal": "OPTIMIZATIONGOAL_APP_REGISTER"
}
```

--------------------------------

### Request Example for Creating Creatives

Source: https://developers.e.qq.com/v3.0/pages/wechat_channel

This is a request payload example for the `dynamic_creatives/add` interface. It includes parameters for account, ad group, and marketing details. Refer to developer documentation for supported creative template IDs.

```json
{
  "account_id": "123456",
  "adgroup_id": "54554691283",
  "dynamic_creative_type": "DYNAMIC_CREATIVE_TYPE_COMMON",
  "page": 1,
  "page_size": 100,
  "marketing_goal": "MARKETING_GOAL_UNKNOWN",
  "marketing_sub_goal": "MARKETING_SUB_GOAL_UNKNOWN",
  "marketing_target_type": "MARKETING_TARGET_TYPE_UNKNOWN",
  "marketing_carrier_type": "MARKETING_CARRIER_TYPE_UNKNOWN"
}
```

--------------------------------

### GET qualifications/get

Source: https://developers.e.qq.com/v3.0/pages/news/info/20260115

获取广告主资质接口调整，更新资质类型枚举值。

```APIDOC
## GET qualifications/get

### Description
获取广告主资质。自 2026 年 1 月 26 日起，qualification_type 参数不再支持 INDUSTRY_QUALIFICATION_WECHAT 和 AD_QUALIFICATION_WECHAT，请使用 INDUSTRY_QUALIFICATION 或 AD_QUALIFICATION。

### Method
GET

### Endpoint
qualifications/get

### Parameters
#### Query Parameters
- **qualification_type** (string) - Required - 资质类型。不再支持枚举值：INDUSTRY_QUALIFICATION_WECHAT, AD_QUALIFICATION_WECHAT。请使用：INDUSTRY_QUALIFICATION, AD_QUALIFICATION
```

--------------------------------

### Targeting Tag Reports Aggregation Example

Source: https://developers.e.qq.com/v3.0/pages/reference/groupby

Example demonstrating how aggregation by `date`, `gender_id`, or both affects the output of targeting tag reports for gender.

```APIDOC
## Targeting Tag Reports Aggregation Example (targeting_tag_reports/get)

Scenario: An account has 10 ad groups with data from 2018/08/01 to 2018/08/11. Querying gender data for a specific ad group during this period.

- **GROUP BY date**: Returns 11 records. Metrics are combined for the ad group across all genders for each day. `gender` in the response is meaningless.
- **GROUP BY gender_id**: Returns 2 records. Metrics are combined for the ad group over the 11 days, broken down by gender. `date` in the response is meaningless.
- **GROUP BY date, gender_id**: Returns 22 records. Metrics are detailed for the ad group by gender for each day. Both `date` and `gender` in the response are meaningful.
```

--------------------------------

### Daily Reports Aggregation Example

Source: https://developers.e.qq.com/v3.0/pages/reference/groupby

Example demonstrating how aggregation by `date`, `adgroup_id`, or both affects the output of daily reports.

```APIDOC
## Daily Reports Aggregation Example (daily_reports/get)

Scenario: An account has 10 ad groups with data from 2018/08/01 to 2018/08/11. Querying report data at the ADGROUP level for this period.

- **GROUP BY date**: Returns 11 records. Metrics are combined for all ad groups per day. `adgroup_id` in the response is meaningless.
- **GROUP BY adgroup_id**: Returns 10 records. Metrics are combined for each ad group over the 10 days. `date` in the response is meaningless.
- **GROUP BY date, adgroup_id**: Returns 110 records. Metrics are detailed for each ad group on each day. Both `adgroup_id` and `date` in the response are meaningful.
```

--------------------------------

### Hourly Reports Aggregation Example

Source: https://developers.e.qq.com/v3.0/pages/reference/groupby

Example demonstrating how aggregation by `hour`, `adgroup_id`, or both affects the output of hourly reports.

```APIDOC
## Hourly Reports Aggregation Example (hourly_reports/get)

Scenario: An account has 10 ad groups with data for all 24 hours on 2018/08/01. Querying hourly data at the ADGROUP level for this day.

- **GROUP BY hour**: Returns 24 records. Metrics are combined for all ad groups per hour. `adgroup_id` in the response is meaningless.
- **GROUP BY adgroup_id**: Returns 10 records. Metrics are combined for each ad group over the 24 hours. `hour` in the response is meaningless.
- **GROUP BY hour, adgroup_id**: Returns 240 records. Metrics are detailed for each ad group in each hour. Both `adgroup_id` and `hour` in the response are meaningful.
```

--------------------------------

### Query Conversion Links via cURL

Source: https://developers.e.qq.com/v3.0/pages/conversion_link_assets

Example request to retrieve conversion links using the optimization_goal_struct parameter.

```bash
curl -v -G 'https://api.e.qq.com/v3.0/conversion_links/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'second_category_type=ANDROID' \
-d 'optimization_goal_struct={"optimization_goal": "OPTIMIZATIONGOAL_APP_ACTIVATE"}'
```

--------------------------------

### Retrieve Conversions via cURL

Source: https://developers.e.qq.com/v3.0/pages/conversion_link_assets

Example request for the conversions/get endpoint using cURL with filtering and pagination parameters.

```bash
curl -v -G 'https://api.e.qq.com/v3.0/conversions/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'filtering=[
    {
        "values": []
    }
]' \
-d 'page=1' \
-d 'page_size=10'
```

--------------------------------

### Import Tencent Advertising SDK

Source: https://developers.e.qq.com/mktui/adtargeting/utils

Import necessary modules from the Tencent Advertising SDK. Ensure you have the SDK installed.

```javascript
import { AdTargeting } from '@tencent/tsaui';
const { AdTargetingUtils } = AdTargeting;
const { utils, validator } = AdTargetingUtils;
```

--------------------------------

### GET /optimization_goal_permissions/get

Source: https://developers.e.qq.com/v3.0/pages/adgroups/add

Retrieve valid optimization goal combinations based on marketing objectives and delivery settings.

```APIDOC
## GET /optimization_goal_permissions/get

### Description
Retrieve the available optimization goal combinations for a specific marketing objective, carrier, and placement.

### Method
GET

### Endpoint
optimization_goal_permissions/get
```

--------------------------------

### CDN Installation for Marketing UI

Source: https://developers.e.qq.com/mktui/start/struct

Includes React, React DOM, and Marketing UI resources via CDN. The webpack.config.js externals configuration is also provided for compatibility.

```html
<!-- react 官方资源，参见 https://reactjs.org/docs/cdn-links.html -->
<script crossorigin src=https://unpkg.com/react@16/umd/react.production.min.js></script>
<script crossorigin src=https://unpkg.com/react-dom@16/umd/react-dom.production.min.js></script>
<!-- Marketing UI 资源 （总包和模块包可选择其一） -->

// 总包
<script type=text/javascript src=https://i.gtimg.cn/qzone/biz/gdt/lib/mktui/1.1.22/js/mktui.min.js></script>

// 模块包
<script type=text/javascript src=https://i.gtimg.cn/qzone/biz/gdt/lib/mktui-adcreative/1.1.8/js/mktui-adcreative.min.js></script>
<script type=text/javascript src=https://i.gtimg.cn/qzone/biz/gdt/lib/mktui-adtargeting/1.1.4/js/mktui-adtargeting.min.js></script>
<script type=text/javascript src=https://i.gtimg.cn/qzone/biz/gdt/lib/mktui-report/1.1.0/js/mktui-report.min.js></script>
<script type=text/javascript src=https://i.gtimg.cn/qzone/biz/gdt/lib/mktui-tools/1.1.2/js/mktui-tools.min.js></script>

// webpack.config.js，需要配置externals
module.exports = {
    ...
    externals: {
        '@tencent/mktui': 'MKTUI',
        '@tencent/mktui-adcreative': 'MKTUI_ADCREATIVE',
        '@tencent/mktui-adtargeting': 'MKTUI_ADTARGETING',
        '@tencent/mktui-report': 'MKTUI_REPORT',
        '@tencent/mktui-tools': 'MKTUI_TOOLS',
        'react': 'React',
        'react-dom': 'ReactDOM'
    }
}
```

--------------------------------

### Load Marketing UI Component Package

Source: https://developers.e.qq.com/mktui/adtargeting/quickstart

Import necessary components from the '@tencent/mktui' package for ad targeting functionality. Ensure the component package is installed.

```javascript
import React, { Component } from 'react';
import { render } from 'react-dom';

import { AdTargeting } from '@tencent/mktui';
const { AdTargetingForm, AdTargetingUtils } = AdTargeting;
const { validator } = AdTargetingUtils;
const { validateField, validateTargeting } = validator;
```

--------------------------------

### 安装样式相关 npm 包

Source: https://developers.e.qq.com/mktui/start/struct

安装处理 CSS、URL 和 SVG 文件的 webpack loader。

```bash
npm i --save-dev babel-loader css-loader url-loader svg-url-loader
```

--------------------------------

### GET advertiser/get

Source: https://developers.e.qq.com/v3.0/pages/news/info/20260115

查询腾讯广告广告主接口调整，移除部分资质及微信相关字段。

```APIDOC
## GET advertiser/get

### Description
查询广告主信息。自 2026 年 1 月 26 日起，接口返回将移除以下字段：industry_qualification_image_id_list、industry_qualification_image、ad_qualification_image_id_list、ad_qualification_image、wechat_spec、is_local_business。

### Method
GET

### Endpoint
advertiser/get

### Response
#### Success Response (200)
- **industry_qualification_image_id_list** (removed) - 行业资质图片 id 列表
- **industry_qualification_image** (removed) - 行业资质证明图片 url 地址
- **ad_qualification_image_id_list** (removed) - 广告资质图片 id 列表
- **ad_qualification_image** (removed) - 广告资质证明图片 url 地址
- **wechat_spec** (removed) - 微信广告开户信息
- **is_local_business** (removed) - 是否附近推账号
```

--------------------------------

### Add Dynamic Creative API Parameters

Source: https://developers.e.qq.com/news

Example parameters for the dynamic_creatives/add API. Ensure required parameters like brand image and action button are provided.

```json
{
    "creative_name": "test_creative_name",
    "promoted_object_type": "CAMPAIGN",
    "promoted_object_id": "12345",
    "creative_template_id": 712,
    "creative_elements": {
        "brand_logo_id": "logo_id",
        "title": {
            "text": "title_text",
            "color": "#000000"
        },
        "description": {
            "text": "description_text",
            "color": "#000000"
        },
        "image": {
            "url": "image_url"
        },
        "video": {
            "url": "video_url"
        },
        "call_to_action": {
            "type": "WEBSITE",
            "url": "https://www.example.com",
            "text": "Learn More"
        }
    }
}
```

--------------------------------

### GET targeting_tag_reports/get

Source: https://developers.e.qq.com/v3.0/pages/ad_insights

获取定向标签报表数据，支持按性别、年龄、地域等维度进行聚合查询。

```APIDOC
## GET targeting_tag_reports/get

### Description
以定向人群的性别、年龄、地域为维度查询报表数据。

### Method
GET

### Endpoint
targeting_tag_reports/get

### Parameters
#### Query Parameters
- **type** (string) - Required - 定向类型，如 GENDER, AGE, REGION, CITY
- **level** (string) - Required - 报表层级

### Response
#### Success Response (200)
- **list** (array) - 报表数据列表，仅包含有曝光量的条目
```

--------------------------------

### GET hourly_reports/get

Source: https://developers.e.qq.com/v3.0/pages/ad_insights

获取广告投放的小时报表数据，支持按小时及多种层级维度进行聚合查询。

```APIDOC
## GET hourly_reports/get

### Description
以小时为维度查询各层级的报表数据，支持按 hour 及不同 level 下的特定字段进行聚合。

### Method
GET

### Endpoint
hourly_reports/get

### Parameters
#### Query Parameters
- **level** (string) - Required - 报表层级，如 ADVERTISER, ADGROUP, DYNAMIC_CREATIVE 等
- **date** (string) - Required - 查询的具体日期

### Response
#### Success Response (200)
- **list** (array) - 报表数据列表，仅包含有曝光量的条目
```

--------------------------------

### POST /websites/developers_e_qq

Source: https://developers.e.qq.com/v3.0/pages/conversion_link_assets

This endpoint is used to configure conversion tracking. It accepts a variety of parameters to define the conversion event, attribution method, and associated marketing carrier.

```APIDOC
## POST /websites/developers_e_qq

### Description
Configures conversion tracking for marketing campaigns.

### Method
POST

### Endpoint
/websites/developers_e_qq

### Parameters
#### Request Body
- **account_id** (integer) - Required - The ID of the promotion account with operational permissions, including agent and advertiser account IDs.
- **conversion_name** (string) - Required - The name of the conversion. Minimum length is 1 EBCDIC character, maximum length is 60 EBCDIC characters (equivalent to 60 Chinese characters or full-width punctuation, or 120 English characters or half-width punctuation). Minimum byte length is 1, maximum byte length is 120.
- **access_type** (enum) - Required - The reporting method. SDK reporting is only supported for Android and iOS conversion scenarios. JS reporting is only supported for web conversion scenarios. See Enumeration Details for more information. Possible values: { ACCESS_TYPE_SDK, ACCESS_TYPE_API, ACCESS_TYPE_JS }.
- **conversion_scene** (enum) - Required - The conversion scene. For web and WeChat mini-program conversion scenarios, the promotion goal ID does not need to be entered. See Enumeration Details for more information. Possible values: { CONVERSION_SCENE_ANDROID, CONVERSION_SCENE_IOS, CONVERSION_SCENE_WEB, CONVERSION_SCENE_WECHAT_MINI_PROGRAM, CONVERSION_SCENE_WECHAT_MINI_GAME, CONVERSION_SCENE_QQ_MINI_GAME, CONVERSION_SCENE_QUICK_APP, CONVERSION_SCENE_WE_COM }.
- **marketing_carrier_id** (string) - Optional - The ID of the marketing carrier, such as Android app ID, iOS app ID, mini-game ID, etc. Minimum length is 0 bytes, maximum length is 2048 bytes.
- **app_android_channel_package_id** (string) - Optional - The Android app channel package ID. When the promotion goal type is Android app and the access method is SDK, you can fill in the channel package ID created by the android_union_channel_packages/add interface in the Market API. Only channel packages with a non-empty custom channel package ID can be selected, and only data with a consistent custom channel package ID will be counted as conversions. The channel package ID can be obtained from the read interface of the promotion goal module. The channel package ID field is composed of "xx;yy". When writing, xx will be set to 0. 0 is normal. Minimum byte length is 1, maximum byte length is 128.
- **claim_type** (enum) - Required - The attribution method. When using SDK reporting, the attribution method can only be CLAIM_TYPE_ACTIVATION. When using JS reporting, it must be CLAIM_TYPE_CLICK. Promotion for WeChat mini-games only supports CLAIM_TYPE_REGISTER. Promotion for QQ mini-games and enterprise WeChat promotion only supports CLAIM_TYPE_CLICK. APP type, WEB type, WeChat mini-program, and accounts configured with a whitelist support CLAIM_TYPE_IMPRESSION. See Enumeration Details for more information. Possible values: { CLAIM_TYPE_ACTIVATION, CLAIM_TYPE_CLICK, CLAIM_TYPE_REGISTER, CLAIM_TYPE_IMPRESSION }.
- **feedback_url** (string) - Optional - Monitoring link. The click monitoring link is used to receive click information from the platform and must be a valid URL. Refer to the documentation: Advertising Clicks. If self-attribution is true and conversion_scene is ANDROID or iOS, feedback_url is required. Maximum byte length is 2048 bytes.
- **landing_page_url** (string) - Optional - Please fill in the landing page URL of the promotion. It should be consistent with the URL in the reporting protocol. Tencent Advertising will generate a unique landing page ID based on this link. For the same domain and different landing page addresses with the same optimization goal, the conversion ID does not need to be created again. feedback_url and landing_page_url must have at least one parameter filled. In the self-attribution Web conversion scenario, it is recommended to fill in feedback_url and use callback to report behavior data. In the non-self-attribution Web conversion scenario, you can not fill in feedback_url, fill in landing_page_url, and use click_id to report behavior data. Default value: No default value! Maximum byte length is 2048 bytes.
- **mini_program_id** (string) - Optional - Mini-program appid. Required for WeChat mini-program conversion scenarios and enterprise WeChat scenarios. For enterprise WeChat scenarios, enter the WeChat mini-program appid bound to the enterprise WeChat. Minimum byte length is 1, maximum byte length is 384. Default value: No default value!
- **self_attributed** (boolean) - Required - Whether it is self-attribution. If set to true, it means self-attribution, and conversion data will be matched and reported to the platform by yourself. If set to false, it means full reporting, and all conversion data generated will be reported to the platform for attribution. Must be TRUE when the reporting method is API, and must be FALSE when the reporting method is SDK/JS. Possible values: { true, false }.
- **optimization_goal** (enum) - Required - The type of optimization goal. Supported optimization goals and their corresponding deep optimization goals can be queried through the "Query Optimization Goal Permissions" interface. See Enumeration Details for more information. Possible values: { OPTIMIZATIONGOAL_NONE, OPTIMIZATIONGOAL_BRAND_CONVERSION, OPTIMIZATIONGOAL_FOLLOW, OPTIMIZATIONGOAL_CLICK, OPTIMIZATIONGOAL_IMPRESSION, OPTIMIZATIONGOAL_APP_DOWNLOAD, OPTIMIZATIONGOAL_APP_ACTIVATE, OPTIMIZATIONGOAL_APP_REGISTER, OPTIMIZATIONGOAL_ONE_DAY_RETENTION, OPTIMIZATIONGOAL_APP_PURCHASE, OPTIMIZATIONGOAL_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_CHECKOUT, OPTIMIZATIONGOAL_LEADS, OPTIMIZATIONGOAL_ECOMMERCE_CART, OPTIMIZATIONGOAL_PROMOTION_CLICK_KEY_PAGE, OPTIMIZATIONGOAL_VIEW_COMMODITY_PAGE, OPTIMIZATIONGOAL_ONLINE_CONSULTATION, OPTIMIZATIONGOAL_TELEPHONE_CONSULTATION, OPTIMIZATIONGOAL_PAGE_RESERVATION, OPTIMIZATIONGOAL_DELIVERY, OPTIMIZATIONGOAL_MESSAGE_AFTER_FOLLOW, OPTIMIZATIONGOAL_CLICK_MENU_AFTER_FOLLOW, OPTIMIZATIONGOAL_PAGE_EFFECTIVE_ONLINE_CONSULT, OPTIMIZATIONGOAL_APPLY, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_CONSULT, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_PHONE, OPTIMIZATIONGOAL_LEADS_COLLECT, OPTIMIZATIONGOAL_FIRST_PURCHASE, OPTIMIZATIONGOAL_PRE_CREDIT, OPTIMIZATIONGOAL_CREDIT, OPTIMIZATIONGOAL_WITHDRAW_DEPOSITS, OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE, OPTIMIZATIONGOAL_MOBILE_APP_CREATE_ROLE, OPTIMIZATIONGOAL_CANVAS_CLICK, OPTIMIZATIONGOAL_PROMOTION_CLAIM_OFFER, OPTIMIZATIONGOAL_ECOMMERCE_ADD_TO_WISHLIST, OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_RESERVATION, OPTIMIZATIONGOAL_PAGE_RECEIPT, OPTIMIZATIONGOAL_PAGE_SCAN_CODE, OPTIMIZATIONGOAL_SELECT_COURSE, OPTIMIZATIONGOAL_CONFIRM_POTENTIAL_CUSTOMER_PHONE, OPTIMIZATIONGOAL_MOBILE_APP_AD_INCOME, OPTIMIZATIONGOAL_MOBILE_APP_ACCREDIT, OPTIMIZATIONGOAL_PURCHASE_MEMBER_CARD, OPTIMIZATIONGOAL_PAGE_CONFIRM_EFFECTIVE_LEADS, OPTIMIZATIONGOAL_RESERVATION, OPTIMIZATIONGOAL_FIRST_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_LIKE, OPTIMIZATIONGOAL_ADD_DESKTOP, OPTIMIZATIONGOAL_EXTERNAL_LINK_CLICK, OPTIMIZATIONGOAL_BUY_COUPONS, OPTIMIZATIONGOAL_LEAVE_INFORMATION, OPTIMIZATIONGOAL_CORE_ACTION, OPTIMIZATIONGOAL_ONE_DAY_RETENTION_RATIO, OPTIMIZATIONGOAL_PROMOTION_READ_ARTICLE, OPTIMIZATIONGOAL_FIRST_TWENTY_FOUR_HOUR_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ECOMMERCE_SCANCODE_WX, OPTIMIZATIONGOAL_MOBILE_APP_SEVEN_DAYS_RETENTION, OPTIMIZATIONGOAL_CLASS_PARTICIPATED, OPTIMIZATIONGOAL_INSURANCE_PURCHASE, OPTIMIZATIONGOAL_RESERVATION_CHECK, OPTIMIZATIONGOAL_OPEN_ACCOUNT, OPTIMIZATIONGOAL_SEVEN_DAY_ECOMMERCE_ORDER, OPTIMIZATIONGOAL_ADD_WECHAT, OPTIMIZATIONGOAL_WECOM_CONSULT, OPTIMIZATIONGOAL_ADD_GROUP, OPTIMIZATIONGOAL_QUICK_ORDER, OPTIMIZATIONGOAL_PRE_PAY, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_ACTIVE_ONE_MSG, OPTIMIZATIONGOAL_CALL_DURATION_THIRTY_SECONDS, OPTIMIZATIONGOAL_CLAIM_COURSE, OPTIMIZATIONGOAL_QUIT_GROUP, OPTIMIZATIONGOAL_VIEW_ACQUISITION_CONTENT, OPTIMIZATIONGOAL_BACK_FLOW, OPTIMIZATIONGOAL_PAGE_ONLINE_CONSULT_THREE_MSG, OPTIMIZATIONGOAL_RENEWAL, OPTIMIZA }.

### Request Example
```json
{
  "account_id": 12345,
  "conversion_name": "App Install",
  "access_type": "ACCESS_TYPE_SDK",
  "conversion_scene": "CONVERSION_SCENE_ANDROID",
  "marketing_carrier_id": "your_app_id",
  "claim_type": "CLAIM_TYPE_ACTIVATION",
  "self_attributed": false,
  "optimization_goal": "OPTIMIZATIONGOAL_APP_ACTIVATE"
}
```

### Response
#### Success Response (200)
- **conversion_id** (integer) - The unique identifier for the created conversion.
- **message** (string) - A confirmation message.

#### Response Example
```json
{
  "conversion_id": 98765,
  "message": "Conversion tracking configured successfully."
}
```
```

--------------------------------

### GET daily_reports/get

Source: https://developers.e.qq.com/v3.0/pages/ad_insights

获取广告投放的日报表数据，支持按天及多种层级维度进行聚合查询。

```APIDOC
## GET daily_reports/get

### Description
以天为维度查询各层级的报表数据，支持按 date 及不同 level 下的特定字段进行聚合。

### Method
GET

### Endpoint
daily_reports/get

### Parameters
#### Query Parameters
- **level** (string) - Required - 报表层级，如 ADVERTISER, ADGROUP, DYNAMIC_CREATIVE 等
- **date_range** (object) - Required - 查询的时间范围

### Response
#### Success Response (200)
- **list** (array) - 报表数据列表，仅包含有曝光量的条目
```

--------------------------------

### 加载公共样式 - React 组件引入

Source: https://developers.e.qq.com/mktui/start/struct

在 React 项目中，通过 import 语句引入 mktui 的 CSS 样式。仅适用于总包，模块包需使用 CDN。

```javascript
import '@tencent/mktui/lib/styles/css/mktui.css';
```

--------------------------------

### POST /callback (消息推送)

Source: https://developers.e.qq.com/v3.0/pages/subscription_callback

当订阅任务数据发生变动时，系统通过回调地址推送消息。

```APIDOC
## POST /callback (消息推送)

### Description
订阅任务数据变动时，系统向预设的回调地址推送消息。

### Method
POST

### Query Parameters
- **signature** (string) - 加密签名，sha1(post内容+secret)
- **timestamp** (integer) - 时间戳（秒）
- **nonce** (string) - 随机字符串

### Request Body
- **subscription_id** (integer) - 订阅任务ID
- **account_id_list** (integer[]) - 账户ID列表
- **subscription_type** (integer) - 订阅类型
- **message_id** (string) - 消息ID

### Request Example
{
  "subscription_id": 111111,
  "subscription_type": "REPORT_SUBSCRIPTION",
  "subscription_data": {
    "account_id_list": [11111111, 22222222]
  },
  "message_id": "MTAwNQ=="
}

### Response
#### Success Response (200)
- **code** (integer) - 返回状态码
- **message_id** (string) - 消息ID

#### Response Example
{
  "code": 0,
  "data": {
    "message_id": "MTAwNQ=="
  }
}
```

--------------------------------

### GET /adcreatives/get

Source: https://developers.e.qq.com/news/info/20210303

Retrieve advertising creative information.

```APIDOC
## GET /adcreatives/get

### Description
Retrieve advertising creative information. For WeChat official accounts, filtering is restricted to adcreative_id and last_modified_time.

### Method
GET

### Endpoint
adcreatives/get

### Parameters
#### Query Parameters
- **filtering** (struct) - Optional - Filter criteria including adcreative_id or last_modified_time.
```

--------------------------------

### Initialize AdCreativeForm

Source: https://developers.e.qq.com/mktui/adcreative/components

Basic usage of the AdCreativeForm component by importing it from the @tencent/mktui package.

```javascript
import { AdCreative } from '@tencent/mktui';
const { AdCreativeForm } = AdCreative;
<AdCreativeForm {...this.props} />
```

--------------------------------

### GET /conversions/get

Source: https://developers.e.qq.com/v3.0/pages/conversion_link_assets

Retrieves the conversion rules associated with a specific marketing funnel.

```APIDOC
## GET /conversions/get

### Description
Retrieves the conversion rules associated with a marketing funnel after the rules have been created.

### Method
GET

### Endpoint
conversions/get

### Reference
https://developers.e.qq.com/v3.0/docs/api/conversions/get
```

--------------------------------

### GET marketing_target_asset_properties/get

Source: https://developers.e.qq.com/v3.0/pages/marketing_product

Queries the supported attributes and properties for a specific asset category.

```APIDOC
## GET marketing_target_asset_properties/get

### Description
Retrieves the list of properties and attributes supported for a specific marketing asset category.

### Method
GET

### Endpoint
marketing_target_asset_properties/get

### Parameters
#### Request Body
- **marketing_asset_type** (string) - Required - The type of marketing asset.
- **organization_id** (integer) - Required - The ID of the organization.
- **marketing_target_type** (string) - Required - The type of marketing target.
- **marketing_asset_category** (string) - Required - The specific category name.

### Request Example
{
    "marketing_asset_type": "MARKETING_ASSET_TYPE_RENOVATION_SERVICES_SERVICE",
    "organization_id": 12345678,
    "marketing_target_type": "MARKETING_TARGET_TYPE_RENOVATION_SERVICES",
    "marketing_asset_category": "装修公司-全屋整装"
}

### Response
#### Success Response (200)
- **code** (integer) - Status code.
- **data** (object) - Contains the list of properties.

#### Response Example
{
	"code": 0,
	"data": {
		"list": [{
				"is_required": true,
				"property_type": "ATTRIBUTE_TYPE_ENUM",
				"property_cn": "公司名称",
				"property_name": "PROMOTED_ASSET_ATTR_KEY_RENOVATION_SERVICES_COMPANY_NAME"
			}
		]
	}
}
```

--------------------------------

### Create Product Sales Ad with Optimization Goal

Source: https://developers.e.qq.com/v3.0/pages/wechat_channel

Configure an ad campaign for product sales, specifying an optimization goal like e-commerce orders. Ensure dates, bid mode, and conversion ID are set correctly.

```json
{
    "account_id": 12345,
    "adgroup_name": "商品销售广告_08_22_16:50:35",
    "marketing_goal": "MARKETING_GOAL_PRODUCT_SALES",
    "marketing_sub_goal": "MARKETING_SUB_GOAL_UNKNOWN",
    "marketing_carrier_type": "MARKETING_CARRIER_TYPE_JUMP_PAGE",
    "marketing_asset_id": 32473684,
    "site_set": [
        "SITE_SET_CHANNELS"
    ],
    "exploration_strategy": "STEADY_EXPLORATION",
    "begin_date": "2025-08-22",
    "end_date": "2026-08-22",
    "optimization_goal": "OPTIMIZATIONGOAL_ECOMMERCE_ORDER",
    "time_series": " ",
    "bid_mode": "BID_MODE_OCPM",
    "conversion_id": 52450254,
    "smart_bid_type": "SMART_BID_TYPE_CUSTOM",
    "automatic_site_enabled": false,
    "search_expand_targeting_switch": "SEARCH_EXPAND_TARGETING_SWITCH_CLOSE",
    "search_expansion_switch": "SEARCH_EXPANSION_SWITCH_OPEN",
    "enable_steady_exploration": true,
    "search_bidwords": [

    ],
    "bid_amount": 16607,
    "scene_spec": {

    },
    "aoi_optimization_strategy": {
        "aoi_optimization_strategy_enabled": true
    },
    "bid_amount_suggest": {
        "bid_amount": {
            "min": 9858,
            "max": 19201
        }
    },
    "targeting": {

    }
}
```

--------------------------------

### GET /oauth/authorize

Source: https://developers.e.qq.com/v3.0/pages/authorization_and_authentication

Redirects the user to the authorization page to obtain an authorization code.

```APIDOC
## GET /oauth/authorize

### Description
Redirects the user to the OAuth 2.0 login and authorization page to obtain an authorization code.

### Method
GET

### Endpoint
https://developers.e.qq.com/oauth/authorize

### Parameters
#### Query Parameters
- **client_id** (integer) - Required - Developer application ID.
- **redirect_uri** (string) - Required - Callback URL, must be URL encoded.
- **state** (string) - Optional - Developer custom parameter for validation.
- **scope** (string) - Optional - Authorization scope.
- **account_type** (string) - Optional - Account type (QQ or WeChat).
```