Частота поисковых запросов отражает их популярность у пользователей

Общее определение

Частотность поисковых запросов – параметр, характеризующий популярность запросов у пользователей. Выражается цифрой, показывающей, сколько раз в месяц конкретный запрос был задан в поисковой системе. Эта цифра и является частотой данного запроса.

Количественное определение частотности запросов

В поисковой оптимизации сайтов (SEO) в целом принято выделять три основных категории запросов по частоте:

• высокочастотные (ВЧ),
• среднечастотные (СЧ),
• низкочастотные (НЧ).

Очень условно считается, что ВЧ-запросы имеют частоту выше 10000, СЧ-запросы – 1000–10000, НЧ-запросы – менее 1000. Но эта градация именно очень условная, поскольку критическое значение имеет тематика запросов. Если тематика популярна, значения частот поисковых запросов в ней будут большими. Если тематика не очень популярная или вообще редкая, значения частот запросов в ней будут небольшими.

Таким образом, при определении частот запросов в SEO, в частности для формирования семантического ядра сайта и определения бюджета продвижения, следует отталкиваться именно от конкретной тематики. В какой-то тематике запрос с частотой 2000 будет являться СЧ или даже НЧ (популярная тематика), а в какой-то – ВЧ (не очень популярная тематика).

Кроме этого на частоту запросов влияют и другие факторы: регион, сезонность и событийность. Например, частота запроса в целом по России будет выше, чем по Москве, а по Москве – выше, чем по небольшому городу. Также для многих тематик частота одних и тех же запросов изменяется в зависимости от времени года (сезонность запросов) или определённого события (событийность запросов), причём изменяться она может в десятки раз (см. ниже «Изменения частот поисковых запросов»). Всё это делает деление поисковых запросов на ВЧ, СЧ и НЧ ещё более условным, т.

к. частота привязывается уже не только к отдельной теме, но и к региону, а также ко времени или событию.

Однако в контекстной рекламе частотность всех запросов (ключей – ключевых слов или фраз) в целом привязывается к некой общей базе, на основе которой определяется стоимость запроса – CPC (cost per click – цена за клик; подробнее – см. статью Контекстная реклама). То есть в контекстной рекламе работает общее правило: чем более популярен запрос в целом (выше его частота), тем выше его стоимость (CPС).

Помимо трёх основных категорий поисковых запросов – ВЧ, СЧ и НЧ – выделяют и дополнительные категории – в сторону уменьшения частоты. Однако значение этих категорий запросов возрастает – как для SEO, так и для контекстной рекламы. Это микро-, или сверхнизкочастотные запросы (сНЧ; здесь мы будем использовать данное понятие), а также

мерцающие (мигающие), случайные и «нулевые» запросы. В целом эти понятия можно рассматривать как универсальные для любой тематики, поскольку значения частот данных запросов являются предельно низкими.

сНЧ-запросы имеют частоту 1–2. Мерцающие запросы имеют частоту 0–2. Это значит, что в какой-то месяц запрос может быть задан единожды или пару раз, а в какой-то – ни разу. Случайные запросы – те, которые возникли один раз и затем вообще никогда больше могут не повториться. Они, в принципе, близки к понятию «нулевые запросы» для которых Яндекс.Вордстат или планировщик ключевых слов Google вообще показывают стабильное значение частоты – ноль.

Практическое значение частотности запросов мы рассмотрим чуть ниже.

Сервисы определения частоты запросов

Значение частот поисковых запросов определяются с помощью специализированных сервисов, которые называются Яндекс.Вордстат и планировщик ключевых слов Google (соответственно, для Яндекс и Google). Оба являются бесплатными. Но Яндекс.Вордстат находится в свободном широком доступе, т.е. с ним можно начать работать немедленно, а планировщик Google доступен только в рамках планирования контекстной рекламы Google Ads или имитации этого планирования.

Для работы с данным сервисом необходимо иметь аккаунт в Google, сайт, для которого планируется реклама, и пройти ряд предварительных шагов в системе.

Таким образом, наиболее удобным для непосредственного («ручного») определения частот поисковых запросов на сегодняшний день является сервис Яндекс.Вордстат – тем более, что он имеет дополнительные очень полезные опции, например определение истории запросов (см. ниже).

Но, поскольку при формировании семантического ядра для SEO сайта или контекстной рекламы работа всегда ведётся с большим количеством запросов (нередко сотнями и даже тысячами), для их подбора и определения частот используют методы автоматизации. Наиболее популярным сервисом в этом отношении является инсталлируемая программа Key Collector, с помощью которой делается автоматический сбор (парсинг) запросов с Яндекс.Вордстата и Google-планировщика.

Практическое значение частотности запросов

Это значение имеет два аспекта – для SEO и для контекстной рекламы.

Значение частотности для SEO

На первый взгляд логично предположить, что, чем выше частота запроса, тем больше по нему трафик на сайт и тем, соответственно, запрос более эффективен: даёт больше потенциальных покупателей, если у нас, например, коммерческий ресурс. Но это именно на первый взгляд. На самом деле имеется три сильных аргумента против опоры на ВЧ-запросы в поисковом продвижении сайтов.

• Во-первых, ВЧ-запросы, как правило, являются и высококонкурентными (ВК). Конкурентность и частотность запросов – это не одно и то же, но во многих случаях они коррелируют (подробнее – см. ниже, а также статью Конкурентность поисковых запросов). Высокая конкуренция по запросу означает, что в ТОПе поисковой выдачи по нему присутствует очень много веб-страниц/сайтов. И это, в свою очередь, означает что продвинуть по данному запросу в ТОП новый сайт чрезвычайно трудно – долго и дорого.
• Во-вторых, в целом работает следующее правило: чем выше частота запроса, тем он менее специфичен (подробнее – см. статью Определённые и неопределённые поисковые запросы). А это означает, что по данному запросу на сайт будет приходить много нецелевых посетителей. Последнее плохо как для SEO, так и в целом для маркетинга. С точки зрения SEO нецелевые посетители будут давать сайту плохие поведенческие факторы (ПФ), т.е. быстро выходить с сайта. Поисковая система может расценивать это как реакцию на плохое качество сайта (он не нравится пользователям) и, соответственно, понижать сайт в своей поисковой выдаче. Для общего же маркетинга слишком нецелевая – «грязная» – аудитория также является нежелательной, поскольку отнимает много ресурсов на её обработку.
• Наконец, в-третьих, на самом деле, несмотря на высокую частоту, доля трафика на сайт по ВЧ-запросам является довольно невысокой. Подавляющий трафик (до 70%) складывается как раз из НЧ и особенно сНЧ, мерцающих и даже случайных и нулевых запросов. Это так называемый хвост, или шлейф запросов.  Да, каждый такой запрос является редким или сверхредким, т. е. в одиночку даёт ничтожный трафик на сайт.

Но, здесь также работают три важных принципа:

1. НЧ, сНЧ, мерцающие и даже случайные и нулевые запросы являются предельно целевыми, т.е. высококонверсионным, т.к. по ним на сайт приходят самые целевые клиенты («тёплые» и «горячие»).
2. Подобные запросы, как правило, являются и низкоконкурентными (НК, сНК), а это значит, что по ним сайт с лёгкостью попадает в ТОП поисковой выдачи. То есть на продвижение по этим запросам тратится минимальное количество средств и времени, если не считать создание контента под такие запросы (копирайтинг). Последнее в данном случае, вообще-то, и есть самая основная и самая дорогая работа.
3. В силу богатства языка НЧ/сНЧ-запросов по теме возникает очень много, а потому по совокупности трафик по таким запросам и составляет наибольшую долю в общем поисковом трафике на сайт (как сказано, до 70%).

Таким образом, выгодной SEO-стратегией является продвижение новых сайтов именно по НЧ/сНЧ-шлейфу запросов.

Причём, при формировании семантического ядра сайта и отдельных веб-страниц, имеет смысл закладывать не просто мерцающие, но даже нулевые запросы – те, для которых Яндекс.Вордстат или планировщик Google показывают значение частоты ноль. Во-первых, обработка запросов данными системами на самом деле является статистической, так что формальный ноль – это не всегда ноль реальный. А во-вторых, если вы двигаете новую тему и считаете, что по ней должны появиться новые запросы, в т.ч. случайные, – их безусловно необходимо закладывать в семантическое ядро сайта.

