广点通API文档详解

广点通API简介

广点通API是腾讯推出的一项针对广告投放的服务，旨在为广告主提供高效的广告管理和数据分析工具。通过API，广告主可以实现广告投放的自动化管理，实时获取广告效果数据，并根据数据反馈进行优化调整。这种方式不仅提高了广告投放的效率，也为广告主节省了大量的人力资源。

在广点通API的使用中，广告主可以绑定自己的广点通账号，通过API获取广告相关的数据。这些数据包括广告的曝光、点击、转化等信息，广告主可以根据这些数据进行广告的优化调整。

广点通API

广点通API的使用场景

广点通API适用于多种广告投放场景，尤其是在以下几个方面表现出色：

广告投放自动化：通过API，广告主可以实现广告投放的自动化管理，从而减少人工操作的时间和错误。
实时数据获取：API可以实时获取广告的曝光、点击、转化等数据，帮助广告主及时了解广告效果。
广告效果分析：通过API获取的数据，广告主可以进行广告效果的详细分析，从而优化广告策略，提高广告ROI。

广告投放自动化

广告投放自动化是广点通API的一大特点。通过API，广告主可以设置投放策略、预算、目标受众等参数，实现广告的自动化投放。这样不仅提高了投放效率，也减少了人工操作的时间。

实时数据获取

实时数据获取是广告主进行广告效果分析的重要基础。通过广点通API，广告主可以实时获取广告的曝光、点击、转化等数据，从而及时了解广告效果，为后续的优化调整提供数据支持。

实时数据获取

广点通API的功能模块

广点通API包含多个功能模块，广告主可以根据自己的需求选择使用。其中主要包括：

广告管理模块：用于创建、修改、删除广告，以及管理广告的投放策略和预算。
数据接口模块：用于获取广告的曝光、点击、转化等数据，帮助广告主进行效果分析。
用户管理模块：用于管理广告主的账户信息，包括账户的创建、修改和删除。

广告管理模块

广告管理模块是广点通API的核心模块之一。通过该模块，广告主可以创建、修改、删除广告，以及管理广告的投放策略和预算。这一模块的使用，可以帮助广告主实现广告投放的自动化管理。

import requests

url = "https://api.gdt.tencent.com/v1/ad/create"
data = {
    "account_id": "123456",
    "ad_name": "新广告",
    "budget": 1000,
    "target_audience": "18-35"
}
response = requests.post(url, json=data)
print(response.json())

数据接口模块

数据接口模块用于获取广告的曝光、点击、转化等数据。广告主可以通过该模块实时获取广告效果数据，及时进行效果分析和优化调整。

广点通API的绑定与授权

在使用广点通API之前，广告主需要进行账号的绑定与授权。绑定与授权的过程主要包括以下几个步骤：

账号绑定：在恒远鑫达后台，进入渠道管理，点击“绑定投放账号”，填写账号别名、投放账号及账号ID。
授权登录：点击授权，进入授权界面，选择“同意授权”。需要使用填写的投放账号与密码登录授权。
产品选择：返回恒远鑫达配置后台，选择“授权完成”，并在“选择产品”中选择广点通后台对应投放的产品。

账号绑定

在账号绑定过程中，广告主需要在恒远鑫达后台进入渠道管理，点击“绑定投放账号”，然后填写账号别名、投放账号及账号ID。账号ID与广点通后台相对应，确保填写的账号信息准确无误。

授权登录

完成账号绑定后，广告主需要进行授权登录。点击授权按钮，进入授权界面，选择“同意授权”。授权过程中需要使用填写的投放账号与密码进行登录。

授权登录

广点通API的数据展示

通过广点通API获取的数据，可以在恒远鑫达后台进行展示。广告主可以根据这些数据了解广告的效果，并进行相应的优化调整。

数据展示包括广告的曝光、点击、转化等信息。这些数据可以帮助广告主进行广告效果的详细分析，从而优化广告策略，提高广告ROI。

广点通API的自定义回调

广点通API支持自定义回调功能，广告主可以根据需要设置“注册”、“付费”等事件的回调。通过回调功能，广告主可以及时获取广告的转化数据，并进行相应的优化调整。

创建自定义回调

在恒远鑫达后台，进入推广活动管理，选择自定义回调管理，选择“广点通”渠道，并在事件中选择“注册”或“付费”。

// 示例代码：创建自定义回调
{
    "channel": "广点通",
    "event": "注册",
    "callback_url": "https://yourcallback.url"
}

自定义回调

广点通API的方案选择

广点通API提供了两种方案供广告主选择：方案一和方案二。广告主可以根据自己的需求选择合适的方案。

方案一

方案一需要广告主在广点通后台填写feedback URL。恒远鑫达实时将激活数据与广点通回传的点击数据进行匹配，将匹配成功的激活数据请求广点通，由广点通返回激活信息、广告名称等信息。

方案二

方案二为广点通自归因，广告主无需填写feedback URL。恒远鑫达实时将全部激活请求广点通，广点通返回激活信息、点击时间、广告名称等信息。

FAQ

问：如何绑定广点通账号？
- 答：在恒远鑫达后台，进入渠道管理，点击“绑定投放账号”，填写账号别名、投放账号及账号ID，完成绑定。
问：广点通API支持哪些数据接口？
- 答：广点通API支持广告曝光、点击、转化等多种数据接口，广告主可以根据需要选择适合的数据接口进行分析。
问：广点通API的方案一和方案二有何区别？
- 答：方案一需要广告主在广点通后台填写feedback URL，方案二为自归因，不需要填写feedback URL。
问：如何创建自定义回调事件？
- 答：在恒远鑫达后台进入推广活动管理，选择自定义回调管理，选择“广点通”渠道，并在事件中选择“注册”或“付费”。
问：广点通API如何进行授权？
- 答：在账号绑定后，点击授权，进入授权界面，选择“同意授权”，使用填写的投放账号与密码进行登录。