Skip to main content
GET
कीवर्ड द्वारा उपलब्ध Facebook विज्ञापन टार्गेटिंग रुचियों की खोज करें। Boost Post एंडपॉइंट के लिए रुचि ID देखने हेतु इस एंडपॉइंट का उपयोग करें। यह एंडपॉइंट आपको आपके Facebook विज्ञापनों के लिए रुचि-आधारित टार्गेटिंग विकल्पों की खोज करने में मदद करता है, साथ ही ऑडियंस आकार अनुमानों के साथ।
  • पोस्ट को बूस्ट करते समय interests array में रुचि ID का उपयोग किया जा सकता है।
  • परिणाम 10 मिनट के लिए कैश किए जाते हैं।
  • सर्वोत्तम परिणामों के लिए विशिष्ट, प्रासंगिक खोज शब्दों का उपयोग करें।
  • Facebook आपके विज्ञापन खाते के उद्योग और क्षेत्र के आधार पर अलग-अलग परिणाम लौटा सकता है।
  • JSON प्रतिक्रिया में audienceSizeLowerBound और audienceSizeUpperBound फ़ील्ड रुचि के लिए ऑडियंस आकार की अनुमानित सीमा प्रदान करते हैं और यह टार्गेटिंग के लिए उपयोगी है।
  • केवल वे रुचियाँ लौटाने के लिए जिन्हें Meta किसी special ad category campaign के लिए अनुमति देता है, specialAdCategories का उपयोग करें। Filtered अनुरोधों के लिए accountId भी आवश्यक है।

Header Parameters

Query Parameters

Facebook विज्ञापन रुचियाँ प्राप्त करने के लिए खोज क्वेरी।खोज क्वेरी को एस्केप करना न भूलें, उदाहरण के लिए Rhythm%20and%20blues%20music।
array
परिणामों को उन रुचियों तक सीमित करें जिन्हें Meta किसी special ad category campaign को टार्गेट करने की अनुमति देता है। किसी housing, employment, financial, या political पोस्ट को boost करने से पहले इसका उपयोग करें, ताकि आप ऐसी रुचि ID चुनें जिनके लिए ad वास्तव में approve किया जाएगा।निम्नलिखित मान समर्थित हैं, जो Boost Post के इसी नाम के पैरामीटर से मेल खाते हैं:
  • housing
  • employment
  • financial_product_services — financial_products_services और credit समतुल्य के रूप में स्वीकार किए जाते हैं और एक ही श्रेणी में resolve होते हैं
  • issues_elections_politics
  • none — Boost Post के साथ symmetry के लिए स्वीकार किया जाता है, जहाँ इसका अर्थ है “किसी special ad category में नहीं”। इसे Meta को regulated_categories=["NONE"] के रूप में भेजा जाता है: accountId आवश्यक है और सफल प्रतिक्रिया ["NONE"] वापस लौटाती है। यह unfiltered खोज जैसे ही परिणामों की गारंटी नहीं देता; Meta की ओर से अस्वीकृति code: 368 लौटाती है। यदि आप सामान्य unfiltered खोज चाहते हैं, तो none भेजने के बजाय specialAdCategories को पूरी तरह छोड़ दें।
मान case-insensitive हैं। किसी unrecognized मान को स्वीकृत मानों की सूची देते हुए 400 और code: 101 के साथ अस्वीकार किया जाता है। वह message Meta के upper-case रूप में लिखा होता है और ऊपर बताई गई वैकल्पिक spellings के नाम भी देता है, इसलिए वह NONE, HOUSING, FINANCIAL_PRODUCTS_SERVICES, EMPLOYMENT, ISSUES_ELECTIONS_POLITICS, FINANCIAL_PRODUCT_SERVICES, CREDIT के रूप में पढ़ा जाता है — यहाँ सूचीबद्ध वही श्रेणियाँ, अतिरिक्त नहीं। Boost Post यही message लौटाता है। खाली मान, जैसे ?specialAdCategories=, उसी तरह अस्वीकार किया जाता है।एक से अधिक श्रेणियाँ भेजने के लिए पैरामीटर को दोहराएँ, उदाहरण के लिए ?search=nursing&specialAdCategories=employment&specialAdCategories=housing। Bracketed रूप ?specialAdCategories[]=employment&specialAdCategories[]=housing भी काम करता है। Comma-separated स्ट्रिंग जैसे ?specialAdCategories=employment,housing समर्थित नहीं है और 400 और code: 101 के साथ अस्वीकार की जाती है। सभी अनुरोधित श्रेणियाँ एक ही खोज में Meta को भेजी जाती हैं। Ayrshare Meta के परिणाम लौटाता है और स्वतंत्र रूप से eligible रुचियों के intersection की गणना या गारंटी नहीं करता। किसी श्रेणी को दोहराना, या एक ही श्रेणी की दो spellings भेजना, एक ही श्रेणी में समेट दिया जाता है।जब आप एक से अधिक श्रेणियाँ देते हैं, तो प्रतिक्रिया में वापस लौटाया गया specialAdCategories फ़ील्ड आपके भेजे गए क्रम के बजाय alphabetically sorted होता है।specialAdCategories को पूरी तरह छोड़ दें और एंडपॉइंट ठीक पहले जैसा ही व्यवहार करता है: unfiltered खोज, किसी accountId की ज़रूरत नहीं, और वही response shape।
string
जब specialAdCategories दिया गया हो तब आवश्यक, अन्यथा नज़रअंदाज़ किया जाता है। उस Facebook ad account की ID जिसके लिए रुचियाँ खोजी जा रही हैं, बिना act_ prefix के — वही मान जो Boost Post लेता है। इसे ad accounts endpoint से प्राप्त करें। यह numeric होना चाहिए; शुरुआत का act_ स्वीकार करके हटा दिया जाता है, और इसके अलावा कुछ भी 400 और code: 101 के साथ अस्वीकार किया जाता है।
Meta category-aware रुचि खोज केवल किसी ad account पर उपलब्ध कराता है, इसलिए ऐसा अनुरोध जो accountId के बिना specialAdCategories देता है, कोई खोज चलने से पहले ही 400 और code: 101 के साथ अस्वीकार कर दिया जाता है। बिना specialAdCategories वाला अनुरोध अपरिवर्तित है और उसे अब भी किसी accountId की ज़रूरत नहीं है।
number
डिफ़ॉल्ट:100
लौटाई गई विज्ञापन रुचियों की संख्या सीमित करें।
Filtered प्रतिक्रिया लागू की गई श्रेणियों को specialAdCategories फ़ील्ड में वापस लौटाती है, ताकि आप पुष्टि कर सकें कि परिणाम किसके आधार पर सीमित किए गए थे। Unfiltered प्रतिक्रिया उस फ़ील्ड को खाली लौटाने के बजाय पूरी तरह छोड़ देती है। Filtered परिणामों में प्रत्येक रुचि पर topic फ़ील्ड भी नहीं होती, क्योंकि Meta की category-aware खोज उसे नहीं लौटाती — इसके बजाय name पढ़ें। जिस खोज के लिए कोई eligible रुचि नहीं है, वह त्रुटि नहीं बल्कि खाली interests array और count: 0 के साथ 200 लौटाती है, और filtered खोज कभी भी unfiltered परिणामों पर fallback नहीं करती।