接口文档SDK业务专题开发者工具

人群价值分析

                <?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)
}