Skip to main content
GET
Пошук доступних інтересів для таргетингу Facebook Ads за ключовим словом. Використовуйте цей ендпоінт, щоб знайти ID інтересів для ендпоінту Boost Post. Цей ендпоінт допомагає виявляти варіанти таргетингу на основі інтересів для ваших оголошень Facebook разом з оцінками розміру аудиторії.
  • ID інтересів можна використовувати в масиві interests під час просування публікацій.
  • Результати кешуються на 10 хвилин.
  • Для найкращих результатів використовуйте конкретні, релевантні пошукові терміни.
  • Facebook може повертати різні результати залежно від галузі та регіону вашого рекламного акаунту.
  • Поля audienceSizeLowerBound та audienceSizeUpperBound у JSON-відповіді надають оцінений діапазон розміру аудиторії для інтересу і є корисними для таргетингу.
  • Використовуйте specialAdCategories, щоб отримати лише ті інтереси, які Meta дозволяє для кампанії спеціальної категорії реклами. Фільтровані запити також вимагають accountId.

Параметри заголовка

Параметри запиту

Пошуковий запит для отримання інтересів Facebook Ads.Не забудьте екранувати пошуковий запит, наприклад, Rhythm%20and%20blues%20music.
array
Обмежте результати інтересами, які Meta дозволяє таргетувати кампанії спеціальної категорії реклами. Використовуйте це перед просуванням допису про житло, працевлаштування, фінанси чи політику, щоб вибрати ID інтересів, для яких оголошення справді буде схвалено.Підтримуються такі значення, що відповідають однойменному параметру Boost Post:
  • housing
  • employment
  • financial_product_services — financial_products_services та credit приймаються як еквіваленти й зводяться до тієї самої категорії
  • issues_elections_politics
  • none — приймається для симетрії з Boost Post, де воно означає «не належить до спеціальної категорії реклами». Воно надсилається до Meta як regulated_categories=["NONE"]: accountId є обов’язковим, а успішна відповідь повертає ["NONE"]. Це не гарантує тих самих результатів, що й нефільтрований пошук; відмова з боку Meta повертає code: 368. Якщо вам потрібен звичайний нефільтрований пошук, повністю пропустіть specialAdCategories, а не надсилайте none.
Регістр значень не має значення. Нерозпізнане значення відхиляється з 400 та code: 101 з переліком прийнятних значень. Це повідомлення подано у верхньому регістрі, як у Meta, і в ньому також названо альтернативні написання, наведені вище, тому воно виглядає так: NONE, HOUSING, FINANCIAL_PRODUCTS_SERVICES, EMPLOYMENT, ISSUES_ELECTIONS_POLITICS, FINANCIAL_PRODUCT_SERVICES, CREDIT — це ті самі категорії, що наведені тут, а не додаткові. Boost Post повертає ідентичне повідомлення. Порожнє значення, як у ?specialAdCategories=, відхиляється так само.Щоб передати кілька категорій, повторіть параметр, наприклад ?search=nursing&specialAdCategories=employment&specialAdCategories=housing. Форма з дужками ?specialAdCategories[]=employment&specialAdCategories[]=housing також працює. Рядок з комами, як-от ?specialAdCategories=employment,housing, не підтримується і відхиляється з 400 та code: 101. Усі запитані категорії надсилаються до Meta в одному пошуку. Ayrshare повертає результати Meta й не обчислює та не гарантує перетин незалежно прийнятних інтересів. Повторення категорії або надсилання двох написань однієї й тієї самої категорії згортається до однієї категорії.Коли ви вказуєте більше однієї категорії, поле specialAdCategories, що повертається у відповіді, відсортовано за алфавітом, а не в тому порядку, в якому ви їх надіслали.Якщо повністю пропустити specialAdCategories, ендпоінт поводиться точно так само, як і раніше: нефільтрований пошук, без потреби в accountId і з тією самою структурою відповіді.
string
Обов’язковий, коли вказано specialAdCategories, і ігнорується в іншому разі. ID рекламного облікового запису Facebook, для якого шукаються інтереси, без префікса act_ — те саме значення, яке приймає Boost Post. Отримайте його з ендпоінту рекламних облікових записів. Значення має бути числовим; префікс act_ на початку приймається та видаляється, а будь-що інше відхиляється з 400 та code: 101.
Meta пропонує пошук інтересів з урахуванням категорії лише в межах рекламного облікового запису, тому запит зі specialAdCategories без accountId відхиляється з 400 та code: 101 ще до початку пошуку. Запит без specialAdCategories не змінився і, як і раніше, не потребує accountId.
number
за замовчуванням:100
Обмеження кількості повернутих інтересів.
Фільтрована відповідь повертає застосовані категорії в полі specialAdCategories, тож ви можете перевірити, за чим було звужено результати. Нефільтрована відповідь повністю пропускає це поле, а не повертає його порожнім. Фільтровані результати також не містять поля topic для кожного інтересу, оскільки пошук Meta з урахуванням категорії його не повертає — замість нього читайте name. Пошук без прийнятних інтересів повертає 200 з порожнім масивом interests та count: 0, а не помилку, і фільтрований пошук ніколи не повертається до нефільтрованих результатів.