Skip to main content
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.

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

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

string
обов'язково
ID рекламного облікового запису Facebook, у якому потрібно просунути допис. ID облікового запису можна отримати з ендпоінту рекламних облікових записів.
string
обов'язково
Назва вашого оголошення (відображається у Facebook Ad Manager) у форматі {adName} - {postId or fbPostId} - {current date}.
number
обов'язково
Максимальна сума ставки в USD. Мінімальна сума ставки — $1.00.
number
обов'язково
Денний бюджет в USD. Мінімальний бюджет — $1.00.
string
обов'язково
ID соціального допису Facebook допису для просування, що дозволяє створити оголошення з допису, створеного безпосередньо у Facebook. Це ID допису у Facebook, а не Ayrshare. Обов’язковий, якщо postId не задано.
string
за замовчуванням:"engagement"
обов'язково
Ціль оголошення. Значення: engagement, interactions, awareness_views та awareness_audience. Див. деталі цілей оголошення вище для отримання додаткової інформації.
object
обов'язково
Цільові локації оголошення у вигляді об’єкта з масивами: countries, regions, cities.
string
обов'язково
Ayrshare post ID допису для просування. Обов’язковий, якщо fbPostId не задано.
string
за замовчуванням:"active"
обов'язково
Статус оголошення. Значення: active та paused.Ви можете пізніше змінити статус оголошення за допомогою ендпоінту оновлення оголошення.
boolean
за замовчуванням:false
Керує спільним використанням бюджету на рівні кампанії Meta для наборів оголошень. Meta тепер вимагає це поле для кожної кампанії, створеної без бюджету на рівні кампанії, тому Ayrshare завжди надсилає його — за замовчуванням false для зворотної сумісності.Встановіть значення true, щоб дозволити Meta ділитися до ~20% бюджету набору оголошень з іншими наборами оголошень у тій самій кампанії для оптимізації загальної продуктивності. Див. довідник групи рекламних кампаній Meta для отримання докладнішої інформації.
object
Відстежуйте оголошення за допомогою Facebook Pixel.
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.
array
Meta вимагає, щоб рекламодавці у спеціальних категоріях реклами самостійно ідентифікували категорію своєї кампанії.Якщо ваш бізнес належить до однієї з цих категорій, ви маєте вибрати відповідну категорію під час просування допису.Підтримуються такі значення:
  • housing: Оголошення, що просувають або безпосередньо посилаються на можливість придбання житла або пов’язану послугу, включаючи, але не обмежуючись, оголошеннями про продаж або оренду будинку чи квартири, страхуванням домовласників, іпотечним страхуванням, іпотечними кредитами, ремонтом житла та послугами з оцінки або кредитування під заставу житла.
  • financial_product_services: Оголошення, що просувають або безпосередньо посилаються на пропозицію фінансових продуктів і послуг, включаючи кредити.
  • employment: Оголошення, що просувають або безпосередньо посилаються на можливість працевлаштування, включаючи, але не обмежуючись, роботами на неповний або повний робочий день, стажуванням або програмами професійної сертифікації. Пов’язані оголошення, які підпадають під цю категорію, включають промоакції для дошок оголошень про роботу або ярмарків, служб агрегації або оголошень, що детально описують переваги, які компанія може надати, незалежно від конкретної пропозиції роботи.
  • issues_elections_politics: Оголошення, створені кандидатом на публічну посаду, від його імені або про нього, політичним діячем, політичною партією або такі, що виступають за результат виборів на публічну посаду. Це також включає оголошення про будь-які вибори, референдум чи ініціативу голосування, включаючи виборчі кампанії «Йдіть та голосуйте». Оголошення, що регулюються як політична реклама або стосуються соціальних питань у будь-якому місці, де розміщується оголошення. Якщо вибираєте питання, вибори або політику, ви маєте вибрати країну, у якій хочете розміщувати ці оголошення. Ви повинні мати авторизацію на розміщення оголошень про соціальні питання, вибори або політику у вказаній країні.
Meta вимагає, щоб рекламодавці самостійно ідентифікували категорію своєї кампанії. Meta використовує людських рецензентів та машинне навчання для виявлення таких оголошень. Якщо ви надішлете нам некоректну specialAdCategory, існує ризик, що ваші оголошення буде призупинено до коригування кампанії.
string
Дата й час завершення у форматі ISO 8601 (має бути щонайменше через 30 годин після початку), наприклад 2025-03-01T00:00:00Z.Якщо не задано, оголошення працюватиме нескінченно і матиме дату завершення ongoing.
object
Виключіть локації за допомогою об’єкта з масивами countries, regions та cities.
string
за замовчуванням:"all"
Стать аудиторії. Значення: all, male, female.
array
Цільові інтереси оголошення у вигляді масиву ID інтересів Facebook.
number
за замовчуванням:65
Максимальний вік для таргетингу оголошення (за замовчуванням: 65).
number
за замовчуванням:18
Мінімальний вік для таргетингу оголошення (за замовчуванням: 18).
string
Дата й час початку у форматі ISO 8601, наприклад 2025-03-01T00:00:00Z.Якщо не задано, оголошення розпочнеться негайно.
string
Отримувач вигоди від оголошення для відповідності Закону про цифрові послуги (DSA) для країн ЄС. Має бути задано разом із dsaPayor, якщо надається одне з них. Зверніться до нашого посібника з DSA для отримання додаткової інформації.
string
Платник за оголошення для відповідності Закону про цифрові послуги (DSA) для країн ЄС. Має бути задано разом із dsaBeneficiary, якщо надається одне з них.