Закладывать в семантическое ядро означает формировать структуру из ключевых слов и фраз, которая должна соответствовать структуре сайта (иерархии разделов и страниц). На самом сайте это воплощается в том, что определённые ключи (вхождения запросов) закладываются в текстовый контент определённых веб-страниц. Таким образом, чем богаче отдельная страница и сайт в целом насыщены точными по смыслу (релевантными), но при этом разнообразными НЧ-ключами, тем легче обеспечить максимальный по объёму и по релевантности трафик на сайт из поиска.

В этом и состоит простой принцип SEO-продвижения по «хвосту» («шлейфу»). И основная задача в данном случае заключается именно в создании соответствующего контента на сайте – текстов, предельно насыщенных разнообразными релевантными НЧ/сНЧ-ключами и обладающих общей высокой релевантностью теме отдельной веб-страницы, сайта в целом, а также интересу (интенту) пользователей.

Значение частотности для контекстной рекламы

Принципиально оно то же, что и для SEO. Только в случае контекстной рекламы работа с запросами (ключами) разной частоты имеет быстрое и гораздо более конкретное выражение в цифрах, в т.ч. денежное выражение.

Как сказано выше, в контекстной рекламе работает общее правило: чем выше частота запроса, тем выше его стоимость (CPC). На стоимость объявления по данному запросу также влияет и положение объявления (выше, ниже прочих объявлений, первая или вторая страница выдачи и т.д.), – но в целом именно стоимость запросов, зависящая от их частоты, является базовым фактором, определяющим стоимость запроса и рекламного объявления по нему.

Соответственно, если заложить в рекламу ВЧ-запрос, он даст большой трафик на сайт. Но, во-первых, бюджет такой рекламы будет очень высоким из-за высокой стоимости запроса. А во-вторых, трафик по этому запросу будет очень низкоспецифичным, т.к. ВЧ-запросы, как правило, имеют широкий смысл (см. выше). Это значит, что очень дорогая контекстная реклама даст очень низкоспецифичный трафик, а значит – низкий уровень продаж и, соответственно, низкий или даже отрицательный возврат инвестиций (ROI – return of investment). На языке специалистов по контекстной рекламе (таргетологов) это и называется «слить деньги на рекламу».

Поэтому выигрышной является стратегия построение контекстной рекламы на основе НЧ и даже сНЧ, мерцающих и случайных запросов. Да, таких запросов в рекламную кампанию может быть заложено очень много – сотни и даже тысячи, чтобы суммарно обеспечить по ним хороший трафик на сайт. Но, во-первых, из-за очень низкой стоимости таких запросов бюджет рекламной кампании в целом будет невысоким. А во-вторых, в силу высокой специфичности трафик по таким запросам будет давать высокий уровень продаж, т.е. обеспечивать высокий ROI рекламы. О такой рекламе говорят, что она высококонверсионная.

В целом же, оперируя конкретными запросами и связанными с ними конкретными показателями, в т.ч. финансовыми (CPC, средний чек, конверсия переходов в продажи и др.), можно довольно точно и выгодно оптимизировать рекламную кампанию – так, чтобы она давала необходимый профит (хороший ROI). И в отличие от SEO этот процесс занимает гораздо меньше времени (за несколько дней можно провести надлежащую оптимизацию рекламы) и опирается на конкретные показатели (KPI – key performance indicators).

Таким образом, параметр частотности поисковых запросов в контекстной рекламе является весьма конкретным (формализуемым) и ключевым для бизнеса (определяющим эффективность рекламы).

Изменения частоты поисковых запросов во времени

Это явление характерно для сезонных и событийных запросов. Подробнее они разбираются в соответствующих статьях Глоссария (см. ссылки ниже).

Здесь же кратко отметим, что для сезонных запросов их частота периодически колеблется от года к году в зависимости от времени года, а точнее – от месяца. Связано это с периодическим изменением популярности темы в годовых периодах. Например, в летнее время возрастает спрос на продукцию и услуги, связанные, с летним отдыхом. Соответственно, частоты запросов по этой теме имеют максимум в летние или поздние весенние месяцы и минимум в зимние месяцы. Для «зимних» тем/товаров наблюдается обратная зависимость.

Амплитуда частоты запросов в определённых темах в течение года может достигать десятков раз. Это можно отчётливо видеть, если выбрать в сервисе Яндекс.Вордастат опцию «история запроса», которая показывает изменения частоты поискового запроса за последние 12 месяцев, в т.ч. наглядно на графике. Так что этот инструмент является очень полезным для маркетологов, поскольку фактически позволяет прогнозировать изменение спроса в течение года в определённой рыночной нише – вплоть до спроса на конкретные товары и услуги в конкретных регионах в конкретные месяцы.

Изменение частоты характерно и для так называемых событийных запросов, когда их количество в поиске может буквально взлетать с нуля и до очень больших значений с наступлением какого-то события: олимпиады, чемпионата мира по футболу, президентских выборов, крупных политических форумов, сильно распиаренной рекламной кампании и т.д. Для некоторых событий взлёт частоты запросов также можно прогнозировать и, соответственно, планировать под них коммерческую деятельность – зарабатывать на событиях.

Частотность и конкурентность запросов

Наряду с частотность для поисковых запросов также выделяют понятие (параметр) конкурентность, или конкуренция по запросу. С одной стороны, оно вроде бы имеет больший практический смысл для бизнеса, т.к. подразумевает конкурентный фон, на котором предполагается продвигать сайт в определённой теме и по определённому запросу. С другой же стороны, этот параметр гораздо менее формализуем, т.е. менее понятен, чем частотность.

Аналогично частотности также выделяют

• высоко-,
• средне- и
• низкоконкурентные запросы. 

Под самой же конкуренцией для запроса понимают количество по нему веб-страниц в ТОПе поисковой выдачи. Если страниц много – конкуренция по запросу высокая (ВК), если мало – низкая (НК), если что-то между «много» и «мало» – средняя (СК). Как понятно, эти слова (много, мало, средне) по сути ни о чём – и сами по себе, и потому что понятие «ТОП» поисковой выдачи является неясным (ТОП3, ТОП5, ТОП10, ТОП20 и т.д.), и потому что конкуренция по запросам сильно зависит от темы, да и вообще – потому что для параметра конкурентность в принципе отсутствуют цифры (для частотности они хотя бы есть).

Всё это делает работу с этим понятием – ориентацию на него – очень сложной. И, как уже сказано, конкурентность запросов во многом зависит от темы, по которой сайт продвигается в поиске.

Однако параметр конкурентности запроса применим не только к SEO, но и к контекстной рекламе. Общий принцип тот же: количество конкурентных ссылок по данному запросу – в данном случае конкурентных рекламных, а не поисковых ссылок. Поскольку работа с контекстной рекламой в целом формализуется гораздо лучше, чем SEO, использовать параметр конкурентности по запросу в контекстной рекламе также проще. Подробнее соответствующие вопросы рассматриваются в соответствующей статье Глоссария (см. ссылки ниже).

Дополнительно по теме – см. статьи Ключевые слова / фразы, Вхождения, Семантическое ядро, Определённые и неопределённые поисковые запросы, Конкурентность поисковых запросов, Контекстная реклама.

Полная классификация запросов представлена в статье Поисковые запросы.

По всем соответствующим практическим вопросам мы рекомендуем Вам обращаться в нашу компанию. Наши профессиональные специалисты не только дадут Вам подробные консультации, но и возьмут на себя полное продвижение Вашего веб-ресурса, включая SEO и контекстную рекламу.

Заказать продвижение сайта

Руководство по рейтингу | Rush Analytics

Рейтинги «Rush Analytics» — это инструмент по анализу поискового спроса и видимости сайтов ведущих компаний рынка.

Что мы отслеживаем

• % запросов в топ 10
• % Видимости
• Частотность “!”
• % видимости в группе (VIS)

Как считаются данные

