Социальные плагины: часто задаваемые вопросы

Кнопки "Нравится", "Поделиться" и "Отправить" доступны для веб-платформ, iOS и Android. Плагин "Страница" и встроенные публикации доступны только для веб-платформ.

• Веб-платформа: если вы используете социальные плагины на сайте, для получения ID приложения вам потребуется аккаунт разработчика Facebook.
• iOS и Android: если вы используете социальные плагины в приложении для Android или iOS, для получения ID приложения вам потребуется аккаунт разработчика Facebook.

• Веб-платформа: если вы используете социальные плагины на сайте, для получения ID приложения вам потребуется аккаунт разработчика Facebook.
• iOS и Android: если вы используете социальные плагины в приложении для Android или iOS, для получения ID приложения вам потребуется аккаунт разработчика Facebook.

• Веб-платформа: если вы используете социальные плагины на сайте, отправлять интеграции на проверку не нужно. Вы можете сразу начать использовать социальные плагины.
• iOS и Android: если вы используете социальные плагины в приложении для iOS или Android, вам потребуется отправить свою интеграцию кнопки "Нравится" на проверку (вкладка "Проверка приложения" на панели приложений).

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

Если вы используете HTML5- или XFBML-версию плагинов, укажите код языка при создании экземпляра библиотеки.

При загрузке SDK задайте для js.src свою локаль. Замените en_US своим языком, например fr_FR (французский язык (Франция)).

// Example 1:
'https://connect.facebook.net/fr_FR/sdk.js';

// Example 2:
js.src = "https://connect.facebook.net/fr_FR/sdk.js#xfbml=1&version=v2.6"; 

Список поддерживаемых локалей см. в файле Facebook Locales XML.

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

• Веб-платформа: если вы используете социальные плагины на сайте, отправлять интеграции на проверку не нужно. Вы можете сразу начать использовать социальные плагины.
• iOS и Android: если вы используете социальные плагины в приложении для iOS или Android, вам потребуется отправить свою интеграцию кнопки "Нравится" на проверку (вкладка "Проверка приложения" на панели приложений).

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

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

Предварительные действия

При разрешении того, к какому URL относится установка отметки "Нравится" или действие кнопки "Поделиться", Facebook разрешает канонический URL для загруженного URL. При загрузке URL краулер будет искать следующую информацию:

1. Код состояния HTTP 301 или 302 Redirect.
2. Использование тега og:url Open Graph на странице.
3. Использование rel=canonical согласно RFC 6596. Краулер Facebook поддерживает только контент, но не заголовки HTTP.

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

Все данные об отметках "Нравится" и кнопке "Поделиться" будут относиться к каноническому URL вместо загруженного.

Примеры

Подсказка. Чтобы узнать, что видит Facebook во время краулинга вашей страницы, воспользуйтесь отладчиком.

Контролируя канонический URL, вы можете переносить контент с одного URL на другой, сохраняя при этом количество отметок "Нравится" и публикаций. Для этого достаточно разрешить Facebook переходить на канонический URL вместо нового. Это можно сделать двумя способами:

Добавление к новому URL тега og:url, указывающего на исходный URL (рекомендуемый способ)

В новом URL следует включить ссылку на старый. Например, если ваш новый URL — https://example.com/new-url, а старый — https://example.com/old-url, в new-url следует включить следующий элемент кода:

<meta property="og:url" content="https://example.com/old-url" />

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

Для этого также требуется, чтобы старый URL возвращал документ с тегами Open Graph и отклик HTTP 200 (по крайней мере при загрузке краулером Facebook). Если вы хотите перенаправлять пользователей, переходящих по этому URL, отправляйте для них отклик HTTP 301, но исключите из их числа краулер Facebook. Старый URL должен содержать собственный тег og:url, который указывает на старый URL.

Информацию о том, как распознать краулер Facebook, см. в рекомендациях по публикации.

Этот способ работает и с rel=canonical, но предпочтительнее использовать og:url.

Перенаправление краулера Facebook на старый URL

Второй способ — перенаправление краулера Facebook на старый URL при каждом посещении нового. Как и в описанном выше способе, старый URL должен представлять собой действительный документ с заголовками Open Graph. Если вы хотите включить перенаправление для старого URL, убедитесь, что краулер Facebook не перенаправляется при посещении старого URL.

Встраивать можно только общедоступный контент. Если у публикации, Страницы или URL есть какие-либо ограничения по конфиденциальности, их нельзя встроить. Это касается кнопки "Нравится", плагина "Страница", встроенных публикаций и видео.

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

