<?php
require_once __DIR__ . '/../../../vendor/autoload.php'; // change path as needed
use TencentAds\TencentAds;
use TencentAds\Exception\TencentAdsResponseException;
use TencentAds\Exception\TencentAdsSDKException;
/*****
* 本文件提供了一个创建广告创意(Adcreative)的简单示例
*/
class AddAdcreatives
{
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 $ADCREATIVE_TEMPLATE_ID = 968; // 文字链
public static $AD_TITLE = 'YOUR AD TEXT'; // 广告标题,968规格要求:字数:10~14
public static $AD_DESCRIPTION = 'YOUR AD DESCRIPTION'; // 广告文案,968规格要求:字数:24~30
public static $PAGE_TYPE = 'PAGE_TYPE_DEFAULT'; // 默认落地页类型
public static $PAGE_URL = 'YOUR AD PAGE URL'; // 广告落地页地址
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;
$adcreativeName = 'SDK广告创意' . uniqid();
$adcreativeElements = [
'title' => static::$AD_TITLE,
'description' => static::$AD_DESCRIPTION,
];
$pageSpec = [
'page_url' => static::$PAGE_URL,
];
$response = $tads->adcreatives()
->add([
'account_id' => static::$ACCOUNT_ID,
'campaign_id' => static::$CAMPAIGN_ID,
'adcreative_name' => $adcreativeName,
'adcreative_template_id' => static::$ADCREATIVE_TEMPLATE_ID,
'adcreative_elements' => $adcreativeElements,
'promoted_object_type' => static::$PROMOTED_OBJECT_TYPE,
'page_type' => static::$PAGE_TYPE,
'site_set' => [static::$SITE_SET],
'page_spec' => $pageSpec,
]);
$adcreativeId = $response->getAdcreativeId();
return $adcreativeId;
} 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 AddAdcreatives();
$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.AdcreativesAddRequest;
import java.util.Arrays;
import java.util.List;
public class AddAdcreatives {
/** YOUR ACCESS TOKEN */
public String ACCESS_TOKEN = "YOUR ACCESS TOKEN";
/** TencentAds */
public TencentAds tencentAds;
public Long accountId = null;
public AdcreativesAddRequest data = new AdcreativesAddRequest();
public Long adcreativeTemplateId = 968L;
public String title = "YOUR AD TEXT";
public String description = "YOUR AD DESCRIPTION";
public DestinationType pageType = DestinationType.DEFAULT;
public String pageUrl = "YOUR AD PAGE URL";
public PromotedObjectType promotedObjectType = PromotedObjectType.LINK;
public String adcreativeName = "SDK广告创意5ede2529029e9";
public List<String> siteSet = Arrays.asList("SITE_SET_QZONE");
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.setAccountId(accountId);
data.setAdcreativeTemplateId(adcreativeTemplateId);
AdcreativeCreativeElementsMp adcreativeElements = new AdcreativeCreativeElementsMp();
adcreativeElements.setTitle(title);
adcreativeElements.setDescription(description);
data.setAdcreativeElements(adcreativeElements);
data.setPageType(pageType);
PageSpec pageSpec = new PageSpec();
pageSpec.setPageUrl(pageUrl);
data.setPageSpec(pageSpec);
data.setPromotedObjectType(promotedObjectType);
data.setAdcreativeName(adcreativeName);
data.setSiteSet(siteSet);
data.setCampaignId(campaignId);
}
public AdcreativesAddResponseData addAdcreatives() throws Exception {
AdcreativesAddResponseData response = tencentAds.adcreatives().adcreativesAdd(data);
return response;
}
public static void main(String[] args) {
try {
AddAdcreatives addAdcreatives = new AddAdcreatives();
addAdcreatives.init();
AdcreativesAddResponseData response = addAdcreatives.addAdcreatives();
} 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 AdcreativesAddExample struct {
TAds *ads.SDKClient
AccessToken string
Data model.AdcreativesAddRequest
}
func (e *AdcreativesAddExample) Init() {
e.AccessToken = "YOUR ACCESS TOKEN"
e.TAds = ads.Init(&config.SDKConfig{
AccessToken: e.AccessToken,
IsDebug: true,
})
e.Data = model.AdcreativesAddRequest{
AccountId: int64(0),
AdcreativeTemplateId: int64(0),
AdcreativeElements: &model.AdcreativeCreativeElementsMp{
Title: "YOUR AD TEXT",
Description: "YOUR AD DESCRIPTION",
},
PageType: model.DestinationType_DEFAULT,
PageSpec: &model.PageSpec{
PageUrl: "YOUR AD PAGE URL",
},
PromotedObjectType: model.PromotedObjectType_LINK,
AdcreativeName: "SDK广告创意5ede2529029e9",
SiteSet: &[]string{"SITE_SET_QZONE"},
CampaignId: int64(0),
}
}
func (e *AdcreativesAddExample) RunExample() (model.AdcreativesAddResponseData, http.Header, error) {
tads := e.TAds
// change ctx as needed
ctx := *tads.Ctx
return tads.Adcreatives().Add(ctx, e.Data)
}
func main() {
e := &AdcreativesAddExample{}
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)
}