參考資料

發佈

端點說明

/{ad-account-id}/ads

建立廣告。

/{business-id}/initiated_sharing_agreements

核准或拒絕處理中的商家協議要求。

/{business-creative-folder-id}

建立和更新商用廣告創意資料夾。

/{business-id}/creative_folders

提供商用廣告創意資料夾。

/{business-id}/images

將圖像上傳到廣告創意資料夾。

/{business-id}/videos

將影片上傳到廣告創意資料夾。

/{business-creative-folder-id}/agencies

在廣告創意資料夾中新增合作夥伴。

/{business-creative-folder-id}/assigned_users

取得有權限可存取商用廣告創意資料夾的用戶清單。

讀取

端點說明

/{business-creative-folder-id}

取得有關商用廣告創意資料夾的詳細資訊。

/{business-id}/creative_folders

取得商家可存取的商用廣告創意資料夾清單。

/{business-id}/creatives

取得商家的商家圖像和商家影片。

/{business-id}/initiated_sharing_agreement

取得處理中協議要求的清單。


此端點於 2020 年 5 月重新推出。先前當圖形 API 第 6.0 版推出時,/initiated_sharing_agreement 已停用。

/{business-image-id}

取得圖像的詳細資訊。

/{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

移除廣告創意資料夾中的用戶。

/{business-image-id}

移除分享圖像。

/{business-video-id}

移除分享影片。

允許的工作

商家用戶允許的工作說明

CREATE_CONTENT

此用戶可以建立資料夾。

MANAGE_CONTENT

此用戶可以管理廣告創意資料夾資產。

MANAGE_PERMISSIONS

此用戶可以管理商用廣告創意資料夾權限。

VIEW_CONTENT

此用戶可以查看廣告創意資料夾中的資產。

VIEW_INSIGHTS

此用戶可以查看廣告創意資產的洞察報告。

洞察報告

這些衡量指標正在開發中

衡量指標名稱說明
impressions

圖像或影片在廣告中顯示的次數。

inline_link_clicks

廣告中的連結點擊次數。內嵌連結點擊次數使用固定的 1 天點擊歸因視窗。

video_play_actions

影片開始播放的次數。我們將每一影片曝光次數計入此數,但排除重播次數。

actions

用戶因為歸因於廣告而採取的動作總數。動作可能包括互動、點擊或轉換。請參閱此文件,瞭解完整的支援類型清單。

video_thruplay_watched_actions

影片完整播放或至少播放 15 秒的次數。

quality_ranking

廣告的品質觀感排名。衡量品質的方式是透過廣告的意見回饋和點擊後體驗。系統會針對廣告與爭取相同受眾青睞的廣告進行排名。


可能的值包括:

  • BELOW_AVERAGE_10
  • BELOW_AVERAGE_20
  • BELOW_AVERAGE_35
  • AVERAGE
  • ABOVE_AVERAGE
  • UNKNOWN(如果沒有足夠的廣告資訊)。

這與廣告相關性問題診斷有關。

您可使用以下資料解析:

  • age
  • gender
  • country
  • objective
  • publisher_platform
  • platform_position
  • device_platform
  • optimization_goal