巨量引擎广告 转化回传 API 对接说明
时间: 2023-08-03 08:04:40 浏览: 954
巨量引擎广告转化回传 API 可以用于将广告转化数据回传给巨量引擎,帮助广告主更好地评估广告效果和优化广告投放策略。下面是巨量引擎广告转化回传 API 的对接说明:
1. 获取 API 认证信息:在巨量引擎广告后台获取 API 认证信息,包括 App ID、App Key 和 Access Token。其中,App ID 和 App Key 是用于对接巨量引擎广告 API 的密钥,Access Token 是用于获取授权访问权限的令牌。
2. 创建转化回传 API:在巨量引擎广告后台创建转化回传 API,包括 API 名称、回传 URL、回传参数等信息。其中,回传 URL 是用于接收转化数据的 URL,回传参数是用于标识和描述转化数据的参数。
3. 调用转化回传 API:在广告转化发生时,调用转化回传 API,将转化数据以 JSON 格式 POST 提交到回传 URL,同时在 POST 请求头中添加 App ID 和 Access Token 等认证信息,确保数据能够被正确接收和处理。
4. 处理转化数据:在回传 URL 中接收并处理转化数据,根据回传参数解析和处理数据,并将数据保存到数据库或其他数据存储介质中。
以下是一个使用 PHP CURL 调用巨量引擎广告转化回传 API 的示例代码:
```php
// API 认证信息
$app_id = "your_app_id";
$app_key = "your_app_key";
$access_token = "your_access_token";
// 转化回传 API URL
$url = "http://your_callback_url";
// 转化数据
$data = array(
"event_type" => "active",
"user_id" => "your_user_id",
"order_id" => "your_order_id",
"order_price" => "your_order_price"
);
// 创建 CURL 请求
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
"Content-Type: application/json",
"X-SS-App-Id: " . $app_id,
"X-SS-Access-Token: " . $access_token
));
// 发送请求并获取响应
$response = curl_exec($ch);
curl_close($ch);
// 处理响应
if ($response == "success") {
// 转化回传成功,记录日志或其他处理
} else {
// 转化回传失败,记录日志或其他处理
}
```
以上代码中,需要将 `$app_id`、`$app_key` 和 `$access_token` 替换为实际的 API 认证信息,将 `$url` 替换为实际的转化回传 API URL,将 `$data` 替换为实际的转化数据。处理响应的方式可以根据实际情况进行调整。
阅读全文