メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://domoinc-jkreitzman-patch-1.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

​
はじめに

マーケティングのエキスパートは、様々なオーディエンスにリーチできるようにターゲットを絞った広告を作成し、業務目標の達成を目指すのにFacebook Adsを活用しています。Facebook APIの詳細については、Facebookのページ（https://developers.facebook.com/docs/marketing-apis）を参照してください。 この高度なバージョンのFacebook Adsコネクターでは、標準バージョンのFacebook Adsコネクターよりも多くのレポートを処理できますが、その分設定項目も多くなります。標準バージョンの詳細については、「Facebook Adsコネクター」を参照してください。 Facebookアカウントには、Data Centerから接続します。このトピックでは、Facebook Adsコネクターのユーザーインターフェース固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報は、「コネクターを使用してDataSetを追加する」を参照してください。
主な使用事例- 個々の広告を表示するユーザーの数をトラッキングする - 各キャンペーンでリーチするユーザーの数をトラッキングする - キャンペーンでどれだけの費用がかかったかをトラッキングする
主なメトリクス- リーチ - 支出 - リード1人当たりのコスト - 獲得リード数 - インプレッション数 - クリック数 - 1クリック当たりのコスト
社内における主な権限オンラインマーケター
平均導入時間1～2時間
使いやすさ（1から10のスケールで、1が「最も使いやすい」）4

​
ベストプラクティス

  • Facebook Adsコネクターには、すぐに使用できるレポートが用意されています。このコネクターに付属しているレポートのうち、最も柔軟性が高いのは「Custom Insights」レポートです。このレポートを使用して、生成するレポートを詳細に管理することができます。
  • 非常に長い日付範囲を指定した場合や、非常に多くのキャンペーンや広告が含まれているアカウントを選択した場合、このコネクターの実行時間が長くなる可能性があります。選択されたメトリクスをFacebookで計算する際に時間がかかる場合は、このコネクターの実行時間も長くなります。DataSetの処理に時間がかかる場合や処理が完了しない場合は、日付の範囲を短くする必要があります。
  • Instagram経由で配置された広告のメトリクスを表示するには、「Custom Insights」レポートを使用して、**［Breakdown］の値を［Placement］**に設定します。これにより、Instagramが配置値の1つとして結果内に表示されます。
  • Instagramビデオ閲覧数のメトリクスを返すこともできます。これについては、この記事の後半にある「Instagramビデオ閲覧数」で説明します。

​
必要条件

Facebookに接続してFacebook Ads DataSetを作成するには、以下が必要になります。
  • Facebookアカウントに関連付けられているメールアドレス、または電話番号
  • Facebookのパスワード
  • 自社のFacebook Adsアカウントへのアクセス権限

​
Facebookアカウントにアクセスする

このセクションでは、Facebook Adsコネクターページの［認証情報］ペインと［詳細］ペインに表示されるオプションについて説明します。このページのほかのペインの項目である**［スケジュール設定］や［DataSetに名前を付け、説明を入力］**に関しては、ほとんどのタイプのコネクターで共通しています。詳細については、「コネクターを使用してDataSetを追加する」を参照してください。

​
［認証情報］ペイン

Domo Facebook AdsコネクターはOAuthを使用して接続を行うため、Domoで認証情報を入力する必要はありません。［接続］をクリックすると（または、Domo内でFacebook Adsアカウントが既に作成されている状態で［アカウントを追加］を選択すると）、Facebookの認証情報を入力するためのFacebook OAuth画面が表示されます。有効なFacebook認証情報を入力すると、それ以降は新しいFacebook Ads DataSetを作成する際に常に同じアカウントを使用できるようになります。コネクターのアカウントはData Centerの［アカウント］タブで管理できます。このタブの詳細については、「コネクターのユーザーアカウントを管理する」を参照してください。
**注記：Domoで接続の際に既にFacebookにログインしている場合は、［アカウントを追加］**をクリックすると自動的に認証されます。ログインしたのと違うアカウントにアクセスしたい場合は、まずFacebookからログアウトする必要があります。

​
［詳細］ペイン

