PHPackages                             cloudycity/uc-marketing-sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. cloudycity/uc-marketing-sdk

ActiveLibrary[API Development](/categories/api)

cloudycity/uc-marketing-sdk
===========================

UC MarketingAPI SDK

v0.3(6y ago)1672[2 PRs](https://github.com/CloudyCity/uc-marketing-sdk/pulls)MITPHPPHP >=5.6.0

Since Mar 26Pushed 3y ago1 watchersCompare

[ Source](https://github.com/CloudyCity/uc-marketing-sdk)[ Packagist](https://packagist.org/packages/cloudycity/uc-marketing-sdk)[ RSS](/packages/cloudycity-uc-marketing-sdk/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependencies (3)Versions (6)Used By (0)

UC Marketing SDK
================

[](#uc-marketing-sdk)

[![Latest Version on Packagist](https://camo.githubusercontent.com/e60c961f5e7b8e682f62e909979bcdcd556e8c86adcff330c409ba00ce895d6a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636c6f756479636974792f75632d6d61726b6574696e672d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/cloudycity/uc-marketing-sdk)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Build Status](https://camo.githubusercontent.com/2612ee03012e233060e3dafbab284e0aac8055c1e7510a125ea734508f219420/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f636c6f756479636974792f75632d6d61726b6574696e672d73646b2f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/cloudycity/uc-marketing-sdk)[![StyleCI](https://camo.githubusercontent.com/ca151b34d83c827bff3cf4affcf7b71570d36faccb7165770104499ae17019b0/68747470733a2f2f7374796c6563692e696f2f7265706f732f3234393933383733362f736869656c643f6272616e63683d6d6173746572)](https://styleci.io/repos/249938736)[![Quality Score](https://camo.githubusercontent.com/00d78fdeffd75b3b109d99bdb23a9a582ce37e84a349496027c619647c20e62c/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f636c6f756479636974792f75632d6d61726b6574696e672d73646b2e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/cloudycity/uc-marketing-sdk)[![Total Downloads](https://camo.githubusercontent.com/edb571576dcbf095c5b2cfbb5d36863abb1cd8af659d3be189b408bfebe81a1c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f636c6f756479636974792f75632d6d61726b6574696e672d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/cloudycity/uc-marketing-sdk)

安装
--

[](#安装)

```
composer require cloudycity/uc-marketing-sdk:*
```

环境要求
----

[](#环境要求)

- PHP 5.6 +

使用
--

[](#使用)

```
use CloudyCity\UCMarketingSDK\Client;
use CloudyCity\UCMarketingSDK\Kernel\Contracts\UcService;

$accounts = UcService::getAccounts();  // 仅提供Interface，需自行实现

// 遍历广告账号
foreach ($accounts as $account) {
    // 第四个参数为可选参数，默认为数组，客户端会自动将响应转为该格式，下载报表的csv文件也会自动转换成该格式
    // 支持的格式有: array、object、collection、raw、实现\CloudyCity\UCMarketingSDK\Kernel\Contracts\Arrayable的自定义类
    $client = new Client($account['username'], $account['password'], $account['token']);

    try {
        $result = $client->account->get();
    } catch (\CloudyCity\UCMarketingSDK\Kernel\Exceptions\ApiException $e) {
        // 阿里汇川接口未提示成功
    } catch (\CloudyCity\UCMarketingSDK\Kernel\Exceptions\InvalidArgumentException $e) {
        // 实例化客户端时配置的响应格式有误
    } catch (\GuzzleHttp\Exception\GuzzleException $e) {
        // Guzzle工具请求异常
    }
}
```

方法
--

[](#方法)

数据报表执行方式获取账户报表$client->report->getAccountReports($params)获取推广组报表$client->report->getAdgroupReports($params)获取推广计划报表$client->report->getCampaignReports($params)获取推广创意报表$client->report->getCreativeReports($params)获取app报表$client->report->getAppReports($params)获取受众分析报表$client->report->getAudienceReports($params)获取视频报表$client->report->getVideoReports($params)查询下载任务状态$client->report->getFile($taskId, $adReport)下载报表文件$client->report->downloadFile($taskId, $adReport)账户模块执行方式获取账户信息$client->account->get()更新账户预算$client->account->updateBudget($params)推广组执行方式创建推广组$client->group->add($params)更新推广组$client->group->update($params)更新组状态$client->group->updatePaused($adGroupIds, $paused)删除推广组$client->group->delete($adGroupIds)根据组id获取推广组$client->group->getByIds($adGroupIds)获取账户下所有推广组$client->group->get()获取账户下所有推广组id$client->group->getIds()推广计划模块执行方式创建推广计划$client->campaign->add($params)更新推广计划$client->campaign->update($params)更新出价$client->campaign->updateBid($params)更新出价(按百分比)$client->campaign->updateBidPercentage($params)更新计划状态$client->campaign->updatePaused($campaignIds, $paused)更新地域定向$client->campaign->updateRegion($campaignIds, $allRegion, $region)更新网络环境$client->campaign->updateNetworkEnv($campaignIds, $target)更新年龄定向$client->campaign->updateAge($campaignIds, $target)更新性别定向$client->campaign->updateGender($campaignIds, $target)更新操作系统定向$client->campaign->updatePlatform($campaignIds, $target)更新转化过滤$client->campaign->updateConvertFilter($campaignIds, $target)更新智能定向$client->campaign->updateIntelli($campaignIds, $target)更新自定义人群包$client->campaign->updateAudience($params)更新计划的预算$client->campaign->updateBudget($params)更新投放排期和投放时段$client->campaign->updateDateAndPeriod($campaignIds, $budget, $forceBudget)删除计划$client->campaign->delete($campaignId)根据组Id查询计划$client->campaign->getByAdGroupIds($adGroupIds)根据组Id查询计划Id$client->campaign->getIdsByAdGroupIds($adGroupIds)根据计划Id获取计划$client->campaign->getByIds($campaignIds)推广创意执行方式获取创意模板$client->creative->getTemplates($groupId)创建推广创意$client->creative->add($params)修改创意信息$client->creative->update($params)更新创意状态$client->creative->updatePaused($creativeId, $paused)删除推广创意$client->creative->delete($creativeIds)根据组Id获取创意$client->creative->getByCampaignIds($campaignIds)根据组Id获取创意Id$client->creative->getIdsByCampaignIds($campaignIds)根据创意Id获取创意$client->creative->getByIds($creativeIds)素材执行方式上传图片$client->material->uploadImages($imageUrls)获取图片$client->material->getImages($params)上传视频$client->material->uploadVideos($files)获取审核通过的视频$client->material->getVideos()获取省市列表$client->material->getProvinces()获取区县列表$client->material->getCounties()获取推荐$client->material->getRecommend($params)获取应用分类列表$client->material->getAppCategories()获取转化类型列表$client->material->getConvertTypes($objectiveType)根据转化类型获取联调通过的转化列表$client->material->getAdConvert($convertMonitorType)获取词包列表$client->material->getWordPackages()获取android app列表$client->material->getAndroidApps()获取ios app$client->material->getIosAppByAppId($appId)获取行业列表$client->material->getIndustries()获取定向包列表$client->material->getTargetingPackages()获取创意分类列表$client->material->getCreativeIndustries()订单执行方式根据订单id获取订单$client->order->getByIds($orderIds)获取指定日期内的订单$client->order->get($startDate, $endDate)获取指定日期内的订单Id$client->order->getIds($startDate, $endDate)License
-------

[](#license)

MIT

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~2 days

Total

3

Last Release

2233d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/a30bac408d56202227d7d978a5befaf1ec37f9c971beaed3145854226f150d24?d=identicon)[CloudyCity](/maintainers/CloudyCity)

---

Top Contributors

[![CloudyCity](https://avatars.githubusercontent.com/u/17662451?v=4)](https://github.com/CloudyCity "CloudyCity (5 commits)")

---

Tags

sdkmarketinguc

###  Code Quality

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/cloudycity-uc-marketing-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/cloudycity-uc-marketing-sdk/health.svg)](https://phpackages.com/packages/cloudycity-uc-marketing-sdk)
```

###  Alternatives

[openai-php/laravel

OpenAI PHP for Laravel is a supercharged PHP API client that allows you to interact with the Open AI API

3.7k7.6M74](/packages/openai-php-laravel)[mailchimp/transactional

458.9M16](/packages/mailchimp-transactional)[thenbsp/wechat

微信公众平台第三方 SDK 开发包，优雅、健壮，可扩展，遵循 PSR 开发规范。

9408.2k](/packages/thenbsp-wechat)[crowdin/crowdin-api-client

PHP client library for Crowdin API v2

611.5M5](/packages/crowdin-crowdin-api-client)[yoti/yoti-php-sdk

Yoti SDK for quickly integrating your PHP backend with Yoti

27539.9k1](/packages/yoti-yoti-php-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)