https://github.com/schulzefelix/laravel-adwords-targeting-idea-service

Get KeywordIdeas and Search Volumes from AdWords
https://github.com/schulzefelix/laravel-adwords-targeting-idea-service

adwords adwords-api google laravel php

Last synced: 3 months ago
JSON representation

Get KeywordIdeas and Search Volumes from AdWords

• Host: GitHub
• URL: https://github.com/schulzefelix/laravel-adwords-targeting-idea-service
• Owner: schulzefelix
• License: mit
• Created: 2017-05-26T17:36:16.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2022-03-20T11:35:32.000Z (almost 3 years ago)
• Last Synced: 2024-10-14T04:43:24.451Z (3 months ago)
• Topics: adwords, adwords-api, google, laravel, php
• Language: PHP
• Size: 53.7 KB
• Stars: 26
• Watchers: 6
• Forks: 8
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# A Laravel API Wrapper For Google AdWords.

[![Latest Version](https://img.shields.io/github/release/schulzefelix/laravel-adwords-targeting-idea-service.svg?style=flat-square)](https://github.com/schulzefelix/laravel-adwords/releases)

[![Software License][ico-license]](LICENSE.md)

[![Build Status][ico-travis]][link-travis]

[![Quality Score][ico-code-quality]][link-code-quality]

[![StyleCI](https://styleci.io/repos/92534151/shield)](https://styleci.io/repos/92534151)

[![Latest Version on Packagist][ico-version]][link-packagist]

[![Total Downloads][ico-downloads]][link-downloads]

## Install

This package can be installed through Composer.

``` bash

$ composer require schulzefelix/laravel-adwords-targeting-idea-service

```

The package will autoregister the service provider. If package discovery is disabled add the following.

```php

// config/app.php

'providers' => [

    ...

    SchulzeFelix\AdWords\AdWordsServiceProvider::class,

    ...

];

```

The package will autoregister the facade. If package discovery is disabled add the following.

```php

// config/app.php

'aliases' => [

    ...

    'AdWords' => SchulzeFelix\AdWords\AdWordsFacade::class,

    ...

];

```

You can publish the config file of this package with this command:

``` bash

php artisan vendor:publish --provider="SchulzeFelix\AdWords\AdWordsServiceProvider"

```

### Generate Refresh Token

This requires that the `clientId` and `clientSecret` are from a **native application**.

Google Console: [https://console.developers.google.com/apis/credentials](https://console.developers.google.com/apis/credentials)

``` bash

$ php artisan adwords:token

```

Open the authorization url. Grant access to the app and input the

access token in the console. Copy the refresh token into your configuration `config/adwords-targeting-idea-service.php`

## Usage

All methods will return an `Illuminate\Support\Collection`-instance.

Here are two basic example to retrieve search volumes for several keywords and new keyword ideas for a given word.

### Search Volumes

```php

$searchVolumes = AdWords::searchVolumes(['cheesecake', 'coffee']);

```

### Keyword Ideas

```php

$keywordIdeas = AdWords::keywordIdeas('coffee');

```

## Provided fluent configuration

### Set Location

For Criteria ID see [https://developers.google.com/adwords/api/docs/appendix/geotargeting](https://developers.google.com/adwords/api/docs/appendix/geotargeting)

```php

AdWords::location(2276)->searchVolumes(['cheesecake', 'coffee']);

```

### Set Language

For Criteria ID see [https://developers.google.com/adwords/api/docs/appendix/codes-formats#languages](https://developers.google.com/adwords/api/docs/appendix/codes-formats#languages)

```php

AdWords::location(2276)->language(1001)->searchVolumes(['cheesecake', 'coffee']);

```

### Include Targeted Monthly Searches

```php

AdWords::withTargetedMonthlySearches()->searchVolumes(['cheesecake', 'coffee']);

```

### Convert NULL values to Zero

```php

AdWords::convertNullToZero()->location(2276)->language(1001)->searchVolumes(['cheesecake', 'coffee']);

```

### Include And Exclude Words For Keyword Ideas

```php

AdWords::location(2642)->exclude(['iphone'])->include(['apple'])->keywordIdeas('iphone');

```

## Change log

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

## Testing

``` bash

$ vendor/bin/phpunit

```

## Contributing

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

## Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

## Credits

- [Felix Schulze][link-author]

- [All Contributors][link-contributors]

## License

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

[ico-version]: https://img.shields.io/packagist/v/schulzefelix/laravel-adwords-targeting-idea-service.svg?style=flat-square

[ico-license]: https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square

[ico-travis]: https://img.shields.io/travis/schulzefelix/laravel-adwords-targeting-idea-service/master.svg?style=flat-square

[ico-scrutinizer]: https://img.shields.io/scrutinizer/coverage/g/schulzefelix/laravel-adwords-targeting-idea-service.svg?style=flat-square

[ico-code-quality]: https://scrutinizer-ci.com/g/schulzefelix/laravel-adwords-targeting-idea-service/badges/quality-score.png?b=master

[ico-downloads]: https://img.shields.io/packagist/dt/schulzefelix/laravel-adwords-targeting-idea-service.svg?style=flat-square

[link-packagist]: https://packagist.org/packages/schulzefelix/laravel-adwords-targeting-idea-service

[link-travis]: https://travis-ci.org/schulzefelix/laravel-adwords-targeting-idea-service

[link-scrutinizer]: https://scrutinizer-ci.com/g/schulzefelix/laravel-adwords-targeting-idea-service/code-structure

[link-code-quality]: https://scrutinizer-ci.com/g/schulzefelix/laravel-adwords-targeting-idea-service

[link-downloads]: https://packagist.org/packages/schulzefelix/laravel-adwords-targeting-idea-service

[link-author]: https://github.com/schulzefelix

[link-contributors]: ../../contributors