グラフAPI

バージョン11.0

グラフAPI

リリース日 2021年6月8日 | 使用期限 2023年9月14日 | ブログ投稿

消費者アプリ

アクセスレベル

すべてのバージョンに適用。

今後数週間以内に、アクセスレベルがすべての既存の消費者アプリに適用されます。これらのアプリでは、アプリレビュープロセスを経て既に承認されているアクセス許可と機能は、自動的にAdvanced Accessが承認されます。その他すべてのアクセス許可と機能については、Standard Accessが自動的に承認されます。

数週間以内に、すべての新規作成アプリにもアクセスレベルが適用されます。新規作成されたアプリの場合、emailとpublic_profileのアクセス許可については、Advanced Accessが自動的に承認されます。ただし、どちらのアクセス許可もデフォルトではStandard Accessに設定されています。手動でAdvanced Accessに設定すると、アプリに対する権限を持たないアプリユーザーからアクセス許可をリクエストできるようになります。

開発者向けサポート

Facebook for Businessステータスツールをリリースしました。このツールで、広告マネージャ、WhatsApp Business、Facebook開発者プラットフォームなどのプラットフォームやビジネス製品の健全性をモニタリングできます。

Facebook Analytics

廃止

すべてのバージョンに適用。

Facebook Analyticsは、2021年6月30日以降は使用できなくなります。さらに、アプリダッシュボードプラグインのマーケティングAPIを廃止します。詳しい情報については、ビジネスヘルプセンターにアクセスしてください。

次のアプリノードフィールドは、利用できなくなりました。

  • analytics_config
  • analytics_platform_metrics_config
  • permissible_ad_accounts

次のエンドポイントは利用できなくなりました。

  • GET Application/analytics_cohort_query
  • GET Application/analytics_entity_user_config
  • GET Application/analytics_event_types
  • GET Application/analytics_funnel_query
  • GET Application/analytics_query
  • GET Application/analytics_segments

Instagram基本表示API

アクセストークンデバッガー

すべてのバージョンに適用。

アクセストークンデバッガーツールが、トークンのデバッグ時にapp-scoped IDだけを返すようになりました。


APIのバージョン管理

すべてのバージョンに適用。

APIで、バージョン指定の呼び出しがサポートされるようになりました。特定のAPIバージョンをクエリする場合は、ベースURLの後のクエリパスに、バージョン番号を含めます。以下はその例です。

https://graph.instagram.com/v11.0/{node-id}/{edge-name}

バージョンを指定しないリクエスト(バージョン番号なし)は、呼び出し側アプリの[アプリダッシュボード] > [設定] > [詳細] > [APIバージョンのアップグレード]の設定で指定されているバージョンに解決されます。


App Scoped User ID

バージョン11.0以降に適用。

App Scoped User ID (ASID)が導入されました。約2年後にバージョン10.0が廃止される時点で、生ユーザーIDに代わってASIDが使用されるようになります。アプリユーザーの生IDをASIDにマッピングしておくことをおすすめします。

  • すべてのバージョンが、生ユーザーIDベースのクエリをサポートします。
  • バージョン11.0以降の呼び出しでのみ、ASIDベースのクエリがサポートされます。
  • バージョン11.0以降で呼び出すと、生ユーザーIDをクエリした場合でも、応答でASIDを受け取ります。

時間ベースのページネーション

v11.0以降に適用。

sinceとuntilパラメーターがGET /{user-id}/mediaエンドポイントに追加され、時間ベースのページネーションがサポートされます。

InstagramグラフAPI

「いいね！」数

v11.0以降に適用。2021年9月7日にすべてのバージョンに適用。

別のエンドポイントやフィールド拡張を通して間接的にIGメディアをクエリする場合、メディアの所有者が「いいね！」数を非表示にしていると、API応答でlike_countフィールドが省略されます。IGメディアを直接クエリする場合(そのIGメディアの所有者のみ実行可能)、「いいね！」数が非表示になっていても、実際の「いいね！」数が返されます。


時間ベースのページネーション

v11.0以降に適用。

sinceとuntilのパラメーターがGET /{ig-user-id}/mediaエンドポイントに追加され、時間ベースのページネーションがサポートされます。

インスタントエクスペリエンス

テンプレート

v11.0以降に適用。

インスタントエクスペリエンスがベータ版から移行し、すべての開発者に公開されました。

Messengerプラットフォーム

メッセージのpostback Webhooks

v11.0以降に適用。

midフィールドがmessaging_postbacks webhookに追加され、アプリがメッセージIDを取得できるようになりました。


