Quảng cáo

​

Các thao tác

​

Liệt kê tài khoản quảng cáo

query {
  adAccounts(platform: FACEBOOK, limit: 10)
}

​

Tìm kiếm tùy chọn nhắm mục tiêu

query {
  adTargetingSearch(platform: INSTAGRAM, kind: INTERESTS, search: "running")
}

query {
  adTargetingSearch(platform: FACEBOOK, kind: CITIES, search: "Austin", countryCode: "US")
}

​

Liệt kê quảng cáo

query {
  ads(platform: FACEBOOK, accountId: "act_1234567890")
}

​

Xem chi phí của một quảng cáo

query {
  adHistory(platform: FACEBOOK, startDate: "2026-09-01", endDate: "2026-09-30")
}

​

Tạm dừng hoặc tiếp tục một quảng cáo

mutation {
  updateAd(platform: FACEBOOK, adId: "120210000000000000", status: PAUSED)
}

​

Boost một bài đăng

• Truyền postId (id bài đăng Ayrshare) hoặc socialPostId (id bài đăng riêng của mạng xã hội).
• Lấy accountId từ adAccounts.
• budget.amount được tính theo đơn vị tiền tệ của tài khoản quảng cáo. Chỉ bỏ qua budget khi attachTo.adSetId thêm quảng cáo vào một nhóm quảng cáo bạn đang chạy, vốn giữ ngân sách riêng của nó. Khi đó cũng bỏ qua targeting: nhóm quảng cáo giữ thiết lập riêng của nó. Xem Boost vào một chiến dịch hoặc nhóm quảng cáo hiện có.
• schedule, targeting, callToAction, attachTo và status là tùy chọn. Nếu bạn bỏ qua status và schedule, quảng cáo sẽ hoạt động, bắt đầu ngay và không có ngày kết thúc, vì vậy nó tiếp tục chi tiêu cho đến khi bạn tạm dừng. Đặt status: PAUSED hoặc schedule.end để giới hạn.
• Đặt các thiết lập chỉ một nền tảng có vào platformOptions, với khóa là nền tảng. Trên Facebook và Instagram, adName và bidAmount là bắt buộc ở đó, ví dụ platformOptions: { facebook: { adName: "Autumn sale", bidAmount: 2 } }. Nếu thiếu chúng, lệnh boost trả về lỗi thiếu trường. Khi dùng attachTo.adSetId, hãy bỏ qua bidAmount: nhóm quảng cáo giữ giá thầu riêng của nó.

mutation {
  boostPost(
    platform: FACEBOOK
    accountId: "act_1234567890"
    postId: "RNlSOkyxl9G3EDhlPuCK"
    goal: "engagement"
    budget: { amount: 20, type: DAILY }
    schedule: { start: "2026-10-10T09:00:00Z", end: "2026-10-17T09:00:00Z" }
    targeting: { ageMin: 25, ageMax: 45, locations: { countries: ["US"] } }
    platformOptions: { facebook: { adName: "Autumn sale", bidAmount: 2 } }
    idempotencyKey: "4f9c2a7e-1b3d-4c8e-9a6f-2d5b7e0c1a34"
  )
}

• accountId nhận một chuỗi hoặc một số.
• Các ngày trong schedule nhận ngày hoặc ngày giờ theo ISO 8601, chẳng hạn "2026-10-10T09:00:00Z". Hãy dùng dạng đó thay vì một số. schedule.end cũng nhận 0 để không có ngày kết thúc.
• Các khóa vị trí nhận một giá trị hoặc một danh sách.
• targeting.interests nhận id dưới dạng chuỗi hoặc số.
• platformOptions nhận một đối tượng.