跳轉到主要內容
POST
請先設定轉換追蹤。 Performance Max 會依據您的轉換來決定在哪裡顯示廣告以及出價多少。Ayrshare 不會阻止沒有轉換追蹤的廣告活動,但在您的 Google Ads 帳戶設定轉換追蹤之前,Google 可能會限制其花費。Ayrshare 不會替您進行設定。若帳戶沒有轉換追蹤,建立回應會包含一則說明此情況的 warnings 項目。
只需一個請求即可建立 Google Ads Performance Max 廣告活動。您傳送文字和圖片網址;Google 會將它們組合成在搜尋、YouTube、多媒體廣告、Discover、Gmail 和地圖上顯示的廣告。Ayrshare 會一併建立預算、廣告活動、一個素材資源群組及其所有素材資源。若 Google 拒絕其中任何部分,則不會建立任何項目。 此請求使用共用的 廣告活動 格式。讀取及變更廣告活動、洞察數據和錯誤的運作方式與 Google 搜尋廣告活動 相同。本頁說明不同之處。
  • Google 廣告需按帳戶個別開通。請聯絡我們以啟用此功能。
  • 新廣告活動預設以 paused 狀態開始,除非您傳送 status: "active"。
  • 預算為每日預算,使用廣告帳戶的幣別,且絕不會與其他廣告活動共用。
  • 其他幣別的支出會依 Open Exchange Rates 提供的當日匯率換算為 USD 計費。使用無法換算之幣別的帳戶會在建立任何項目之前返回 code: 101。
  • 不支援影片。Google 可能會使用您的圖片製作影片。

請求頭參數

string
必填
每個新的廣告活動都請傳送一個新的唯一值,例如 UUID。以相同金鑰重複發送請求,會返回第一次的回應。若建立請求在 Ayrshare 將廣告活動傳送至 Google 之前就失敗(例如圖片尺寸錯誤),該金鑰會被釋放,因此您可以修正請求後以相同的金鑰重試。

請求體參數

string
必填
performanceMax。
object
必填
Performance Max 僅接受以下策略。其他任何值都會返回 code: 101。
  • maximizeConversions:在預算內取得最多轉換。
  • targetCpa 搭配 targetCpa:同上,並以該單次轉換費用為目標。
  • maximizeConversionValue:在預算內取得最高轉換價值。
  • targetRoas 搭配 targetRoas:同上,並以該廣告投資報酬率為目標,例如 3.5 代表 350%。
boolean
必填
Google 要求每個廣告活動都提供此聲明。
string[]
Google 地區 ID,例如 2840 代表美國。省略此欄位即可定位所有地區。
object
必填

圖片

Ayrshare 會從每個圖片網址下載圖片,並在傳送任何內容至 Google 之前進行檢查:
  • GIF、JPG 或 PNG 格式,每個最多 5120 KB。
  • 至少達到上方所列的最小尺寸,且符合其欄位的長寬比(誤差 1% 以內)。
  • 所有圖片合計最多 45 MB。
  • 網址必須是公開的。私人位址會遭拒絕。
未通過檢查的圖片會返回指出該圖片的 code: 101,例如 platformOptions.google.assets.logos[0]: the image is 100x100; use at least 128x128.