На вкладке сайты:

• % запросов в топ 10 — означает % ключевых слов от общего количества запросов у данного домена (сайта) находиться в ТОП10.

• % Видимости — Видимость группы запросов (формула мегаиндекс) Q1, Q2, … Qn – коэффициент видимости запроса 1,2, … n в данной группе Q1 = 1, если позиция запроса от 1 до 3 включительно Q2 = 0,85, если позиция запроса 4. Q3 = 0,6, если позиция запроса 5. Q4 = 0,5, если позиция запроса от 6 до 7 включительно. Q5 = 0,3, если позиция запроса от 8 до 9 включительно. Q6 = 0,2, если позиция запроса 10. Q7 = 0,1, если позиция запроса от 11 до 15 включительно. Q8 = 0,05, если позиция запроса от 16 до 20 включительно. W1, W2 … Wn – точная частотность по wordstat этих запросов («!»)

На вкладке Ключевые слова:

• Частотность “!” — показывает долю частотности данного запроса по отношению к суммарной частотности всех запросов группы или проекта.

• VIS – видимость группы запросов в % — VIS = 100 (Q1W1 + Q2W2 + … + QnWn) / (W1 + W2 + … + Wn) Выводится на графике для каждой группы запросов, а также для всех запросов.

Частота сбора данных

• Частотность запросов обновляется один раз в месяц.
• Видимость запросов обновляется один раз в неделю.

Как использовать инструмент Рейтинг

Рейтинг видимости сайтов может помочь в анализе поискового спроса и видимости сайтов ведущих компаний рынка, а также он показывает частотность запросов по тематикам.

На главной странице рейтинга отображаются категории рейтинга и их подкатегории.

По умолчанию на карточке отображаются 4 подкатегории рейтинга, нажав кнопку “Смотреть рейтинг” откроется страница с рейтингом выбранной категории и там же отображается весь список подкатегорий.

На странице рейтинга выбранной категории по умолчанию расположен график видимости сайтов и таблица ведущих компаний на рынке.

Чтобы посмотреть семантическое ядро и частотность запросов, нажмите на кнопку “Ключевые слова”.

На графике сайтов отображаются данные лидеров рейтинга, вы можете выводить на график любые сайты из таблицы, отмечая их чек-боксами. На графике может быть отображено не более 10 сайтов одновременно.

Также есть возможность поменять поисковую систему. Мы собираем данные по поисковым системам Яндекс и Google.

На графике ключевых слов отображаются данные суммарной частотности запросов.

Перейти на рейтинг сайтов

Как правильно парсить подсказки?

Полное руководство по подбору семантического ядра

Была ли статья полезной?

3

0

Ограничения скорости — Graph API — Документация

Ограничение скорости — это количество вызовов API, которое приложение или пользователь может сделать в течение заданного периода времени. Если это ограничение превышено или превышены ограничения ЦП или общего времени, приложение или пользователь могут быть ограничены. Запросы API, сделанные регулируемым пользователем или приложением, завершатся ошибкой.

Для всех запросов API действуют ограничения скорости. На запросы Graph API и Instagram Basic Display API распространяются ограничения скорости платформы, в то время как на запросы Marketing API и Instagram Graph API распространяются ограничения скорости Business Use Case (BUC).

Запросы API страниц подпадают под ограничения скорости платформы или BUC, в зависимости от токена, используемого в запросе; запросы, сделанные с приложение или токены доступа пользователей подпадают под ограничения скорости платформы, в то время как запросы, сделанные с помощью системный пользователь или на токены доступа к странице распространяются ограничения на количество случаев использования в бизнесе.

Статистика использования ограничения скорости в реальном времени описывается в заголовках, которые включаются в большинство ответов API после того, как к конечной точке было сделано достаточное количество вызовов. Статистика использования ограничения скорости платформы также отображается на панели приложений. После достижения ограничения скорости любые последующие запросы, сделанные вашим приложением, будут завершаться с ошибкой, и API будет возвращать код ошибки до тех пор, пока не пройдет достаточно времени, чтобы количество вызовов упало ниже ограничения.

Если к запросу могут быть применены ограничения скорости как для платформы, так и для варианта использования в бизнесе, будут применены ограничения скорости BUC.

Ограничения скорости платформы

Ограничения скорости платформы отслеживаются на уровне отдельного приложения или пользователя, в зависимости от типа маркера, используемого в запросе.

Приложения

Запросы Graph API, сделанные с помощью токена доступа к приложению, учитываются в ограничении скорости этого приложения. Счетчик вызовов приложения — это количество вызовов, которые оно может сделать в течение скользящего окна в один час, и рассчитывается следующим образом:

Звонки в течение одного часа = 200 * Количество пользователей

Количество пользователей основано на количестве уникальных ежедневных активных пользователей приложения. В тех случаях, когда есть периоды медленного ежедневного использования, например, если ваше приложение имеет высокую активность по выходным, но низкую активность в будние дни, еженедельные и ежемесячные активные пользователи используются для расчета количества пользователей для вашего приложения. Приложения с высокой ежедневной активностью будут иметь более высокие ограничения скорости, чем приложения с низкой ежедневной активностью, независимо от фактического количества установок приложения.

Обратите внимание, что это ограничение не на пользователя, а на количество вызовов, сделанных вашим приложением. Любой отдельный Пользователь может совершать более 200 звонков в час с помощью вашего приложения, если общее количество звонков из вашего приложения не превышает максимальное количество для приложения. Например, если в вашем приложении 100 пользователей, ваше приложение может совершать 20 000 звонков в час. Однако ваша десятка самых активных пользователей может сделать 19 000 таких звонков.

Пользователи

Запросы Graph API, сделанные с помощью маркера доступа пользователя, учитываются в подсчете вызовов этого пользователя. Количество вызовов пользователя — это количество вызовов, которые пользователь может сделать в течение скользящего окна продолжительностью один час. Из соображений конфиденциальности мы не раскрываем фактическое количество звонков для пользователей.

Обратите внимание, что количество вызовов пользователя может быть распределено по нескольким приложениям. Например, пользователь может совершать вызовы X через App1 и вызовы Y через App2. Если X+Y превышает количество вызовов пользователя, этот пользователь будет ограничен по скорости. Это не обязательно означает, что какое-то приложение делает что-то не так; возможно, пользователь использует несколько приложений или неправильно использует API.

Заголовки

Конечные точки, которые получают достаточно запросов от вашего приложения, будут включать X-App-Usage или X-Ad-Account-Usage (для вызовов Ads API версии 3. 3 и более ранних) HTTP-заголовок в их ответах. Заголовок будет содержать строку в формате JSON, описывающую текущее использование ограничения скорости приложения.

Содержимое заголовка

Ключ	Значение Описание
call_count	Целое число, выражающее процент вызовов, сделанных вашим приложением за скользящий период в один час.
общее_процессорное время	Целое число, выражающее процент процессорного времени, выделенного для обработки запроса.
общее_время	Целое число, выражающее процент общего времени, отведенного на обработку запроса.

Общее время ЦП

Количество времени ЦП, которое требуется для обработки запроса. Когда total_cputime достигает 100, вызовы могут регулироваться.

Общее время

Время, необходимое для обработки запроса. Когда total_time достигает 100, вызовы могут регулироваться.

Пример значения заголовка X-App-Usage

 x-app-usage: {
    "call_count": 28, //Процент совершенных звонков
    "total_time": 25, // Процент от общего времени
    "total_cputime": 25 // Процент от общего времени процессора
} 

Пример значения заголовка X-Ad-Account-Usage

 x-ad-account-usage: {
    "acc_id_util_pct": 9.67 //Процент звонков, сделанных для этого рекламного аккаунта.
} 

Информационная панель

На информационной панели приложения отображается количество пользователей приложения с ограниченной скоростью, текущий процент использования ограничения скорости приложения и средняя активность за последние 7 дней. В карточке Ограничение скорости приложений нажмите Просмотреть подробности и наведите указатель мыши на любую точку на графике, чтобы просмотреть дополнительные сведения об использовании в данный конкретный момент. Поскольку использование зависит от объема вызовов, на этом графике могут отображаться не полные 7 дней. Приложения с большим количеством звонков будут показывать больше дней.

