本日、FacebookはグラフAPI v10.0とマーケティングAPI v10.0をリリースします。
このリリースには、アプリとFacebookプラットフォームを統合する方法に影響する可能性がある多くのお知らせ、アップデート、廃止、および「廃止の解除」が含まれています。この投稿では、これらの更新情報に加えて、該当する場合にビジネスの中断を避けるために開発者が実行する必要がある手順の概要を説明します。
すべての変更に関する詳細情報を以下に示します。技術仕様については、v10.0の更新履歴をご覧ください。
Facebookの開発者プラットフォームの詳細については、プラットフォーム主導のハブを参照してください。
FacebookプラットフォームAPIの利用を続けるには、登録から60日以内にデータの使用状況の確認(DUC)を実施してください。DUCを実施するには、アプリダッシュボードの[マイアプリ]ページに移動します。
昨年の秋、Facebookはデータの使用状況の確認(DUC)を導入しました。これは、開発者がAPIアクセスとデータ使用についてFacebookのプラットフォーム規約および開発者ポリシーを遵守していることを証明するための年度ごとの要件を新たに規定したものです。
すべてのアプリに段階的にロールアウトするFacebookのプロセスの一環として、開発者に期限日と詳細な手順を連絡します。この連絡は、開発者アラート、登録された連絡先アドレスへのメール、アプリダッシュボードの必要なアクションのリストに表示される通知によって行われます。
DUCを実施するための詳細な手順については、開発者向けドキュメントを参照してください。また、よくある質問のDUCに関するセクションもご覧ください。
2021年5月24日以降、グループAPIを利用する場合、アプリの利用可能なデータアクセス期間が90日に制限されます。
また、消費者アプリでは、アプリが開発モードにあるかライブモードにあるかに基づいて階層化されるグループAPIアクセスを導入します。グループAPIのアクセス許可は、ビジネスアプリの標準アクセスおよび詳細アクセスと同様に動作するようになります。
現在、開発モードのアプリは、公開グループと開発者が管理者であるプライベートグループのすべてのコンテンツにアクセスできます。それらのアプリは、アプリレビューが完了すると、アプリをインストールしたグループのすべてのコンテンツにアクセスできます。
2021年5月24日以降、開発モードのアプリは、公開グループと開発者が管理者であるプライベートグループの自分が所有するコンテンツにしかアクセスできなくなります。つまり、他のグループユーザー(アプリの役割を持たないユーザー)が公開したコンテンツ(投稿やコメントなど)にはアクセスできません。
詳細については、v10.0の更新履歴をご覧ください。
ユーザーデータを安全に保護するための継続的な方針の一環として、新規および既存のビジネスタイプのアプリ向けにグラフAPI v8.0で発表したアクセスレベルモデルに、public_profile (デフォルト公開プロフィールフィールド)アクセス許可とemailアクセス許可が追加されました。
新しく作成されるビジネスタイプのアプリには、public_profileアクセス許可とemailアクセス許可を含む標準アクセスが最初に設定されます。アプリにpublic_profileへの標準アクセスが設定されている場合、アプリに関する役割またはアプリを申請したビジネス内の役割を持つユーザーのみがアプリの検索またはログインを行えます。外部ユーザーがアプリにログインする必要がある場合、アプリ管理者はアプリダッシュボードで詳細アクセスをリクエストできます。このアクセスは自動的に許可されます。
詳細については、v10.0の更新履歴をご覧ください。
2020年11月10日にお知らせしたように、消費者タイプとゲームタイプのアプリについてアプリレビューを申請する場合、または開発モードからライブモードに移行する場合は、データ削除リクエストのコールバックを提供するか、ユーザーが自分のデータの削除をリクエストする方法を明示的に示すURLを表示する必要があります。Facebookはこの要件を2022年11月10日までに適用することを予定しており、適用の60日前に、アプリ開発者にリマインダーを送ります。
広告マネージャのUIは、保持期間が37か月を超える広告インサイト指標データのレポート作成をサポートしなくなります。保持期間が37か月を超える日付範囲がリクエストに含まれている場合、APIはエラーを返します。「date_preset = lifetime」は無効になり、「date_preset = maximum」に置き換えられます。
AdsInsightに対するグラフAPI v10.0の変更は、「date_preset = lifetime」を除いて、90日後にグラフAPIの他のすべてのバージョンに適用されます。呼び出される特定のフィールドを変更する必要はありません。プリセット機能が組み込まれ、すべての「lifetime」呼び出しにデフォルトで最大37か月の保持期間が設定されます。
この変更は、広告クリエイティブ、オーディエンス、配信設定、または広告オブジェクト名に関連するデータには影響せず、既存の指標の計算に変更はありません。この変更は、広告マネージャ、広告レポート、軽量広告エクスペリエンスなどの広告レポートのサーフェス全体に適用されます。
詳細については、v10.0の更新履歴をご覧ください。
2021年5月24日以降、パートナーがThreatExchangeにアップロードするデータにexpire_timeを設定すると、指定された有効期限でデータが「ハードデリート」されます。データが無効になったことを指定したい場合は、「expired_on」フィールドを設定すると、自動的に削除されます。
従来の「ソフトデリート」は、有効期限が切れたコンテンツに期限切れのラベルを付けることを意味していました。今後、ソフトデリートはサポートされません。有効期限が切れたコンテンツはハードデリートされ、ThreatExchangeに表示されなくなります。
さらに、ThreatExchange内のFacebook以外のすべてのThreatDescriptorは、有効期限が切れるとハードデリートされます。有効期限は、引き続きThreatDescriptorの作成者によって設定されます。今後、Facebookによって作成されていないすべての期限切れのThreatDescriptorで、削除が開始されます。このポリシーが適用されたときに削除されたくない期限切れのThreatDescriptorが現在アプリにある場合は、有効期限を延長するか「0」に設定して、データが期限切れにならないようにしてください。
2021年5月24日以降、類似カスタムオーディエンスを作成する際に、APIのすべてのバージョンでlocation_specパラメーターとcountryパラメーターが要求されなくなります。
類似オーディエンスを作成する際、ユーザーは類似ソースと希望する比率を選択します。類似オーディエンスの場所は、キャンペーンのターゲット設定仕様の国の場所によって決定されます。この変更は、既存のキャンペーンには影響しません。新規のキャンペーンと編集されるキャンペーンにのみ影響します。
新しいFacebookのビジネスステータスページは、透明性を高め、Facebookのプラットフォーム製品を使用する外部開発者との事前のコミュニケーションを活性化するために役立ちます。このページは、Facebookのビジネス製品(広告、WhatsApp Business API、Facebook開発者プラットフォームなど)のプラットフォームステータスを一元的に確認する場所として利用できます。現在、このページは広告マネージャとWhatsapp Business APIで利用可能です。その他のビジネス製品は、2021年5月に追加される予定です。
2021年5月24日に、[ライブ配信を開始]ダイアログ(GLD) SDKが廃止されます。この従来のライブプロダクションツールの廃止は、APIのすべてのバージョンで行われます。この変更は、Facebookでのライブ一斉配信にのみ影響します。開発者は、すべてのカスタマイズされたライブプロダクションソリューションについて、Live ProducerとLive APIを使用することをおすすめします。
GLD SDKの廃止後にライブ配信を行うためのソリューション:
詳細については、v10.0の更新履歴をご覧ください。
2021年5月24日以降、広告セットの作成/編集時に、接続ターゲット設定がサポートされなくなります。この要件は、新規のキャンペーンと編集されるキャンペーンにのみ影響し、既存のキャンペーンには影響しません。
詳細については、v10.0の更新履歴をご覧ください。
グラフAPI v8.0のリリース時に、[ページ]タブ用のgr:delete:Page/tabsエンドポイントが廃止されました。グラフAPI v10.0では、このエンドポイントを直ちに復活させることが決定しました。他のすべてのグラフAPIバージョンでは、2021年5月24日に再びアクセスが可能になります。
詳細については、v10.0の更新履歴をご覧ください。
グラフAPI v9.0のリリース時に、次の3つのビジネスエンドポイントへのアクセスが制限されました。
グラフAPI v10.0がリリースされた時点で、アプリが次の2つの条件のいずれかを満たす場合、API呼び出しに対してこれらのエンドポイントを再びオープンします。
詳細については、v10.0の更新履歴をご覧ください。
マーケティングAPIのバージョン管理スケジュールに基づく今後のマーケティングAPIバージョンの廃止に注意してください。
ビジネスの中断を避けるため、すべての呼び出しを本日リリースされた最新のマーケティングAPIバージョンに移行することをおすすめします(詳細については、更新履歴をご覧ください)。
グラフAPIのバージョン管理スケジュールに基づく以下のグラフAPIバージョンの廃止に注意してください。