<?php
require_once __DIR__ . '/../../../vendor/autoload.php'; // change path as needed
use TencentAds\TencentAds;
use TencentAds\Exception\TencentAdsResponseException;
use TencentAds\Exception\TencentAdsSDKException;
/*****
* 本文件提供了一个创建动态创意(Dynamic creative)的简单示例
*/
class AddDynamicCreatives
{
public static $tads;
public static $ACCESS_TOKEN = 'YOUR ACCESS TOKEN';
public static $ACCOUNT_ID = 'YOUR ACCOUNT ID';
public static $CAMPAIGN_TYPE = 'CAMPAIGN_TYPE_NORMAL'; // 普通推广计划
public static $PROMOTED_OBJECT_TYPE = 'PROMOTED_OBJECT_TYPE_LINK'; // 推广普通外链
public static $SITE_SET = 'SITE_SET_MOBILE_INNER'; // 投放移动站点流量
public static $ADCREATIVE_TEMPLATE_ID = 717; // 方形小图
public static $AD_IMAGE_ID = 'YOUR AD IMAGE'; // 广告图片,717规格要求:147x147, <30K, png/jpg
public static $AD_TITLE_1 = 'YOUR AD TEXT 1'; // 广告标题,717规格要求:字数:1~10
public static $AD_TITLE_2 = 'YOUR AD TEXT 2'; // 广告标题,717规格要求:字数:1~10
public static $AD_DESCRIPTION = 'YOUR AD DESCRIPTION'; // 广告文案,717规格要求:字数:1~18
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;
$dynamicCreativeName = 'SDK动态创意' . uniqid();
$dynamicCreativeElements = [
'image_options' => [static::$AD_IMAGE_ID],
'title_options' => [static::$AD_TITLE_1, static::$AD_TITLE_2],
'description_options' => [static::$AD_DESCRIPTION],
];
$pageSpec = [
'page_url' => static::$PAGE_URL,
];
$response = $tads->dynamicCreatives()
->add([
'account_id' => static::$ACCOUNT_ID,
'dynamic_creative_name' => $dynamicCreativeName,
'dynamic_creative_template_id' => static::$ADCREATIVE_TEMPLATE_ID,
'dynamic_creative_elements' => $dynamicCreativeElements,
'campaign_type' => static::$CAMPAIGN_TYPE,
'promoted_object_type' => static::$PROMOTED_OBJECT_TYPE,
'page_type' => static::$PAGE_TYPE,
'site_set' => [static::$SITE_SET],
'page_spec' => $pageSpec,
]);
$dynamicCreativeId = $response->getDynamicCreativeId();
return $dynamicCreativeId;
} 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 AddDynamicCreatives();
$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.DynamicCreativesAddRequest;
import java.util.Arrays;
import java.util.List;
public class AddDynamicCreatives {
/** YOUR ACCESS TOKEN */
public String ACCESS_TOKEN = "YOUR ACCESS TOKEN";
/** TencentAds */
public TencentAds tencentAds;
public Long accountId = null;
public DynamicCreativesAddRequest data = new DynamicCreativesAddRequest();
public List<String> imageOptions = Arrays.asList("YOUR AD IMAGE");
public List<String> titleOptions = Arrays.asList("YOUR AD TEXT 1", "YOUR AD TEXT 2");
public List<String> descriptionOptions = Arrays.asList("YOUR AD DESCRIPTION");
public DestinationType pageType = DestinationType.DEFAULT;
public String pageUrl = "YOUR AD PAGE URL";
public CampaignType campaignType = CampaignType.NORMAL;
public PromotedObjectType promotedObjectType = PromotedObjectType.LINK;
public List<String> siteSet = Arrays.asList("SITE_SET_MOBILE_INNER");
public Long dynamicCreativeTemplateId = 717L;
public String dynamicCreativeName = "SDK动态创意5ede25293ba60";
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);
DynamicCreativeElements dynamicCreativeElements = new DynamicCreativeElements();
dynamicCreativeElements.setImageOptions(imageOptions);
dynamicCreativeElements.setTitleOptions(titleOptions);
dynamicCreativeElements.setDescriptionOptions(descriptionOptions);
data.setDynamicCreativeElements(dynamicCreativeElements);
data.setPageType(pageType);
DynamicCreativePageSpec pageSpec = new DynamicCreativePageSpec();
pageSpec.setPageUrl(pageUrl);
data.setPageSpec(pageSpec);
data.setCampaignType(campaignType);
data.setPromotedObjectType(promotedObjectType);
data.setSiteSet(siteSet);
data.setDynamicCreativeTemplateId(dynamicCreativeTemplateId);
data.setDynamicCreativeName(dynamicCreativeName);
}
public DynamicCreativesAddResponseData addDynamicCreatives() throws Exception {
DynamicCreativesAddResponseData response =
tencentAds.dynamicCreatives().dynamicCreativesAdd(data);
return response;
}
public static void main(String[] args) {
try {
AddDynamicCreatives addDynamicCreatives = new AddDynamicCreatives();
addDynamicCreatives.init();
DynamicCreativesAddResponseData response = addDynamicCreatives.addDynamicCreatives();
} 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 DynamicCreativesAddExample struct {
TAds *ads.SDKClient
AccessToken string
Data model.DynamicCreativesAddRequest
}
func (e *DynamicCreativesAddExample) Init() {
e.AccessToken = "YOUR ACCESS TOKEN"
e.TAds = ads.Init(&config.SDKConfig{
AccessToken: e.AccessToken,
IsDebug: true,
})
e.Data = model.DynamicCreativesAddRequest{
AccountId: int64(0),
DynamicCreativeElements: &model.DynamicCreativeElements{
ImageOptions: &[]string{"YOUR AD IMAGE"},
TitleOptions: &[]string{"YOUR AD TEXT 1", "YOUR AD TEXT 2"},
DescriptionOptions: &[]string{"YOUR AD DESCRIPTION"},
},
PageType: model.DestinationType_DEFAULT,
PageSpec: &model.DynamicCreativePageSpec{
PageUrl: "YOUR AD PAGE URL",
},
CampaignType: model.CampaignType_NORMAL,
PromotedObjectType: model.PromotedObjectType_LINK,
SiteSet: &[]string{"SITE_SET_MOBILE_INNER"},
DynamicCreativeTemplateId: int64(0),
DynamicCreativeName: "SDK动态创意5ede25293ba60",
}
}
func (e *DynamicCreativesAddExample) RunExample() (model.DynamicCreativesAddResponseData, http.Header, error) {
tads := e.TAds
// change ctx as needed
ctx := *tads.Ctx
return tads.DynamicCreatives().Add(ctx, e.Data)
}
func main() {
e := &DynamicCreativesAddExample{}
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)
}