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