Skip to main content
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 đượ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 Tạo một phiên liên kết để lấy một URL liên kết mạng xã hội.
URL liên kết mạng xã hội đăng nhập người dùng của bạn vào trang liên kết mạng xã hội, nên họ đến được trang đó mà không cần có tài khoản Ayrshare riêng. 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. Đố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ào trang liên kết mạng xã hội

Ayrshare đăng nhập người dùng của bạn vào trang liên kết mạng xã hội thay cho bạn. Bạn tạo một phiên liên kết và mở url được trả về; ứng dụng của bạn không phải tạo gì và không phải ký gì.

Tạo URL liên kết mạng xã hội

Gọi Tạo một phiên liên kết với Profile-Key của người dùng trong header. Nó trả về một url mang theo một token phiên không minh bạch và có thời hạn ngắn:
Linking URL
Hãy gửi URL đó cho người dùng đúng như khi được trả về và mở nó trong một tab hoặc cửa sổ mới, cho phép người dùng dễ dàng liên kết mạng xã hội của họ. Token chỉ tồn tại bên trong URL, và URL này đăng nhập người dùng vào profile của họ, vì vậy hãy coi nó như một mật khẩu và chỉ gửi mỗi URL cho một người dùng duy nhất.
URL có hiệu lực trong 5 phút theo mặc định. Dùng expiresIn để đặt khoảng thời gian khác, tối đa 2880 phút (48 giờ), điều này yêu cầu Max Pack.
Bạn cũng có thể kiểm tra xem một liên kết đã được mở chưa và thu hồi nó trước khi hết hạn.
Tạo URL liên kết (generateJWT) thực hiện cùng công việc và tiếp tục hoạt động không thay đổi, nên các liên kết bạn đã phát đi không bị ảnh hưởng. Nó đã ngừng khuyến nghị (deprecated) cho các tích hợp mới và không có ngày gỡ bỏ. Các tham số privateKey, base64 và verify của nó vẫn được chấp nhận và bị bỏ qua — không có gì được ký ở phía bạn, và bạn không còn cần private key mà chúng tôi đã cấp cho bạn.
URL liên kết mạng xã hội 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.
Ba cách để kết nối một tài khoản, và trang này mô tả một trong số đó. Trang liên kết được lưu trữ ở trên cho người dùng của bạn thấy mọi mạng bạn cho phép, trên một trang do chúng tôi lưu trữ và bạn gắn thương hiệu. Nếu bạn muốn việc kết nối diễn ra bên trong dashboard của riêng bạn, widget Ayrshare Connect nhúng các nút của chúng tôi trực tiếp vào bố cục của bạn, và Chế độ trực tiếp (Direct Mode) mở từng mạng một từ một cửa sổ bật lên mà bạn tự quản lý. Cả hai trang đều mở đầu bằng cùng một bảng so sánh.

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

Vì trang kết nối được mở bởi URL liên kết mạng xã hội 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 liên kết mạng xã hội 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 URL liên kết mạng xã hội 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?session=[session token]&domain=[domain id]&logout=trueĐiều này buộc đăng xuất và sau đó đăng nhập vào profile mới.Bạn cũng có thể đặt tham số thân logout trên Tạo một phiên liên kết để nó được thêm giúp bạn.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 Tạo một phiên liên kết để 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 các tham số thân của Tạo một phiên liên kết để biết thêm chi tiết.
Linking 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