1. Adwords API Community
2014.3.28(Fri) / Google Tokyo Office
～Adwords API Communityとは～
Adwords APIを活用している各社のエンジニアが集い、
課題やベストプラクティスを共有することで、
明日の現場開発に活かしていくべく有志により発足したCommunity

2. 自己紹介
 前田 寿之(まえだ としゆき)
 株式会社シーエーアドバンス
 AdWordsAPI歴：1年くらい
 自然大好き

3. API version up対応について
バージョンアップ対応お疲れ様です

4. アジェンダ
1.Developers Guide
2.Code Example
Developer GuideにはAPIを扱う上で
基本的なこと・重要なことが記述されている。
そこをピックアップして紹介したい。
Code Exampleも非常に充実している。
必ず目を通すべし。

5. Developers Guide

6. Developer Guide
Developer Guide内容

7. Basic Concept：基本概念
• AdwordsAPIはSOAP APIでリクエストとレスポンスはXMLである。
• クライアントライブラリを利用することでSOAPやXMLをあまり気にする必要がない。
• 認証にはOAuth認証を利用すること。
• APIを呼び出すには、Developer Tokenが必要
• API利用料は無料。ただし、2種類のアクセスレベル有り（Basic＆Standard）
• そもそもAdwordsの知識が必要。Adwordsの資格も有

8. Adwords認定資格
Google partnersプログラム内の取り組みとして、3種類の認定資格がある。
• 広告掲載の初心者向け試験
• 検索広告の上級者向け試験
• ディスプレイ広告の上級者向け試験
→体系的にAdwordsの知識を身につけるための手段としてお勧め
Google partners管理画面

9. SOAPの基本
[リクエストヘッダー]
• developerToken,userAgent,clientCustmerId(require)
• validateOnly(option)
validateOnlyをtrueにしてSOAPヘッダーに含めると、
対象サービスを変更（mutate）することなく、
API呼び出しをテストすることができる。
リアルタイムでの広告文ポリシーチェック等を実装することが可能。
• partialFailure(option)
エラーのない操作をAPI実行し、エラーの箇所はレスポンスに含まれるようになる。
[レスポンスヘッダー]
・requestId, operations, responseTime(millisecond)

10. オブジェクトについて理解
Adwordsオブジェクトは、Campaign－Ad Group－Td＆Keywordという構造。
このデータ構造をシステムで組む場合は、下記表のルールをしておく必要がある。
・Campaign IDはGlobalでユニーク
・Ad Group IDはGlobalでユニーク
・Ad IDは,AdGroup IdとAdIdがペアでユニーク

11. オブジェクトの操作
操作方法は2種類：getとmutate
mutate：変異させるの意味
→Adwordsオブジェクトの作成(追加),更新,削除を行うオブジェクト

12. テストアカウント
[特徴]
1. APIでどんな操作をしても本番環境に影響なし
2. developer token必要なし
3. 本番MCCにテストアカウント(MCC)はリンク不可
4. TargetingIdeaService等はダミーデータが返ってくる
※テストコードを書く際に利用すると便利かも

13. Developer Guide
Developer Guide内容

14. Campaign Management
• 入札方法
• 共有予算関するFAQ
• 広告グループ単位の単価調整
• オフラインコーンバージョンのインポート
• Shopping Campaign(v201402～)
Developer Guide(英語) Developer Guide(日本語)
≠
日本語サイトは更新が遅い。
最新情報をキャッチアップするためには英語サイトを参照すべし。

15. Developer Guide
Developer Guide内容

16. Ad Management
• 広告のスケジュール設定方法
• ターゲティング地域設定
• リマーケティング
• 動画広告
• フィードサービス
サイトリンク
電話番号表示
アプリリンク
フィードサービスで実現可能機能

17. フィードサービスの実装
１．サイトリンクを実装しよう！
２．Campaignに紐付けたいからCampaignAdExtensionで実装できそうかな？
３．adExtensionのTypeにSitelinksExtensionがあるので実装できそう！
４．実装
５．エラー！！（CampaignAdExtension INVALID_ADEXTENSION_TYPE）

18. フィードサービスの実装
Adwords API Forumで同エラーを検索
サイトリンクの実装で、
全く同じエラーについて質問している人を発見!!

19. フィードサービスの実装
Feed Serviceで利用できるよ、ブログを見てね
• Ads Developer Blogは要チェック!!
• Adwords API Forumを活用しよう!!

20. Developer Guide
Developer Guide内容

21. トラブルシューティングとパフォーマンス
• バッチ処理：MutateJobService
送信された複数のJobを並列で実行するサービス。
システムのレート制限もあり。
レート制限を超えた場合は、Jobの開始が遅延する。
対象サービス
• AdGroupAdOperation
• AdGroupCriterionOperation
• AdGroupOperation
• AdGroupBidModifierOperation
• CampaignCriterionOperation
• CampaignOperation
• FeedItemOperation

22. トラブルシューティングとパフォーマンス
• ベストプラクティス
[全般 ]
・複数のリクエストに認証トークンを再利用する
・2 段階認証プロセスを使用する際に欠落したアプリケーション固有のパスワードを検出する
・オペレーションをバッチ化してリクエスト数を減らす
・ターゲット広告グループまたはキャンペーンごとにオペレーションをグループ化する
・アップデートのためスパース オブジェクトを送信する
・エラー処理と再試行を実行する
・開発環境でテストアカウント利用する
・SOAP メッセージを圧縮する
・Partial Failure 機能を利用する
[ターゲット候補]
・STATSリクエストでキーワードをバッチ化する
→ 世界中の技術者からベストプラクティスを集めたい

23. Code Examples
Code Exampleは新しいサービスを導入しようとする場合等は非常に参考になる。
特に実装がややこしいFeedService等。
とにもかくにもサンプルソースを理解は必要かと。
PHPの例で、v201402のコードサンプル。
12カテゴリ、67種類のサンプルコードが提供されている。

24. 最速でサンプルコードを動かす
~/src/Google/Api/Ads/AdWords/auth.ini
auth.iniにSOAP通信に必要な項目を記述する(OAuth設定は別途対応)

25. 最速でサンプルコードを動かす
~/example/AdWords/v201402/BasicOperations/GetCampaigns.php
※同階層にある soap_xml.logを参照することで通信内容の確認が可能
Campaign情報を取得するサンプルコード(GetCampaigns.php)を実行する

26. まとめ
1. Developer GuideでAPIの基本的なことを知ろう！
2. Code Exampleは必ず目を通すべし！
3. Ads Developer Blog, API Forum等を活用しよう！
4. Adwords API WorkShopに参加しよう！
5. 困ったら質問しよう！