Коды ошибок

Когда приложение или пользователь достигли предела скорости, запросы, сделанные этим приложением или пользователем, будут выполнены, и API ответит кодом ошибки.

Коды ошибок дроссельной заслонки

Код ошибки	Описание
4	Указывает, что приложение, чей токен используется в запросе, достигло предела скорости.
17	Указывает, что пользователь, чей токен используется в запросе, достиг предела скорости.
17 с субкодом 2446079	Указывает, что токен, используемый в запросе Ads API версии 3.3 или более ранней, достиг предела скорости.
32	Указывает, что пользователь или приложение, чей токен используется в запросе API страниц, достигли предела скорости.
613	Указывает, что достигнут предел пользовательской скорости. Чтобы решить эту проблему, посетите вспомогательную документацию для конкретного API, который вы вызываете, чтобы узнать о настраиваемых ограничениях скорости, которые могут применяться.
613 с субкодом 1996	Указывает, что мы заметили непоследовательное поведение в объеме запросов API вашего приложения. Если вы внесли какие-либо недавние изменения, влияющие на количество запросов API, вы можете столкнуться с этой ошибкой.

Пример ответа

 {
  "ошибка": {
    "message": "(#32) Достигнут лимит запроса страницы",
    "тип": "OAuthException",
    "код": 32,
    "fbtrace_id": "Fz54k3GZrio"
  }
} 

Коды ограничения стабильности Facebook

Код ошибки	Описание
регулирование	Регулируется ли запрос или нет. Значения: Истина , Ложь
backend_qps	Первый коэффициент регулирования backend_qps . Поддерживаемые значения: fact_score — Фактический backend_qps этого приложения. Значение: 8 limit — backend_qps лимит этого приложения. Значение: 5 more_info —Запросы требуют обработки большого количества внутренних запросов. Мы предлагаем отправлять меньше запросов или упрощать запросы с более узкими временными диапазонами, меньшим количеством идентификаторов объектов и т. д.
показатель сложности	Второй коэффициент регулирования complex_score . Поддерживаемые значения: fact_score — Фактическая сложность_score этого приложения. Значение: 0,1 limit — complex_score лимит этого приложения. Значение: 0,01 more_info —Высокий уровень сложности означает, что ваши запросы очень сложные и запрашивают большие объемы данных. Мы предлагаем упростить запросы с более короткими временными диапазонами, меньшим количеством идентификаторов объектов, метрик или разбивок и так далее. Разбивайте большие сложные запросы на несколько запросов меньшего размера и распределяйте их между собой.

Передовой опыт

• Когда предел достигнут, прекратите выполнять вызовы API. Продолжая совершать звонки, вы продолжите увеличивать количество звонков, что увеличит время до того, как вызовы снова будут успешными.

• Равномерно распределите запросы, чтобы избежать скачков трафика.

• Используйте фильтры, чтобы ограничить размер ответа данных и избежать вызовов, которые запрашивают перекрывающиеся данные.

• Проверьте X-App-Usage HTTP-заголовок, чтобы увидеть, насколько ваше приложение близко к своему пределу, и когда вы можете возобновить выполнение вызовов, когда предел будет достигнут.

• Если пользователей ограничивают, убедитесь, что ваше приложение не является причиной. Сократите звонки пользователя или распределите звонки пользователя более равномерно во времени.

Ограничения скорости для вариантов использования в бизнесе

Все запросы Marketing API и запросы API страниц, сделанные с помощью маркера доступа к системе или странице, подчиняются ограничениям скорости для вариантов использования в бизнесе (BUC) и зависят от конечных точек, которые вы запрашиваете.

Статистика рекламы Управление рекламой Пользовательская аудитория API графов Instagram Ведущее поколение

Курьер страницы Управление рекламными эффектами Spark AR API управления бизнесом WhatsApp

Ads Insights

Запросы, сделанные вашим приложением к Ads Insights API, учитываются при подсчете вызовов приложения. Счетчик вызовов приложения — это количество вызовов, которые оно может сделать в течение скользящего окна в один час, и рассчитывается следующим образом:

Для приложений со стандартным и расширенным доступом:

Звонки в течение одного часа = 60 + 400 * Количество активных объявлений — 0,001 * Ошибки пользователя

Количество активных объявлений — это количество объявлений, которые в настоящее время показываются на рекламный аккаунт. User Errors — количество ошибок, полученных при вызове API. Чтобы получить более высокий предел скорости, вы можете подать заявку на функцию стандартного доступа к управлению рекламой.

Управление рекламой

Запросы, сделанные вашим приложением к API управления рекламой, учитываются при подсчете вызовов приложения. Счетчик вызовов приложения — это количество вызовов, которые оно может сделать в течение скользящего окна в один час, и рассчитывается следующим образом:

Для приложений со стандартным и расширенным доступом:

Звонки в течение часа = 300 + 40 * Количество активных объявлений

Количество активных объявлений — это количество объявлений для каждого рекламного аккаунта.

Пользовательская аудитория

Запросы, сделанные вашим приложением к API пользовательской аудитории, учитываются при подсчете вызовов приложения. Счетчик вызовов приложения — это количество вызовов, которое оно может сделать в течение скользящего окна в один час, и рассчитывается следующим образом, но никогда не превышает 700 000:

Для приложений со стандартным и расширенным доступом:

Звонки в течение одного часа = 5000 + 40 * Количество активных настраиваемых аудиторий

Количество активных настраиваемых аудиторий — это количество активных настраиваемых аудиторий для каждого рекламного аккаунта.

API-интерфейс Instagram Graph

Вызовы API-интерфейса Instagram Graph учитываются в подсчете вызовов вызывающего приложения. Счетчик вызовов приложения уникален для каждой пары приложение и пользователь приложения и представляет собой количество вызовов, сделанных приложением за скользящий 24-часовой интервал. Рассчитывается следующим образом:

Звонки в течение 24 часов = 4800 * Количество показов

Количество показов — это количество раз, когда любой контент из учетной записи Instagram пользователя приложения появлялся на экране человека в течение последних 24 часов.

Примечания

• API Instagram Basic Display использует ограничения скорости платформы.
• Business Discovery и поиск по хэштегам подпадают под ограничения скорости платформы.

LeadGen

Запросы, сделанные вашим приложением к API LeadGen, учитываются при подсчете вызовов приложения. Счетчик вызовов приложения — это количество вызовов, которое оно может сделать в течение непрерывного 24-часового окна, и рассчитывается следующим образом:

Звонки в течение 24 часов = 4800 * Сгенерированные лиды

Количество сгенерированных лидов — это количество лидов, созданных на Странице для этого рекламного аккаунта за последние 90 дней.

Платформа Messenger

Ограничения скорости для Платформы Messenger зависят от используемого API и, в некоторых случаях, от содержимого сообщения.

Messenger API

Запросы, сделанные вашим приложением, учитываются в количестве вызовов, которое ваше приложение может сделать за скользящий 24-часовой период, и рассчитывается следующим образом:

Звонки в течение 24 часов = 200 * количество вовлеченных пользователей

Количество вовлеченных пользователей — это количество людей, которым бизнес может отправлять сообщения через Messenger.

Messenger API для Instagram

Запросы, сделанные вашим приложением, учитываются в количестве вызовов, которое ваше приложение может сделать для учетной записи Instagram Professional и используемого API.

API разговоров

• Ваше приложение может совершать 2 звонка в секунду на аккаунт Instagram Professional

Send API

• Ваше приложение может выполнять 100 вызовов в секунду для каждой учетной записи Instagram Professional для сообщений, содержащих текст, ссылки, реакции и стикеры
• Ваше приложение может выполнять 10 вызовов в секунду для каждой учетной записи Instagram Professional для сообщений, содержащих аудио- или видеоконтент

API частных ответов

• Ваше приложение может выполнять 100 вызовов в секунду для каждой учетной записи Instagram Professional для частных ответов на комментарии Instagram Live
• Ваше приложение может совершать 750 вызовов в час на одну учетную запись Instagram Professional для частных ответов на комментарии к публикациям и роликам Instagram

