Перейти до основного вмісту
POST
Просувайте наявний допис у Facebook для створення реклами. Цей ендпоінт дає змогу перетворювати ваші органічні дописи на платні оголошення з користувацькими параметрами таргетингу, бюджету та планування.
  • Суми бюджету та ставки мають бути вказані в USD з точністю до двох десяткових знаків.
  • Оголошення має тривати щонайменше 30 годин, щоб відповідати вимозі Facebook.
  • Ви можете використати ендпоінт інтересів, щоб знайти ID інтересів для таргетингу.
  • Facebook може знадобитися до 24 годин, щоб переглянути та схвалити просунуті дописи.
  • Якщо ви використовуєте fbPostId безпосередньо (замість Ayrshare postId), переконайтеся, що це коректний ID допису Facebook.

Цілі оголошення

Кожне оголошення має мати ціль. Ціль визначає, як оголошення буде оптимізовано для показу.
  • engagement: Ця ціль спрямована на підвищення залученості, водночас гарантуючи, що оголошення досягає максимальної кількості унікальних користувачів. Вона балансує між видимістю та залученістю, показуючи оголошення якомога більшій кількості різних людей, які можуть з ним взаємодіяти.
  • interactions: Розроблена для підвищення взаємодії, як-от вподобання, коментарі та поширення оголошення. Facebook надає пріоритет показу оголошення користувачам, які найімовірніше з ним взаємодіятимуть.
  • awareness_views: Зосереджується на підвищенні впізнаваності бренду, максимізуючи кількість разів, коли оголошення показується. Пріоритет — показати оголошення якомога більше разів у межах бюджету, незалежно від унікального охоплення.
  • awareness_audience: Спрямована на підвищення впізнаваності бренду шляхом максимізації кількості унікальних людей, які бачать оголошення. Гарантує, що оголошення досягає якомога більшої кількості різних користувачів, і максимізує розмір унікальної аудиторії, а не показує його багато разів одній і тій самій аудиторії.
Дізнайтеся більше про інтеграцію Facebook Marketing API з Ayrshare у нашому посібнику з інтеграції Facebook Marketing API.

Параметри заголовка

Параметри тіла

