> ## 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 لإنشاء إعلان.
تتيح لك نقطة النهاية هذه تحويل منشوراتك العضوية إلى إعلانات مدفوعة مع معلمات استهداف وميزانية وجدولة مخصصة.
- يجب تحديد قيم الميزانية وعرض السعر بالدولار الأمريكي بحد أقصى منزلتين عشريتين.
- يجب أن يعمل الإعلان لمدة 30 ساعة على الأقل لتلبية متطلبات Facebook.
-
يمكنك استخدام [نقطة نهاية الاهتمامات](/apis/ads/facebook/get-ad-interests) للعثور على معرّفات الاهتمامات
للاستهداف.
- قد يستغرق Facebook حتى 24 ساعة لمراجعة المنشورات المُعزَّزة والموافقة عليها.
-
عند استخدام `fbPostId` مباشرةً (بدلاً من `postId` الخاص بـ Ayrshare)، تأكّد من أنه معرّف منشور Facebook
صالح.
### أهداف الإعلان
يجب أن يكون لكل إعلان هدف. يحدد الهدف كيف سيتم تحسين الإعلان للعرض.
-
`engagement`: يسعى هذا الهدف إلى زيادة التفاعل مع ضمان أن يصل الإعلان إلى
أكبر عدد ممكن من المستخدمين الفريدين. يوازن بين الوضوح والتفاعل، ويعرض الإعلان لأكبر
عدد ممكن من الأشخاص المختلفين الذين قد يتفاعلون معه.
-
`interactions`: مصمم لزيادة التفاعلات، مثل الإعجابات والتعليقات والمشاركات، على الإعلان.
يعطي Facebook الأولوية لعرض الإعلان للمستخدمين الأكثر احتمالاً للتفاعل معه.
-
`awareness_views`: يركّز على زيادة الوعي بالعلامة التجارية من خلال تعظيم عدد المرات التي
يُعرض فيها الإعلان. يعطي الأولوية لعرض الإعلان لأكبر عدد ممكن من المرات ضمن الميزانية،
بغض النظر عن الوصول الفريد.
-
`awareness_audience`: يهدف إلى تعزيز الوعي بالعلامة التجارية من خلال تعظيم عدد الأشخاص الفريدين
الذين يرون الإعلان. يضمن أن يصل الإعلان إلى أكبر عدد ممكن من المستخدمين المختلفين ويعظّم
حجم الجمهور الفريد بدلاً من عرضه عدة مرات لنفس الجمهور.
اعرف المزيد عن دمج Facebook Marketing API مع Ayrshare في [دليل تكامل Facebook Marketing API](https://www.ayrshare.com/blog/facebook-ads-api-boosting-with-the-marketing-api/).
## معلمات الترويسة
## معلمات الجسم
معرّف حساب إعلانات Facebook لتعزيز المنشور عليه. يمكن استرداد معرّف الحساب من
[نقطة نهاية حسابات الإعلانات](/apis/ads/facebook/get-ad-accounts).
اسم إعلانك (يظهر في Facebook Ad Manager) بالتنسيق `{adName} - {postId or fbPostId} - {current date}`.
الحد الأقصى لعرض السعر بالدولار الأمريكي. الحد الأدنى لعرض السعر هو 1.00 دولار.
الميزانية اليومية بالدولار الأمريكي. الحد الأدنى للميزانية هو 1.00 دولار.
[معرّف المنشور الاجتماعي على Facebook](/apis/overview#social-post-id) للمنشور المراد تعزيزه، مما يتيح لك
إنشاء إعلان من منشور تم إنشاؤه مباشرة على Facebook. هذا هو معرّف [المنشور على
Facebook](/apis/history/history-platform)، وليس Ayrshare. مطلوب إذا لم يتم تعيين `postId`.
هدف الإعلان. القيم: `engagement`, `interactions`, `awareness_views`, و
`awareness_audience`. راجع [تفاصيل أهداف الإعلان](/apis/ads/facebook/boost-post#ad-goals) أعلاه
لمزيد من المعلومات.
استهدف مواقع الإعلان بكائن من المصفوفات: `countries`, `regions`, `cities`.
قائمة رموز الدول.
```json theme={"system"}
{
"countries": ["US", "CA"]
}
```
تتطلب المناطق قيمة `key` الخاصة بمنطقة Facebook. راجع [نقطة نهاية المناطق](/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`.
راجع [نقطة نهاية المدن](/apis/ads/facebook/get-ad-cities) لمزيد من المعلومات.
```json theme={"system"}
{
"cities": [
{ "key": "2420605", "radius": 25, "distance_unit": "mile" }
]
}
```
[معرّف منشور Ayrshare](/apis/overview#ayrshare-post-id) للمنشور المراد تعزيزه. مطلوب إذا لم يتم تعيين
`fbPostId`.
حالة الإعلان. القيم: `active` و`paused`.
يمكنك لاحقًا تغيير حالة الإعلان باستخدام [نقطة نهاية تحديث الإعلان](/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.
معرّف Facebook Pixel لتتبّع الإعلان.
```json theme={"system"}
{
"pixelId": 1234567890
}
```
أضف علامات UTM إلى عنوان URL الخاص بالإعلان.
```json theme={"system"}
{
"urlTags": ["utm_source=ayrshare", "utm_medium=social", "utm_campaign=ayrshare-social"]
}
```
على سبيل المثال، إذا كان عنوان 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`.
تطلب 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. راجع [نقطة نهاية المناطق](/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`.
راجع [نقطة نهاية المدن](/apis/ads/facebook/get-ad-cities) لمزيد من المعلومات.
```json theme={"system"}
{
"cities": [
{ "key": "2420605", "radius": 25, "distance_unit": "mile" }
]
}
```
جنس الجمهور. القيم: `all` و`male` و`female`.
الاهتمامات المستهدفة للإعلان كمصفوفة من [معرّفات اهتمامات](/apis/ads/facebook/get-ad-interests) Facebook.
الحد الأقصى للعمر لاستهداف الإعلان (الافتراضي: 65).
الحد الأدنى للعمر لاستهداف الإعلان (الافتراضي: 18).
تاريخ ووقت البدء بتنسيق ISO 8601، على سبيل المثال `2025-03-01T00:00:00Z`.
إذا لم يتم تعيينه، سيبدأ الإعلان فورًا.
المستفيد من الإعلان للامتثال لقانون الخدمات الرقمية (DSA) لدول الاتحاد الأوروبي. يجب تعيينه
مع `dsaPayor` إذا تم تقديم أي منهما. يرجى الرجوع إلى [دليل
DSA](/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: تم تعزيز المنشور 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: معرّف الحساب غير صالح 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: معلمات مطلوبة مفقودة 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"
}
```