[インポートコネクション]Instagram
概要
Instagram Graph APIを利用して、広告情報を取得します。
接続手順
以下の手順に従い、コネクションを使用するために必要な情報を取得し、ecforce AIdp管理画面にて設定を行ってください。
※コネクション作成画面を別タブで開き、情報の取得とコネクションの設定を同時に行うことを推奨します。
Step 1:Meta for Developersに登録する
Step 2:ダッシュボード上で新しいアプリを作成する
Step 3:Facebook Marketing API のアクセス許可を追加する
Step 4:アクセストークンを発行する
Step 5:コネクションを作成する
Step 1:Meta for Developersに登録する
- Meta for Developersにアクセスし、Facebookのアカウントでログインする
- 以下の手順で開発者登録をする
1.「Get Started」をクリックする
2.「次へ」をクリックする
3.電話番号を入力して「認証SMSを送信」をクリックする
※「090」や「080」の先頭の「0」は省略する
4.コード入力し「次へ」をクリックする
5.開発者情報を受け取る場合はチェックを入れて「メールアドレスを認証」をクリックする
6.「開発者」を選択して「登録完了」をクリックする
Step 2:ダッシュボード上で新しいアプリを作成する
- ダッシュボードの「マイアプリ > アプリを作成」をクリックする
- ポップアップ画面が表示されるので「アプリを作成」をクリックする
- 任意のアプリ名(例:ecforce AIdp)を入力して「次へ」をクリックする
- 「その他」を選択して「次へ」をクリックする
- 「ビジネス」を選択して「次へ」をクリックする
- 「アプリを作成」をクリックする
※パスワードを求められたら入力する -
アプリ追加後、左メニューの「アプリの設定 > ベーシック」をクリックして「アプリID」と「app secret」をコピーする
コピーした値は、コネクション作成画面の以下の項目に設定してください。
・「アプリID」の値 →「アプリID」
・「app secret」の値 →「アプリシークレット」
Step 3:Facebook Marketing API のアクセス許可を追加する
- アプリダッシュボードの「マーケティングAPI > ツール」をクリックする
-
以下のマーケティング関連パーミッションを選択して「トークンを取得」をクリックする
パーミッション名 用途 ads_read 広告データの読み取り ads_management 広告アカウントへのアクセス business_management ビジネスマネージャー操作
Step 4:アクセストークンを発行する
- Graph API Explorerにアクセスする
- アプリを選択し、自分のユーザーアカウントを選択する
- permissionに以下を選択する
・instagram_basic
・instagram_manage_insights
・pages_show_list
・pages_read_engagement - 「アクセストークンを取得」クリックする
-
発行されたアクセストークンをコピーする
コピーした値は、コネクション作成画面の項目「アクセストークン」に設定してください。
発行したアクセストークンは、発行してから1〜2時間ほどで期限が切れる短期アクセストークンであり、アクセストークンの更新は自動で行われないため長期アクセストークンもしくは永久アクセストークンを利用する必要があります。
▼長期トークン(有効期限:60日間)を利用する場合
1.ブラウザのアドレスバーに以下を入力し、エンターキーを押すhttps://graph.facebook.com/v19.0/oauth/access_token?grant_type=fb_exchange_token&client_id={app-id}&client_secret={app-secret}&fb_exchange_token={short-lived-token}2.Json形式のレスポンスが返却されるので「access_token」の値をコピーする
{ "access_token": "EAAJZC7...ZDZD", "token_type": "bearer", "expires_in": 5183944 }▼永久アクセストークン(有効期限:なし)を利用する場合 ※ビジネスマネージャーのSystem Userのみ可能
1.Graph API Explorerにアクセスする
2.「アクセストークン」に長期トークンをペーストする(①)
3.APIのパスにme/accountsを入力する(②)
4.「送信」をクリックする(③)
2.レスポンスの「access_token」(①)が無期限トークンとなる
※発行されたトークンが無期限か否かは以下の手順で確認できます
1.アクセストークンデバッガーにアクセスする
2.「access_token」(①)を入力して、「デバッグ」(②)をクリックする
3.「有効期限」が「受け取らない」になっていることを確認する
Step 5:コネクションを作成する
- ecforce AIdp管理画面にて、「コネクション > コネクションを作成 > インポート用コネクションを作成」をクリックする
- 「Instagram」を選択して「決定」をクリックする
-
以下の項目を入力して、「接続確認をして保存」をクリックする
項目 説明 接続先サービス 選択した接続先サービス名が表示されます。 接続先名 必須です。接続先の名前を設定できます。
※管理用の名前です。説明 任意です。接続先の説明が設定できます。 項目 説明 アクセストークン Step 4:アクセストークンを発行するの手順5でコピーした「アクセストークン」を設定してください。
※長期トークンや永久アクセストークンを発行した場合は、発行したアクセストークンを設定してください。クライアントID
※オプションStep 2:ダッシュボード上で新しいアプリを作成するの手順7でコピーした「アプリID」を設定してください。 クライアントシークレット
※オプション任意です。Step 2:ダッシュボード上で新しいアプリを作成するの手順7でコピーした「app secret」を設定してください。 開始日
※オプションUser Insights を取り込む開始日時です。未入力の場合、現在から 2 年前です。
任意の項目として、クライアントID、クライアントシークレット、同時実行スレッド数(既定 20)も出ます。
長期アクセストークン更新手順
以下の手順に従い、新しい長期アクセストークンを取得し、ecforce AIdp管理画面にてコネクションの更新をしてください。
Step 1:新しい長期アクセストークンを取得する
Step 2:新しい長期アクセストークンをコネクションに設定する
Step 1:新しい長期アクセストークンを取得する
- Graph API Explorerにアクセスし、「Metaアプリ > AIdp用に登録されているアプリ」を選択する
- アクセストークン横のコピーボタンをクリックし、アクセストークンをコピーする
-
ブラウザのアドレスバーに以下を入力し、エンターキーを押す
https://graph.facebook.com/v19.0/oauth/access_token?grant_type=fb_exchange_token&client_id={app-id}&client_secret={app-secret}&fb_exchange_token={手順2でコピーしたアクセストークン} - Json形式のレスポンスが返却されるので「access_token」の値をコピーする
Step 2:新しい長期アクセストークンをコネクションに設定する
- ecforce AIdp管理画面にて、接続手順のStep 5で作成したで作成したコネクション(接続先名の初期値は「Instagram」)をクリックする
- 項目「アクセストークン」にStep 1:新しい長期アクセストークンを取得するの手順4でコピーしたアクセストークンを入力し、「接続確認をして保存」をクリックする
この記事の目次
このセクションの記事