Обычную HTML-страницу контента, которому ставят отметку "Нравится" или которым делятся, можно сделать объектом Open Graph с помощью мета-тегов.

Если вы планируете использовать кнопки "Нравится", "Поделиться" или "Отправить" на страницах своего сайта, ознакомьтесь с рекомендациями, которые помогут обеспечить наилучший охват и эффективное представление вашей страницы на Facebook.

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

Когда пользователь переходит по ссылке из истории трансляции, настройка ref добавляет в URL перехода два параметра:

• fb_ref — параметр ref.
• fb_source — кнопки "Нравится" или "Поделиться". Содержит информацию о типе трансляции, в которой была нажата кнопка (home, profile, search, ticker, tickerdialog или other) и типе истории (oneline или multiline). Типы объединены в одну строку с помощью символа подчеркивания. Кнопка "Отправить": тип истории, для которой была нажата кнопка (message).

Пример:

http://www.facebook.com/l.php?fb_ref=top_left&fb_source=profile_oneline

Отслеживать эти параметры можно с помощью программного обеспечения для аналитики.

Если кнопка "Нравится", "Поделиться" или "Отправить" находится рядом с границей HTML-элемента, для которого CSS-свойство overflow имеет значение hidden, всплывающее окно при нажатии кнопки может перекрываться частично или полностью. Чтобы избежать этого, установите для свойства overflow любое значение, кроме hidden, например visible, scroll или auto.

Facebook необходимо выполнять скрапинг ссылок, которыми делятся на Facebook, чтобы определить, какую информацию показывать в предварительном просмотре ссылки на сайте Facebook.com или в приложении Facebook для iOS или Android. Скрапинг выполняется каждые 30 дней для обеспечения актуальности свойств ссылок. Скрапинг страницы, на которую публикуется ссылка, также выполняется, когда ее URL вводится в инструмент для отладки.

Facebook работает с заголовками кэша ваших URL. Заголовки Expires и Cache-Control просматриваются в заданном вами порядке. Но даже если вы укажете более длительный промежуток времени, Facebook будет проводить скрапинг вашей страницы каждые 30 дней.

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

facebookexternalhit/1.1 (+http://www.facebook.com/externalhit_uatext.php)

Да. Для этого укажите URL Страницы Facebook в настройке href кнопки.

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

Функция защиты добавляет ещё один этап в работу кнопки "Нравится". Когда достаточное количество различных пользователей подтвердит установки отметки "Нравится", этот этап исчезнет.

Это сумма следующих элементов:

• количество отметок "Нравится" для URL;
• количество раз, когда вашим URL поделились (включая копирование и вставку ссылки на Facebook);
• количество отметок "Нравится" и комментариев к историям Facebook, связанным с URL.

Код для отдельного отображения кнопки "Поделиться" можно найти в документации по ней.

Это сумма следующих элементов:

• количество отметок "Нравится" для URL;
• количество раз, когда вашим URL поделились (включая копирование и вставку ссылки на Facebook);
• количество отметок "Нравится" и комментариев к историям Facebook, связанным с URL.

Код для отдельного отображения кнопки "Поделиться" можно найти в документации по ней.

Да. Мы рекомендуем использовать кнопку "Поделиться", чтобы предоставить пользователям самый простой и удобный способ делиться контентом, но мы также предоставляем отдельный диалог, который можно запустить с помощью SDK JavaScript или ссылки URL. Ознакомьтесь с руководством по использованию диалога "Поделиться".

• Добавление знаков пунктуации (например, точек в конце предложения).
• Удаление лишних пробелов.
• Исправление правописание для сленга (пример для английского: plz исправляется на please).
• Добавление пробелов после знаков пунктуации (например, "Привет,Маша" исправляется на "Привет, Маша").
• Исправление распространенных грамматических ошибок (например, опечаток).

Включить грамматический фильтр можно в разделе настроек плагина.

Все комментарии, связанные с каким-либо URL, доступны с помощью API Graph. Выполните следующий запрос HTTP GET:

https://graph.facebook.com/v2.6/?fields=og_object{comments}
  &id=<YOUR_URL>
  &access_token=<YOUR_TOKEN>

Подробную информацию см. в руководстве по модерации комментариев. Если вам не удается настроить список модераторов с помощью метасвойства fb:admins, укажите ID fb:app_id и обновите список модераторов для приложения в настройках инструмента для модерации.