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

# 経緯
私が所属している会社では__[待ラノ](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の利用申請をする  <font color="Red">←イマココ</font>__
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の利用申請をする](https://qiita.com/kaga_espla/items/cb050518f7c0174d109d)
7. [Tiwtter広告APIでを利用してツイートを使ったキャンペーンを作る](https://qiita.com/kaga_espla/items/9197695bda901fa6499d)

今回は3の__【TiwtterAPIの利用申請をする】__について説明していきます。

# 1.Twitter Developerのページにアクセス
まずはTwitterにログインした状態で、__[Deeloperサイト](https://developer.twitter.com/en/apps/ "Deeloperサイト")__へアクセスします。

# 2.「Create an app」ボタンをクリックします。
![スクリーンショット 2020-09-14 4.32.14.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/ba7a8498-aebc-b623-b6e4-a968090108b3.png)

# 3.デベロッパーツールの利用目的を選択します。
今回はTwitter広告APIを利用するため__「Publishing ads programatically」__を選択します。
「Doing sometihg else」でもOK。
ここは厳密に回答しなくても問題はありません。
![スクリーンショット 2020-09-14 4.23.55.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/4c38c7d0-e3bd-64bd-35eb-875a16183ae2.png)

# 4.内容を確認して次へ進みます。
![スクリーンショット 2020-09-14 4.41.55.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/2bb8f01d-42d4-26c6-2f10-2de10f98df48.png)

# 5.所属組織について記入します。
以下の項目を入力していきます。

- 「__Team name__（TwitterAPIのアカウント名）」
- 「__Legal entity name__（所属している企業名）」
- 「__Organization Twitter @ username__（TwitterのアカウントID）」
- 「__Organization primary country of operation__（所属している企業の主な国）」
- 「__How do you categorize your organization?__（所属している企業の業種）」
- 「__What industries do you / will you serve?__（自分が関わっている業種）」

![スクリーンショット 2020-09-14 4.47.13.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/bfd7146a-7020-20ed-4bfc-d43fa0fd34ba.png)

# 6.英文でTwitterAPIの利用目的を回答していきます。
まずは__「In English, please describe how you plan to use Twitter data and/or APIs. The more detailed the response, the easier it is to review and approve.__（Twitter APIまたはTwitterデータの利用方法を教えて下さい）」

今回、下記のように回答しました。

```
1.私のウェブサイトに投稿した記事をTwitterのAPIを利用して、Twitterのタイムラインにも自動的に表示されるようにしたい。
2.Twitterのタイムラインに自動的に表示させるのは1日に1回程度です。
3.Twitter APIを利用しTwitterからのコンテンツを取得して、Twitter以外で表示させることはありません。
```

これを__英文__にすると下記になります。

```
1.I want to make sure that articles posted on my website are automatically displayed on Twitter's timeline as well, using Twitter's API.
2.I would like to have an article automatically displayed on my Twitter timeline about once a day.
3. We do not use the Twitter API to retrieve content from Twitter and display it outside of Twitter.
```

![スクリーンショット 2020-09-14 5.05.43.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/7d0c10b5-2e81-62f7-f0fe-6dcd13c4519a.png)

---

__「Are you planning to analyze Twitter data?__（ツイッターのデータを利用しますか？）」

今回は利用しないので__「No」__にします。
![スクリーンショット 2020-09-14 5.12.02.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/c0c6fb61-610a-3ab0-721a-6d25f4ca1a5d.png)

---

__「Will your app use Tweet, Retweet, like, follow, or Direct Message functionality?__（アプリはツイート、リツイート、お気に入り、フォロー、ダイレクトメッセージを利用するか？）」

今回は下記のように回答しました。

```
1.私のウェブサイトに投稿した記事をTwitterのAPIを利用して、Twitterのタイムラインにも自動的に表示されるようにしたい。
2.Twitterのタイムラインに自動的に表示させるのは1日に1回程度です。
```

これを__英文__にすると下記になります。

```
1.I want to make sure that articles posted on my website are automatically displayed on Twitter's timeline as well, using Twitter's API.
2.I would like to have an article automatically displayed on my Twitter timeline about once a day.
```

![スクリーンショット 2020-09-14 5.17.44.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/c3de3b28-63bb-db1e-d4a6-57971fb413a8.png)

---

__「Do you plan to display Tweets or aggregate data about Twitter content outside of Twitter?__（Twitter以外のTwitterコンテンツに関するツイートを表示したり集計データを表示するか？）」

今回は利用しないので__「No」__にします。
![スクリーンショット 2020-09-14 5.27.12.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/caf62fc5-909c-2530-9f0c-69d68076b672.png)

---

__「Will your product, service or analysis make Twitter content or derived information available to a government entity?__（あなたの製品・サービス，または分析によって，Twitterコンテンツまたは派生情報が政府機関が利用可能になりますか？）」

該当しないため__「No」__にします。
![スクリーンショット 2020-09-14 5.30.15.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/8e550c7f-3f5f-5b21-e18b-13fbc2a72cf7.png)

# 7.内容を確認して次へ進みます。
![スクリーンショット 2020-09-14 5.32.41.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/1972742b-bc91-3bd4-3f01-cf3b55a814bf.png)

# 8.利用規約に同意して申請します。
![スクリーンショット 2020-09-14 5.35.55.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/b87b4464-2262-241d-b17b-0fcd198ebcec.png)

# 9.メールアドレスの認証メールが届きます。
以下のようなメールが届き、メールに記載されている__「Confirm your email」__押して認証を完了します。
![スクリーンショット 2020-09-14 10.24.30.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/48815693-3ce8-500a-7941-2a61985836e8.png)

# 10.Twitter社からTwitterAPIの使用目的についての確認メールが届きます。
以下のようなメールが届き、こちらのメールに使用目的を記載して返信します。
![スクリーンショット 2020-09-15 9.41.08.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/3034e3b8-49a7-e41a-ceae-5a332ef5f24c.png)

# 11.Twitterからの申請の承認メールが届きます。
以下のようなメールが届いたら承認が完了です。
![スクリーンショット 2020-09-14 10.33.17.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/76311/90d93306-029d-74b2-657f-ad71d3f56bc5.png)

---

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