エアラインテンプレートの廃止

v11.0以降に適用。2021年12月6日にすべてのバージョンに適用。

いずれかのエアラインテンプレート(template_typeのタイプがairline_boardingpass、airline_checkin、airline_itinerary、airline_updateであるもの)が含まれている、POST /{page-id}/messagesへの呼び出しは失敗します。

oEmbed

新しいoEmbed Read機能

すべてのバージョンに適用。

oEmbed製品は、新しいoEmbed Read機能へと置き換えられました。oEmbed製品を2021年6月8日より前に実装した場合は、2021年9月7日までに、oEmbed Read機能のアプリレビューを完了させてください。2021年9月7日までにoEmbed Read機能の承認を得ていない場合、oEmbed実装で読み込みが失敗します。

ページAPI

コメントID

v11.0以降に適用。2021年9月7日にすべてのバージョンに適用。

Page Public Content Access機能だけを使用してページエンドポイントをクエリするアプリの場合、コメントのidフィールドは返されません。これには、/PAGEPOST-ID/commentsや/COMMENT-ID/commentsのidフィールドが含まれます。ページ投稿へのコメントのidフィールドを取得するには、アプリユーザーがクエリ対象のページにMODERATEタスクを実行できなければなりません。

新しいページエクスペリエンス

今後数カ月以内に、従来のページはすべて新しいページエクスペリエンスに移行します。has_transitioned_to_new_page_experienceページフィールドを使用すると、ページが移行済みかどうかを確認できます。すべてのページが移行されると、従来のページエクスペリエンスは提供されなくなります。

ほとんどのページAPIエンドポイントは、新旧両方のページエクスペリエンスのページをサポートします。新しいページエクスペリエンスのページをサポートしているエンドポイントのリファレンスには、「新しいページエクスペリエンス」セクションが表示されます。

以下のエンドポイントは、新しいページエクスペリエンスのページをサポートしません。

  • /PAGE-ID/likes
  • /PAGE-ID/global_brand_children
  • /PAGE-ID/locations
  • /PAGE-ID/tabs
  • /PAGE-ID/visitor_posts

一部のページフィールドは新しいページエクスペリエンスで使用できず、呼び出されるとnull、別のデータセット、エラーのいずれかを返します。「新しいページエクスペリエンスの概要」にアクセスして、該当するページフィールドの一覧をご確認ください。

アクセス許可

user_likes

すべてのバージョンに適用。

user_likesアクセス許可で許可されている用途がアップデートされました。このアクセス許可が既に承認されていても、2021年9月7日以降、新しい用途の説明に違反するアプリは、その承認が取り消されます。

  • 以前に許可されていた用途: アプリのユーザーエクスペリエンスの質を意義深い仕方で高める(エクスペリエンスを提供するためにデータを利用する方法を明確にユーザーに示す必要があります)。
  • 新しく許可された用途: ユーザーの好みと関連性があるコンテンツを相関させたり表示させたりすることで、パーソナライズされたエクスペリエンスを提供する。これには、大規模にコンテンツをキュレートし、大量のコンテンツでアプリをカスタマイズしたり、ユーザーが(デートアプリや音楽アプリなどで)好み他の人に共有できるようにしたりすることが含まれます。

user_posts

すべてのバージョンに適用。

user_postsアクセス許可で許可されている用途がアップデートされました。このアクセス許可が既に承認されていても、2021年9月7日以降、新しい用途の説明に違反するアプリは、その承認が取り消されます。

  • 以前に許可されていた用途: アプリのユーザーエクスペリエンスの質を意義深い仕方で高める(エクスペリエンスを提供するためにデータを利用する方法を明確にユーザーに示す必要があります)。
  • 新しく許可された用途: ユーザーが紙またはデジタルでタイムラインのブックやアルバムを作成したり、Facebookや他のソーシャルアプリのタイムラインから思い出をシェアしたりできるようにする。

SDK

iOS SDK更新履歴、Android SDK更新履歴、Unity SDK更新履歴にアクセスして、これらのSDKで予定されている重要な変更点をご確認ください。

マーケティングAPI

リリース日 2021年6月8日 | 使用期限 2022年2月23日 | ブログ投稿

オーディエンス

カスタムオーディエンス、類似オーディエンス、保存済みのオーディエンスの削除

すべてのバージョンに適用。

2021年6月8日以降、アクティブな広告セットで2年以上使用されていないカスタムオーディエンス、類似オーディエンス、保存済みのオーディエンスはすべて、「Expiring Audience」としてフラグされます。このようなオーディエンスは、「Expiring Audience」としてマークされてから90日後に削除されます。

