Перейти до основного вмісту
Важлива частина інтеграції Business Plan або Launch Plan полягає у створенні нових облікових записів профілів в Ayrshare для Ваших користувачів або клієнтів та наданні Вашим користувачам можливості зв’язувати свої соціальні мережі через сторінку соціального зв’язування. Кожен із Ваших користувачів налаштовується як user profile Ayrshare. User profile отримує одне підключення до кожної соціальної мережі.
Це стандартний спосіб онбордингу клієнтів. Ваші користувачі під’єднують свої власні соціальні облікові записи через сторінку під’єднання з white-labeled JWT URL, описану нижче — вони ніколи не входять в Ayrshare і ніколи не торкаються Вашої панелі керування. Панель керування зарезервована для Вашої внутрішньої команди (створення та керування профілями, тестування та публікація від імені клієнта).

​
Робочий процес інтеграції

Щоб інтегрувати Ayrshare у Ваш додаток, Вам потрібно зробити два виклики API:
  1. Викличте кінцеву точку Create Profiles, щоб створити новий профіль Ayrshare для Вашого користувача.
  2. Викличте кінцеву точку Generate JWT, щоб отримати JWT URL.
JWT URL дозволяє Вашому користувачу безпечно отримати доступ до сторінки соціального зв’язування через автентифікацію єдиного входу. Ви відображатимете цю сторінку в новій вкладці, вікні або view controller, щоб дозволити користувачам під’єднувати свої облікові записи соціальних мереж. Робочий процес під'єднання user profiles Після того, як Ваш користувач зв’яже свої облікові записи соціальних мереж, Ви зможете публікувати дописи, отримувати аналітику та керувати їхніми обліковими записами через API.
З міркувань безпеки платформи соціальних мереж вимагають від користувачів автентифікуватися через свій браузер, що не можна зробити через backend-виклики сервера. Це гарантує, що Ваші користувачі можуть безпечно під’єднувати свої облікові записи соціальних мереж, входячи безпосередньо на офіційній сторінці входу кожної платформи. Соціальні мережі обмежують автентифікацію так, щоб вона відбувалася лише через їхні авторизовані партнерські домени, такі як Ayrshare. Вони також блокують iFrames, що означає, що Ви не можете вбудувати або відобразити сторінку зв’язування Ayrshare в iFrame на Вашому сайті.

​
Створення User Profile Ayrshare

​
Створення профілю за допомогою API

Коли новий користувач реєструється у Вашій системі або коли Ваш клієнт клацає посилання на соціальну мережу у Вашому додатку, створіть новий обліковий запис профілю Ayrshare, викликавши RESTful-кінцеву точку /profiles/create-profile або використовуючи пакети NPM чи PyPi.

Profiles

З цього виклику буде повернутий PROFILE KEY Вашого користувача. Цей ключ буде використано для публікації від імені Вашого користувача та керування їхнім обліковим записом. Ви повинні зберігати його в безпечному місці.

​
Створення профілю за допомогою Панелі керування (внутрішня команда)

Ваша внутрішня команда також може створювати User Profiles безпосередньо з Developer Dashboard — корисно для тестування, ручного онбордингу профілю або одноразового адміністрування. Це командний інструмент, а не клієнтський потік: Вашим клієнтам ніколи не надається доступ до панелі керування, і вони завжди онбордяться через сторінку під’єднання JWT URL. Для виробничого онбордингу створюйте профілі програмно за допомогою API, щоб кожен новий користувач автоматично надавався.

Керування User Profiles у Панелі керування

​
Пакет інтеграції

Під час Вашого онбордингу як клієнта Business Plan або Launch Plan Ви отримали персоналізований пакет інтеграції з важливою інформацією про налаштування та домен, приклади викликів кінцевих точок тощо. Будь ласка, перевірте у Вашого головного власника облікового запису цю інформацію. Ви також можете отримати або скинути пакет інтеграції в панелі керування на сторінці API. Обов’язково спочатку перемкніться на Ваш Primary Profile. Ayrshare Integration Package

​
Єдиний вхід з JWT-автентифікацією

Ayrshare використовує JWT (JSON Web Token) для автентифікації Вашого користувача та виконання єдиного входу на сторінку соціального зв’язування. JWT — це безпечний механізм для передачі цифрово підписаної інформації, що дозволяє Ayrshare автентифікувати Вас та Вашого користувача.