Страницы

Ограничение скорости страницы может использовать логику ограничения скорости Платформы или BUC в зависимости от типа используемого токена. Любые вызовы API страниц, сделанные с использованием маркера доступа пользователя страницы или системы, используют приведенный ниже расчет ограничения скорости. Любые вызовы, сделанные с помощью токенов доступа приложений или пользователей, подлежат ограничениям скорости приложений или пользователей.

Запросы, сделанные вашим приложением к API страниц с использованием маркера доступа к странице или системного маркера доступа пользователя, учитываются при подсчете вызовов приложения. Количество вызовов приложения — это количество вызовов, которое оно может сделать в течение скользящего окна в один час, и рассчитывается следующим образом:

Звонки в течение одного часа = 4800 * Количество вовлеченных пользователей

Количество вовлеченных пользователей — это количество Пользователи, взаимодействовавшие со Страницей за 24 часа.

Запросы, сделанные вашим приложением к API страниц с использованием токена доступа пользователя или токена доступа к приложению, следуют логике ограничения скорости платформы.

Чтобы избежать проблем с ограничением скорости при использовании функции общего доступа к содержимому страницы, рекомендуется использовать маркер доступа системного пользователя.

Spark AR Commerce Effect Management

Запросы, сделанные вашим приложением к любым конечным точкам Commerce, учитываются в подсчете вызовов приложения. Счетчик вызовов приложения — это количество вызовов, которое оно может сделать в течение скользящего окна в один час, и рассчитывается следующим образом:

Звонки в течение одного часа = 200 + 40 * Количество каталогов

Количество каталогов — это общее количество каталогов во всех коммерческих учетных записях, управляемых вашим приложением.

API управления бизнесом WhatsApp

Запросы, сделанные вашим приложением к WhatsApp Business Management API, учитываются при подсчете вашего приложения. Счетчик вызовов приложения — это количество вызовов, которое оно может сделать в течение одного часа. Для следующего WhatsApp Business Management API ваше приложение по умолчанию может совершать 200 вызовов в час для каждого приложения и для каждой учетной записи WhatsApp Business (WABA). Для активных WABA с хотя бы одним зарегистрированным номером телефона ваше приложение может совершать 5000 вызовов в час на приложение для каждого активного WABA.

Тип вызова	Конечная точка
ПОЛУЧИТЬ	/ {идентификатор бизнес-аккаунта WhatsApp}
ПОЛУЧИТЬ , ОТПРАВИТЬ и УДАЛИТЬ	/{идентификатор бизнес-аккаунта WhatsApp}/assigned_users
ПОЛУЧИТЬ	/{whatsapp-business-account-id}/phone_numbers
ПОЛУЧИТЬ , ОТПРАВИТЬ и УДАЛИТЬ	/{идентификатор бизнес-аккаунта WhatsApp}/message_templates
ПОЛУЧИТЬ , ОТПРАВИТЬ и УДАЛИТЬ	/{идентификатор бизнес-аккаунта WhatsApp}/subscribed_apps
ПОЛУЧИТЬ	/{whatsapp-бизнес-аккаунт-на-номер-идентификатор-текущего-состояния}

Для следующих API кредитной линии ваше приложение может выполнять 5000 вызовов в час для каждого приложения.

Тип вызова	Конечная точка
ПОЛУЧИТЬ	/{идентификатор бизнеса}/extendedcredits
ПОЧТ	/{расширенный идентификатор кредита}/whatsapp_credit_sharing_and_attach
ПОЛУЧИТЬ и УДАЛИТЬ	/{идентификатор конфигурации-распределения}
ПОЛУЧИТЬ	/{расширенный идентификатор кредита}/owning_credit_allocation_configs

Чтобы избежать ограничения скорости, мы рекомендуем использовать веб-перехватчики для отслеживания обновлений статуса для шаблонов сообщений, телефонных номеров и WABA.

Для получения дополнительной информации о том, как узнать текущую скорость использования, см. Заголовки.

Все ответы API, сделанные вашим приложением, скорость которых ограничена с использованием логики BUC, включают HTTP-заголовок X-Business-Use-Case-Usage (для вызовов Ads API версии 3.3 и более ранних) со строкой в ​​формате JSON, которая описывает использование текущего ограничения скорости внесения. Этот заголовок может возвращать до 32 объектов за один вызов.

Содержимое заголовка X-Business-Use-Use Usage

Код ошибки	Значение Описание
бизнес-идентификатор	Идентификатор компании, связанной с токеном, выполняющим вызовы API.
call_count	Целое число, выражающее процент разрешенных вызовов, сделанных вашим приложением за скользящий период в один час.
расчетное_время_до_восстановления_доступа	Время в минутах, по истечении которого вызовы перестанут регулироваться.
общее_процессорное время	Целое число, выражающее процент процессорного времени, выделенного для обработки запроса.
общее_время	Целое число, выражающее процент общего времени, отведенного на обработку запроса.
тип	Тип применяемого ограничения скорости. Значение может быть одним из следующих: ads_insights , ads_management , custom_audience , instagram , Leadgen , messenger или страницы .

Общее время ЦП

Количество времени ЦП, которое требуется для обработки запроса. Когда total_cputime достигает 100, вызовы могут регулироваться.

Общее время

Время, необходимое для обработки запроса. Когда total_time достигает 100, вызовы могут быть отрегулированы.

Пример значения заголовка X-Business-Use-Usage-Usage

 x-business-use-case-usage: {
    "{идентификатор бизнес-объекта}": [
        {
            "type": "{rate-limit-type}", //Тип применяемой логики ограничения скорости BUC.
            "call_count": 100, // Процент совершенных звонков.
            "total_cputime": 25, // Процент от общего времени процессора, которое было использовано.
            "total_time": 25, // Процент от общего времени, которое было использовано.
            "estimated_time_to_regain_access": 19//Время в минутах для восстановления доступа.
        }
    ],
    "66782684": [
        {
            "тип": "управление_объявлениями",
            "колл_колл": 95,
            "total_cputime": 20,
            "общее_время": 20,
            "Estimated_time_to_regain_access": 0
        }
    ],
    "10153848260347724": [
        {
            "тип": "управление_объявлениями",
            "колл_счетчик": 97,
            "total_cputime": 23,
            "общее_время": 23,
            "Estimated_time_to_regain_access": 0
        }
    ],
. ..
} 

Коды ошибок

Когда ваше приложение достигает предела количества сценариев использования для бизнеса, последующие запросы, сделанные вашим приложением, завершатся с ошибкой, и API ответит кодом ошибки.

Код ошибки	Тип ограничения скорости BUC
код ошибки 80000, субкод ошибки 2446079	Статистика рекламы
код ошибки 80004, субкод ошибки 2446079	Управление рекламой
код ошибки 80003, субкод ошибки 2446079	Пользовательская аудитория
код ошибки 80002	Инстаграм
код ошибки 80005	ЛидГен
код ошибки 80006	Курьер
код ошибки 32	Вызовы страниц, выполненные с токеном доступа пользователя
код ошибки 80001	Вызов страницы, выполненный с помощью маркера доступа пользователя страницы или системы
код ошибки 17, субкод ошибки 2446079	V3. 3 и более старые Ads API, за исключением Ads Insights
код ошибки 80008	API управления бизнесом WhatsApp

Сообщение с кодом ошибки SampleError

 {
"ошибка": {
    "message": "(#80001) На эту учетную запись Страницы поступило слишком много вызовов. Подождите немного и повторите попытку. Для получения дополнительной информации см. https://developers.facebook.com/docs/graph-api/ обзор/ограничение скорости.",
    "тип": "OAuthException",
    "код": 80001,
    "fbtrace_id": "AmFGcW_3hwDB7qFbl_QdebZ"
    }
} 

Передовой опыт

