Twitter広告APIを利用してキャンペーンを作ってみる その4~Tiwtter広告APIのAPI申請編~

# 経緯
私が所属している会社では__[待ラノ](https://lanobe.jp/ "待ラノ")__という小説投稿サイトを運営しています。
待ラノではオススメ小説のランキング上位5作を定期的にTwitterの公式アカウントで紹介しています。
紹介された小説をTwitter広告のキャンペーンを利用してプロモーションをしようってなりました。

# そもそもTwitter広告のキャンペーンって何？
Twitter広告のキャンペーンですが、簡単いうと1日にかける予算や期間内にかける総予算を指定して、Twitterに広告を出す機能です。

# Twitter広告APIでキャンペーンを作る理由
1つのキャンペーンで複数のツイートをプロモーションする場合、1日にかける予算を一気に消化されてしまいます。
しかもどのツイートにどれだけ予算が消化されているかがわかりません。
そのため、1つのツイートに1キャンペーンを紐付けることで消化される予算の見える化を行うことになりました。

ただ手動でTwitterの広告コンソールから、1ツイートに1キャンペーンを毎回作ることになると結構手間です。
というわけで、__Twitter広告APIを利用して動的にキャンペーンを作成__することになりました。

# Twitter広告APIでキャンペーンを作成するためには
以下の手順が必要です。

1. Tiwtterアカウントを作成する（省略）
2. Tiwtterアカウントにメールアドレスと電話番号を設定する（省略）
3. TiwtterAPIの利用申請をする
4. [TiwtterAPIのAPIキーとトークンを取得する](https://qiita.com/kaga_espla/items/4514be0ca123f9ec35c2 "TiwtterAPIのAPIキーとトークンを取得する")
5. [TiwtterAPIを利用してツイートをする](https://qiita.com/kaga_espla/items/546c64714e6dc2ca2d7f "TiwtterAPIを利用してツイートをする")
6. __Tiwtter広告APIの利用申請をする  <font color="Red">←イマココ</font>__
7. [Tiwtter広告APIでを利用してツイートを使ったキャンペーンを作る](https://qiita.com/kaga_espla/items/9197695bda901fa6499d)

今回は6の__【Tiwtter広告APIの利用申請をする】__について説明していきます。
__本稿は、[その1](https://qiita.com/kaga_espla/items/48161d51d79041cfe4b6)と[その2](https://qiita.com/kaga_espla/items/4514be0ca123f9ec35c2)が完了している前提で記載されております。__

# 1.Twitter広告APIガイドのページ（英語）にアクセス
まずはTwitterにログインした状態で、__[Twitter広告APIガイド](https://developer.twitter.com/en/docs/twitter-ads-api/getting-started "Twitter広告APIガイド")__へアクセスします。
__<font color="red">注：日本語のTwitter広告APIガイドは存在しておりますが、申請フォームがバグっているせいでチェックボックス等が正しく押せない状態になっておりますので、こちらの記事同様に英語ページで申請を行ってください。</font>__

# 2.「Apply for Ads API Access」ボタンをクリックします。
![スクリーンショット 2020-09-18 14.44.11.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/57ec264f-c159-b40f-1eb8-32deb2999e83.png)


# 3.英語で申請フォームに回答していきます。

まずは「基本情報」です。

以下の項目を入力していきます。

- 「__Company__（企業名）」
- 「__Country__（国）」
- 「__State/Province__（都道府県）」
- 「__City__（市）」

![スクリーンショット 2020-09-18 14.52.34.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/151a4b46-0291-cb6c-47a1-00876a047840.png)

---

「__Company Handle__（Twitterの企業アカウントID）」
![スクリーンショット 2020-09-18 14.58.57.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/b00e0cd0-4b24-6c5f-fa02-599f16f6b9d4.png)

---

「__App ID__（アプリID）」
![スクリーンショット 2020-09-18 14.59.08.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/be709311-3203-e8e6-8c1b-9d42d1e55a20.png)

■__[その2](https://qiita.com/kaga_espla/items/4514be0ca123f9ec35c2)で作成したアプリのIDを取得します。__
__「[developer.twitter.com/en/apps/](https://developer.twitter.com/content/developer-twitter/en/apps)」__のリンクをクリックしてください。
そうすると__開発ポータル__に遷移するので、対象のアプリの__「設定（歯車）」__ボタンをクリックしてください。
![スクリーンショット 2020-09-18 15.04.49.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/a2236c97-ca0b-b4cd-3752-e4fbd3c9b070.png)

__「アプリID」__が表示されますので、先程の入力フォームに記載してください。
![スクリーンショット 2020-09-18 15.05.09.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/8335502d-6ad9-6b1c-c2b0-06b9d764c52e.png)

---

「__I acknowledge that the provided app will be capped at 5 tokens for the Developer phase.__（指定されたアプリは開発者フェーズについてトークンが5つまでに制限されることに同意します。）」

こちらのラジオボタンをチェックしてください。
![スクリーンショット 2020-09-18 14.59.25.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/15436b3e-63c6-449f-543d-0e4451a36c8a.png)

---

次に「代表連絡先」です。
以下の項目を入力していきます。

- 「__First Name__（名）」
- 「__Last Name__（姓）」
- 「__Title__（役職）」
- 「__Job Function__（職務）」
- 「__Job Level__（職務レベル）」
- 「__Email__（メールアドレス）」
- 「__Phone__（電話番号）」

![スクリーンショット 2020-09-18 15.28.30.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/9c3e1c17-31ba-3cad-a861-bb4709df7027.png)

---

次に「Twitter広告APIの利用目的」です。

「__Of the following, which best describes your business?__（次のうち、御社の事業について最もよく当てはまる説明はどれですか？）」
![スクリーンショット 2020-09-18 15.35.23.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/f0e17e9e-aad4-0360-a8cd-691614da161e.png)

「__Of the following, which best describes your business?__（次のうち、御社の事業について最もよく当てはまる説明はどれですか？）」
![スクリーンショット 2020-09-18 15.35.30.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/52b1cf0b-69c0-10ff-a67c-87cf67c90f5d.png)

「__...tell us about your business__（御社のビジネスについて教えてください）」
![スクリーンショット 2020-09-18 15.35.44.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/5f201a48-7e32-7f01-08b1-02c45d83586d.png)

「__...what do you plan to build on the Ads API?__（広告APIに何を構築する予定ですか？）」
![スクリーンショット 2020-09-18 15.35.52.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/155b4747-4b42-9bee-c351-1f76335f2fad.png)

「__...describe your unique differentiators in the Ad Tech ecosystem__（広告テクノロジー市場での御社の差別化要素について説明してください）」
![スクリーンショット 2020-09-18 15.36.01.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/c94c4cb0-edd2-d695-80b0-71b011e5e940.png)

「__Do you have API partnerships on any other platforms?__（Twitter以外のプラットフォームでAPIパートナーシップを組んでいますか？）」
![スクリーンショット 2020-09-18 15.36.10.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/62f2d638-4e9a-b72c-09fa-497c6aa802dd.png)

---

次に「顧客情報」です。

「__Where are your customers based? Please indicate your top market__（顧客基盤はどこにありますか？御社の最大市場を教えてください）」
![スクリーンショット 2020-09-18 15.51.20.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/0349117c-ac59-f51d-ad39-202bfb2a1a43.png)

「__Which industries are most common among your customers?__（どの業界の顧客が最も多いですか？）」
![スクリーンショット 2020-09-18 15.51.28.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/b03a4be7-3d59-e2dd-adb2-ba58b7eb7cfd.png)

「__Tell us more about your strategic customers/advertisers__（御社の戦略顧客/広告主について詳しく教えてください）」
![スクリーンショット 2020-09-18 15.51.36.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/df4d73d9-0241-a310-2709-a5f6f984d0d7.png)

---

次に「商品情報」です。

「__Of the following campaign objectives, where is your offering strongest?__（次のキャンペーン目的のうち、御社の商品が最も優れている部分はどこにありますか？）」
![スクリーンショット 2020-09-18 15.57.06.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/8fcc2a07-f1de-aeab-461f-473cfd7ca016.png)

「__How is your product distributed?__（商品の流通方法を教えてください）」
![スクリーンショット 2020-09-18 15.57.14.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/0c269c2b-6f2a-e620-725b-f70f41233816.png)

「__List the languages that your product supports__（商品がサポートする言語を列挙してください）」
![スクリーンショット 2020-09-18 15.57.25.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/b89b16dd-8c31-8e35-135e-3c88fa03bfc0.png)

「__Does your product currently use or plan to utilize any other Twitter APIs?__（御社の製品にほかのTwitterAPIを現在使用していますか？または、今後、利用する予定がありますか？）」
![スクリーンショット 2020-09-18 15.57.37.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/de583ffc-3019-1b4b-39a5-62803facbefc.png)

「__Do you license data from Twitter's Data APIs?__（TwitterのデータAPIから取得したデータをライセンスの対象にしますか？）」
![スクリーンショット 2020-09-18 15.57.46.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/9b9f9139-0de8-4564-9c2a-21e33f791eda.png)


---

次に「Twitter広告API制約」です。

![スクリーンショット 2020-09-18 16.06.15.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/8bc7c383-ecb0-a55e-4172-682adfcbb26f.png)

以下の項目はラジオボタンにチェックしてください。

- 「__Yes, I agree to the terms of the Twitter Ads Products and Services Agreement.__（はい、Twitter広告商品およびサービス契約書の条件に同意します。）」
- 「__I acknowledge that by agreeing to this Twitter Ads Products and Services Agreement, I agree to the Twitter Privacy Policy, Terms of Service, Developer Agreement and Policy, Trademark and Brand Guidelines, and applicable Twitter Master Services Agreement.__（このTwitter広告商品およびサービス契約書に同意することにより、Twitterプライバシーポリシー、利用規約、開発者契約およびポリシー、商標およびブランドガイドライン、および適用対象となるTwitterマスターサービス契約に同意することに同意いたします。）」
- 「__I further acknowledge that by agreeing to this Twitter Ads Products and Services Agreement, I agree to the Twitter Ads policies, including those for Conversion Tracking and Tailored Audiences, and Twitter's Data Processing Addendum.__（さらに、このTwitter広告商品およびサービス契約書に同意することにより、Twitter広告ポリシー（コンバージョントラッキングおよびテイラードオーディエンスのポリシー、Twitterのデータ処理補遺を含む）に同意することに同意いたします。）」

以下はどちらを選んでも問題ありません。
選択後は、__「Submit」__ボタンをクリックします。

- 「__By clicking on Yes below, you agree to receive various marketing communications (like tech updates, version notifications, events) via email from Twitter. You may unsubscribe at any time.__（以下で [はい] をクリックすると、Twitterからさまざまなマーケティング関連のメール（技術更新、バージョンの通知、イベントなど）を受信することに同意するものとします。購読登録はいつでも解除できます。）」
![スクリーンショット 2020-09-18 16.14.20.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/a799c6c0-4e01-2380-6ebb-3adc41f18d6e.png)

# 4.Twitterからの申請の承認メールが届きます。
以下のようなメールが届いたら承認が完了です。
![スクリーンショット 2020-09-18 16.21.23.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/842a3f66-812d-e41b-5eeb-71799e29087b.png)

---

### ■「Twitter広告APIを利用してキャンペーンを作ってみる 」シリーズ
1. [その１~TwitterAPI申請編~](https://qiita.com/kaga_espla/items/48161d51d79041cfe4b6)
2. [その２~TiwtterAPIのAPIキーとトークンの取得編~](https://qiita.com/kaga_espla/items/4514be0ca123f9ec35c2)
3. [その３~TwitterAPIでツイート編~](https://qiita.com/kaga_espla/items/546c64714e6dc2ca2d7f)
4. __その4~Tiwtter広告APIのAPI申請編~ <font color="Red">←イマココ</font>__
5. [その５~Twitter広告APIでキャンペーン作成編~](https://qiita.com/kaga_espla/items/9197695bda901fa6499d)