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

创建广告组

                <?php
require_once __DIR__ . '/../../../vendor/autoload.php'; // change path as needed
use TencentAds\TencentAds;
use TencentAds\Exception\TencentAdsResponseException;
use TencentAds\Exception\TencentAdsSDKException;

/*****
 * 本文件提供了一个创建广告组(Adgroup)的简单示例
 */
class AddAdgroups
{
    public static $tads;
    public static $ACCESS_TOKEN         = 'YOUR ACCESS TOKEN';
    public static $ACCOUNT_ID           = 'YOUR ACCOUNT ID';
    public static $CAMPAIGN_ID          = 'YOUR CAMPAIGN ID';
    public static $PROMOTED_OBJECT_TYPE = 'PROMOTED_OBJECT_TYPE_LINK'; // 推广普通外链
    public static $SITE_SET             = 'SITE_SET_QZONE'; // 投放QQ空间流量
    public static $BILLING_EVENT        = 'BILLINGEVENT_IMPRESSION'; // 按曝光扣费(CPM)
    public static $OPTIMIZATION_GOAL    = 'OPTIMIZATIONGOAL_IMPRESSION'; // 广告目标优化类型:曝光
    public static $BID_AMOUNT           = 150; // 出价1.5元(150分)
    public static $BEGIN_DATE           = 'YOUR ADGROUP BEGIN DATE'; // 广告开始投放日期
    public static $END_DATE             = 'YOUR ADGROUP 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;

            $adgroupName = 'SDK广告组' . uniqid();
            $timeSeries = str_repeat('1', 48 * 7); // 全天投放
            $targeting = [
                'user_os' => ['IOS'], // 定向IOS用户
            ];

            $response = $tads->adgroups()
                             ->add([
                                 'account_id'           => static::$ACCOUNT_ID,
                                 'campaign_id'          => static::$CAMPAIGN_ID,
                                 'adgroup_name'         => $adgroupName,
                                 'promoted_object_type' => static::$PROMOTED_OBJECT_TYPE,
                                 'begin_date'           => static::$BEGIN_DATE,
                                 'end_date'             => static::$END_DATE,
                                 'billing_event'        => static::$BILLING_EVENT,
                                 'bid_amount'           => static::$BID_AMOUNT,
                                 'optimization_goal'    => static::$OPTIMIZATION_GOAL,
                                 'time_series'          => $timeSeries,
                                 'site_set'             => [static::$SITE_SET],
                                 'targeting'            => $targeting,
                             ]);
            $adgroupId = $response->getAdgroupId();

            return $adgroupId;
        } 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 AddAdgroups();
        $example->init();
        $example->main();
    } catch (\Exception $e) {
        exit(-1);
    }
}
            
                package com.tencent.ads.examples.BasicOperations.AdsManagement;

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.AdgroupsAddRequest;
import java.util.Arrays;
import java.util.List;

public class AddAdgroups {
  /** YOUR ACCESS TOKEN */
  public String ACCESS_TOKEN = "YOUR ACCESS TOKEN";

  /** TencentAds */
  public TencentAds tencentAds;

  public String endDate = "YOUR ADGROUP END DATE";
  public AdgroupsAddRequest data = new AdgroupsAddRequest();
  public OptimizationGoal optimizationGoal = OptimizationGoal.IMPRESSION;
  public List<String> userOs = Arrays.asList("IOS");
  public Long accountId = null;
  public Long bidAmount = 150L;
  public BillingEvent billingEvent = BillingEvent.IMPRESSION;
  public String timeSeries =
      "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111";
  public PromotedObjectType promotedObjectType = PromotedObjectType.LINK;
  public String beginDate = "YOUR ADGROUP BEGIN DATE";
  public List<String> siteSet = Arrays.asList("SITE_SET_QZONE");
  public String adgroupName = "SDK广告组5ede25290dec2";
  public Long campaignId = null;

  public void init() {
    this.tencentAds = TencentAds.getInstance();
    this.tencentAds.init(
        new ApiContextConfig().accessToken(ACCESS_TOKEN).isDebug(true)); // debug==true 会打印请求详细信息
    this.tencentAds.useSandbox(); // 默认使用沙箱环境,如果要请求线上,这里需要设为线上环境
    this.buildParams();
  }

  public void buildParams() {
    data.setEndDate(endDate);

    data.setOptimizationGoal(optimizationGoal);

    WriteTargetingSettingForAdgroup targeting = new WriteTargetingSettingForAdgroup();
    targeting.setUserOs(userOs);
    data.setTargeting(targeting);

    data.setAccountId(accountId);

    data.setBidAmount(bidAmount);

    data.setBillingEvent(billingEvent);

    data.setTimeSeries(timeSeries);

    data.setPromotedObjectType(promotedObjectType);

    data.setBeginDate(beginDate);

    data.setSiteSet(siteSet);

    data.setAdgroupName(adgroupName);

    data.setCampaignId(campaignId);
  }

  public AdgroupsAddResponseData addAdgroups() throws Exception {
    AdgroupsAddResponseData response = tencentAds.adgroups().adgroupsAdd(data);
    return response;
  }

  public static void main(String[] args) {
    try {
      AddAdgroups addAdgroups = new AddAdgroups();
      addAdgroups.init();
      AdgroupsAddResponseData response = addAdgroups.addAdgroups();
    } 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/tencentad/marketing-api-go-sdk/pkg/ads"
	"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 AdgroupsAddExample struct {
	TAds        *ads.SDKClient
	AccessToken string
	Data        model.AdgroupsAddRequest
}

func (e *AdgroupsAddExample) Init() {
	e.AccessToken = "YOUR ACCESS TOKEN"
	e.TAds = ads.Init(&config.SDKConfig{
		AccessToken: e.AccessToken,
		IsDebug:     true,
	})
	e.Data = model.AdgroupsAddRequest{
		EndDate:          "YOUR ADGROUP END DATE",
		OptimizationGoal: model.OptimizationGoal_IMPRESSION,
		Targeting: &model.WriteTargetingSettingForAdgroup{
			UserOs: &[]string{"IOS"},
		},
		AccountId:          int64(0),
		BidAmount:          int64(0),
		BillingEvent:       model.BillingEvent_IMPRESSION,
		TimeSeries:         "111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111",
		PromotedObjectType: model.PromotedObjectType_LINK,
		BeginDate:          "YOUR ADGROUP BEGIN DATE",
		SiteSet:            &[]string{"SITE_SET_QZONE"},
		AdgroupName:        "SDK广告组5ede25290dec2",
		CampaignId:         int64(0),
	}
}

func (e *AdgroupsAddExample) RunExample() (model.AdgroupsAddResponseData, http.Header, error) {
	tads := e.TAds
	// change ctx as needed
	ctx := *tads.Ctx
	return tads.Adgroups().Add(ctx, e.Data)
}

func main() {
	e := &AdgroupsAddExample{}
	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)
}