このペインには、メインとなる**［Report］**メニューのほか、選択したレポートタイプに応じて表示または非表示になる様々なメニューが含まれています。 多くのレポートタイプは「エッジ」と呼ばれるサブレポートを含んでいます。これらも以下に説明します。

​
レポートとエッジ

メニュー説明
Report実行するFacebook Adsレポートを選択します。以下のレポートが利用できます。
レポート名説明
Ad Accounts選択した1つあるいは複数のFacebook Adsアカウントに関する情報を返します。
Ad Campaigns選択したアカウントがコントロールする1つまたは複数の広告キャンペーンに関する情報を返します。
Ad Keyword Statistics（廃止）選択した広告をターゲットするのに使用されたキーワードに関する情報を返します。
Ad Sets選択した広告キャンペーン内の1つまたは複数の広告セットに関する情報を返します。
Ads選択した広告セットで定義された1つまたは複数の広告に関する情報を返します。
Custom Insightsユーザーが選択したインサイトに関する情報を、レベルフィールドで定義されたレポートレベルで返します。
FBAds PreBuilt ReportDomoのFacebook広告向けの無料作成済みレポートは、アカウント、キャンペーン、広告グループ、広告レベルのレポートなど、広告のパフォーマンスを包括的に分析したものです。
General Metricsキャンペーンレベルで一般的に使用されるインサイトのメトリクスを返します。
Object Information - NEWこの新しいレポートを使用すると、選択した広告アカウントに関連付けられているアカウント、キャンペーン、広告セット、広告オブジェクトの情報エッジを取得することができます。情報の取得元となる広告アカウントとオブジェクトタイプを選択します。
Object Insights - NEWこの新しいレポートを使用すると、選択した広告アカウントに関連付けられているアカウント、キャンペーン、広告セット、広告オブジェクトのインサイトエッジを取得することができます。インサイトの取得元となる広告アカウントとオブジェクトタイプを選択し、ほかのインサイトメトリクスを入力します。
Page Actions (Ad sets)広告セットレベルでのページと投稿のインタラクションに関連するインサイトを返します。
Page Actions (Ads)広告レベルでのページと投稿のインタラクションに関連するインサイトを返します。
Placement Metricsキャンペーンレベルで一般的に使用されるメトリクスをスクリーンプレースメント別に返します。
Responder Demographics広告レベルでの一般的なメトリクスを、年齢や性別別に返します。
User認証されたユーザーの情報を返します。
Select Status Of Account To Retrieveアカウントのステータスを選択します。
Select Object Typeデータを収集するオブジェクトレベルを選択します。Domoは、選択したアカウント内のそのタイプのオブジェクトすべてについて報告します。
Breakdownsレポートデータの内訳方法を選択します。
Time Incrementデータを集計するために使用する粒度を選択します。
Durationレポートのデータが、1 日分か日付期間を対象にしたものかを指定します。
Date From日付範囲の第1日目が特定日付か、相対日付かを指定します。現在の日付から数えて一定数の過去の日数（**［Date From Offset］で指定）のデータをレポートで取得する場合は、［Relative］を選択します。ここで ［Relative］を選択した場合は、［Date To］にも［Relative］を選択し、［Date To Offset］ の値を指定する必要があります。 例えば、［Date From Offset］に10、［Date To Offset］**に5を入力し、そのデータソースを毎日更新するように設定した場合、日が更新される度にその日から過去5〜10 日分の情報が表示されます。
Date From Offsetレポートの開始日とする日まで現在の日付から遡る日数を入力します。
Select Specific Date From日付範囲の最初の日付を選択します。
Date To日付範囲の終了日が特定の日か、相対日付かを指定します。常に現在の日付から一定日数遡った日付（［Date To Offset］で指定）までのデータをレポートで取得する場合は、［Relative］を選択します。ここで［Relative］を選択した場合、［Date From］ にも **［Relative］を選択し、［Date From Offset］の値を指定する必要があります。 例えば、［Date From Offset］に10、［Date To Offset］**に5を入力し、そのデータソースを毎日更新するように設定した場合、日が更新される度にその日から過去5〜10 日分の情報が表示されます。
Date To Offsetレポートの最終日とする日まで現在の日付から遡る日数を入力します。
Select Specific Date To日付範囲の最後の日付を選択します。
Write ID Columns as type String列［AdId］、［AdsetId］、［CampaignID］、［AccountId］を数値ではなく文字列として入力する場合は、このチェックボックスを選択します。
Ad Account ID広告アカウントを選択します。
Columns列を選択します。
Ad Campaign Type広告キャンペーンのタイプを選択します。
Ad Campaign広告キャンペーンを選択します。
Levelレポートの広告レベルを選択します。
Conversion Type Selectionカスタムまたは標準のコンバージョンのみを取得する場合に選択します。
Action Breakdownsレポートに入れたいアクションの内訳を選択します。
Include Archived Objects「True」に設定すると、アーカイブ済みのオブジェクトが結果に表示されます。それ以外の場合は、アーカイブ済みのオブジェクトは報告されません。
Action Attribution Windowsレポートで希望するアクション属性のウインドウを選択します。
Reset Schemaスキーマをリセットする場合は、これを選択します。
**警告：**Facebook APIから一部のフィールドが一時的に返されない場合、データの損失やデータタイプの変更が発生する可能性があります。このチェックボックスが選択されている間、データセットは実行されるたびにスキーマをリセットします。追加モードでは使用しないでください。
Ad Set広告セットを選択します。
Ad広告を選択します。
Ad Edge
エッジ説明
Ad Creatives選択した広告のクリエイティブをリストにして返します。
Ad Info選択した広告に関する情報を返します。
Insights指定条件のインサイト情報を返します。
Reach Estimate選択した広告の推定リーチを返します。
Action Report Timeアクション統計データのレポートタイムを決定します。例えば、あるユーザーが1月1日に広告を見て、1月2日にコンバージョンに至った場合、action_report_time=impressionでAPIにクエリを実行すると、1月1日にコンバージョンに至ったことが表示されます。action_report_time=conversionでAPIにクエリを実行すると、1月2日にコンバージョンに至ったことが表示されます。
Ad Account Edge
エッジ説明
Ad Account Info広告アカウント情報
Activities選択したアカウントに関するアクションのログを返します。
Ad Campaigns選択したアカウントの広告キャンペーンをリストにして返します。
Ad Sets選択したアカウントの広告セットをリストにして返します。
Ads選択したアカウントの広告リストを返します。
Custom Audiences選択したアカウントを所有または共有しているカスタムオーディエンスを返します。
Insights指定条件のインサイト情報を返します。
Partners選択したアカウントの広告パートナーをリストにして返します。
Rate Card通貨レートをリストにして返します。
Reach Estimate選択したアカウントと特定のターゲットスペックに対する推定リーチを返します。
Users選択したアカウントのユーザーID、権限、役割を返します。
Expand List Columns
オプション説明
Expand as Columnsリストのデータは、結果で複数の列に展開されます。
Expand as Rowsリストのデータは、結果で複数の行に展開されます。その結果、多くの行でデータが重複します。
Do not expandリストのデータは、結果で展開されません。結果では「リスト」として返されます。
Expand Lists In Placeリストの展開の実施中
Targeting Specターゲットスペックを入力します。
Ad Campaign Edge
エッジ説明
Ad Campaign Info選択したキャンペーンに関する情報を返します。
Insights指定条件のインサイト情報を返します。
Skip Failing Campaign IDsチェックマークを入れると、失敗したキャンペーンIDはスキップされ、コネクターは残りのキャンペーンIDを使用して引き続き実行されます。
Ad Set Edge
エッジ説明
Activities選択した広告セットに対するアクションのログを返します。
Ad Set Info選択した広告セットに関する情報を返します。
Ad Creatives選択した広告セットの広告クリエイティブをリストにして返します。
Insights指定条件のインサイト情報を返します。
Reach Estimate選択した広告セットの推定リーチを返します。
Skip Failing Ad Set IDsチェックマークを入れると、失敗した広告セットIDはスキップされ、コネクターは残りの広告セットIDを使用して引き続き実行されます。
User Edge
エッジ説明
Ad Accounts残高、機能、資金源など、認証ユーザーの広告アカウントに関する情報を返します。
User Info認証ユーザーの名前とIDを返します。

