<?php
require_once __DIR__ . '/../../../vendor/autoload.php'; // change path as needed
use TencentAds\TencentAds;
use TencentAds\Exception\TencentAdsResponseException;
use TencentAds\Exception\TencentAdsSDKException;
/*****
* 本文件提供了一个获取人群报表(Custom audience report)列表的简单示例
*/
class GetCustomAudienceReports
{
public static $tads;
public static $ACCESS_TOKEN = 'YOUR ACCESS TOKEN';
public static $ACCOUNT_ID = 'YOUR ACCOUNT ID';
public static $AUDIENCE_ID = 'YOUR AUDIENCE ID'; // 人群ID
public static $START_DATE = 'REPORT START DATE'; // 报表开始日期
public static $END_DATE = 'REPORT END DATE'; // 报表结束日期
public function init()
{
$tads = TencentAds::init([
'access_token' => static::$ACCESS_TOKEN,
'is_debug' => true,
]);
$tads->useSandbox(); // 默认访问沙箱环境,如访问正式环境,请切换为$tads->useProduction()
static::$tads = $tads;
return $tads;
}
public function main()
{
try {
/* @var TencentAds $tads */
$tads = static::$tads;
$filtering = [
[
'field' => 'audience_id',
'operator' => 'IN',
'values' => [static::$AUDIENCE_ID],
],
[
'field' => 'audience_platform',
'operator' => 'EQUALS',
'values' => ['DMP'],
],
]; // 过滤条件
$fields = [
'audience_id', 'account_id', 'adgroup_id', 'campaign_id', 'wechat_adgroup_id', 'wechat_campaign_id',
'model_id', 'audience_predict_task_id', 'action_type', 'cost', 'action_count', 'user_count',
]; // 需要返回的字段
$response = $tads->customAudienceReports()
->get([
'account_id' => static::$ACCOUNT_ID,
'date_range' => [
'start_date' => static::$START_DATE,
'end_date' => static::$END_DATE,
],
'filtering' => $filtering,
'fields' => $fields,
]);
// 从返回里获得Report信息
foreach ($response->getList() as $report) {
// echo $report . PHP_EOL;
}
return $response;
} catch (TencentAdsResponseException $e) {
// When Api returns an error
echo 'Tencent ads returned an error: ' . $e->getMessage() . PHP_EOL;
throw $e;
} catch (TencentAdsSDKException $e) {
// When validation fails or other local issues
echo 'Tencent ads SDK returned an error: ' . $e->getMessage() . PHP_EOL;
throw $e;
} catch (Exception $e) {
echo 'Other exception: ' . $e->getMessage() . PHP_EOL;
throw $e;
}
}
}
if (basename($_SERVER['PHP_SELF']) == basename(__FILE__)) {
try {
$example = new GetCustomAudienceReports();
$example->init();
$example->main();
} catch (\Exception $e) {
exit(-1);
}
}
package com.tencent.ads.examples.BasicOperations.Insights;
import com.tencent.ads.ApiContextConfig;
import com.tencent.ads.TencentAds;
import com.tencent.ads.exception.TencentAdsResponseException;
import com.tencent.ads.exception.TencentAdsSDKException;
import com.tencent.ads.model.*;
import com.tencent.ads.model.DateRange;
import com.tencent.ads.model.FilteringStruct;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;
public class GetCustomAudienceReports {
/** YOUR ACCESS TOKEN */
public String ACCESS_TOKEN = "YOUR ACCESS TOKEN";
/** TencentAds */
public TencentAds tencentAds;
public Long accountId = null;
public List<FilteringStruct> filtering = new ArrayList<>();
public DateRange dateRange = new DateRange();
public List<String> groupBy = null;
public List<String> fields =
Arrays.asList(
"audience_id",
"account_id",
"adgroup_id",
"campaign_id",
"wechat_adgroup_id",
"wechat_campaign_id",
"model_id",
"audience_predict_task_id",
"action_type",
"cost",
"action_count",
"user_count");
public void init() {
this.tencentAds = TencentAds.getInstance();
this.tencentAds.init(
new ApiContextConfig().accessToken(ACCESS_TOKEN).isDebug(true)); // debug==true 会打印请求详细信息
this.buildParams();
}
public void buildParams() {
String field = "audience_id";
FilteringStruct filteringStruct = new FilteringStruct();
filteringStruct.setField(field);
String operator = "IN";
filteringStruct.setOperator(operator);
List<String> values = Arrays.asList("YOUR AUDIENCE ID");
filteringStruct.setValues(values);
String field_1 = "audience_platform";
FilteringStruct filteringStruct_1 = new FilteringStruct();
filteringStruct_1.setField(field_1);
String operator_1 = "EQUALS";
filteringStruct_1.setOperator(operator_1);
List<String> values_1 = Arrays.asList("DMP");
filteringStruct_1.setValues(values_1);
filtering.add(filteringStruct);
filtering.add(filteringStruct_1);
String startDate = "REPORT START DATE";
dateRange.setStartDate(startDate);
String endDate = "REPORT END DATE";
dateRange.setEndDate(endDate);
}
public CustomAudienceReportsGetResponseData getCustomAudienceReports() throws Exception {
CustomAudienceReportsGetResponseData response =
tencentAds
.customAudienceReports()
.customAudienceReportsGet(accountId, filtering, dateRange, groupBy, fields);
return response;
}
public static void main(String[] args) {
try {
GetCustomAudienceReports getCustomAudienceReports = new GetCustomAudienceReports();
getCustomAudienceReports.init();
CustomAudienceReportsGetResponseData response =
getCustomAudienceReports.getCustomAudienceReports();
} catch (TencentAdsResponseException e) {
e.printStackTrace();
} catch (TencentAdsSDKException e) {
e.printStackTrace();
} catch (Exception e) {
e.printStackTrace();
}
}
}
/*
* Marketing API
*
* Marketing API
*
* API version: 1.3
* Generated by: Swagger Codegen (https://github.com/swagger-api/swagger-codegen.git)
*/
package main
import (
"encoding/json"
"fmt"
"net/http"
"github.com/antihax/optional"
"github.com/tencentad/marketing-api-go-sdk/pkg/ads"
"github.com/tencentad/marketing-api-go-sdk/pkg/api"
"github.com/tencentad/marketing-api-go-sdk/pkg/config"
"github.com/tencentad/marketing-api-go-sdk/pkg/errors"
"github.com/tencentad/marketing-api-go-sdk/pkg/model"
)
type CustomAudienceReportsGetExample struct {
TAds *ads.SDKClient
AccessToken string
AccountId int64
Filtering []model.FilteringStruct
DateRange model.DateRange
CustomAudienceReportsGetOpts *api.CustomAudienceReportsGetOpts
}
func (e *CustomAudienceReportsGetExample) Init() {
e.AccessToken = "YOUR ACCESS TOKEN"
e.TAds = ads.Init(&config.SDKConfig{
AccessToken: e.AccessToken,
IsDebug: true,
})
e.AccountId = int64(0)
e.Filtering = []model.FilteringStruct{{
Field: "audience_id",
Operator: "IN",
Values: &[]string{"YOUR AUDIENCE ID"},
}, {
Field: "audience_platform",
Operator: "EQUALS",
Values: &[]string{"DMP"},
}}
e.DateRange = model.DateRange{
StartDate: "REPORT START DATE",
EndDate: "REPORT END DATE",
}
e.CustomAudienceReportsGetOpts = &api.CustomAudienceReportsGetOpts{
Fields: optional.NewInterface([]string{"audience_id", "account_id", "adgroup_id", "campaign_id", "wechat_adgroup_id", "wechat_campaign_id", "model_id", "audience_predict_task_id", "action_type", "cost", "action_count", "user_count"}),
}
}
func (e *CustomAudienceReportsGetExample) RunExample() (model.CustomAudienceReportsGetResponseData, http.Header, error) {
tads := e.TAds
// change ctx as needed
ctx := *tads.Ctx
return tads.CustomAudienceReports().Get(ctx, e.AccountId, e.Filtering, e.DateRange, e.CustomAudienceReportsGetOpts)
}
func main() {
e := &CustomAudienceReportsGetExample{}
e.Init()
response, headers, err := e.RunExample()
if err != nil {
if resErr, ok := err.(errors.ResponseError); ok {
errStr, _ := json.Marshal(resErr)
fmt.Println("Response error:", string(errStr))
} else {
fmt.Println("Error:", err)
}
}
fmt.Println("Response data:", response)
fmt.Println("Headers:", headers)
}