包简介

巨量引擎 MarketingApi SDK

README 文档

README

巨量引擎 MARKETING API SDK

Installation

composer require 57feng/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()

License

licensed under the Apache License 2.0

57feng/ads-marketing-api 适用场景与选型建议

57feng/ads-marketing-api 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 163 次下载、GitHub Stars 达 1，最近一次更新时间为 2022 年 09 月 17 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「sdk」「头条」「marketing-api」「巨量�」「�擎」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 57feng/ads-marketing-api 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 57feng/ads-marketing-api 我们能提供哪些服务？

定制开发 / 二次开发

基于 57feng/ads-marketing-api 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 57feng/ads-marketing-api 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

scriptdevelop/meta-catalog-manager 2

Laravel package for Meta Marketing API — multi-account catalog management, product feeds, batch inventory, offers, diagnostics and localized catalogs.

rx-coder/toutiao-marketing-sdk 44

头条 MarketingApi SDK

zys5210/toutiao-marketing-sdk 0

头条 MarketingApi SDK

pure_88_66/ads-jl-api 0

巨量引擎 API SDK

westng/oc-marketing-api 0

巨量引擎 MarketingApi SDK

baitu/toutiao-marketing-sdk 0

头条 MarketingApi SDK