Chuyển đến nội dung chính
Một phần quan trọng của việc tích hợp Gói Business hoặc Gói Launch là tạo các tài khoản profile mới trong Ayrshare cho người dùng hoặc khách hàng của bạn và cho phép người dùng liên kết các mạng xã hội của họ với trang liên kết mạng xã hội. Mỗi người dùng của bạn được thiết lập như một profile người dùng Ayrshare. Một profile người dùng có một kết nối đến mỗi mạng xã hội.
Đây là cách chuẩn để onboard khách hàng. Người dùng của bạn kết nối tài khoản mạng xã hội của họ thông qua trang kết nối JWT URL được white-label được mô tả bên dưới — họ không bao giờ đăng nhập vào Ayrshare và không bao giờ chạm vào dashboard của bạn. Dashboard được dành cho đội nội bộ của bạn (tạo và quản lý profile, kiểm thử và đăng bài thay mặt cho khách hàng).

Quy trình Tích hợp

Để tích hợp Ayrshare vào ứng dụng của bạn, bạn sẽ cần thực hiện hai lệnh gọi API:
  1. Gọi điểm cuối Tạo Profile để tạo một profile Ayrshare mới cho người dùng của bạn.
  2. Gọi điểm cuối Tạo JWT để lấy một URL JWT.
URL JWT cho phép người dùng của bạn truy cập an toàn vào trang liên kết mạng xã hội thông qua xác thực đăng nhập một lần (single sign-on). Bạn sẽ hiển thị trang này trong tab, cửa sổ hoặc view controller mới để người dùng kết nối các tài khoản mạng xã hội của họ. Quy trình kết nối profile người dùng Sau khi người dùng của bạn liên kết các tài khoản mạng xã hội của họ, bạn sẽ có thể xuất bản bài đăng, lấy phân tích và quản lý tài khoản của họ thông qua API.
Vì lý do bảo mật, các nền tảng mạng xã hội yêu cầu người dùng xác thực thông qua trình duyệt của họ, điều không thể thực hiện thông qua các lệnh gọi máy chủ backend. Điều này đảm bảo người dùng của bạn có thể an toàn kết nối các tài khoản mạng xã hội của họ bằng cách đăng nhập trực tiếp với trang đăng nhập chính thức của mỗi nền tảng. Các mạng xã hội hạn chế xác thực chỉ diễn ra thông qua các miền đối tác được ủy quyền của họ, chẳng hạn như Ayrshare. Họ cũng chặn iFrame, điều này có nghĩa là bạn không thể nhúng hoặc hiển thị trang liên kết Ayrshare trong iFrame trên trang web của bạn.

Tạo một Profile Người dùng Ayrshare

Tạo Profile bằng API

Khi một người dùng mới đăng ký với hệ thống của bạn hoặc khi khách hàng của bạn nhấp vào liên kết mạng xã hội trong ứng dụng của bạn, hãy tạo một tài khoản profile Ayrshare mới bằng cách gọi điểm cuối RESTful /profiles/create-profile, hoặc sử dụng gói NPM hoặc PyPi.

Profile

Được trả về từ lệnh gọi này sẽ là PROFILE KEY của người dùng của bạn. Khóa này sẽ được sử dụng để đăng bài thay mặt cho người dùng của bạn và quản lý tài khoản của họ. Bạn nên lưu trữ nó ở một nơi an toàn.

Tạo Profile bằng Dashboard (Đội nội bộ)

Đội nội bộ của bạn cũng có thể tạo Profile Người dùng trực tiếp từ Developer Dashboard — hữu ích để kiểm thử, onboard một profile thủ công, hoặc quản trị một lần. Đây là công cụ dành cho đội, không phải quy trình hướng tới khách hàng: khách hàng của bạn không bao giờ được cấp quyền truy cập dashboard và luôn được onboard thông qua trang kết nối JWT URL. Đối với onboard trong môi trường sản xuất, hãy tạo profile theo cách lập trình với API để mỗi người dùng mới được cấp phát tự động.

