> ## Documentation Index > Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Просування допису > Просувайте допис, надіславши його на рекламну платформу Facebook export const PlansAvailable = ({plans = [], maxPackRequired}) => { let displayPlans = plans; if (plans && plans.length === 1) { const lowerCasePlan = plans[0].toLowerCase(); if (lowerCasePlan === "business") { displayPlans = ["Launch", "Business", "Enterprise"]; } else if (lowerCasePlan === "premium") { displayPlans = ["Premium", "Launch", "Business", "Enterprise"]; } } return Available on {displayPlans.length === 1 ? "the " : ""} {displayPlans.join(", ").replace(/\b\w/g, l => l.toUpperCase())}{" "} {displayPlans.length > 1 ? "plans" : "plan"}. {maxPackRequired && window.open('https://www.ayrshare.com/docs/additional/maxpack', '_self')} className="flex items-center mt-2 cursor-pointer"> Max Pack required } ; }; export const HeaderAPI = ({noProfileKey, profileKeyRequired}) => <> API Key of the Primary Profile.

Format: Authorization: Bearer API_KEY {!noProfileKey && (profileKeyRequired ? Profile Key of a User Profile.

Format: Profile-Key: PROFILE_KEY : Profile Key of a User Profile.

Format: Profile-Key: PROFILE_KEY )} ; Просувайте наявний допис у Facebook для створення реклами. Цей ендпоінт дає змогу перетворювати ваші органічні дописи на платні оголошення з користувацькими параметрами таргетингу, бюджету та планування. ### Цілі оголошення Кожне оголошення має мати ціль. Ціль визначає, як оголошення буде оптимізовано для показу. Дізнайтеся більше про інтеграцію Facebook Marketing API з Ayrshare у нашому [посібнику з інтеграції Facebook Marketing API](https://www.ayrshare.com/blog/facebook-ads-api-boosting-with-the-marketing-api/). ## Параметри заголовка ## Параметри тіла ID рекламного облікового запису Facebook, у якому потрібно просунути допис. ID облікового запису можна отримати з [ендпоінту рекламних облікових записів](/docs/apis/ads/facebook/get-ad-accounts). Назва вашого оголошення (відображається у Facebook Ad Manager) у форматі `{adName} - {postId or fbPostId} - {current date}`. Максимальна сума ставки в USD. Мінімальна сума ставки — \$1.00. Денний бюджет в USD. Мінімальний бюджет — \$1.00. [ID соціального допису Facebook](/docs/apis/overview#social-post-id) допису для просування, що дозволяє створити оголошення з допису, створеного безпосередньо у Facebook. Це ID [допису у Facebook](/docs/apis/history/history-platform), а не Ayrshare. Обов'язковий, якщо `postId` не задано. Ціль оголошення. Значення: `engagement`, `interactions`, `awareness_views` та `awareness_audience`. Див. [деталі цілей оголошення](/docs/apis/ads/facebook/boost-post#ad-goals) вище для отримання додаткової інформації. Цільові локації оголошення у вигляді об'єкта з масивами: `countries`, `regions`, `cities`. Список кодів країн. ```json theme={"system"} { "countries": ["US", "CA"] } ``` Регіони потребують значення `key` регіону Facebook. Див. [ендпоінт регіонів](/docs/apis/ads/facebook/get-ad-regions) для отримання додаткової інформації. ```json theme={"system"} { "regions": [{ "key": "3886" }] } ``` Міста потребують: `key` (з Facebook), `radius` та `distance_unit`. `radius` — це відстань навколо міста: 10–50 миль або 17–80 кілометрів. `distance_unit` — це `mile` або `kilometer`. Див. [ендпоінт міст](/docs/apis/ads/facebook/get-ad-cities) для отримання додаткової інформації. ```json theme={"system"} { "cities": [ { "key": "2420605", "radius": 25, "distance_unit": "mile" } ] } ``` [Ayrshare post ID](/docs/apis/overview#ayrshare-post-id) допису для просування. Обов'язковий, якщо `fbPostId` не задано. Статус оголошення. Значення: `active` та `paused`. Ви можете пізніше змінити статус оголошення за допомогою [ендпоінту оновлення оголошення](/docs/apis/ads/facebook/put-ad-update). Керує спільним використанням бюджету на рівні кампанії Meta для наборів оголошень. Meta тепер вимагає це поле для кожної кампанії, створеної без бюджету на рівні кампанії, тому Ayrshare завжди надсилає його — за замовчуванням `false` для зворотної сумісності. Встановіть значення `true`, щоб дозволити Meta ділитися до \~20% бюджету набору оголошень з іншими наборами оголошень у тій самій кампанії для оптимізації загальної продуктивності. Див. [довідник групи рекламних кампаній](https://developers.facebook.com/docs/marketing-api/reference/ad-campaign-group/) Meta для отримання докладнішої інформації. Відстежуйте оголошення за допомогою Facebook Pixel. ID Facebook Pixel для відстеження оголошення. ```json theme={"system"} { "pixelId": 1234567890 } ``` Додайте UTM-теги до URL оголошення. ```json theme={"system"} { "urlTags": ["utm_source=ayrshare", "utm_medium=social", "utm_campaign=ayrshare-social"] } ``` Наприклад, якщо посилання — це `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`. Meta вимагає, щоб рекламодавці у [спеціальних категоріях реклами](https://www.facebook.com/business/help/298000447747885?helpref=faq_content) самостійно ідентифікували категорію своєї кампанії. Якщо ваш бізнес належить до однієї з цих категорій, ви маєте вибрати відповідну категорію під час просування допису. Підтримуються такі значення:
  • `housing`: Оголошення, що просувають або безпосередньо посилаються на можливість придбання житла або пов'язану послугу, включаючи, але не обмежуючись, оголошеннями про продаж або оренду будинку чи квартири, страхуванням домовласників, іпотечним страхуванням, іпотечними кредитами, ремонтом житла та послугами з оцінки або кредитування під заставу житла.
  • `financial_product_services`: Оголошення, що просувають або безпосередньо посилаються на пропозицію фінансових продуктів і послуг, включаючи кредити.
  • `employment`: Оголошення, що просувають або безпосередньо посилаються на можливість працевлаштування, включаючи, але не обмежуючись, роботами на неповний або повний робочий день, стажуванням або програмами професійної сертифікації. Пов'язані оголошення, які підпадають під цю категорію, включають промоакції для дошок оголошень про роботу або ярмарків, служб агрегації або оголошень, що детально описують переваги, які компанія може надати, незалежно від конкретної пропозиції роботи.
  • `issues_elections_politics`: Оголошення, створені кандидатом на публічну посаду, від його імені або про нього, політичним діячем, політичною партією або такі, що виступають за результат виборів на публічну посаду. Це також включає оголошення про будь-які вибори, референдум чи ініціативу голосування, включаючи виборчі кампанії «Йдіть та голосуйте». Оголошення, що регулюються як політична реклама або стосуються соціальних питань у будь-якому місці, де розміщується оголошення. Якщо вибираєте питання, вибори або політику, ви маєте вибрати країну, у якій хочете розміщувати ці оголошення. Ви повинні мати авторизацію на розміщення оголошень про соціальні питання, вибори або політику у вказаній країні.