​
その他のペイン

スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「コネクターを使用してDataSetを追加する」を参照してください。

​
ヒントとコツ

​
インサイト列を選択する

「Custom Insights」レポートは非常に柔軟性が高いため、Facebook Ads UIで作成できるほとんどすべてのレポートを、Custom Insightsレポートで作成することができます。ただし、Facebook Ads UIに表示される列名と、有効な列やカテゴリーのリストをどのようにマッピングするかを判断するのが難しくなる場合があります。このような場合は、以下の手順を実行します。
  1. Facebook Ads UIで、Domoで複製するレポートを開きます。
  2. **［Columns］>［Customize Columns］**を選択します。
    レポート内の列を選択して順序を変更するためのダイアログボックスが表示されます。
  3. レポートに追加する列を選択して**［Apply］**をクリックします。
    URLに「columns」というパラメーターが表示されます。このパラメーターは以下のように表示されます。     columns=[“name”%2C”date_start”%2C”date_stop”%2C”reach”%2C”frequency”%2C”impressions”%2C”cpm”%2C”cpp”%2C”spend”%2C”clicks”%2C”unique_clicks”%2C”ctr”%2C”unique_ctr”%2C”cpc”%2C”actions%3Aoffsite_conversion.lead”%2C”social_reach”] 引用符で囲まれている各項目が列名を表し、その列のAPI名になります。**［Columns］**フィールドに表示される名前は通常、上記の列名に非常に近い名前（または同じ名前）になります。 Domo UI内で大きなカテゴリーの一部になっている列については、注意が必要です。こうした列の例としては、［Actions］列などがあります。この列は、上記のactions%3Aoffsite_conversion.leadなど複数の小さなフィールドに展開されます（これは、UI上では「Leads (Conversion)」として表示されます）。