Quản lý Profile Người dùng trong Dashboard

Gói Tích hợp

Trong quá trình onboarding với tư cách là khách hàng Gói Business hoặc Gói Launch, bạn đã nhận được một gói tích hợp được cá nhân hóa với thông tin thiết lập và tên miền quan trọng, các lệnh gọi điểm cuối mẫu, và nhiều hơn nữa. Vui lòng kiểm tra với chủ tài khoản chính của bạn để có thông tin này. Bạn cũng có thể truy xuất hoặc đặt lại gói tích hợp trong dashboard ở trang API. Hãy đảm bảo chuyển sang Profile Chính (Primary Profile) trước. Gói Tích hợp Ayrshare

Đăng nhập một lần với Xác thực JWT

Ayrshare sử dụng JWT (JSON Web Token) để xác thực người dùng của bạn và thực hiện Đăng nhập một lần (Single Sign-On) đến trang liên kết mạng xã hội. JWT là một cơ chế an toàn để truyền tải thông tin đã được ký kỹ thuật số và cho phép Ayrshare xác thực bạn và người dùng của bạn.

Tạo JWT

Ứng dụng của bạn sẽ tạo một JWT bao gồm API Key, Profile Key của người dùng và một vài tham số khác. JWT sẽ được ký bằng khóa riêng 1024-bit của bạn.
JWT token có hiệu lực trong 5 phút. Vui lòng xem Max Pack để có thời gian hết hạn dài hơn.
Vui lòng sử dụng điểm cuối Tạo JWT để Ayrshare tạo token và URL liên kết mạng xã hội. Mở URL liên kết mạng xã hội trong một tab hoặc cửa sổ mới, cho phép người dùng của bạn dễ dàng liên kết mạng xã hội của họ.
URL JWT là đường dẫn onboarding được khuyến nghị cho mọi khách hàng. Người dùng của bạn xác thực trực tiếp với từng mạng xã hội theo cách riêng của họ — bạn không bao giờ thu thập hoặc lưu trữ thông tin đăng nhập mạng xã hội của họ. Nếu đội của bạn cần liên kết một tài khoản thủ công trong quá trình kiểm thử, bạn có thể làm như vậy từ dashboard, nhưng đây là tiện ích nội bộ và không phải là cách khách hàng được onboard.

White-Label trang Kết nối Tài khoản

Vì trang kết nối được mở bởi URL JWT là giao diện Ayrshare duy nhất mà người dùng của bạn từng thấy, bạn nên xây dựng thương hiệu như của riêng bạn. Thêm logo và tiêu đề tùy chỉnh của bạn, chọn mạng xã hội nào xuất hiện, đặt ngôn ngữ trang và sử dụng các liên kết trợ giúp của riêng bạn — và với Max Pack, áp dụng tệp CSS tùy chỉnh đầy đủ, favicon, tiêu đề trang và chân trang. Các tùy chọn này được cấu hình một lần bởi đội của bạn từ Profile Chính và áp dụng cho mọi URL JWT bạn tạo.

White-Label trang Kết nối Tài khoản

Xem mọi tùy chọn xây dựng thương hiệu và tùy chỉnh cho trang kết nối.

Đăng xuất Tự động Phiên Profile

