मुख्य सामग्री पर जाएं
POST
एक ad बनाने के लिए मौजूदा Facebook पोस्ट को boost करें। यह endpoint आपको कस्टम targeting, बजट और scheduling parameters के साथ आपके organic पोस्ट्स को paid विज्ञापनों में परिवर्तित करने की अनुमति देता है।
  • Budget और bid राशियाँ USD में अधिकतम दो दशमलव स्थानों तक निर्दिष्ट की जानी चाहिए।
  • Facebook की आवश्यकता को पूरा करने के लिए ad कम से कम 30 घंटे चलना चाहिए।
  • Targeting के लिए interest ID खोजने के लिए आप interests endpoint का उपयोग कर सकते हैं।
  • Facebook को boosted पोस्ट्स की समीक्षा और अनुमोदन में 24 घंटे तक लग सकते हैं।
  • यदि fbPostId का सीधे उपयोग कर रहे हैं (Ayrshare postId के बजाय), तो सुनिश्चित करें कि यह एक वैध Facebook post ID है।

Ad Goals

प्रत्येक ad का एक goal होना चाहिए। Goal यह निर्धारित करता है कि ad को display के लिए किस प्रकार optimize किया जाएगा।
  • engagement: यह goal engagement बढ़ाने का प्रयास करता है और साथ ही यह सुनिश्चित करता है कि ad अधिकतम संख्या में unique उपयोगकर्ताओं तक पहुँचे। यह visibility को engagement के साथ संतुलित करता है, ad को अधिक से अधिक विभिन्न लोगों को दिखाता है जो इसके साथ interact कर सकते हैं।
  • interactions: ad पर interactions जैसे likes, comments, और shares को बढ़ाने के लिए डिज़ाइन किया गया। Facebook उन उपयोगकर्ताओं को ad दिखाने को प्राथमिकता देता है जिनके इसके साथ engage होने की सबसे अधिक संभावना है।
  • awareness_views: ad को दिखाए जाने की अधिकतम संख्या के माध्यम से ब्रांड जागरूकता बढ़ाने पर केंद्रित है। यह unique reach की परवाह किए बिना, बजट के भीतर ad को अधिक से अधिक बार दिखाने को प्राथमिकता देता है।
  • awareness_audience: ad को देखने वाले unique लोगों की संख्या को अधिकतम करके ब्रांड जागरूकता बढ़ाने का लक्ष्य रखता है। यह सुनिश्चित करता है कि ad अधिक से अधिक विभिन्न उपयोगकर्ताओं तक पहुँचे और एक ही audience को कई बार दिखाने के बजाय unique audience के आकार को अधिकतम करे।
Ayrshare के साथ Facebook Marketing API को integrate करने के बारे में हमारी Facebook Marketing API Integration Guide में और जानें।

Header Parameters

Body Parameters