​
Instagramビデオ閲覧数

Instagramビデオ閲覧数を表示するには、以下の手順を実行します。
  1. 「Custom Insights」レポートを作成します。
  2. 表示したいメトリクスを選択します。［Actions］メトリクスを選択すると、ビデオ閲覧数に関する列が取得されます。
  3. 内訳のオプションとして、**［Placement］**を選択します。
  4. レポートのレベルを選択します（Account、Campaign、AdSet、 Ad）。
  5. 日付の範囲と時間の増加量を選択します。
これにより、様々なプレースメントオプションに関する情報が返されます。中でも興味深いのは「instagramstream」というオプションです。ビデオ閲覧数を表示する「ActionsVideoView」という列もあります。

​
統計情報を集計する

より詳細なレベルの情報を確認する場合に、Custom Insightsレポートを使用したくなることがよくあります。例えば、DataSetには複数のキャンペーンに関する日次メトリクスが記録されます。そのため、すべてのキャンペーンの日次データを合計して、キャンペーンのアカウントの合計値を確認することができます。また、クリック数、支出、インプレッション数などの各種メトリクスを確認することができます。しかしこの方法では、個々のユーザーに関するメトリクス（「Reach」など）で正しくない値が生成されます。例えば「Reach」というメトリクスの場合、広告を表示したユーザー数が毎日カウントされるため、不正確な値になります。さらに、毎月のリーチ数を合計すると、同じユーザーが複数回カウントされることになります。この集計結果をFacebook Ads UIの月次結果と比較すると、集計結果の方がはるかに大きな値になります。Facebook Ads UIでは、閲覧ユーザーは指定の期間内に1回だけカウントされ、重複する閲覧ユーザーはカウントされません。 この問題を回避するには、値の集計期間をDataSet内で定義し、それ以降はカウントしないようにする必要があります。特定の月のリーチ数をカウントする場合は、その月の開始日と終了日をDataSetで定義し、**［Time Increment］の値を［all_days］に設定するか空白のままにする必要があります。長期間にわたって値を集計する場合は（2016年1月1日～2016年12月31日など）、［Time Increment］の値を［monthly］に設定します。これにより、Facebookでの集計値と同じ値が表示されるようになります。同様に、アカウントレベルでリーチデータを収集する場合は、DataSetの［Level］の値を［Campaigns］ではなく［Account］**に設定します。これにより、Domoで正しい値が集計されるようになります。 コネクターによる集計結果をFacebook Ads UIでの集計結果と比較すると便利な場合がよくあります。しかし正確に比較するためには、Facebook Ads UIの設定とコネクターの設定を一致させる必要があります。集計期間（開始日と終了日）だけでなく、レポートレベルと時間増加量の値も一致させる必要があります。

