コネクション

[インポートコネクション]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に登録する

  1. Meta for Developersにアクセスし、Facebookのアカウントでログインする
  2. 以下の手順で開発者登録をする
    1.「Get Started」をクリックする
    2.「次へ」をクリックする
    content_11_01.jpg
    3.電話番号を入力して「認証SMSを送信」をクリックする
    ※「090」や「080」の先頭の「0」は省略する
    content_11_02.jpg
    4.コード入力し「次へ」をクリックする
    content_11_03.jpg
    5.開発者情報を受け取る場合はチェックを入れて「メールアドレスを認証」をクリックする
    content_11_04.jpg
    6.「開発者」を選択して「登録完了」をクリックする

Step 2:ダッシュボード上で新しいアプリを作成する

  1. ダッシュボードの「マイアプリ > アプリを作成」をクリックする
    content_11_05.jpg
  2. ポップアップ画面が表示されるので「アプリを作成」をクリックする
    content_11_06.jpg
  3. 任意のアプリ名(例:ecforce AIdp)を入力して「次へ」をクリックする
    content_11_07.jpg
  4. 「その他」を選択して「次へ」をクリックする
    content_11_08.jpg
  5. 「ビジネス」を選択して「次へ」をクリックする
    content_11_09.jpg
  6. 「アプリを作成」をクリックする
    ※パスワードを求められたら入力する
    content_11_10.jpg
  7. アプリ追加後、左メニューの「アプリの設定  > ベーシック」をクリックして「アプリID」と「app secret」をコピーする

    コピーした値は、コネクション作成画面の以下の項目に設定してください。
    ・「アプリID」の値 →「アプリID」
    ・「app secret」の値 →「アプリシークレット」

    content_11_11.jpg

Step 3:Facebook Marketing API のアクセス許可を追加する

  1. アプリダッシュボードの「マーケティングAPI > ツール」をクリックする
  2. 以下のマーケティング関連パーミッションを選択して「トークンを取得」をクリックする

    パーミッション名 用途
    ads_read 広告データの読み取り
    ads_management 広告アカウントへのアクセス
    business_management ビジネスマネージャー操作

    content_11_13.jpg

Step 4:アクセストークンを発行する

  1. Graph API Explorerにアクセスする
  2. アプリを選択し、自分のユーザーアカウントを選択する
  3. permissionに以下を選択する
    ・instagram_basic
    ・instagram_manage_insights
    ・pages_show_list
    ・pages_read_engagement
  4. 「アクセストークンを取得」クリックする
  5. 発行されたアクセストークンをコピーする

    コピーした値は、コネクション作成画面の項目「アクセストークン」に設定してください。

    content_11_14.jpg

    発行したアクセストークンは、発行してから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.「送信」をクリックする(③)
    content_11_15.jpg
    2.レスポンスの「access_token」(①)が無期限トークンとなる
    content_11_16.jpg
    ※発行されたトークンが無期限か否かは以下の手順で確認できます
    1.アクセストークンデバッガーにアクセスする
    2.「access_token」(①)を入力して、「デバッグ」(②)をクリックする
    3.「有効期限」が「受け取らない」になっていることを確認する

Step 5:コネクションを作成する

  1. ecforce AIdp管理画面にて、「コネクション > コネクションを作成 > インポート用コネクションを作成」をクリックする
  2. 「Instagram」を選択して「決定」をクリックする
  3. 以下の項目を入力して、「接続確認をして保存」をクリックする

    content_04_16.jpg
    項目 説明
    接続先サービス 選択した接続先サービス名が表示されます。
    接続先名 必須です。接続先の名前を設定できます。
    ※管理用の名前です。
    説明 任意です。接続先の説明が設定できます。
    content_27_01.jpg
    項目 説明
    アクセストークン 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:新しい長期アクセストークンを取得する

  1. Graph API Explorerにアクセスし、「Metaアプリ > AIdp用に登録されているアプリ」を選択する
  2. アクセストークン横のコピーボタンをクリックし、アクセストークンをコピーする
    content_11_18.jpg
  3. ブラウザのアドレスバーに以下を入力し、エンターキーを押す

    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でコピーしたアクセストークン}
  4. Json形式のレスポンスが返却されるので「access_token」の値をコピーする
    content_11_19.jpg

Step 2:新しい長期アクセストークンをコネクションに設定する

  1. ecforce AIdp管理画面にて、接続手順のStep 5で作成したで作成したコネクション(接続先名の初期値は「Instagram」)をクリックする
    content_27_02.jpg
  2. 項目「アクセストークン」にStep 1:新しい長期アクセストークンを取得するの手順4でコピーしたアクセストークンを入力し、「接続確認をして保存」をクリックする
     content_27_03.jpg

この記事の目次

このセクションの記事

コネクション