​
Генерація JWT

Ваш додаток створить JWT, що складається з Вашого API-ключа, Profile Key користувача та кількох інших параметрів. Це буде підписано Вашим 1024-бітним приватним ключем.
JWT-токен дійсний протягом 5 хвилин. Для більшого часу закінчення терміну див. Max Pack.
Будь ласка, використовуйте кінцеву точку Generate JWT, щоб Ayrshare створив токен та URL соціального зв’язування. Відкрийте URL соціального зв’язування в новій вкладці або вікні, дозволяючи Вашим користувачам легко зв’язати свої соціальні мережі.
JWT URL — це рекомендований шлях онбордингу для кожного клієнта. Ваші користувачі автентифікуються безпосередньо в кожній соціальній мережі самостійно — Ви ніколи не збираєте та не зберігаєте їхні соціальні облікові дані. Якщо Вашій команді потрібно вручну зв’язати обліковий запис під час тестування, Ви можете зробити це з панелі керування, але це внутрішня зручність, а не спосіб онбордингу клієнтів.

​
White-Label сторінки Connect Accounts

Оскільки сторінка під’єднання, відкрита JWT URL, є єдиним інтерфейсом Ayrshare, який Ваші користувачі коли-небудь бачать, Ви повинні брендувати її як власну. Додайте свій логотип та користувацькі заголовки, оберіть, які соціальні мережі з’являються, встановіть мову сторінки та використовуйте свої власні посилання допомоги — а з Max Pack, застосуйте повний користувацький CSS-файл, favicon, заголовок сторінки та footer. Ці параметри налаштовуються один раз Вашою командою з Primary Profile і застосовуються до кожного JWT URL, який Ви генеруєте.

White-Label сторінки Connect Accounts

Перегляньте всі параметри брендингу та кастомізації для сторінки під’єднання.

​
Автоматичний вихід із сесії профілю

Як автоматично вийти з активної сесії профілюЯкщо профіль вже авторизовано, надсилання JWT іншого профілю не переключить профілі. Це зроблено для швидшого досвіду для вже авторизованих користувачів. При тестуванні виходьте з поточного профілю перед виконанням виклику SSO з іншим профілем. Авторизовані профілі залишаються авторизованими, поки явно не виходять.Однак, якщо у Вас є бізнес-потреба, наприклад, Ваші користувачі мають кілька профілів, до яких часто отримують доступ, або Ви хочете провести тестування, включіть параметр URL в SSO URL:logout=trueНаприклад:https://profile.ayrshare.com?domain=[domain id]&jwt=[jwt token]&logout=trueЦе примусово виходить, а потім входить у новий профіль.Будь ласка, також див. кінцеву точку Generate JWT, щоб автоматично додати logout.Попередження: Використання автоматичного виходу спричиняє затримку продуктивності для Вашого користувача, тому, якщо це не потрібно, ми пропонуємо не примушувати вихід і не використовувати його у виробництві.

​
Відкриття та закриття URL соціального зв’язування

Сторінка Social Accounts має кнопку “Close”, яка закриває вікно і повертає Вашого користувача на Ваш сайт.

​
Відкриття URL соціального зв’язування

При відкритті URL соціального зв’язування ми рекомендуємо використовувати функцію JavaScript window.open() замість anchor href. Кнопка “Close” використовує JavaScript, щоб закрити вікно, і більшість браузерів дозволяє закривати лише вікна, відкриті через скрипт. Ви можете використовувати наступний зразок коду на Вашому сайті для запуску вікна соціального зв’язування.
Window Open
або
Window Open Function
Ви можете керувати кнопкою “Close”, щоб або перенаправити вкладку соціального зв’язування на сторінку за Вашим вибором, або перенаправити оригінальну вкладку/вікно opener і закрити вкладку соціального зв’язування. Це можна зробити за допомогою параметра redirect та додавання origin=true до параметрів запиту URL перенаправлення. Для отримання додаткових деталей див. кінцеву точку Generate JWT.

​
Перенаправлення при закритті

Крім того, якщо Ви хочете, щоб кнопка Close перенаправляла назад на Вашу сторінку (часто корисно на мобільних), передайте GET-параметр redirect як URL-закодований рядок, що починається з https. Для отримання додаткових деталей див. параметри кінцевої точки Generate JWT.
JWT URL
Перенаправлення буде збережено для цього профілю і використано в подальших викликах SSO, навіть якщо параметр redirect не передається. Щоб скинути кнопку Close назад на close, передайте параметр redirect=null.

