概要

マーケティングAPIは、プログラムを使用したデータのクエリや、広告の作成と管理など、さまざまなタスクの実行に利用できるHTTPベースのAPIです。このセクションでは、マーケティングAPI、アクセス、バージョン管理などの情報について説明します。

マーケティングAPIはHTTPベースであるため、HTTPをサポートするあらゆる言語やソフトウェア(cURLやほとんどすべての最新ウェブブラウザーを含む)で動作します。マーケティングAPIはMetaのグラフAPI上に構築されているので、ほとんどすべてのリクエストはgraph.facebook.comホストURLに渡されます。

基本概念

以下に、マーケティングAPIを使用するために理解しておくべき概念を示します。

広告キャンペーン構造

Metaの広告構造には、キャンペーン、広告セット、広告の3つのレベルがあります。開発者はAPIで、クリエイティブと呼ばれる第4のレベルを使用できます。

認証

アプリがマーケティングAPIのエンドポイントにアクセスするには、グラフAPI認証の複数のレイヤーをクリアする必要があります。

認証

API呼び出しに必要なアクセストークンを取得して保存する方法を確認してください。

レート制限

マーケティングAPIには独自のレート制限ロジックがあり、すべてのグラフAPIのレート制限から除外されます。

バージョン管理

Metaのプラットフォームには、コアバージョン管理モデルと拡張バージョン管理モデルがあります。Metaのバージョン管理とマイグレーションのシステムを使って、今後の変更と廃止予定についてご確認ください。バージョンスケジュール、マイグレーション、更新履歴をご覧ください。

アプリレビュー

マーケティングAPIを使用するには、サーバー側APIとオフラインコンバージョンのいくつかの例外を除き、アプリはアプリレビューを受ける必要があります。

アクセス許可

主な広告アクセス許可は、ads_managementとads_readの2つです。呼び出しを実行するアプリにアクセス許可を付与する必要があります。アクセス許可のリクエストは、アプリレビュープロセスで行うことができます。ビジネスアプリに利用可能なアクセス許可のリストをご覧ください。

エラーコード

APIの使用中にエラーコードが表示されることがあります。各エラーコードの詳細を確認するには、リファレンスとしてこちらをご利用ください。

後処理

Metaがリクエストを受信した後の後処理フェーズについてご確認ください。