開発者は、operation_statusフィールドを使用して「Expiring Audience」ステータスをフィルターアウトしたり、delete_timeフィールドを使用してシステムでのオーディエンス推定削除時間を確認したりできるようになります。開発者は、事前にオーディエンスを削除することも、アクティブな広告セットでそのオーディエンスを使用して削除を回避することもできます。オーディエンスが削除されたら、広告主はそのオーディエンスを再びアクティブにすることはできません。

カスタムオーディエンス(顧客リストカスタムオーディエンスは除く)、類似オーディエンス、保存済みのオーディエンスの場合:

  • フラグの付いたオーディエンスが2021年9月6日以降に自動的に削除されることを広告主が望む場合、特にアクションは必要ありません。広告主は、自動削除日よりも前にオーディエンスを削除することもできます。
  • 広告主がフラグの付いたオーディエンスを保持したい場合は、2021年9月6日より前にアクティブな広告セットでそれらを使用し、削除を回避してください。

顧客リストカスタムオーディエンスの場合:

  • このオーディエンスは、広告主の指示に従い、広告主に代わってFacebookが保存します。広告主が2021年9月6日より前にアクティブな広告セットでフラグの付いたオーディエンスを使用しない場合、Facebookはそのオーディエンスを削除する指示を受けたものと見なします。

次のエンドポイントとフィールドに影響があります。

これらの更新に関する詳しい情報は、「オーディエンスの概要: カスタムオーディエンス削除の変更」をご覧ください。

ビジネスAPI

すべてのバージョンに適用。

一時的に、次のエンドポイントに対するアクセスを制限しています。過去30日以内にこれらのエンドポイントの呼び出しに成功したアプリのみ、引き続きアクセスできます。

その他のアプリはすべて、これらのエンドポイントを呼び出すとエラーを受け取ります。

カタログAPI

商品インベントリーフィールドの廃止

v11.0以降に適用。

inventoryフィールドは廃止され、新しいquantity_to_sell_on_facebookフィールドに置き換わります。当面の間inventoryフィールドもサポートされますが、新しいquantity_to_sell_on_facebookフィールドを使用することをおすすめします。

以下のエンドポイントが影響を受けます。

このアップデートに関する詳しい情報は、「Quantity to Sell」と「商品でサポートされているフィールド - ダイナミック広告とコマース」をご覧ください。


空ではない商品グループの削除

v11.0以降に適用。2021年9月7日にすべてのバージョンに適用。

空ではない商品グループの削除は、デフォルトで許可されなくなります。空ではない商品グループを削除するには、deletion_method=delete_itemsを削除リクエストに適用します。これにより、商品グループとその中のアイテムの両方が削除されます。

次のエンドポイントが影響を受けます。


ライブ商品セットの削除

v11.0以降に適用。2021年9月7日にすべてのバージョンに適用。

ライブ商品セットを持つカタログの削除は、デフォルトで許可されなくなります。ライブ商品セットを含むカタログの削除を可能にする場合は、カタログのallow_delete_catalog_with_live_product_setパラメーターをtrueに設定してください。

この変更により、次のエンドポイントが影響を受けます。


新しい診断エンドポイント

v11.0以降に適用。

新しいエンドポイントGET /{product_catalog_id}/diagnosticsが追加されました。このエンドポイントを使って、特定のカタログの診断データを取得できます。商品がチャネルで表示されない原因や、商品が見つかりやすくなる機会などを特定することができます。

コマースAPI

注文合計の推定支払い情報

v11.0以降に適用。2021年9月7日にすべてのバージョンに適用。

{commerce-order-id}/?fields=estimated_payment_detailsエンドポイントへの呼び出しで、推定支払い情報が注文合計でレポートされる方法が変わります。これまで、注文が実行されなかった場合は推定税額が使用され、実行済みの注文には実際の税額が使用されました。バージョン11.0以降、このエンドポイントは常に推定税額を使用するようになります。実際の税額に関する情報には、{commerce-order-id}/items?fields=tax_detailsを使用してアクセスできます。

コンバージョンリフト

指標の変更

v11.0以降に適用。2021年9月7日にすべてのバージョンに適用。

GET /{objective-id}/?fields=resultフィールドから返される指標が変わりました。

次の指標が追加されました。

  • conversions_incremental_share
  • conversions_CPiC
  • conversions_multicell_confidence
  • conversions_multicell_rank
  • sales_incremental_share
  • sales_multicell_confidence
  • sales_multicell_rank
  • buyers_incremental_share
  • buyers_CPiB
  • buyers_multicell_confidence
  • buyers_multicell_rank