​
Додаткова інформація

​
Сповіщення про зв’язування або від’єднання користувача

Коли користувач зв’язує або від’єднує соціальну мережу, Ви можете отримати сповіщення через webhook. Для отримання додаткової інформації див. сторінку Social Action Webhooks. Ви також можете використовувати кінцеву точку user, щоб отримати під’єднані соціальні мережі для user profile.

​
Кілька наборів соціальних облікових записів

​
Огляд

Кожен User Profile має набір облікових записів соціальних мереж і може зробити одне підключення до кожної соціальної мережі. Якщо Ваші користувачі або клієнти мають кілька наборів облікових записів соціальних мереж, наприклад, дві сторінки Facebook, два облікові записи Instagram та два канали YouTube, Ви можете керувати цими кількома наборами облікових записів соціальних мереж, виконавши наступні кроки:
  1. Створіть кілька User Profiles - Створіть окремі User Profiles у системі Ayrshare для кожного набору соціальних облікових записів, якими Вашому користувачу або клієнту потрібно керувати.
  2. Зберігайте унікальні Profile Keys - Кожен User Profile матиме свій унікальний Profile Key, повернутий з кінцевої точки створення User Profile.
  3. Позначте свої профілі - Задайте назву або позначте тегами кожен User Profile, щоб чітко ідентифікувати, з якими обліковими записами соціальних мереж вони пов’язані (наприклад, “Facebook Page A” та “Facebook Page B”).
  4. Зіставте у Вашій базі даних - У Вашій власній системі пов’яжіть усі відповідні Profile Keys з відповідним користувачем або клієнтом.
  5. Використовуйте відповідний Profile Key - При публікації контенту або отриманні аналітики для конкретного соціального облікового запису, використовуйте Profile Key, пов’язаний з цим обліковим записом. Наприклад, щоб опублікувати на Facebook Page A, використовуйте Profile Key User Profile, під’єднаного до Facebook Page A.

​
Приклад

Розглянемо практичний сценарій для кількох клієнтських облікових записів:
  • Клієнт: Мережа ресторанів Joe’s з двома локаціями
Joe потребує окремих облікових записів соціальних мереж для кожної локації ресторану: Локація ресторану 1:
  • Facebook Page: “Joe’s Downtown Bistro”
  • Instagram: @joesdowntownbistro
  • LinkedIn: бізнес-сторінка Joe’s Downtown Bistro
Локація ресторану 2:
  • Facebook Page: “Joe’s Seaside Grill”
  • Instagram: @joesseasidegrill
  • LinkedIn: бізнес-сторінка Joe’s Seaside Grill
Рішення реалізації:
  1. Створіть два окремих User Profiles в Ayrshare:
  • User Profile 1: З назвою “Joe’s Downtown Bistro Accounts”
  • User Profile 2: З назвою “Joe’s Seaside Grill Accounts”
  1. Під’єднайте відповідні соціальні облікові записи до кожного профілю:
  • Profile 1: Зв’язує Facebook, Instagram та LinkedIn Downtown Bistro
  • Profile 2: Зв’язує Facebook, Instagram та LinkedIn Seaside Grill
  1. Зберігайте обидва Profile Keys у Вашій базі даних, пов’язуючи їх з обліковим записом Joe:
  2. При публікації спеціального оновлення меню для локації Downtown використовуйте Profile Key 1 у викликах API. При публікації про промоцію морепродуктів у локації Seaside використовуйте Profile Key 2.
Створюючи кілька User Profiles, задаючи їх назви або теги належним чином і пов’язуючи їх з одним користувачем або клієнтом у Вашій системі, Ви можете керувати їхніми кількома обліковими записами соціальних мереж на одних і тих самих платформах за допомогою Ayrshare. Цей підхід дозволяє цілеспрямовану публікацію та отримання аналітики для кожного конкретного облікового запису.

​
Наступні кроки

Для отримання більше деталей про досвід користувача див. тут:

User Integration

Після того, як Ваш користувач налаштує свої посилання на соціальні мережі, Ви зможете почати публікувати від їхнього імені за допомогою кінцевих точок /post та /profile.

Post API

Profiles API