> ## 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. # تعزيز المنشور > عزّز منشورًا بإرساله إلى منصة إعلانات Instagram 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 )} ; عزّز منشورًا موجودًا على Instagram لإنشاء إعلان. تتيح لك نقطة النهاية هذه تحويل منشوراتك العضوية إلى إعلانات مدفوعة مع معلمات استهداف وميزانية وجدولة مخصصة.

يجب تحديد قيم الميزانية وعرض السعر بالدولار الأمريكي بحد أقصى منزلتين عشريتين.
يجب أن يعمل الإعلان لمدة 30 ساعة على الأقل لتلبية متطلبات Instagram.
يمكنك استخدام [نقطة نهاية الاهتمامات](/docs/apis/ads/instagram/get-ad-interests) للعثور على معرّفات الاهتمامات للاستهداف.
قد يستغرق Instagram حتى 24 ساعة لمراجعة المنشورات المُعزَّزة والموافقة عليها.
عند استخدام `socialPostId` مباشرةً (بدلاً من `postId` الخاص بـ Ayrshare)، تأكّد من أنه معرّف منشور Instagram صالح.

### أهداف الإعلان يجب أن يكون لكل إعلان هدف. يحدد الهدف كيف سيتم تحسين الإعلان للعرض.

`engagement`: يسعى هذا الهدف إلى زيادة التفاعل مع ضمان أن يصل الإعلان إلى أكبر عدد ممكن من المستخدمين الفريدين. يوازن بين الوضوح والتفاعل، ويعرض الإعلان لأكبر عدد ممكن من الأشخاص المختلفين الذين قد يتفاعلون معه.
`interactions`: مصمم لزيادة التفاعلات، مثل الإعجابات والتعليقات والمشاركات، على الإعلان. يعطي Instagram الأولوية لعرض الإعلان للمستخدمين الأكثر احتمالاً للتفاعل معه.
`awareness_views`: يركّز على زيادة الوعي بالعلامة التجارية من خلال تعظيم عدد المرات التي يُعرض فيها الإعلان. يعطي الأولوية لعرض الإعلان لأكبر عدد ممكن من المرات ضمن الميزانية، بغض النظر عن الوصول الفريد.
`awareness_audience`: يهدف إلى تعزيز الوعي بالعلامة التجارية من خلال تعظيم عدد الأشخاص الفريدين الذين يرون الإعلان. يضمن أن يصل الإعلان إلى أكبر عدد ممكن من المستخدمين المختلفين ويعظّم حجم الجمهور الفريد بدلاً من عرضه عدة مرات لنفس الجمهور.