​
トラブルシューティング

  • 最もよくある問題は、返されたデータとFacebook Ads UIのデータが一致しないという問題です。この問題は、DataSetの設定とFacebook UIのレポート設定が一致していない場合に発生します。この問題が発生した場合は、以下のパラメーターが一致しているかどうかを確認してください。
    • Start Date
    • End Date
    • Breakdown
    • Level
    • Time Increment
  • 個々のユーザーに関するメトリクス（Reachなど）は、Domoで特定の期間にわたって集計しないでください。こうしたメトリクスの場合、Facebook Adsシステムでは除外される重複値がカウントされてしまうためです。

​
よくある質問

Facebookアカウントに関連付けられているメールアドレスとFacebook用のパスワードが必要になります。ログイン処理ではOAuthプロセスが使用されるため、パスワードは画面には表示されず、Domoに保存されることもありません。これにより、ログインの安全性が保たれます。Domoのアカウントへのアクセスはいつでも取り消すことができます。
関心のあるFacebook AdsアカウントにアクセスするためのFacebookアカウントが必要になります。アクセスレベルには、アナリスト、広告主、管理者という3つのレベルがあります。コネクター内でレポートを使用する場合は、アナリストレベルのアクセス権で十分です。
Custom Insightsレポートは非常に柔軟性が高いため、Facebook Ads UIで作成できるほとんどすべてのレポートを、Custom Insightsレポートで作成することができます。ただし、Facebook Ads UIに表示される列名と、有効な列やカテゴリーのリストをどのようにマッピングするかを判断するのが難しくなる場合があります。このような場合は、以下の手順を実行します。
  1. Facebook Ads UIで、Domoで複製するレポートを開きます。
  2. 画面右側で**［Columns］ボタンをクリックして［Customize Columns］**を選択します。レポート内の列を選択して順序を変更するためのダイアログボックスが表示されます。
  3. レポートに追加する列を選択して**［Apply］**をクリックします。
  4. URLに「columns」というパラメーターが表示されます。これは以下のようになります。
    columns=[“name”,“date_start”,“date_stop”,“reach”,“cpm”,“cpp”,“spend”,“clicks”,“unique_clicks”,“ctr”,“unique_ctr”,“cpc”,“actions:offsite_conversion.lead”,“social_reach”]
    • 引用符で囲まれている各項目が列名になります。［Columns］フィールドに表示される名前は通常、Domoで表示される列名に非常に近い名前（または同じ名前）になります。
    • 大規模なカテゴリーに属する列の場合、このインターフェースとDomoのインターフェースとでは、多少異なって表示されることがあります。例えば 「actions」という列は、「actions:offsite_conversion.lead」などを含む複数の小さなフィールドに展開されます。Domoのインターフェースでは、この列は「Leads (Conversion)」列として表示されます。
Instagram広告は、特殊な広告プレースメントオプションとして設計されています。Instagram閲覧数に関する統計情報を取得するには、以下の手順を実行します。
  1. Custom Insightsレポートを作成します。
  2. 表示したいメトリクスを選択します。（例えば**［Actions］**を選択すると、ビデオ閲覧数に関する列が表示されます。）
  3. 内訳のオプションとして、**［Placement］**を選択します。
  4. レポートのレベルを選択します（［Account］、［Campaign］、［AdSet］、［Ad］）。
  5. 日付の範囲と時間の増加量を選択します。
これにより、instagramstreamやActionsVideoViewなど、様々なプレースメントオプションに関する情報が返されるようになります。
特定のアカウントに関連付けられているすべてのキャンペーン、広告セット、広告に関する情報を取得するには、以下の手順を実行します（レポートの作成後に、キャンペーン、広告セット、広告を作成する場合も同じです）。
  1. 新しいObject Informationレポートと、レポートの作成対象となるアカウントを選択します。
  2. **［Object Type］**として、［Account］、［Campaign］、［Ad Set］、［Ad］のいずれかを選択します。