Cách Tự động Đăng xuất Phiên Profile đang Hoạt độngNếu một profile đã đăng nhập, việc gửi JWT của một profile khác sẽ không chuyển đổi profile. Điều này được thực hiện để làm cho trải nghiệm nhanh hơn cho những người dùng đã đăng nhập. Khi kiểm thử, hãy đăng xuất khỏi profile hiện tại trước khi thực hiện lệnh gọi SSO với một profile khác. Các profile đã đăng nhập vẫn ở trạng thái đăng nhập cho đến khi được đăng xuất một cách rõ ràng.Tuy nhiên, nếu bạn có nhu cầu kinh doanh, chẳng hạn như người dùng của bạn có nhiều profile mà họ thường truy cập, hoặc bạn muốn kiểm thử, hãy bao gồm tham số URL trong URL SSO:logout=trueVí dụ:https://profile.ayrshare.com?domain=[domain id]&jwt=[jwt token]&logout=trueĐiều này buộc đăng xuất và sau đó đăng nhập vào profile mới.Vui lòng xem thêm điểm cuối Tạo JWT để tự động thêm đăng xuất.Cảnh báo: Việc sử dụng đăng xuất tự động gây ra sự chậm trễ về hiệu năng cho người dùng của bạn, vì vậy trừ khi bạn cần, chúng tôi khuyên bạn không nên ép buộc đăng xuất và không sử dụng nó trong sản xuất.

Mở & Đóng URL Liên kết Mạng xã hội

Trang Tài khoản Mạng xã hội có nút “Close” đóng cửa sổ và đưa người dùng của bạn trở lại trang của bạn.

Mở URL Liên kết Mạng xã hội

Khi bạn mở URL liên kết mạng xã hội, chúng tôi khuyến nghị sử dụng hàm window.open() của JavaScript thay vì href anchor. Nút “Close” sử dụng JavaScript để đóng cửa sổ, và hầu hết các trình duyệt chỉ cho phép các cửa sổ được mở qua script được đóng. Bạn có thể sử dụng mã mẫu sau trên trang web của mình để khởi chạy cửa sổ liên kết mạng xã hội.
Window Open
hoặc
Window Open Function
Bạn có thể điều khiển nút “Close” để chuyển hướng tab liên kết mạng xã hội đến trang bạn chọn hoặc chuyển hướng tab/cửa sổ nguồn ban đầu và đóng tab liên kết mạng xã hội. Điều này có thể được thực hiện bằng cách sử dụng tham số redirect và thêm origin=true vào tham số truy vấn của URL chuyển hướng. Vui lòng xem điểm cuối Tạo JWT để biết thêm chi tiết.

Chuyển hướng khi Đóng

Ngoài ra, nếu bạn muốn có nút Close chuyển hướng trở lại trang của bạn (thường hữu ích trên thiết bị di động), hãy truyền tham số GET redirect dưới dạng chuỗi URL encoded bắt đầu bằng https. Vui lòng xem tham số điểm cuối Tạo JWT để biết thêm chi tiết.
JWT URL
Việc chuyển hướng sẽ được lưu cho profile đó và sử dụng trong các lệnh gọi SSO tiếp theo ngay cả khi tham số redirect không được truyền. Để đặt lại nút Close về mặc định đóng, hãy truyền tham số redirect=null.

Thông tin thêm

Thông báo Liên kết hoặc Hủy Liên kết Người dùng

Khi người dùng liên kết hoặc hủy liên kết một mạng xã hội, bạn có thể nhận thông báo qua webhook. Vui lòng xem trang Webhook Hành động Mạng xã hội để biết thêm thông tin. Bạn cũng có thể sử dụng điểm cuối user để lấy các mạng xã hội đã kết nối cho một profile người dùng.

Nhiều Bộ Tài khoản Mạng xã hội

Tổng quan

