PHPackages victordevphp/tiktok-ads - 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. victordevphp/tiktok-ads ActiveLibrary[API Development](/categories/api) victordevphp/tiktok-ads ======================= Biblioteca PHP para integração com o TikTok Ads API v1.0.1(1y ago)118MITPHPPHP ^8.2 Since Jan 15Pushed 1y ago1 watchersCompare [ Source](https://github.com/VictorDevPHP/tiktok-ads)[ Packagist](https://packagist.org/packages/victordevphp/tiktok-ads)[ Docs](https://github.com/VictorDevPHP/tiktok-ads)[ RSS](/packages/victordevphp-tiktok-ads/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependencies (1)Versions (3)Used By (0) TikTok Ads PHP Library ====================== [](#tiktok-ads-php-library) Descrição --------- [](#descrição) Este pacote PHP oferece uma interface simples para interagir com a **TikTok Ads API**, permitindo a criação de relatórios e integração com as funcionalidades do TikTok Ads. A biblioteca facilita a obtenção de dados como impressões, cliques, conversões e outras métricas importantes para o gerenciamento de campanhas publicitárias no TikTok. Instalação ---------- [](#instalação) Para instalar este pacote, use o Composer. Execute o seguinte comando em seu terminal dentro do diretório do seu projeto: ``` composer require victordevphp/tiktok-ads ``` Requisitos ---------- [](#requisitos) - PHP >= 8.2 - [GuzzleHttp](https://github.com/guzzle/guzzle) (>= 7.9) - Para comunicação HTTP com a API do TikTok. Contribuição ------------ [](#contribuição) Se você deseja contribuir para este projeto, fique à vontade para enviar pull requests! Qualquer contribuição será muito bem-vinda. Metodos ======= [](#metodos) 1. Obter Relatório (`getReport`) -------------------------------- [](#1-obter-relatório-getreport) Este método recupera relatórios detalhados para um anunciante específico com base nos parâmetros fornecidos. ### Parâmetros: [](#parâmetros) - `advertiser_id` (string): ID do anunciante. - `report_type` (string): Tipo de relatório (ex.: `BASIC`). - `dimensions` (array): Dimensões para o agrupamento dos dados (ex.: `adgroup_id`). - `data_level` (string): Nível dos dados (ex.: `AUCTION_ADGROUP`). - `start_date` (string): Data de início no formato `YYYY-MM-DD`. - `end_date` (string): Data de término no formato `YYYY-MM-DD`. - `metrics` (array): Métricas a serem incluídas no relatório. ### Requisição: [](#requisição) ``` use TikTokAds\Report\ReportManager; $reportManager = new ReportManager("SEU_TOKEN_DE_ACESSO"); $params = [ 'advertiser_id' => '0000000000000000000', 'report_type' => 'BASIC', 'dimensions' => ['adgroup_id'], 'data_level' => 'AUCTION_ADGROUP', 'start_date' => '2024-12-01', 'end_date' => '2024-12-30', 'metrics' => [ "campaign_id", "campaign_name", "impressions", "clicks", "conversion", "budget", "spend", "onsite_form", "onsite_shopping", "onsite_initiate_checkout_count", "onsite_on_web_cart", "onsite_add_billing" ] ]; $response = $reportManager->getReport($params); print_r($response); ``` ### Resposta [](#resposta) ``` { "code": 0, "message": "OK", "request_id": "2025012214454248D365647", "data": { "list": [ { "metrics": { "conversion": 5, "spend": 652.96, "impressions": 76804, "clicks": 9477, "campaign_id": "00000000000000", "campaign_name": "Leadfy - TikTok", "onsite_on_web_cart": 0, "onsite_form": 0, "onsite_shopping": 0, "budget": 35, "onsite_initiate_checkout_count": 0, "onsite_add_billing": 0 }, "dimensions": { "adgroup_id": "000000000000" } } ], "page_info": { "total_number": 1, "total_page": 1, "page_size": 1, "page": 1 } } } ``` 2. Obter Informações do Anunciante (`getInfo`) ---------------------------------------------- [](#2-obter-informações-do-anunciante-getinfo) Este método recupera informações básicas sobre um anunciante, como o saldo. ### Parâmetros: [](#parâmetros-1) - `advertiser_ids` (array): Array contendo o(s) ID(s) do(s) anunciante(s). - `fields` (array): Campos que devem ser retornados (ex.: `balance`). ### Requisição: [](#requisição-1) ``` use TikTokAds\Advertiser\Advertiser; $advertiser = new Advertiser("SEU_TOKEN_DE_ACESSO"); $params = [ 'advertiser_ids' => ['0000000000000000000'], 'fields' => ["balance"] ]; $response = $advertiser->getInfo($params); print_r($response); ``` ### Resposta [](#resposta-1) ``` { "code": 0, "message": "OK", "request_id": "2025012214174179D49B0CE47F3", "data": { "list": [ { "balance": 1000.0 } ] } } ``` ### Health Score 30 — LowBetter than 64% of packages Maintenance44 Moderate activity, may be stable Popularity8 Limited adoption so far Community9 Small or concentrated contributor base Maturity51 Maturing project, gaining track record Bus Factor1 Top contributor holds 77.8% 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 ~0 days Total 2 Last Release 478d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/30ce88fb027e27d79503dd8d864fe8d8e5cd74357c3ab0b2979e05384fd9f01c?d=identicon)[VictorDevPHP](/maintainers/VictorDevPHP) --- Top Contributors [![VictorDevPHP](https://avatars.githubusercontent.com/u/98700678?v=4)](https://github.com/VictorDevPHP "VictorDevPHP (7 commits)")[![VictorLeadfy](https://avatars.githubusercontent.com/u/130988854?v=4)](https://github.com/VictorLeadfy "VictorLeadfy (2 commits)") --- Tags apiadsintegrationTikTok ### Embed Badge ![Health badge](/badges/victordevphp-tiktok-ads/health.svg) ``` [![Health](https://phpackages.com/badges/victordevphp-tiktok-ads/health.svg)](https://phpackages.com/packages/victordevphp-tiktok-ads) ``` ### Alternatives [lasserafn/laravel-economic Economic REST wrapper for Laravel 1118.5k](/packages/lasserafn-laravel-economic)[lasserafn/php-dinero Dinero REST wrapper for PHP 115.2k](/packages/lasserafn-php-dinero) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)