• Когда предел будет достигнут, прекратите выполнять вызовы API. Продолжая совершать звонки, вы продолжите увеличивать количество звонков, что увеличит время до того, как вызовы снова будут успешными.
• Проверьте HTTP-заголовок X-Business-Use-Case-Usage , чтобы узнать, насколько ваша рекламная учетная запись близка к пределу и когда вы сможете возобновить звонки.
• Проверьте код ошибки и конечную точку API, чтобы подтвердить тип регулирования.
• Переключитесь на другие рекламные аккаунты и вернитесь к этому позже.
• Лучше создать новое объявление, чем менять уже существующие.
• Равномерно распределите запросы между двумя временными интервалами, чтобы избежать отправки трафика пиками.
• Используйте фильтры, чтобы ограничить размер ответа данных и избежать вызовов, которые запрашивают перекрывающиеся данные.

Часто задаваемые вопросы

Что мы считаем вызовом API?

Все вызовы учитываются в ограничениях скорости, а не только отдельные запросы API. Например, вы можете сделать один запрос API, указав несколько идентификаторов, но каждый идентификатор будет считаться одним вызовом API.

В следующей таблице показана эта концепция.

Примеры запросов	Количество вызовов API
GET https://graph. facebook.com/photos?ids=4 ПОЛУЧИТЬ https://graph.facebook.com/photos?ids=5 ПОЛУЧИТЬ https://graph.facebook.com/photos?ids=6	3
ПОЛУЧИТЬ https://graph.facebook.com/photos?ids=4,5,6	3

Мы настоятельно рекомендуем по возможности указывать несколько идентификаторов в одном запросе API, так как это повышает производительность ваших ответов API.

Я строю скребок, есть ли что-то еще, о чем мне следует беспокоиться?

Если вы создаете службу, которая очищает данные, ознакомьтесь с нашими условиями очистки.

Ограничения скорости — Graph API — Документация

Ограничение скорости — это количество вызовов API, которые приложение или пользователь может сделать в течение заданного периода времени. Если это ограничение превышено или превышены ограничения ЦП или общего времени, приложение или пользователь могут быть ограничены. Запросы API, сделанные регулируемым пользователем или приложением, завершатся ошибкой.

Для всех запросов API действуют ограничения скорости. На запросы Graph API и Instagram Basic Display API распространяются ограничения скорости платформы, в то время как на запросы Marketing API и Instagram Graph API распространяются ограничения скорости Business Use Case (BUC).

Запросы API страниц подпадают под ограничения скорости платформы или BUC, в зависимости от токена, используемого в запросе; запросы, сделанные с приложение или токены доступа пользователей подпадают под ограничения скорости платформы, в то время как запросы, сделанные с помощью системный пользователь или на токены доступа к странице распространяются ограничения на количество случаев использования в бизнесе.

Статистика использования лимита скорости в реальном времени описывается в заголовках, которые включаются в большинство ответов API после того, как к конечной точке было сделано достаточное количество вызовов. Статистика использования ограничения скорости платформы также отображается на панели приложений. После достижения ограничения скорости любые последующие запросы, сделанные вашим приложением, будут завершаться с ошибкой, и API будет возвращать код ошибки до тех пор, пока не пройдет достаточно времени, чтобы количество вызовов упало ниже ограничения.

Если к запросу можно применить ограничения скорости как для платформы, так и для бизнес-использования, будут применены ограничения скорости BUC.

Ограничения скорости платформы

Ограничения скорости платформы отслеживаются на уровне отдельного приложения или пользователя, в зависимости от типа маркера, используемого в запросе.

Приложения

Запросы Graph API, сделанные с помощью токена доступа к приложению, учитываются в ограничении скорости этого приложения. Счетчик вызовов приложения — это количество вызовов, которое оно может сделать в течение скользящего окна в один час, и рассчитывается следующим образом:

Звонки в течение одного часа = 200 * Количество пользователей

Количество пользователей основано на количестве уникальных ежедневных активных пользователей приложения. В тех случаях, когда есть периоды медленного ежедневного использования, например, если ваше приложение имеет высокую активность по выходным, но низкую активность в будние дни, еженедельные и ежемесячные активные пользователи используются для расчета количества пользователей для вашего приложения. Приложения с высокой ежедневной активностью будут иметь более высокие ограничения скорости, чем приложения с низкой ежедневной активностью, независимо от фактического количества установок приложения.

Обратите внимание, что это ограничение не на пользователя, а на количество вызовов, сделанных вашим приложением. Любой отдельный Пользователь может совершать более 200 звонков в час с помощью вашего приложения, если общее количество звонков из вашего приложения не превышает максимальное количество для приложения. Например, если в вашем приложении 100 пользователей, ваше приложение может совершать 20 000 звонков в час. Тем не менее, ваша десятка самых активных пользователей может составить 19000 из тех вызовов.

Пользователи

Запросы Graph API, сделанные с помощью маркера доступа пользователя, учитываются в подсчете вызовов этого пользователя. Количество вызовов пользователя — это количество вызовов, которые пользователь может сделать в течение скользящего окна продолжительностью один час. Из соображений конфиденциальности мы не раскрываем фактическое количество звонков для пользователей.

Обратите внимание, что количество вызовов пользователя может быть распределено по нескольким приложениям. Например, пользователь может совершать вызовы X через App1 и вызовы Y через App2. Если X+Y превышает количество вызовов пользователя, этот пользователь будет ограничен по скорости. Это не обязательно означает, что какое-то приложение делает что-то не так; возможно, пользователь использует несколько приложений или неправильно использует API.

Заголовки

Конечные точки, которые получают достаточно запросов от вашего приложения, будут включать в свои ответы HTTP-заголовок X-App-Usage или X-Ad-Account-Usage (для вызовов Ads API версии 3. 3 и более ранних). Заголовок будет содержать строку в формате JSON, описывающую текущее использование ограничения скорости приложения.

Содержимое заголовка

Ключ	Значение Описание
call_count	Целое число, выражающее процент вызовов, сделанных вашим приложением за скользящий период в один час.
общее_процессорное время	Целое число, выражающее процент процессорного времени, выделенного для обработки запроса.
общее_время	Целое число, выражающее процент общего времени, отведенного на обработку запроса.

Общее время ЦП

Количество времени ЦП, которое требуется для обработки запроса. Когда total_cputime достигает 100, вызовы могут регулироваться.

Общее время

Время, необходимое для обработки запроса. Когда total_time достигает 100, вызовы могут регулироваться.

Пример значения заголовка X-App-Usage

 x-app-usage: {
    "call_count": 28, //Процент совершенных звонков
    "total_time": 25, // Процент от общего времени
    "total_cputime": 25 // Процент от общего времени процессора
} 

Пример значения заголовка X-Ad-Account-Usage

 x-ad-account-usage: {
    "acc_id_util_pct": 9.67 //Процент звонков, сделанных для этого рекламного аккаунта.
} 

Информационная панель

На информационной панели приложения отображается количество пользователей приложения с ограниченной скоростью, текущий процент использования ограничения скорости приложения и средняя активность за последние 7 дней. В карточке Ограничение скорости приложений нажмите Просмотреть подробности и наведите указатель мыши на любую точку на графике, чтобы просмотреть дополнительные сведения об использовании в данный конкретный момент. Поскольку использование зависит от объема вызовов, на этом графике могут отображаться не полные 7 дней. Приложения с большим количеством звонков будут показывать больше дней.

Коды ошибок

Когда приложение или пользователь достигли предела скорости, запросы, сделанные этим приложением или пользователем, будут выполнены, и API ответит кодом ошибки.

Коды ошибок дроссельной заслонки

Код ошибки	Описание
4	Указывает, что приложение, чей токен используется в запросе, достигло предела скорости.
17	Указывает, что пользователь, чей токен используется в запросе, достиг предела скорости.
17 с субкодом 2446079	Указывает, что токен, используемый в запросе Ads API версии 3.3 или более ранней, достиг предела скорости.
32	Указывает, что пользователь или приложение, чей токен используется в запросе API страниц, достигли предела скорости.
613	Указывает, что достигнут предел пользовательской скорости. Чтобы решить эту проблему, посетите вспомогательную документацию для конкретного API, который вы вызываете, чтобы узнать о настраиваемых ограничениях скорости, которые могут применяться.
613 с субкодом 1996	Указывает, что мы заметили непоследовательное поведение в объеме запросов API вашего приложения. Если вы внесли какие-либо недавние изменения, влияющие на количество запросов API, вы можете столкнуться с этой ошибкой.

