1. ecforce AIdp faq
  2. コネクション
コネクション

[インポートコネクション]Facebook Ads（Meta広告）

概要

Facebook Marketing API を利用して、広告情報を取得します。

接続手順

以下の手順に従い、コネクションを使用するために必要な情報を取得し、ecforce AIdp管理画面にて設定を行ってください。
※コネクション作成画面を別タブで開き、情報の取得とコネクションの設定を同時に行うことを推奨します。

Step 1：Meta for Developersに登録する
Step 2：ダッシュボード上で新しいアプリを作成する
Step 3：Facebook Marketing API のアクセス許可を追加する
Step 4：アクセストークンを発行する
Step 5：広告アカウントIDを取得する
Step 6：コネクションを作成する

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」の値 →「appID」
    ・「app secret」の値 →「appSecret」

    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に以下を選択する
    ・ads_management
    ・ads_read
    ・business_management
    ・read_insights
    ※instagramも利用する場合は以下も選択する
    ・instagram_basic
    ・instagram_manage_insights
    ・pages_show_list
    ・pages_read_engagement
  4. 「アクセストークンを取得」クリックする

  5. 発行されたアクセストークンをコピーする

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

    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：広告アカウントIDを取得する

  1. 広告アカウントにログインする

  2. URLに表示される「act_XXXXXXXX」の形式の文字列（広告アカウントID）をコピーする

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

Step 6：コネクションを作成する

  1. ecforce AIdp管理画面にて、「コネクション > コネクションを作成 > インポート用コネクションを作成する」をクリックする
  2. 「Facebook Ads」を選択して「決定」をクリックする

  3. 以下の項目を入力して、「接続確認をして保存」をクリックする

    content_11_22.jpg
    項目 説明
    接続先サービス 選択した接続先サービス名が表示されます。
    接続先名 接続先の名前を設定できます。
    ※管理用の名前です。
    説明 接続先の説明が設定できます。
    content_11_17.jpg
    項目 説明
    appID Step 2：ダッシュボード上で新しいアプリを作成するの手順7でコピーした「アプリID」を設定してください。
    appSecret Step 2：ダッシュボード上で新しいアプリを作成するの手順7でコピーした「app secret」を設定してください。
    accessToken Step 4：アクセストークンを発行するの手順5でコピーした「アクセストークン」を設定してください。
    ※長期トークンや永久アクセストークンを発行した場合は、発行したアクセストークンを設定してください。
    adAccountId Step 5：広告アカウントIDを取得するの手順2でコピーした「広告アカウントID」を設定してください。
    全件更新時のデータ取得方法 データを全件取得する際の取得方法を設定できます。
    ・直近N日：「取得するインサイトの日数（現在日から過去N日間, 最大37ヶ月）」に指定した日付から現時点までのデータを取得します
    ・日付範囲指定（固定）：「取得するインサイトの開始日付」に指定した日付から「取得するインサイトの終了日付」に指定した日付までのデータを取得します
    ※「取得するインサイトの開始日付」のみを指定した場合、「取得するインサイトの開始日付」に指定した日付から現時点までのデータを取得します
    差分更新時のデータ取得方法 データを差分取得する際の取得方法を設定できます。
    ・直近N日：「取得するインサイトの日数（現在日から過去N日間, 最大37ヶ月）」に指定した日付から現時点までのデータを取得します
    ・日付範囲指定（固定）：「取得するインサイトの開始日付」に指定した日付から「取得するインサイトの終了日付」に指定した日付までのデータを取得します
    ※「取得するインサイトの開始日付」のみを指定した場合、「取得するインサイトの開始日付」に指定した日付から現時点までのデータを取得します
    Table Name Prefix ecforce AIdpの管理画面発行時に各アカウントごとに付与される「brand_id」を用いて「{brand_id}_」の形式で設定してください。
    例えば、「brand_id」が「hoge」の場合は「hoge_」と設定してください。
    ※「brand_id」がご不明の場合はお問い合わせください。また、一つのbland idに複数のコネクタのデータを取り込みたい場合は、「{brand_id}_2_」 と設定してください。
    取得するインサイトの Breakdown （カンマ区切り）
    ※オプション    		 「publisher_platform」を指定することで、広告費データセットに広告の種類が集計されます。
    ※指定できる値についてはこちらの「内訳の組み合わせ」をご参照ください。
    ▼指定しない場合
    全ての広告が「facebook」として集計されます
    ▼「publisher_platform」を指定した場合
    広告の種類に応じて、「facebook」や「instagram」などに分類して集計されます
    広告費フィー（数値）
    ※オプション    		 取り込んだ広告の広告費に掛かるフィーを設定してください。
    例えば「0.1」を指定した場合、10％のフィーが計上されます。

長期アクセストークン更新手順

以下の手順に従い、新しい長期アクセストークンを取得し、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 6で作成した「Facebook source connector」をクリックする
    content_11_20.jpg
  2. 項目「accessToken」にStep 1：新しい長期アクセストークンを取得するの手順4でコピーしたアクセストークンを入力し、「接続確認をして保存」をクリックする
    content_11_21.jpg

この記事の目次

このセクションの記事

コネクション

  • もっと見る