Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/rx-coder/toutiao-marketing-sdk

今日头条MARKETING API SDK
https://github.com/rx-coder/toutiao-marketing-sdk

Last synced: 3 months ago
JSON representation

今日头条MARKETING API SDK

Lists

README

        

# 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

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

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

```php
// 调用示例
$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](https://www.apache.org/licenses/LICENSE-2.0.html)