Meta вимагає, щоб рекламодавці самостійно ідентифікували категорію своєї кампанії. Meta використовує людських рецензентів та машинне навчання для виявлення таких оголошень. Якщо ви надішлете нам некоректну `specialAdCategory`, існує ризик, що ваші оголошення буде призупинено до коригування кампанії. Дата й час завершення у форматі ISO 8601 (має бути щонайменше через 30 годин після початку), наприклад `2025-03-01T00:00:00Z`. Якщо не задано, оголошення працюватиме нескінченно і матиме дату завершення `ongoing`. Виключіть локації за допомогою об'єкта з масивами `countries`, `regions` та `cities`. Список кодів країн для виключення. ```json theme={"system"} { "countries": ["US", "CA"] } ``` Регіони потребують значення `key` регіону Facebook. Див. [ендпоінт регіонів](/docs/apis/ads/facebook/get-ad-regions) для отримання додаткової інформації. ```json theme={"system"} { "regions": [{ "key": "3886" }] } ``` Міста потребують: `key` (з Facebook), `radius` та `distance_unit`. `radius` — це відстань навколо міста: 10–50 миль або 17–80 кілометрів. `distance_unit` — це `mile` або `kilometer`. Див. [ендпоінт міст](/docs/apis/ads/facebook/get-ad-cities) для отримання додаткової інформації. ```json theme={"system"} { "cities": [ { "key": "2420605", "radius": 25, "distance_unit": "mile" } ] } ``` Стать аудиторії. Значення: `all`, `male`, `female`. Цільові інтереси оголошення у вигляді масиву [ID інтересів](/docs/apis/ads/facebook/get-ad-interests) Facebook. Максимальний вік для таргетингу оголошення (за замовчуванням: 65). Мінімальний вік для таргетингу оголошення (за замовчуванням: 18). Дата й час початку у форматі ISO 8601, наприклад `2025-03-01T00:00:00Z`. Якщо не задано, оголошення розпочнеться негайно. Отримувач вигоди від оголошення для відповідності Закону про цифрові послуги (DSA) для країн ЄС. Має бути задано разом із `dsaPayor`, якщо надається одне з них. Зверніться до нашого [посібника з DSA](/docs/apis/ads/facebook/get-dsa-recommendations) для отримання додаткової інформації. Платник за оголошення для відповідності Закону про цифрові послуги (DSA) для країн ЄС. Має бути задано разом із `dsaBeneficiary`, якщо надається одне з них. ```bash cURL theme={"system"} curl -X POST https://api.ayrshare.com/api/ads/facebook/boost \ -H "Authorization: Bearer API_KEY" \ -H "Content-Type: application/json" \ -d '{ "postId": "1234567890", "accountId": "1234567890", "adName": "My Ad", "status": "active", "goal": "engagement", "minAge": 18, "maxAge": 65, "locations": { "countries": ["US"] }, "budget": 100, "bidAmount": 1, "startDate": "2025-03-01T00:00:00Z", "endDate": "2025-03-07T23:59:59Z", "interests": [1234567890, 1234567891] }' ``` ```javascript JavaScript theme={"system"} const API_KEY = "API_KEY"; fetch("https://api.ayrshare.com/api/ads/facebook/boost", { method: "POST", headers: { "Content-Type": "application/json", Authorization: `Bearer ${API_KEY}` }, body: JSON.stringify({ postId: "1234567890", accountId: "1234567890", adName: "My Ad", status: "active", goal: "engagement", minAge: 18, maxAge: 65, locations: { countries: ["US"] }, budget: 100, bidAmount: 1, startDate: "2025-03-01T00:00:00Z", endDate: "2025-03-07T23:59:59Z", interests: [1234567890, 1234567891] }) }) .then((res) => res.json()) .then((json) => console.log(json)) .catch(console.error); ``` ```python Python theme={"system"} import requests API_KEY = "API_KEY" url = "https://api.ayrshare.com/api/ads/facebook/boost" payload = { "postId": "1234567890", "accountId": "1234567890", "adName": "My Ad", "status": "active", "goal": "engagement", "minAge": 18, "maxAge": 65, "locations": {"countries": ["US"]}, "budget": 100, "bidAmount": 1, "startDate": "2025-03-01T00:00:00Z", "endDate": "2025-03-07T23:59:59Z", "interests": [1234567890, 1234567891] } response = requests.post(url, headers={"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}, json=payload) print(response.json()) ``` ```php PHP theme={"system"} "1234567890", "accountId" => "1234567890", "adName" => "My Ad", "status" => "active", "goal" => "engagement", "minAge" => 18, "maxAge" => 65, "locations" => ["countries" => ["US"]], "budget" => 100, "bidAmount" => 1, "startDate" => "2025-03-01T00:00:00Z", "endDate" => "2025-03-07T23:59:59Z", "interests" => [1234567890, 1234567891] ]; $ch = curl_init("https://api.ayrshare.com/api/ads/facebook/boost"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload)); curl_setopt($ch, CURLOPT_HTTPHEADER, [ "Content-Type: application/json", "Authorization: Bearer " . $API_KEY ]); $response = curl_exec($ch); $result = json_decode($response, true); print_r($result); curl_close($ch); ``` ```csharp C# theme={"system"} using System; using System.Net.Http; using System.Net.Http.Headers; using System.Text; using System.Text.Json; using System.Threading.Tasks; class Program { static async Task Main() { string API_KEY = "API_KEY"; var payload = new { postId = "1234567890", accountId = "1234567890", adName = "My Ad", status = "active", goal = "engagement", minAge = 18, maxAge = 65, locations = new { countries = new[] { "US" } }, budget = 100, bidAmount = 1, startDate = "2025-03-01T00:00:00Z", endDate = "2025-03-07T23:59:59Z", interests = new[] { 1234567890, 1234567891 } }; using var client = new HttpClient(); client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", API_KEY); var content = new StringContent( JsonSerializer.Serialize(payload), Encoding.UTF8, "application/json" ); var response = await client.PostAsync("https://api.ayrshare.com/api/ads/facebook/boost", content); var responseBody = await response.Content.ReadAsStringAsync(); Console.WriteLine(responseBody); } } ``` ```go Go theme={"system"} package main import ( "bytes" "encoding/json" "fmt" "io/ioutil" "net/http" ) func main() { apiKey := "API_KEY" payload := map[string]interface{}{ "postId": "1234567890", "accountId": "1234567890", "adName": "My Ad", "status": "active", "goal": "engagement", "minAge": 18, "maxAge": 65, "locations": map[string]interface{}{"countries": []string{"US"}}, "budget": 100, "bidAmount": 1, "startDate": "2025-03-01T00:00:00Z", "endDate": "2025-03-07T23:59:59Z", "interests": []int{1234567890, 1234567891}, } jsonData, err := json.Marshal(payload) if err != nil { fmt.Println("Error marshaling JSON:", err) return } req, err := http.NewRequest("POST", "https://api.ayrshare.com/api/ads/facebook/boost", bytes.NewBuffer(jsonData)) if err != nil { fmt.Println("Error creating request:", err) return } req.Header.Set("Content-Type", "application/json") req.Header.Set("Authorization", "Bearer "+apiKey) client := &http.Client{} resp, err := client.Do(req) if err != nil { fmt.Println("Error sending request:", err) return } defer resp.Body.Close() body, err := ioutil.ReadAll(resp.Body) if err != nil { fmt.Println("Error reading response:", err) return } fmt.Println(string(body)) } ``` ```java Java theme={"system"} import java.io.IOException; import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import java.util.Arrays; import java.util.HashMap; import java.util.Map; import com.fasterxml.jackson.databind.ObjectMapper; public class BoostPost { public static void main(String[] args) { String API_KEY = "API_KEY"; String url = "https://api.ayrshare.com/api/ads/facebook/boost"; Map payload = new HashMap<>(); payload.put("postId", "1234567890"); payload.put("accountId", "1234567890"); payload.put("adName", "My Ad"); payload.put("status", "active"); payload.put("goal", "engagement"); payload.put("minAge", 18); payload.put("maxAge", 65); Map locations = new HashMap<>(); locations.put("countries", Arrays.asList("US")); payload.put("locations", locations); payload.put("budget", 100); payload.put("bidAmount", 1); payload.put("startDate", "2025-03-01T00:00:00Z"); payload.put("endDate", "2025-03-07T23:59:59Z"); payload.put("interests", Arrays.asList(1234567890, 1234567891)); try { ObjectMapper objectMapper = new ObjectMapper(); String requestBody = objectMapper.writeValueAsString(payload); HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create(url)) .header("Content-Type", "application/json") .header("Authorization", "Bearer " + API_KEY) .POST(HttpRequest.BodyPublishers.ofString(requestBody)) .build(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } catch (IOException | InterruptedException e) { e.printStackTrace(); } } } ``` ```ruby Ruby theme={"system"} require 'net/http' require 'uri' require 'json' API_KEY = "API_KEY" uri = URI.parse("https://api.ayrshare.com/api/ads/facebook/boost") payload = { postId: "1234567890", accountId: "1234567890", adName: "My Ad", status: "active", goal: "engagement", minAge: 18, maxAge: 65, locations: { countries: ["US"] }, budget: 100, bidAmount: 1, startDate: "2025-03-01T00:00:00Z", endDate: "2025-03-07T23:59:59Z", interests: [1234567890, 1234567891] } http = Net::HTTP.new(uri.host, uri.port) http.use_ssl = true request = Net::HTTP::Post.new(uri.request_uri) request["Content-Type"] = "application/json" request["Authorization"] = "Bearer #{API_KEY}" request.body = payload.to_json response = http.request(request) puts response.body ``` ```json 200: Post Boosted theme={"system"} { "status": "success", "adId": "120217670757750410", "adName": "API Post - DE6gpw8kxlonHy2b7Lo - 2025-03-26T23:42:43", "adStatus": "active", "bidAmount": 10, "budget": 100, "endDate": "2026-03-28T22:30:00Z", "goal": { "title": "Get More Engagement", "description": "This goal seeks to increase engagement...", "type": "engagement" }, "interests": [ "6003195554098" ], "locations": { "countries": ["US"] }, "maxAge": 65, "minAge": 18, "postId": "DE6gpw8kxlonHy2b7Lo", "startDate": "2026-03-26T22:30:00Z" } ``` ```json 400: Invalid Account ID theme={"system"} { "action": "boost post", "status": "error", "code": 369, "message": "Unable to boost post. Please try again or contact us if the issue persists.", "details": "The accountId likely does not exist. Please check the accountId and try again." } ``` ```json 400: Missing Required Parameters theme={"system"} { "action": "request", "status": "error", "code": 101, "message": "Missing or incorrect parameters. Please verify with the docs. https://www.ayrshare.com/docs/apis", "details": "Missing required fields: budget" } ```