リファレンス
投稿
| エンドポイント | 説明 |
|---|---|
広告を作成します。 | |
処理待ちビジネス合意リクエストを承認または却下します。 | |
ビジネスクリエイティブフォルダーを作成・更新します。 | |
ビジネスクリエイティブフォルダーを指定します。 | |
クリエイティブフォルダーに画像をアップロードします。 | |
クリエイティブフォルダーに動画をアップロードします。 | |
/{business-creative-folder-id}/agencies | クリエイティブフォルダーにパートナーを追加します。 |
/{business-creative-folder-id}/assigned_users | ビジネスクリエイティブフォルダーにアクセスできる人のリストを取得します。 |
読み取り
| エンドポイント | 説明 |
|---|---|
ビジネスクリエイティブフォルダーの詳細を取得します。 | |
ビジネスがアクセスできるビジネスクリエイティブフォルダーのリストを取得します。 | |
ビジネスのビジネス画像とビジネス動画を取得します。 | |
承認待ちの合意リクエストのリストを取得します。 このエンドポイントは2020年5月に再導入されました。それ以前、 | |
画像の詳細を取得します。 | |
/{business-image-id}/insights | 共有画像のインサイトを取得します。 |
/{business-video-id} | 共有動画の詳細を取得します。 |
/{business-video-id}/insights | 共有動画のインサイトを取得します。 |
/{business-creative-folder-id}/agencies | 該当クリエイティブフォルダーにアクセスできるビジネスのリストを取得します。 |
/{business-creative-folder-id}/assigned_users | 該当クリエイティブフォルダーにアクセスできる人のリストを取得します。 |
削除
| エンドポイント | 説明 |
|---|---|
/{business-creative-folder-id} | クリエイティブフォルダーを削除します。 |
/{business-creative-folder-id}/agencies | クリエイティブフォルダーからパートナーを削除します。 |
/{business-creative-folder-id}/assigned_users | クリエイティブフォルダーからユーザーを削除します。 |
共有画像を削除します。 | |
共有動画を削除します。 |
許可されているタスク
| ビジネスユーザーに対して許可されているタスク | 説明 |
|---|---|
| このユーザーは、フォルダーを作成できます。 |
| このユーザーは、クリエイティブフォルダーアセットを管理できます。 |
| このユーザーは、ビジネスクリエイティブフォルダーのアクセス許可を管理できます。 |
| このユーザーは、クリエイティブフォルダー内のアセットを閲覧できます。 |
| このユーザーは、クリエイティブアセットのインサイトを閲覧できます。 |
インサイト
これらの指標は開発中です。
| 指標名 | 説明 |
|---|---|
impressions | 画像または動画が広告に表示された回数。 |
inline_link_clicks | 広告内のリンクをクリックした回数。インラインリンクのクリックでは、固定クリック1日アトリビューション時間枠を使います。 |
video_play_actions | 動画の再生が開始された回数。動画インプレッションごとにカウントされ、リプレイは除外されます。 |
| 該当広告がきっかけとなって実行されたアクションの合計数。アクションには、エンゲージメント、クリック、コンバージョンが含まれることがあります。サポートされているタイプの完全なリストについては、こちらのドキュメントをご覧ください。 |
| 動画が最後まで再生されたか、15秒以上再生された回数です。 |
| 広告の評価品質のランキング。品質は。広告のフィードバックとクリック後エクスペリエンスを使って測定されます。広告のランキングは、同じオーディエンスを対象として競合する他の広告との比較によります。 次のような値を指定できます。
これは広告関連度診断に関連する値です。 |
次の内訳を使うことができます。
agegendercountryobjectivepublisher_platformplatform_positiondevice_platformoptimization_goal