Пример ответа

 {
  "ошибка": {
    "message": "(#32) Достигнут лимит запроса страницы",
    "тип": "OAuthException",
    "код": 32,
    "fbtrace_id": "Fz54k3GZrio"
  }
} 

Коды ограничения стабильности Facebook

Код ошибки	Описание
регулирование	Регулируется ли запрос или нет. Значения: Истина , Ложь
backend_qps	Первый коэффициент регулирования backend_qps . Поддерживаемые значения: fact_score — Фактический backend_qps этого приложения. Значение: 8 limit — backend_qps лимит этого приложения. Значение: 5 more_info —Запросы требуют обработки большого количества внутренних запросов. Мы предлагаем отправлять меньше запросов или упрощать запросы с более узкими временными диапазонами, меньшим количеством идентификаторов объектов и т. д.
показатель сложности	Второй коэффициент регулирования complex_score . Поддерживаемые значения: fact_score — Фактическая сложность_score этого приложения. Значение: 0,1 limit — complex_score лимит этого приложения. Значение: 0,01 more_info —Высокий уровень сложности означает, что ваши запросы очень сложные и запрашивают большие объемы данных. Мы предлагаем упростить запросы с более короткими временными диапазонами, меньшим количеством идентификаторов объектов, метрик или разбивок и так далее. Разбивайте большие сложные запросы на несколько запросов меньшего размера и распределяйте их между собой.

Передовой опыт

• Когда предел достигнут, прекратите выполнять вызовы API. Продолжая совершать звонки, вы продолжите увеличивать количество звонков, что увеличит время до того, как вызовы снова будут успешными.

• Равномерно распределите запросы, чтобы избежать скачков трафика.

• Используйте фильтры, чтобы ограничить размер ответа данных и избежать вызовов, которые запрашивают перекрывающиеся данные.

• Проверьте X-App-Usage HTTP-заголовок, чтобы увидеть, насколько ваше приложение близко к своему пределу, и когда вы можете возобновить выполнение вызовов, когда предел будет достигнут.

• Если пользователей ограничивают, убедитесь, что ваше приложение не является причиной. Сократите звонки пользователя или распределите звонки пользователя более равномерно во времени.

Ограничения скорости для вариантов использования в бизнесе

Все запросы Marketing API и запросы API страниц, сделанные с помощью маркера доступа к системе или странице, подчиняются ограничениям скорости для вариантов использования в бизнесе (BUC) и зависят от конечных точек, которые вы запрашиваете.

Статистика рекламы Управление рекламой Пользовательская аудитория API графов Instagram Ведущее поколение

Курьер страницы Управление рекламными эффектами Spark AR API управления бизнесом WhatsApp

Ads Insights

Запросы, сделанные вашим приложением к Ads Insights API, учитываются при подсчете вызовов приложения. Счетчик вызовов приложения — это количество вызовов, которые оно может сделать в течение скользящего окна в один час, и рассчитывается следующим образом:

Для приложений со стандартным и расширенным доступом:

Звонки в течение одного часа = 60 + 400 * Количество активных объявлений — 0,001 * Ошибки пользователя

Количество активных объявлений — это количество объявлений, которые в настоящее время показываются на рекламный аккаунт. User Errors — количество ошибок, полученных при вызове API. Чтобы получить более высокий предел скорости, вы можете подать заявку на функцию стандартного доступа к управлению рекламой.

Управление рекламой

Запросы, сделанные вашим приложением к API управления рекламой, учитываются при подсчете вызовов приложения. Счетчик вызовов приложения — это количество вызовов, которые оно может сделать в течение скользящего окна в один час, и рассчитывается следующим образом:

Для приложений со стандартным и расширенным доступом:

Звонки в течение часа = 300 + 40 * Количество активных объявлений

Количество активных объявлений — это количество объявлений для каждого рекламного аккаунта.

Пользовательская аудитория

Запросы, сделанные вашим приложением к API пользовательской аудитории, учитываются при подсчете вызовов приложения. Счетчик вызовов приложения — это количество вызовов, которое оно может сделать в течение скользящего окна в один час, и рассчитывается следующим образом, но никогда не превышает 700 000:

Для приложений со стандартным и расширенным доступом:

Звонки в течение одного часа = 5000 + 40 * Количество активных настраиваемых аудиторий

Количество активных настраиваемых аудиторий — это количество активных настраиваемых аудиторий для каждого рекламного аккаунта.

API-интерфейс Instagram Graph

Вызовы API-интерфейса Instagram Graph учитываются в подсчете вызовов вызывающего приложения. Счетчик вызовов приложения уникален для каждой пары приложение и пользователь приложения и представляет собой количество вызовов, сделанных приложением за скользящий 24-часовой интервал. Рассчитывается следующим образом:

Звонки в течение 24 часов = 4800 * Количество показов

Количество показов — это количество раз, когда любой контент из учетной записи Instagram пользователя приложения появлялся на экране человека в течение последних 24 часов.

Примечания

• API Instagram Basic Display использует ограничения скорости платформы.
• Business Discovery и поиск по хэштегам подпадают под ограничения скорости платформы.

LeadGen

Запросы, сделанные вашим приложением к API LeadGen, учитываются при подсчете вызовов приложения. Счетчик вызовов приложения — это количество вызовов, которое оно может сделать в течение непрерывного 24-часового окна, и рассчитывается следующим образом:

Звонки в течение 24 часов = 4800 * Сгенерированные лиды

Количество сгенерированных лидов — это количество лидов, созданных на Странице для этого рекламного аккаунта за последние 90 дней.

Платформа Messenger

Ограничения скорости для Платформы Messenger зависят от используемого API и, в некоторых случаях, от содержимого сообщения.

Messenger API

Запросы, сделанные вашим приложением, учитываются в количестве вызовов, которое ваше приложение может сделать за скользящий 24-часовой период, и рассчитывается следующим образом:

Звонки в течение 24 часов = 200 * количество вовлеченных пользователей

Количество вовлеченных пользователей — это количество людей, которым бизнес может отправлять сообщения через Messenger.

Messenger API для Instagram

Запросы, сделанные вашим приложением, учитываются в количестве вызовов, которое ваше приложение может сделать для учетной записи Instagram Professional и используемого API.

API разговоров

• Ваше приложение может совершать 2 звонка в секунду на аккаунт Instagram Professional

Send API

• Ваше приложение может выполнять 100 вызовов в секунду для каждой учетной записи Instagram Professional для сообщений, содержащих текст, ссылки, реакции и стикеры
• Ваше приложение может выполнять 10 вызовов в секунду для каждой учетной записи Instagram Professional для сообщений, содержащих аудио- или видеоконтент

API частных ответов

• Ваше приложение может выполнять 100 вызовов в секунду для каждой учетной записи Instagram Professional для частных ответов на комментарии Instagram Live
• Ваше приложение может совершать 750 вызовов в час на одну учетную запись Instagram Professional для частных ответов на комментарии к публикациям и роликам Instagram

Страницы

Ограничение скорости страницы может использовать логику ограничения скорости Платформы или BUC в зависимости от типа используемого токена. Любые вызовы API страниц, сделанные с использованием маркера доступа пользователя страницы или системы, используют приведенный ниже расчет ограничения скорости. Любые вызовы, сделанные с помощью токенов доступа приложений или пользователей, подлежат ограничениям скорости приложений или пользователей.

Запросы, сделанные вашим приложением к API страниц с использованием маркера доступа к странице или системного маркера доступа пользователя, учитываются при подсчете вызовов приложения. Количество вызовов приложения — это количество вызовов, которое оно может сделать в течение скользящего окна в один час, и рассчитывается следующим образом:

Звонки в течение одного часа = 4800 * Количество вовлеченных пользователей

Количество вовлеченных пользователей — это количество Пользователи, взаимодействовавшие со Страницей за 24 часа.

Запросы, сделанные вашим приложением к API страниц с использованием токена доступа пользователя или токена доступа к приложению, следуют логике ограничения скорости платформы.