تتطلب إعلانات Instagram حساب Instagram Business مرتبطًا عبر Facebook، وصفحة Facebook مقترنة به، وصلاحية `ads_management`. أعد الربط عبر Facebook لمنح هذه الصلاحية. لا يمكن للحسابات المرتبطة عبر Instagram Login استخدام نقاط نهاية الإعلانات هذه. يُستخرج معرّف الوسائط ومعرّف حساب Instagram من حسابك المرتبط؛ فلا تُرسل `instagram_user_id`. يقبل مُحدِّد `socialPostId` أيضًا الاسم البديل الخاص بـ Instagram وهو `igPostId`. أما `fbPostId` فينطبق على Facebook فقط. تتضمن الاستجابات الناجحة `platform: "instagram"` و`socialPostId` و`igPostId`. ## معلمات الترويسة ## معلمات الجسم مفتاح فريد وغير فارغ لطلب التعزيز هذا. أعد إرسال الحمولة نفسها بالمفتاح نفسه لتجنّب إنشاء إعلان مكرر. إعادة استخدام المفتاح مع حمولة أو منصة مختلفة تعيد HTTP 409. والطلب الذي لا يزال قيد التنفيذ يعيد 409 أيضًا؛ أما الحجز غير المتاح فيعيد 503 دون إنشاء إعلان. السماح لـ Meta بمشاركة الميزانية بين مجموعات الإعلانات في الحملة. معرّف حساب إعلانات Instagram لتعزيز المنشور عليه. يمكن استرداد معرّف الحساب من [نقطة نهاية حسابات الإعلانات](/docs/apis/ads/instagram/get-ad-accounts). اسم إعلانك (يظهر في Instagram Ad Manager) بالتنسيق `{adName} - {postId or socialPostId} - {current date}`. الحد الأقصى لعرض السعر بالدولار الأمريكي، كقيمة موجبة بحد أقصى منزلتين عشريتين. الميزانية اليومية بالدولار الأمريكي. استخدم قيمة موجبة بحد أقصى منزلتين عشريتين. قد تفرض Meta حدودًا دنيا إضافية بحسب حسابك وهدفك. [معرّف المنشور الاجتماعي على Instagram](/docs/apis/overview#social-post-id) للمنشور المراد تعزيزه، مما يتيح لك إنشاء إعلان من منشور تم إنشاؤه مباشرة على Instagram. هذا هو معرّف [المنشور على Instagram](/docs/apis/history/history-platform)، وليس Ayrshare. مطلوب إذا لم يتم تعيين `postId`. هدف الإعلان. القيم: `engagement`, `interactions`, `awareness_views`, و`awareness_audience`. راجع [تفاصيل أهداف الإعلان](/docs/apis/ads/instagram/boost-post#ad-goals) أعلاه لمزيد من المعلومات. استهدف الدول باستخدام `{"countries": ["US", "CA"]}` مع [رموز الدول](/docs/iso-codes/country). يمكنك أيضًا تقديم مصفوفتي `regions` و`cities`؛ راجع [المناطق](/docs/apis/ads/instagram/get-ad-regions) و[المدن](/docs/apis/ads/instagram/get-ad-cities). [معرّف منشور Ayrshare](/docs/apis/overview#ayrshare-post-id) للمنشور المراد تعزيزه. مطلوب إذا لم يتم تعيين `socialPostId`. حالة الإعلان. القيم: `active` و`paused`. يمكنك لاحقًا تغيير حالة الإعلان باستخدام [نقطة نهاية تحديث الإعلان](/docs/apis/ads/instagram/put-ad-update). تتبّع الإعلان باستخدام Meta Pixel. معرّف Meta 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 المراجعين البشريين والتعلم الآلي لتحديد هذه الأنواع من الإعلانات. إذا أرسلت لنا `specialAdCategories` غير صحيحة، فهناك خطر من إيقاف إعلاناتك مؤقتًا حتى يتم تعديل الحملة. الشخص أو الجهة المستفيدة من الإعلان. يُعيَّن مع `dsaPayor`. استخدم [نقطة نهاية توصيات DSA](/docs/apis/ads/instagram/get-dsa-recommendations) للحصول على اقتراحات. الشخص أو الجهة التي تدفع مقابل الإعلان. يُعيَّن مع `dsaBeneficiary`. تاريخ ووقت الانتهاء بتنسيق ISO 8601 (يجب أن يكون على الأقل 30 ساعة بعد البداية)، على سبيل المثال `2025-03-01T00:00:00Z`. إذا لم يتم تعيينه، سيعمل الإعلان إلى أجل غير مسمى وسيكون له تاريخ انتهاء `ongoing`. استبعد المواقع باستخدام بنية `countries` و`regions` و`cities` نفسها المستخدمة في `locations`. جنس الجمهور. القيم: `all` و`male` و`female`. الاهتمامات المستهدفة للإعلان كمصفوفة من [معرّفات اهتمامات](/docs/apis/ads/instagram/get-ad-interests) Instagram. الحد الأقصى للعمر لاستهداف الإعلان (الافتراضي: 65). الحد الأدنى للعمر لاستهداف الإعلان (الافتراضي: 18). تاريخ ووقت البدء بتنسيق ISO 8601، على سبيل المثال `2025-03-01T00:00:00Z`. إذا لم يتم تعيينه، سيبدأ الإعلان فورًا. استبدل المعرّفات الواردة في الأمثلة بمعرّفاتك الخاصة. عيّن `startDate` و`endDate` وفق الجدول الزمني الذي تريده؛ فالتواريخ في الأمثلة توضيحية فقط. ```bash cURL theme={"system"} curl -X POST https://api.ayrshare.com/api/ads/instagram/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/instagram/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/instagram/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/instagram/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/instagram/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/instagram/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/instagram/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); payload.put("locations", Map.of("countries", Arrays.asList("US"))); 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/instagram/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", "socialPostId": "1234567890", "igPostId": "1234567890", "platform": "instagram", "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: accountId" } ```