Skip to main content
廣告操作以廣告平台作為引數,因此同一個操作適用於 Ayrshare 支援的所有廣告平台。目前支援 FACEBOOK 與 INSTAGRAM。 每個操作都會呼叫對應的 REST 廣告端點,並原封不動地傳回其回應。驗證與限制皆與 REST 相同。呼叫失敗時會傳回 GraphQL 錯誤:extensions.status 帶有 REST 狀態碼,若 REST 錯誤含有 Ayrshare 錯誤碼,則 extensions.code 會帶有該錯誤碼。請參閱錯誤。廣告操作需要 Ads 附加元件。若未啟用,每次呼叫都會傳回 extensions.status 為 403、extensions.code 為 399 的錯誤。

操作

每個操作也都接受選用的 profileKey,以針對某個 User Profile(使用者設定檔)執行。所有操作都以 JSON 傳回 REST 回應,因此不需要選取欄位。

列出廣告帳戶

從這裡開始。凡是操作要求提供 accountId 時,請使用此回應中的 accountId 值。

搜尋目標設定選項

kind 決定搜尋類型:INTERESTS 用於受眾目標設定,REGIONS 或 CITIES 用於地點。每種類型只接受各自的引數。例如,countryCode 與 regionId 僅適用於 CITIES,而 INTERESTS 需要 search。

列出廣告

請至少傳入 campaignId、accountId、adId、postId 或 socialPostId 其中之一。socialPostId 是社群網路本身的貼文 id,適用於非透過 Ayrshare 發布的貼文。

查看廣告的花費

暫停或恢復廣告

updateAd 會影響實際的廣告支出。PAUSED 會停止支出,ACTIVE 會恢復支出,而 DELETED 或 ARCHIVED 會停用廣告。相同的狀態也會套用到該廣告所屬的廣告集與活動,因此該廣告集或活動中的其他廣告也會隨之變更。
透過這些操作推廣貼文的功能即將推出。在此之前,請使用 boostFacebookPost 或 instagramBoostPost,或是 Facebook 或 Instagram 的 REST 推廣端點。
各平台專屬的操作(例如 facebookAdAccounts 與 instagramAds)仍可正常使用,且維持不變。