Чтобы избежать проблем с ограничением скорости при использовании функции общего доступа к содержимому страницы, рекомендуется использовать маркер доступа системного пользователя.

Spark AR Commerce Effect Management

Запросы, сделанные вашим приложением к любым конечным точкам Commerce, учитываются в подсчете вызовов приложения. Счетчик вызовов приложения — это количество вызовов, которое оно может сделать в течение скользящего окна в один час, и рассчитывается следующим образом:

Звонки в течение одного часа = 200 + 40 * Количество каталогов

Количество каталогов — это общее количество каталогов во всех коммерческих учетных записях, управляемых вашим приложением.

API управления бизнесом WhatsApp

Запросы, сделанные вашим приложением к WhatsApp Business Management API, учитываются при подсчете вашего приложения. Счетчик вызовов приложения — это количество вызовов, которое оно может сделать в течение одного часа. Для следующего WhatsApp Business Management API ваше приложение по умолчанию может совершать 200 вызовов в час для каждого приложения и для каждой учетной записи WhatsApp Business (WABA). Для активных WABA с хотя бы одним зарегистрированным номером телефона ваше приложение может совершать 5000 вызовов в час на приложение для каждого активного WABA.

Тип вызова	Конечная точка
ПОЛУЧИТЬ	/ {идентификатор бизнес-аккаунта WhatsApp}
ПОЛУЧИТЬ , ОТПРАВИТЬ и УДАЛИТЬ	/{идентификатор бизнес-аккаунта WhatsApp}/assigned_users
ПОЛУЧИТЬ	/{whatsapp-business-account-id}/phone_numbers
ПОЛУЧИТЬ , ОТПРАВИТЬ и УДАЛИТЬ	/{идентификатор бизнес-аккаунта WhatsApp}/message_templates
ПОЛУЧИТЬ , ОТПРАВИТЬ и УДАЛИТЬ	/{идентификатор бизнес-аккаунта WhatsApp}/subscribed_apps
ПОЛУЧИТЬ	/{whatsapp-бизнес-аккаунт-на-номер-идентификатор-текущего-состояния}

Для следующих API кредитной линии ваше приложение может выполнять 5000 вызовов в час для каждого приложения.

Тип вызова	Конечная точка
ПОЛУЧИТЬ	/{идентификатор бизнеса}/extendedcredits
ПОЧТ	/{расширенный идентификатор кредита}/whatsapp_credit_sharing_and_attach
ПОЛУЧИТЬ и УДАЛИТЬ	/{идентификатор конфигурации-распределения}
ПОЛУЧИТЬ	/{расширенный идентификатор кредита}/owning_credit_allocation_configs

Чтобы избежать ограничения скорости, мы рекомендуем использовать веб-перехватчики для отслеживания обновлений статуса для шаблонов сообщений, телефонных номеров и WABA.

Для получения дополнительной информации о том, как узнать текущую скорость использования, см. Заголовки.

Все ответы API, сделанные вашим приложением, скорость которых ограничена с использованием логики BUC, включают HTTP-заголовок X-Business-Use-Case-Usage (для вызовов Ads API версии 3.3 и более ранних) со строкой в ​​формате JSON, которая описывает использование текущего ограничения скорости внесения. Этот заголовок может возвращать до 32 объектов за один вызов.

Содержимое заголовка X-Business-Use-Use Usage

Код ошибки	Значение Описание
бизнес-идентификатор	Идентификатор компании, связанной с токеном, выполняющим вызовы API.
call_count	Целое число, выражающее процент разрешенных вызовов, сделанных вашим приложением за скользящий период в один час.
расчетное_время_до_восстановления_доступа	Время в минутах, по истечении которого вызовы перестанут регулироваться.
общее_процессорное время	Целое число, выражающее процент процессорного времени, выделенного для обработки запроса.
общее_время	Целое число, выражающее процент общего времени, отведенного на обработку запросов.
тип	Тип применяемого ограничения скорости. Значение может быть одним из следующих: ads_insights , ads_management , custom_audience , instagram , Leadgen , messenger или страницы .

Общее время ЦП

Количество времени ЦП, которое требуется для обработки запроса. Когда total_cputime достигает 100, вызовы могут регулироваться.

Общее время

Время, необходимое для обработки запроса. Когда total_time достигает 100, вызовы могут быть отрегулированы.

Пример значения заголовка X-Business-Use-Usage-Usage

 x-business-use-case-usage: {
    "{идентификатор бизнес-объекта}": [
        {
            "type": "{rate-limit-type}", //Тип применяемой логики ограничения скорости BUC.
            "call_count": 100, // Процент совершенных звонков.
            "total_cputime": 25, // Процент от общего времени процессора, которое было использовано.
            "total_time": 25, // Процент от общего времени, которое было использовано.
            "estimated_time_to_regain_access": 19//Время в минутах для восстановления доступа.
        }
    ],
    "66782684": [
        {
            "тип": "управление_объявлениями",
            "колл_колл": 95,
            "total_cputime": 20,
            "общее_время": 20,
            "Estimated_time_to_regain_access": 0
        }
    ],
    "10153848260347724": [
        {
            "тип": "управление_объявлениями",
            "колл_счетчик": 97,
            "total_cputime": 23,
            "общее_время": 23,
            "Estimated_time_to_regain_access": 0
        }
    ],
. ..
} 

Коды ошибок

Когда ваше приложение достигает предела количества сценариев использования для бизнеса, последующие запросы, сделанные вашим приложением, завершатся с ошибкой, и API ответит кодом ошибки.

Код ошибки	Тип ограничения скорости BUC
код ошибки 80000, субкод ошибки 2446079	Статистика рекламы
код ошибки 80004, субкод ошибки 2446079	Управление рекламой
код ошибки 80003, субкод ошибки 2446079	Пользовательская аудитория
код ошибки 80002	Инстаграм
код ошибки 80005	ЛидГен
код ошибки 80006	Курьер
код ошибки 32	Вызовы страниц, выполненные с токеном доступа пользователя
код ошибки 80001	Вызов страницы, выполненный с помощью маркера доступа пользователя страницы или системы
код ошибки 17, субкод ошибки 2446079	V3. 3 и более старые Ads API, за исключением Ads Insights
код ошибки 80008	API управления бизнесом WhatsApp

Сообщение с кодом ошибки SampleError

 {
"ошибка": {
    "message": "(#80001) На эту учетную запись Страницы поступило слишком много вызовов. Подождите немного и повторите попытку. Для получения дополнительной информации см. https://developers.facebook.com/docs/graph-api/ обзор/ограничение скорости.",
    "тип": "OAuthException",
    "код": 80001,
    "fbtrace_id": "AmFGcW_3hwDB7qFbl_QdebZ"
    }
} 

Передовой опыт

• Когда предел будет достигнут, прекратите выполнять вызовы API. Продолжая совершать звонки, вы продолжите увеличивать количество звонков, что увеличит время до того, как вызовы снова будут успешными.
• Проверьте HTTP-заголовок X-Business-Use-Case-Usage , чтобы узнать, насколько ваша рекламная учетная запись близка к пределу и когда вы сможете возобновить звонки.
• Проверьте код ошибки и конечную точку API, чтобы подтвердить тип регулирования.
• Переключитесь на другие рекламные аккаунты и вернитесь к этому позже.
• Лучше создать новое объявление, чем менять уже существующие.
• Равномерно распределите запросы между двумя временными интервалами, чтобы избежать отправки трафика пиками.
• Используйте фильтры, чтобы ограничить размер ответа данных и избежать вызовов, которые запрашивают перекрывающиеся данные.

Часто задаваемые вопросы

Что мы считаем вызовом API?

Все вызовы учитываются в ограничениях скорости, а не только отдельные запросы API. Например, вы можете сделать один запрос API, указав несколько идентификаторов, но каждый идентификатор будет считаться одним вызовом API.

В следующей таблице показана эта концепция.

Примеры запросов	Количество вызовов API
GET https://graph. Добавить комментарий Отменить ответ Ваш адрес email не будет опубликован. Обязательные поля помечены * Комментарий * Имя * Email * Сайт