または
  1. Ad Accountsレポートと、レポートの対象となるアカウントを選択します。
  2. 適切な**［Ad Account］**エッジを選択します。
    • すべてのキャンペーンに関する情報を取得する場合は、**［Ad Campaigns］**を選択します。
    • すべての広告セットに関する情報を取得する場合は、**［Ad Sets］**を選択します。
    • すべての広告に関する情報を取得する場合は、**［Ads］**を選択します。
特定のアカウントに関連付けられているすべてのキャンペーン、広告セット、広告に関するインサイトを取得するには、以下の手順を実行します（レポートの作成後に、キャンペーン、広告セット、広告を作成する場合も同じです）。
  1. 新しいObject Insightsレポートと、レポートの対象となるアカウントを選択します。
  2. **［Object Type］**として、［Account］、［Campaign］、［Ad Set］、［Ad］のいずれかを選択します。
  3. 残りのすべてのフィールドで、必要なパラメーターを選択します。
または
  1. Ad Accountsレポートと、レポートの対象となるアカウントを選択します。
  2. **［Insights Ad Account］**エッジを選択します。
  3. 適切なレベルを選択します。
    • すべてのキャンペーンに関するインサイトを取得する場合は、**［Ad Campaign］**を選択します。
    • すべての広告セットに関するインサイトを取得する場合は、**［Ad Set］**を選択します。
    • すべての広告に関するインサイトを取得する場合は、**［Ad］**を選択します。
  4. 残りのすべてのフィールドで、必要なパラメーターを選択します。
Facebook Ads Advancedコネクターの場合、Facebook Adsコネクターと比べて、非常に多くのレポートとオプションが用意されています。最も大きな違いは、AdvancedコネクターにはCustom Insightsレポートが付属しているという点です。Facebook Adsコネクターは、簡単に使用できる一連の定義済みレポートから構成されています。様々なオプションを使用して柔軟にレポートを設定できるAdvancedコネクターを使用することを推奨します。
このコネクターでは、ほぼリアルタイムでデータが更新されます。ただし、正確な値（閲覧回数など）はFacebookによって決定されるため、多くの統計情報について、更新内容が反映されるまで最大で3日かかります。
FacebookでAPIの呼び出しが制限されることがありますが、ユーザーがこれを気にする必要はありません。
Facebook広告では、クエリの結果を計算してからデータの取得が開始されるため、時間がかかります。サーバーの負荷によっては、さらに時間がかかる場合もあります。作業負荷が高くなる時間帯を避けてクエリを実行すると、DataSetの実行速度が上がる可能性があります。例えば、Facebook Ads DataSetをインドで実行したところ、15分で完了しましたが、6～8時間後に別のユーザーが同じDataSetを実行したところ、完了までに約2時間かかりました。
このコネクターはバージョン18のFacebook API（https://graph.facebook.com/v18.0）を使用します。
レポート名エンドポイントURL（1つまたは複数）
Ad Accounts/{AD_ACCOUNT_ID}/info
Ad Campaigns/{AD_ACCOUNT_ID}/adcampaign_groups
Ad Keyword Statistics/keywordstats
Ad Sets/{AD_ACCOUNT_ID}/adcampaigns
Ads/{AD_ACCOUNT_ID}/adgroups
Custom Insights/{AD_ACCOUNT_ID}/insights
General Metrics/{CAMPAIGN_GROUP_ID}/insights
Object Informaion-NEWAccount Object/{AD_ACCOUNT_ID}/insights
Campaign Object/{AD_ACCOUNT_ID}/insights
Ad Sets Object{AD_ACCOUNT_ID}/adsets
Ads Object/{AD_ACCOUNT_ID}/ads
Object Insights-NEW/{AD_ACCOUNT_ID}/insights
Page Actions (Ad sets)/{AD_SET_ID}/insights
Page Actions (Ads)/{AD_SET_ID}/insights
Placement Metrics/{CAMPAIGN_GROUP_ID}/insights
Responder Demographics/{AD_SET_ID}/insights
User/{USER_ID}