跳轉到主要內容
POST
只需一個請求即可建立 Google Ads 搜尋廣告活動。Ayrshare 會一併建立預算、廣告活動、一個廣告群組、您的關鍵字、一則回應式搜尋廣告以及地區定位。若 Google 拒絕其中任何部分,則不會建立任何項目。 此請求使用共用的 廣告活動 格式。本頁說明 Google 特有的部分。
  • Google 廣告需按帳戶個別開通。請聯絡我們以啟用此功能。
  • 請先在 Social Accounts(社群帳戶)頁面連結 Google Ads。accountId 是 10 位數的 Google Ads 客戶 ID,可包含或不含連字號(123-456-7890)。
  • 您連結的 Google 使用者必須能直接存取該廣告帳戶。僅能透過管理員帳戶存取的帳戶不會列出,目前也無法使用:請將該使用者直接加入廣告帳戶本身。管理員帳戶同樣不會列出:它們無法包含廣告活動。
  • 新廣告活動預設以 paused 狀態開始,除非您傳送 status: "active"。
  • 預算為每日預算,使用廣告帳戶的幣別。請勿發送 budget.currency:否則會返回 code: 101。
  • 其他幣別的支出會依 Open Exchange Rates 提供的當日匯率換算為 USD 計費。使用無法換算之幣別的帳戶會在建立任何項目之前返回 code: 101。
  • 廣告只會在 Google 搜尋上顯示,不會出現在搜尋夥伴或多媒體廣告聯播網上。
轉換追蹤。 只有在您的 Google Ads 帳戶已設定轉換追蹤時,maximizeConversions 才會生效。Ayrshare 不會替您進行設定。若未設定,請使用 maximizeClicks 或 manualCpc。

請求頭參數

string
必填
每個新的廣告活動都請傳送一個新的唯一值,例如 UUID。以相同金鑰重複發送請求,會返回第一次的回應,且不會建立任何新項目。若建立請求在 Ayrshare 將廣告活動傳送至 Google 之前就失敗,該金鑰會被釋放,因此您可以修正請求後以相同的金鑰重試。這包括 Ayrshare 拒絕的值(例如不支援的出價策略)、使用無法換算為 USD 之幣別的帳戶,以及 Ayrshare 事先進行的帳戶檢查的任何失敗,包括遭 Google 拒絕。廣告活動已傳送至 Google 後才失敗的建立請求會保留其回應:請以新的金鑰重試。

請求體參數

共用欄位的運作方式如 廣告活動 所述。在 Google 上:
string
必填
search。
string
必填
maximizeClicks、manualCpc 或 maximizeConversions。其他任何值都會返回 code: 101。
boolean
必填
Google 要求每個廣告活動都提供此聲明。只要帳戶中有任何廣告活動未聲明,Google 就會拒絕對該帳戶廣告活動的所有變更。
object
Google 以廣告帳戶時區的完整日期進行排程。start 從當天 00:00:00 開始,end 於當天 23:59:59 結束;您傳送的時間只用於決定日期。start 可以是今天,但不能是更早的日期。若要建立為期一天的廣告活動,請為 start 和 end 傳送相同的日期。若 end 的日期早於 start,會返回 code: 101。
object
Google 依據您廣告文字的語言將搜尋廣告與使用者配對,因此沒有語言設定。傳送 targeting.languages 會返回 code: 101。
object
必填

錯誤