README

巨量引擎 MARKETING API SDK（2022年10月16日17:25:50）

Installation

composer require vincenteerr/ads-marketing-api

Requirements

PHP 7.0 +

Directory Structure

Advertiser/           账号服务模块
AdvertisingDelivery/           广告组模块
AdvertisingOriginality/        广告创意模块
AdvertisingPlan/               广告计划模块
AuthenticationOauth/           头条OAuth2.0授权
core/                          sdk核心
Dmp/                           DMP人群管理模块
Report/                        报表模块
Tool/                          工具模块
Tool/AppManagement             工具模块/应用管理
Tool/AdConvert                 工具模块/转化目标管理
Tool/CreativeWord              工具模块/动态创意词包管理
Tool/File                      工具模块/素材管理

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);
$args = [];
$req = $client::AdvertisingDelivery()->campaignGet()->setArgs($args)->send();
var_dump($req->getBody());

Method introduction

账号服务模块	执行方式
获取代理商账户	$client::Advertiser()->agentAdvertise()
获取代理商子账户	$client::Advertiser()->childAgentAdvertise()
获取纵横组织账户(广告主)	$client::Advertiser()->majordomoAdvertise()
获取纵横组织账户(广告主)(分页)	$client::Advertiser()->customerAdvertise()
查询账号余额	$client::Advertiser()->fundGet()
获取账户日预算	$client::Advertiser()->budgetGet()
更新账户日预算	$client::Advertiser()->updateBudget()
查询账户日流水	$client::Advertiser()->fundDailyStat()
查询账户流水明细	$client::Advertiser()->fundTransactionGet()

广告组模块	执行方式
获取广告组	$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()->appManagement->getApp()
查询游戏信息	$client::Tool()->appManagement->getBooking()
查询应用分包列表	$client::Tool()->appManagement->getExtendPackage()

工具（文件管理）	执行方式
广告主图片	$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()

工具（获取计划诊断信息）	执行方式
获取计划诊断信息(旧)	$client::Tool()->diagnosis->adGetV2()
获取计划诊断建议	$client::Tool()->diagnosis->suggestionGet()
采纳计划诊断建议	$client::Tool()->diagnosis->suggestionAccept()

License

licensed under the Apache License 2.0

vincenteerr / ads-marketing-api

Maintainers

Details

README

Installation

Requirements

Directory Structure

Example

Method introduction

License