toutiao-marketing-sdk

• 今日头条MARKETING API SDK

Installation

composer require rx-coder/toutiao-marketing-sdk:*

Api Doc

• https://ad.toutiao.com/openapi/doc/index.html?id=30

Requirements

• PHP 5.6 +

Directory Structure

AdvertisingDelivery/           广告组模块
AdvertisingOriginality/        广告创意模块
AdvertisingPlan/               广告计划模块
AuthenticationOauth/           头条OAuth2.0授权
core/                          sdk核心
Dmp/                           DMP人群管理模块
Report/                        报表模块
Tool/                          工具模块

Example

// 获取token, refresh_token
$auth = new ToutiaoSdk\ToutiaoAuth(APPID, SECRET);
print_r($auth->getAccessToken(AUTH_CODE));

// 刷新token
print_r($auth->refreshToken(REFRESH_TOKEN));

// 调用示例
$client = new ToutiaoSdk\TouTiaoClient(TOKEN);
$req = $client::AdvertisingDelivery()->campaignGet()->setAdvertiserId(ADVERTISER_ID)->send();
var_dump($req->getBody());

Method introduction

广告组模块	执行方式
获取广告组	$client::AdvertisingDelivery()->campaignGet()
创建广告组	$client::AdvertisingDelivery()->campaignCreate()
修改广告组	$client::AdvertisingDelivery()->campaignUpdate()
广告组更新状态	$client::AdvertisingDelivery()->campaignUpdateStatus()

广告创意	执行方式
获取创意列表	$client::AdvertisingOriginality()->CreativeGet()
创建广告创意	$client::AdvertisingOriginality()->CreativeCreate()
创意素材信息	$client::AdvertisingOriginality()->CreativeMaterialRead()
创意详细信息	$client::AdvertisingOriginality()->CreativeRead()
修改创意信息	$client::AdvertisingOriginality()->CreativeUpdate()
更新创意状态	$client::AdvertisingOriginality()->CreativeUpdateStatus()

广告计划	执行方式
创建广告计划	$client::AdvertisingPlan()->AdCreate()
获取广告计划	$client::AdvertisingPlan()->AdGet()
修改广告计划	$client::AdvertisingPlan()->AdUpdate()
更新计划出价	$client::AdvertisingPlan()->AdUpdateBid()
更新计划预算	$client::AdvertisingPlan()->AdUpdateBudget()
更新计划状态	$client::AdvertisingPlan()->AdUpdateStatus()

数据报表	执行方式
广告主数据（新版）	$client::Report()->advertiserGet()
广告组数据（新版）	$client::Report()->campaignGet()
广告计划数据（新版）	$client::Report()->adGet()
广告创意数据（新版）	$client::Report()->creativeGet()
受众分析（省级数据）	$client::Report()->audienceProvince()
受众分析（性别数据）	$client::Report()->audienceGender()
受众分析（性别数据）	$client::Report()->audienceGender()
受众分析（兴趣数据）	$client::Report()->audienceTag()
受众分析（年龄数据）	$client::Report()->audienceAge()
受众分析（市级数据）	$client::Report()->audienceCity()
代理商数据	$client::Report()->agentGet()

DMP 人群管理	执行方式
数据源文件上传	$client::Dmp()->dataSourceFileUpload()
数据源创建	$client::Dmp()->dataSourceCreate()
数据源更新	$client::Dmp()->dataSourceUpdate()
数据源详细信息	$client::Dmp()->dataSourceRead()
人群包列表	$client::Dmp()->customAudienceSelect()
人群包详细信息	$client::Dmp()->customAudienceRead()
删除人群包	$client::Dmp()->customAudienceDelete()
拓展人群包	$client::Dmp()->customAudienceLookalike()
规则人群包	$client::Dmp()->customAudienceRule()

工具 （文件管理）	执行方式
广告主图片	$client::Tool()->file->imageAdvertiser()
广告图片	$client::Tool()->file->imageAd()
上传视频	$client::Tool()->file->videoAd()
查询图片信息	$client::Tool()->file->imageAdGet()
查询视频信息	$client::Tool()->file->videoAdGet()
获取视频智能封面	$client::Tool()->file->videoCoverSuggest()
获取图片素材库	client::Tool()->file->imageGet()
获取视频素材库	$client::Tool()->file->videoGet()

工具（动态创意词包）	执行方式
创建动态创意词包	$client::Tool()->creativeWord->create()
删除动态创意词包	$client::Tool()->creativeWord->delete()
更新动态创意词包	$client::Tool()->creativeWord->update()
查询动态创意词包	$client::Tool()->creativeWord->select()

工具（查询工具）	执行方式
查询受众预估结果	$client::Tool()->queryTool->estimateAudience()
查询应用信息	$client::Tool()->queryTool->appSearch()
查询建议出价	$client::Tool()->queryTool->bidSuggest()
查询DPA商品库可用类型	$client::Tool()->queryTool->dpaProductAvailables()
查询DPA可用类型	$client::Tool()->queryTool->dpaBehaviourAvailables()
查询广告质量度	$client::Tool()->queryTool->adQualityGet()
获取行业列表	$client::Tool()->queryTool->industryGet()

工具（兴趣词包）	执行方式
查询兴趣词包	$client::Tool()->interestTag->select()
创建兴趣词包	$client::Tool()->interestTag->create()
更新兴趣词包	$client::Tool()->interestTag->update()
删除兴趣词包	$client::Tool()->interestTag->delete()
兴趣关键词ID转词	$client::Tool()->interestTag->id2word()
兴趣关键词词转ID	$client::Tool()->interestTag->word2Id()

工具 （转化目标管理）	执行方式
创建转化ID	$client::Tool()->adConvert->create()
修改转化ID	$client::Tool()->adConvert->update()
更新转化状态	$client::Tool()->adConvert->updateStatus()
查询计划可用转化ID	$client::Tool()->adConvert->select()
转化ID列表	$client::Tool()->adConvert->advConvertSelect()
查询转化详细信息	$client::Tool()->adConvert->read()
转化ID推送	$client::Tool()->adConvert->push()

工具 （图片转视频）	执行方式
创建图片转视频任务	$client::Tool()->picToVideo->taskCreate()
获取音乐列表	$client::Tool()->picToVideo->musicGet()
获取任务状态	$client::Tool()->picToVideo->statusGet()
视频任务回调接口	$client::Tool()->picToVideo->taskCallback()

工具	执行方式
获取建站列表	$client::Tool()->siteGet()

Authors && Contributors

• xiayifeng
• zhangwenzong

Contact information

• QQ群：712720083

License

licensed under the Apache License 2.0