弊社ではSEOコンサルティングを手がけておりますが、日々変化するSEO対策の状況に対応すべく、様々な角度から解析を行っております。 その解析には弊社が独自で開発した解析ツールを用いることにより、お客様により精度の高いSEOコンサルティングサービスをご提案いたします。

はじめに

　自社開発の解析ツールではGoogle Adwordsの機能を利用しておりますが、現在運用しているv201705バージョンは2018年3月28日以降のリクエストを受け付けられなくなるとのアナウンスがGoogle Ads Developer Blogに記載されていました。

Google Ads Developer Blog「AdWords API v201705 and v201708 sunset reminder」より一部抜粋

Both AdWords API v201705 and v201708 will be sunset on March 28, 2018. After this date, all v201705 and v201708 API requests will begin to fail. If you haven’t already migrated to v201710, we recommend that you skip v201710 and migrate directly to v201802. Please migrate prior to March 28, 2018 to ensure your API access is unaffected.

　このアナウンスに基づき、Google Adwords APIの移行手順について説明します。 なお、既にGoogle Adwords API実装済であることを前提としています。(この例ではv201705からv201802への移行を例とし、TargetingIdeaServiceに変更が無いケースとしています。)

クライアントライブラリの取得

1.Client Librariesより対応するライブラリを取得します。(PHPを例とする)

2.取得したtarボールを解凍します

$ tar xzvf adwords-examples-33.1.0.tar.gz

3.ディレクトリを移動しcomposerにて対応するコンポーネントを取得します

$ cd adwords-examples-33.1.0
$ composer update

実行環境への適用

1.上記で取得した最新のライブラリを実行環境へ移します

$ cd ./vendor/googleads/googleads-php-lib/src/Google/AdsApi/AdWords

2.最新版ライブラリのディレクトリv201802ごと実行環境へコピーします。コピー先は各プロダクトに合わせてください。
　SEO支援ツールでは./develop/application/third_party/googleadslib/src/Google/AdsApi/AdWords配下に各バージョンがあるので同じレベルにv201802をコピーします

3.クライアント側APIアクセス用ライブラリのコードを旧バージョンディレクトリから新バージョンディレクトリに変更します。

旧コード

:
use Google\AdsApi\AdWords\v201705\cm\Keyword;
use Google\AdsApi\AdWords\v201705\cm\Language;
use Google\AdsApi\AdWords\v201705\cm\NetworkSetting;
use Google\AdsApi\AdWords\v201705\cm\Paging;
use Google\AdsApi\AdWords\v201705\o\AttributeType;
use Google\AdsApi\AdWords\v201705\o\IdeaType;
use Google\AdsApi\AdWords\v201705\o\LanguageSearchParameter;
use Google\AdsApi\AdWords\v201705\o\NetworkSearchParameter;
use Google\AdsApi\AdWords\v201705\o\RelatedToQuerySearchParameter;
use Google\AdsApi\AdWords\v201705\o\RequestType;
use Google\AdsApi\AdWords\v201705\o\TargetingIdeaSelector;
use Google\AdsApi\AdWords\v201705\o\TargetingIdeaService;
use Google\AdsApi\AdWords\v201705\o\IdeaTextFilterSearchParameter;
use Google\AdsApi\AdWords\v201705\o\IncludeAdultContentSearchParameter;
:

新コード

:
use Google\AdsApi\AdWords\v201802\cm\Keyword;
use Google\AdsApi\AdWords\v201802\cm\Language;
use Google\AdsApi\AdWords\v201802\cm\NetworkSetting;
use Google\AdsApi\AdWords\v201802\cm\Paging;
use Google\AdsApi\AdWords\v201802\o\AttributeType;
use Google\AdsApi\AdWords\v201802\o\IdeaType;
use Google\AdsApi\AdWords\v201802\o\LanguageSearchParameter;
use Google\AdsApi\AdWords\v201802\o\NetworkSearchParameter;
use Google\AdsApi\AdWords\v201802\o\RelatedToQuerySearchParameter;
use Google\AdsApi\AdWords\v201802\o\RequestType;
use Google\AdsApi\AdWords\v201802\o\TargetingIdeaSelector;
use Google\AdsApi\AdWords\v201802\o\TargetingIdeaService;
use Google\AdsApi\AdWords\v201802\o\IdeaTextFilterSearchParameter;
use Google\AdsApi\AdWords\v201802\o\IncludeAdultContentSearchParameter;
:

おわりに

　自社開発の解析ツールではAdwordsAPIのTargetingIdeaServiceサービスを利用しています。リリースノート等を確認してTargetingIdeaServiceに変更が無ければ上記のように置き換えるだけで問題は無いのですが、TargetingIdeaServiceに変更があれば移行ガイド等を確認して対応する必要があります。

おまけ

　入力キーワードが英文字のみの場合、検索ボリュームが多くなることがありました。これはAdwordsのターゲット地域が未設定だったため、英語圏の検索ボリュームも含まれていたことによります。 ツールの解析対象が日本国内なのでこれを是正すべく、ターゲット地域を日本に限定し、検索ボリュームの精度を高めることにしました。詳細についてはこちらを参照願います。

　まずターゲット地域の設定が無かったので、その設定を追加するにあたり必要となるクラスを追加します。

use Google\AdsApi\AdWords\v201802\cm\Location;
use Google\AdsApi\AdWords\v201802\o\LocationSearchParameter;

$locationParameter = new LocationSearchParameter();    …１
$locjapan = new Location();                            …１
$locjapan->setId(2392);                                …２
$locationParameter->setLocations([$locjapan]);         …３
$searchParameters[] = $locationParameter;              …４

1. ターゲット地域パラメータクラスと地域クラスを生成します。
2. ターゲット地域パラメータを「日本」するためにはIDを設定しますが、そのIDはターゲット表からターゲットIDを探します。「Fillter」ボタンで絞り込み項目をnameとし、絞込み文字列をJapanとするとピンポイントで日本のターゲットID2392が表示されますのでそれを指定します。
3. ターゲット地域パラメータに地域IDを設定します。
4. サーチパラメータにターゲット地域パラメータを設定します。

これでターゲット地域の設定が出来、検索ボリュームも概ね正しい値が取得出来ました。

おしまい