次の指標は削除されました。

  • advancedBuyers.control
  • ancedBuyers.informativeMultiCellBayesianConfidence
  • advancedBuyers.lift
  • advancedBuyers.test
  • advancedConversions.control
  • advancedConversions.informativeMultiCellBayesianConfidence
  • advancedConversions.lift
  • advancedConversions.test
  • advancedSales.control
  • advancedSales.informativeMultiCellBayesianConfidence
  • advancedSales.lift
  • advancedSales.test
  • buyers.baseline
  • buyers.bayesianCILower
  • buyers.bayesianCIUpper
  • buyers.control
  • buyers.delta
  • buyers.incremental
  • buyers.isStatSig
  • buyers.lift
  • buyers.multiCellBayesianConfidence
  • buyers.reachedPercent
  • buyers.singleCellBayesianConfidence
  • conversions.baseline
  • conversions.bayesianCILower
  • conversions.bayesianCIUpper
  • conversions.control
  • conversions.delta
  • conversions.incremental
  • conversions.isStatSig
  • conversions.lift
  • conversions.multiCellBayesianConfidence
  • conversions.reachedPercent
  • conversions.singleCellBayesianConfidence
  • frequency
  • incrementalROAS
  • sales.baseline
  • sales.bayesianCILower
  • sales.bayesianCIUpper
  • sales.control
  • sales.delta
  • sales.incremental
  • sales.isStatSig
  • sales.lift
  • sales.multiCellBayesianConfidence
  • sales.singleCellBayesianConfidence

次の指標の名前が変更されました。

変更前の名前変更後の名前

advancedBuyers.baseline

buyers_not_exposed

advancedBuyers.bayesianCILower

buyers_incremental_lower

advancedBuyers.bayesianCIUpper

buyers_incremental_upper

advancedBuyers.incremental

buyers_incremental

advancedBuyers.informativeMultiCellPairwiseBayesianConfidence

buyers_multicell_confidence

advancedBuyers.informativeSingleCellBayesianConfidence

buyers_confidence

advancedBuyers.scaled

buyers_control_scaled

advancedConversions.baseline

conversions_not_exposed

advancedConversions.bayesianCILower

conversions_incremental_lower

advancedConversions.bayesianCIUpper

conversions_incremental_upper

advancedConversions.incremental

conversions_incremental

advancedConversions.informativeMultiCellPairwiseBayesianConfidence

conversions_multicell_confidence

advancedConversions.informativeSingleCellBayesianConfidence

conversions_confidence

advancedConversions.scaled

conversions_control_scaled

advancedSales.baseline

sales_not_exposed

advancedSales.bayesianCILower

sales_incremental_lower

advancedSales.bayesianCIUpper

sales_incremental_upper

advancedSales.incremental

sales_incremental

advancedSales.informativeMultiCellPairwiseBayesianConfidence

sales_multicell_confidence

advancedSales.informativeSingleCellBayesianConfidence

sales_confidence

advancedSales.scaled

sales_control_scaled

buyers.pValue

buyers_raw_pValue

/buyers.reached

buyers_exposed

buyers.scaled

buyers_control_raw_scaled

buyers.test

buyers_test

conversions.pValue

conversions_raw_pValue

conversions.reached

conversions_exposed

conversions.scaled

conversions_control_raw_scaled

conversions.test

conversions_test

IncrementalROAS

sales_ROAS

sales.pValue

sales_raw_pValue

sales.reached

sales_exposed

sales.scaled

sales_control_raw_scaled

sales.test

sales_test

使用可能な指標の全一覧は、「Facebookリフト指標用語集」でご確認ください。

インサイトAPI

来店数指標の廃止

v11.0以降に適用。2021年9月6日にすべてのバージョンに適用。

store_visits_actionsおよびcost_per_store_visit_actionsの指標が廃止されます。

以下のエンドポイントが影響を受けます。

クーポン広告API

クーポン広告APIエンドポイントの廃止

v11.0以降に適用。2021年9月7日にすべてのバージョンに適用。

製品の安定性を向上させるための継続的な取り組みの一環として、Facebookは2021年6月8日をもってクーポン広告製品のサポートを終了します。店舗やオンラインで割引を配布する手段の代替方法として、標準のFacebook広告が推奨されています。割引情報、引き換え場所、有効期限、プロモーションコードは、広告レベルのクリエイティブで直接置き換えてください。

以下のエンドポイントは廃止されます。