accountId
string
आवश्यक
उस Facebook ad account की ID जिस पर पोस्ट को boost करना है। Account ID को ad accounts endpoint से प्राप्त किया जा सकता है।
adName
string
आवश्यक
आपके ad का नाम (Facebook Ad Manager में दिखाई देता है) {adName} - {postId or fbPostId} - {current date} फ़ॉर्मैट के साथ।
bidAmount
number
आवश्यक
USD में अधिकतम bid राशि। न्यूनतम bid राशि $1.00 है।
budget
number
आवश्यक
USD में दैनिक बजट। न्यूनतम बजट $1.00 है।
fbPostId
string
आवश्यक
Boost करने के लिए पोस्ट की Facebook social post ID, जो आपको सीधे Facebook पर बनाए गए पोस्ट से एक ad बनाने की अनुमति देती है। यह Facebook पर पोस्ट की ID है, Ayrshare की नहीं। यदि postId सेट नहीं है तो आवश्यक है।
goal
string
डिफ़ॉल्ट:"engagement"
आवश्यक
ad का goal। मान: engagement, interactions, awareness_views, और awareness_audience। अधिक जानकारी के लिए ऊपर ad goals details देखें।
locations
object
आवश्यक
arrays के object के साथ ad locations को target करें: countries, regions, cities
postId
string
आवश्यक
Boost करने के लिए पोस्ट की Ayrshare post ID। यदि fbPostId सेट नहीं है तो आवश्यक है।
status
string
डिफ़ॉल्ट:"active"
आवश्यक
ad का status। मान: active और pausedआप बाद में update ad endpoint का उपयोग करके ad का status बदल सकते हैं।
adSetBudgetSharingEnabled
boolean
डिफ़ॉल्ट:false
Meta के campaign-level ad set budget sharing को नियंत्रित करता है। Meta अब campaign-level बजट के बिना बनाए गए हर campaign पर इस wire field की आवश्यकता रखता है, इसलिए Ayrshare इसे हमेशा भेजता है — backward compatibility के लिए डिफ़ॉल्ट false है।Meta को समग्र प्रदर्शन को optimize करने के लिए एक ही campaign में अन्य ad sets के बीच ad set के बजट का लगभग 20% साझा करने देने के लिए true पर सेट करें। विवरण के लिए Meta का ad campaign group reference देखें।
tracking
object
Facebook Pixel का उपयोग करके ad को track करें।
urlTags
array
ad URL में UTM tags जोड़ें।
उदाहरण के लिए यदि linking URL https://www.mysite.com/my-post है और जोड़े गए URL tags हैं:utm_source=ayrshare, utm_medium=social, और utm_campaign=ayrshare-socialAd URL होगा: https://www.mysite.com/my-post?utm_source=ayrshare&utm_medium=social&utm_campaign=ayrshare-social
specialAdCategories
array
Meta special ad categories में विज्ञापनदाताओं से अपनी campaign category स्वयं-पहचान करने की आवश्यकता रखता है।यदि आपका व्यवसाय इनमें से किसी एक श्रेणी में है, तो अपनी पोस्ट को boost करते समय आपको उपयुक्त श्रेणी चुननी होगी।निम्नलिखित मान समर्थित हैं:
  • housing: ऐसे ads जो आवास के अवसर या संबंधित सेवा को promote करते हैं या सीधे लिंक करते हैं, जिनमें घर या अपार्टमेंट की बिक्री या किराए, homeowners insurance, mortgage insurance, mortgage loans, housing repairs और home equity या appraisal सेवाओं के लिए listings शामिल हैं, लेकिन इन्हीं तक सीमित नहीं हैं।
  • financial_product_services: ऐसे ads जो credit सहित financial products और services offer को promote करते हैं या सीधे लिंक करते हैं।
  • employment: ऐसे ads जो किसी employment अवसर को promote करते हैं या सीधे लिंक करते हैं, जिसमें part- या full-time jobs, internships या professional certification programs शामिल हैं, लेकिन इन्हीं तक सीमित नहीं हैं। इस श्रेणी में आने वाले संबंधित ads में किसी विशिष्ट नौकरी की पेशकश की परवाह किए बिना, job boards या fairs, aggregation services, या किसी कंपनी द्वारा प्रदान किए जा सकने वाले perks का विवरण देने वाले ads के promotions शामिल हैं।
  • issues_elections_politics: ऐसे ads जो सार्वजनिक पद के लिए उम्मीदवार, राजनीतिक शख्सियत, राजनीतिक दल द्वारा, उनकी ओर से या उनके बारे में बनाए गए हैं या सार्वजनिक पद के लिए चुनाव के परिणाम की वकालत करते हैं। इसमें किसी भी चुनाव, referendum या ballot initiative के बारे में ads भी शामिल हैं, जिनमें “Go out and vote” चुनाव अभियान शामिल हैं। जहाँ ad रखा जा रहा है वहाँ राजनीतिक विज्ञापन के रूप में विनियमित ads या सामाजिक मुद्दों के बारे में ads। यदि issues, elections, या politics का चयन कर रहे हैं, तो आपको उस देश का चयन करना होगा जिसमें आप ये ads चलाना चाहते हैं। आपको निर्दिष्ट देश में सामाजिक मुद्दों, चुनावों, या राजनीति के बारे में ads चलाने के लिए अधिकृत होना आवश्यक है।
Meta उन विज्ञापनदाताओं से आवश्यकता रखता है जिन्होंने अपनी campaign category स्वयं-पहचानी है। Meta इस प्रकार के ads की पहचान करने के लिए मानव समीक्षकों और machine-learning का उपयोग करता है। यदि आप हमें एक गलत specialAdCategory भेजते हैं, तो जोखिम है कि आपके ads तब तक रोक दिए जाएंगे जब तक campaign समायोजित नहीं हो जाती।
endDate
string
ISO 8601 फ़ॉर्मैट में समाप्ति तिथि और समय (start के बाद कम से कम 30 घंटे होना चाहिए), उदाहरण के लिए 2025-03-01T00:00:00Zयदि सेट नहीं है, तो ad अनिश्चित काल तक चलेगा और उसकी end date ongoing होगी।
excludedLocations
object
countries, regions, और cities के arrays वाले object का उपयोग करके locations को exclude करें।
gender
string
डिफ़ॉल्ट:"all"
Audience का लिंग। मान: all, male, female
interests
array
Facebook interest ids के array के रूप में ad के target interests।
maxAge
number
डिफ़ॉल्ट:65
Ad को target करने के लिए अधिकतम आयु (डिफ़ॉल्ट: 65)।
minAge
number
डिफ़ॉल्ट:18
Ad को target करने के लिए न्यूनतम आयु (डिफ़ॉल्ट: 18)।
startDate
string
ISO 8601 फ़ॉर्मैट में प्रारंभ तिथि और समय, उदाहरण के लिए 2025-03-01T00:00:00Zयदि सेट नहीं है, तो ad तुरंत शुरू हो जाएगा।
dsaBeneficiary
string
EU देशों के लिए Digital Services Act (DSA) अनुपालन हेतु ad का beneficiary। यदि दोनों में से कोई एक प्रदान किया जाता है तो dsaPayor के साथ सेट किया जाना चाहिए। अधिक जानकारी के लिए कृपया हमारी DSA guide देखें।
dsaPayor
string
EU देशों के लिए Digital Services Act (DSA) अनुपालन हेतु ad का payor। यदि दोनों में से कोई एक प्रदान किया जाता है तो dsaBeneficiary के साथ सेट किया जाना चाहिए।