accountId
string
обов'язково
ID рекламного облікового запису Facebook, у якому потрібно просунути допис. ID облікового запису можна отримати з ендпоінту рекламних облікових записів.
adName
string
обов'язково
Назва вашого оголошення (відображається у Facebook Ad Manager) у форматі {adName} - {postId or fbPostId} - {current date}.
bidAmount
number
обов'язково
Максимальна сума ставки в USD. Мінімальна сума ставки — $1.00.
budget
number
обов'язково
Денний бюджет в USD. Мінімальний бюджет — $1.00.
fbPostId
string
обов'язково
ID соціального допису Facebook допису для просування, що дозволяє створити оголошення з допису, створеного безпосередньо у Facebook. Це ID допису у Facebook, а не Ayrshare. Обов’язковий, якщо postId не задано.
goal
string
за замовчуванням:"engagement"
обов'язково
Ціль оголошення. Значення: engagement, interactions, awareness_views та awareness_audience. Див. деталі цілей оголошення вище для отримання додаткової інформації.
locations
object
обов'язково
Цільові локації оголошення у вигляді об’єкта з масивами: countries, regions, cities.
postId
string
обов'язково
Ayrshare post ID допису для просування. Обов’язковий, якщо fbPostId не задано.
status
string
за замовчуванням:"active"
обов'язково
Статус оголошення. Значення: active та paused.Ви можете пізніше змінити статус оголошення за допомогою ендпоінту оновлення оголошення.
adSetBudgetSharingEnabled
boolean
за замовчуванням:false
Керує спільним використанням бюджету на рівні кампанії Meta для наборів оголошень. Meta тепер вимагає це поле для кожної кампанії, створеної без бюджету на рівні кампанії, тому Ayrshare завжди надсилає його — за замовчуванням false для зворотної сумісності.Встановіть значення true, щоб дозволити Meta ділитися до ~20% бюджету набору оголошень з іншими наборами оголошень у тій самій кампанії для оптимізації загальної продуктивності. Див. довідник групи рекламних кампаній Meta для отримання докладнішої інформації.
tracking
object
Відстежуйте оголошення за допомогою Facebook Pixel.
urlTags
array
Додайте UTM-теги до URL оголошення.
Наприклад, якщо посилання — це https://www.mysite.com/my-post, а додані URL-теги:utm_source=ayrshare, utm_medium=social та utm_campaign=ayrshare-social.URL оголошення буде: https://www.mysite.com/my-post?utm_source=ayrshare&utm_medium=social&utm_campaign=ayrshare-social.
specialAdCategories
array
Meta вимагає, щоб рекламодавці у спеціальних категоріях реклами самостійно ідентифікували категорію своєї кампанії.Якщо ваш бізнес належить до однієї з цих категорій, ви маєте вибрати відповідну категорію під час просування допису.Підтримуються такі значення:
  • housing: Оголошення, що просувають або безпосередньо посилаються на можливість придбання житла або пов’язану послугу, включаючи, але не обмежуючись, оголошеннями про продаж або оренду будинку чи квартири, страхуванням домовласників, іпотечним страхуванням, іпотечними кредитами, ремонтом житла та послугами з оцінки або кредитування під заставу житла.
  • financial_product_services: Оголошення, що просувають або безпосередньо посилаються на пропозицію фінансових продуктів і послуг, включаючи кредити.
  • employment: Оголошення, що просувають або безпосередньо посилаються на можливість працевлаштування, включаючи, але не обмежуючись, роботами на неповний або повний робочий день, стажуванням або програмами професійної сертифікації. Пов’язані оголошення, які підпадають під цю категорію, включають промоакції для дошок оголошень про роботу або ярмарків, служб агрегації або оголошень, що детально описують переваги, які компанія може надати, незалежно від конкретної пропозиції роботи.
  • issues_elections_politics: Оголошення, створені кандидатом на публічну посаду, від його імені або про нього, політичним діячем, політичною партією або такі, що виступають за результат виборів на публічну посаду. Це також включає оголошення про будь-які вибори, референдум чи ініціативу голосування, включаючи виборчі кампанії «Йдіть та голосуйте». Оголошення, що регулюються як політична реклама або стосуються соціальних питань у будь-якому місці, де розміщується оголошення. Якщо вибираєте питання, вибори або політику, ви маєте вибрати країну, у якій хочете розміщувати ці оголошення. Ви повинні мати авторизацію на розміщення оголошень про соціальні питання, вибори або політику у вказаній країні.
Meta вимагає, щоб рекламодавці самостійно ідентифікували категорію своєї кампанії. Meta використовує людських рецензентів та машинне навчання для виявлення таких оголошень. Якщо ви надішлете нам некоректну specialAdCategory, існує ризик, що ваші оголошення буде призупинено до коригування кампанії.
endDate
string
Дата й час завершення у форматі ISO 8601 (має бути щонайменше через 30 годин після початку), наприклад 2025-03-01T00:00:00Z.Якщо не задано, оголошення працюватиме нескінченно і матиме дату завершення ongoing.
excludedLocations
object
Виключіть локації за допомогою об’єкта з масивами countries, regions та cities.
gender
string
за замовчуванням:"all"
Стать аудиторії. Значення: all, male, female.
interests
array
Цільові інтереси оголошення у вигляді масиву ID інтересів Facebook.
maxAge
number
за замовчуванням:65
Максимальний вік для таргетингу оголошення (за замовчуванням: 65).
minAge
number
за замовчуванням:18
Мінімальний вік для таргетингу оголошення (за замовчуванням: 18).
startDate
string
Дата й час початку у форматі ISO 8601, наприклад 2025-03-01T00:00:00Z.Якщо не задано, оголошення розпочнеться негайно.
dsaBeneficiary
string
Отримувач вигоди від оголошення для відповідності Закону про цифрові послуги (DSA) для країн ЄС. Має бути задано разом із dsaPayor, якщо надається одне з них. Зверніться до нашого посібника з DSA для отримання додаткової інформації.
dsaPayor
string
Платник за оголошення для відповідності Закону про цифрові послуги (DSA) для країн ЄС. Має бути задано разом із dsaBeneficiary, якщо надається одне з них.