Chuyển đến nội dung chính
POST
Tạo một chiến dịch Tìm kiếm trên Google Ads chỉ trong một yêu cầu. Ayrshare tạo đồng thời ngân sách, chiến dịch, một nhóm quảng cáo, các từ khóa của bạn, một quảng cáo tìm kiếm thích ứng và phần nhắm mục tiêu theo vị trí. Nếu Google từ chối bất kỳ phần nào, sẽ không có gì được tạo. Yêu cầu dùng cấu trúc chung của Chiến dịch Quảng cáo. Trang này trình bày những điểm dành riêng cho Google.
  • Quảng cáo Google được bật theo từng tài khoản. Hãy liên hệ với chúng tôi để kích hoạt.
  • Trước tiên, hãy liên kết Google Ads từ trang “Social Accounts”. accountId là mã khách hàng Google Ads gồm 10 chữ số, có hoặc không có dấu gạch nối (123-456-7890).
  • Người dùng Google mà bạn liên kết phải có quyền truy cập trực tiếp vào tài khoản quảng cáo. Các tài khoản bạn chỉ truy cập được thông qua một tài khoản người quản lý sẽ không được liệt kê và hiện chưa thể sử dụng: hãy thêm người dùng đó vào chính tài khoản quảng cáo. Các tài khoản người quản lý cũng không được liệt kê: chúng không thể chứa chiến dịch.
  • Chiến dịch mới bắt đầu ở trạng thái paused trừ khi bạn gửi status: "active".
  • Ngân sách được tính theo ngày, bằng đơn vị tiền tệ của tài khoản quảng cáo. Không gửi budget.currency: trường này sẽ trả về code: 101.
  • Chi tiêu bằng loại tiền khác được quy đổi sang USD để thanh toán theo tỷ giá của ngày đó từ Open Exchange Rates. Tài khoản dùng loại tiền không thể quy đổi sẽ trả về code: 101 trước khi bất kỳ thứ gì được tạo.
  • Quảng cáo chỉ hiển thị trên Google Search, không hiển thị trên các đối tác tìm kiếm hoặc Mạng Hiển thị (Display Network).
Theo dõi chuyển đổi. maximizeConversions chỉ hoạt động khi tính năng theo dõi chuyển đổi đã được thiết lập trong tài khoản Google Ads của bạn. Ayrshare không thiết lập tính năng này cho bạn. Nếu chưa có, hãy dùng maximizeClicks hoặc manualCpc.

Tham số Header

string
bắt buộc
Một giá trị duy nhất mới, chẳng hạn một UUID, cho mỗi chiến dịch mới. Lặp lại một yêu cầu với cùng khóa sẽ trả về phản hồi đầu tiên và không tạo thêm gì mới. Khi một yêu cầu tạo thất bại trước khi Ayrshare gửi chiến dịch đến Google, khóa sẽ được giải phóng, vì vậy bạn có thể sửa yêu cầu và thử lại với cùng khóa đó. Điều này áp dụng cho một giá trị bị Ayrshare từ chối (chẳng hạn một chiến lược đặt giá thầu không được hỗ trợ), một tài khoản dùng loại tiền không thể quy đổi sang USD, và mọi lỗi trong bước kiểm tra tài khoản mà Ayrshare thực hiện trước, kể cả khi Google từ chối. Một yêu cầu tạo thất bại sau khi chiến dịch đã được gửi đến Google sẽ giữ nguyên phản hồi của nó: hãy thử lại với một khóa mới.

Tham số Body

Các trường chung hoạt động như mô tả trên trang Chiến dịch Quảng cáo. Trên Google:
string
bắt buộc
search.
string
bắt buộc
maximizeClicks, manualCpc, hoặc maximizeConversions. Bất kỳ giá trị nào khác sẽ trả về code: 101.
boolean
bắt buộc
Google yêu cầu khai báo này trên mọi chiến dịch. Khi còn bất kỳ chiến dịch nào trong một tài khoản chưa được khai báo, Google sẽ từ chối mọi thay đổi đối với các chiến dịch của tài khoản đó.
object
Google lên lịch theo trọn ngày, theo múi giờ của tài khoản quảng cáo. start bắt đầu lúc 00:00:00 của ngày đó và end dừng lúc 23:59:59 của ngày đó; thời gian bạn gửi chỉ dùng để chọn ngày. start có thể là hôm nay nhưng không được là một ngày trước đó. Với chiến dịch kéo dài một ngày, hãy gửi cùng một ngày cho start và end. Một end rơi vào ngày sớm hơn start sẽ trả về code: 101.
object
Google ghép quảng cáo Tìm kiếm với người dùng dựa trên ngôn ngữ của văn bản quảng cáo, vì vậy không có tùy chọn cài đặt ngôn ngữ. Gửi targeting.languages sẽ trả về code: 101.
object
bắt buộc

Lỗi