Mỗi Profile Người dùng có một bộ tài khoản mạng xã hội và có thể tạo một kết nối đến mỗi mạng xã hội. Nếu người dùng hoặc khách hàng của bạn có nhiều bộ tài khoản mạng xã hội, chẳng hạn như hai Trang Facebook, hai tài khoản Instagram và hai kênh YouTube, bạn có thể quản lý nhiều bộ tài khoản mạng xã hội này bằng cách làm theo các bước sau:
  1. Tạo nhiều Profile Người dùng - Tạo các Profile Người dùng riêng biệt trong hệ thống Ayrshare cho mỗi bộ tài khoản mạng xã hội mà người dùng hoặc khách hàng của bạn cần quản lý.
  2. Lưu trữ các Profile Key duy nhất - Mỗi Profile Người dùng sẽ có Profile Key duy nhất của riêng nó, được trả về từ điểm cuối tạo Profile Người dùng.
  3. Gán nhãn cho profile của bạn - Đặt tiêu đề hoặc gắn thẻ cho mỗi Profile Người dùng để nhận dạng rõ ràng chúng liên kết với tài khoản mạng xã hội nào (ví dụ, “Trang Facebook A” và “Trang Facebook B”).
  4. Ánh xạ trong cơ sở dữ liệu của bạn - Trong hệ thống của riêng bạn, liên kết tất cả các Profile Key có liên quan với người dùng hoặc khách hàng tương ứng.
  5. Sử dụng Profile Key phù hợp - Khi đăng nội dung hoặc truy xuất phân tích cho một tài khoản mạng xã hội cụ thể, hãy sử dụng Profile Key liên kết với tài khoản đó. Ví dụ, để đăng lên Trang Facebook A, hãy sử dụng Profile Key của Profile Người dùng được kết nối với Trang Facebook A.

Ví dụ

Hãy xem xét một tình huống thực tế cho nhiều tài khoản khách hàng:
  • Khách hàng: Chuỗi Nhà hàng của Joe với hai địa điểm
Joe cần các tài khoản mạng xã hội riêng biệt cho mỗi địa điểm nhà hàng: Địa điểm Nhà hàng 1:
  • Trang Facebook: “Joe’s Downtown Bistro”
  • Instagram: @joesdowntownbistro
  • LinkedIn: Trang doanh nghiệp Joe’s Downtown Bistro
Địa điểm Nhà hàng 2:
  • Trang Facebook: “Joe’s Seaside Grill”
  • Instagram: @joesseasidegrill
  • LinkedIn: Trang doanh nghiệp Joe’s Seaside Grill
Giải pháp triển khai:
  1. Tạo hai Profile Người dùng riêng biệt trong Ayrshare:
  • Profile Người dùng 1: Tiêu đề “Tài khoản Joe’s Downtown Bistro”
  • Profile Người dùng 2: Tiêu đề “Tài khoản Joe’s Seaside Grill”
  1. Kết nối các tài khoản mạng xã hội phù hợp với từng profile:
  • Profile 1: Liên kết Facebook, Instagram và LinkedIn của Downtown Bistro
  • Profile 2: Liên kết Facebook, Instagram và LinkedIn của Seaside Grill
  1. Lưu trữ cả hai Profile Key trong cơ sở dữ liệu của bạn, liên kết chúng với tài khoản của Joe:
  2. Khi đăng một cập nhật thực đơn đặc biệt cho địa điểm Downtown, hãy sử dụng Profile Key 1 trong các lệnh gọi API. Khi đăng về khuyến mãi hải sản tại địa điểm Seaside, hãy sử dụng Profile Key 2.
Bằng cách tạo nhiều Profile Người dùng, đặt tiêu đề hoặc gắn thẻ chúng một cách phù hợp, và liên kết chúng với một người dùng hoặc khách hàng duy nhất trong hệ thống của bạn, bạn có thể quản lý nhiều tài khoản mạng xã hội của họ trên cùng các nền tảng bằng cách sử dụng Ayrshare. Cách tiếp cận này cho phép đăng bài và truy xuất phân tích có mục tiêu cho từng tài khoản cụ thể.

Các bước tiếp theo

Vui lòng xem tại đây để biết thêm chi tiết về trải nghiệm người dùng:

Tích hợp Người dùng

Khi người dùng của bạn thiết lập các liên kết mạng xã hội của họ, bạn sẽ có thể bắt đầu đăng bài thay mặt cho họ bằng cách sử dụng các điểm cuối /post và /profile.

API Post

API Profiles