Zum Hauptinhalt springen
Ein wichtiger Teil der Integration in den Business-Plan oder den Launch-Plan besteht darin, für Ihre Nutzer oder Kunden neue Profil-Accounts in Ayrshare zu erstellen und ihnen zu ermöglichen, ihre sozialen Netzwerke über die Social-Linking-Seite zu verknüpfen. Jeder Ihrer Nutzer wird als Ayrshare-User-Profile eingerichtet. Ein User Profile erhält jeweils eine Verbindung zu jedem sozialen Netzwerk.
Dies ist der Standardweg für das Onboarding von Kunden. Ihre Nutzer verbinden ihre eigenen Social-Media-Konten über die unten beschriebene, mit einem White-Label versehene JWT-URL-Connect-Seite – sie melden sich nie bei Ayrshare an und greifen nie auf Ihr Dashboard zu. Das Dashboard ist Ihrem internen Team vorbehalten (zum Erstellen und Verwalten von Profilen, zum Testen und zum Posten im Namen eines Kunden).

​
Integrations-Workflow

Um Ayrshare in Ihre Anwendung zu integrieren, müssen Sie zwei API-Aufrufe durchführen:
  1. Rufen Sie den Create Profiles-Endpoint auf, um für Ihren Nutzer ein neues Ayrshare-Profil zu erstellen.
  2. Rufen Sie den Generate JWT-Endpoint auf, um eine JWT-URL zu erhalten.
Die JWT-URL ermöglicht Ihrem Nutzer den sicheren Zugriff auf die Social-Linking-Seite über eine Single-Sign-On-Authentifizierung. Sie zeigen diese Seite in einem neuen Tab, Fenster oder View-Controller an, damit Nutzer ihre Social-Media-Konten verbinden können. Workflow für die Verknüpfung von User Profiles Nachdem Ihr Nutzer seine Social-Media-Konten verknüpft hat, können Sie über die API Beiträge veröffentlichen, Analytics abrufen und die Konten verwalten.
Aus Sicherheitsgründen verlangen Social-Media-Plattformen, dass sich Nutzer über ihren Browser authentifizieren, was nicht über Backend-Server-Aufrufe möglich ist. Dies stellt sicher, dass Ihre Nutzer ihre Social-Media-Konten sicher verbinden können, indem sie sich direkt über die offizielle Login-Seite jeder Plattform anmelden. Soziale Netzwerke erlauben die Authentifizierung nur über ihre autorisierten Partner-Domains wie Ayrshare. Sie blockieren außerdem iFrames, was bedeutet, dass Sie die Ayrshare-Linking-Seite nicht in einem iFrame auf Ihrer Website einbetten oder anzeigen können.

​
Ein Ayrshare-User-Profile erstellen

​
Ein Profil mit der API erstellen

Wenn sich ein neuer Nutzer in Ihrem System registriert oder Ihr Kunde in Ihrer App auf den Social-Network-Link klickt, erstellen Sie einen neuen Ayrshare-Profil-Account, indem Sie den RESTful-Endpoint /profiles/create-profile aufrufen oder die NPM- oder PyPi-Pakete verwenden.

Profiles

Dieser Aufruf gibt den PROFILE KEY Ihres Nutzers zurück. Dieser Schlüssel wird verwendet, um im Namen Ihres Nutzers zu posten und dessen Konto zu verwalten. Sie sollten ihn an einem sicheren Ort speichern.

​
Ein Profil über das Dashboard erstellen (Internes Team)

Ihr internes Team kann User Profiles auch direkt aus dem Developer Dashboard erstellen – nützlich für Tests, manuelles Onboarding eines Profils oder einmalige administrative Aufgaben. Dies ist ein Team-Tool, kein kundenorientierter Ablauf: Ihre Kunden erhalten niemals Zugriff auf das Dashboard und werden immer über die JWT-URL-Connect-Seite onboardet. Erstellen Sie Profile für das produktive Onboarding programmatisch über die API, damit jeder neue Nutzer automatisch bereitgestellt wird.

User Profiles im Dashboard verwalten

​
Integrations-Paket

Während Ihres Onboardings als Business-Plan- oder Launch-Plan-Kunde haben Sie ein personalisiertes Integrations-Paket mit wichtigen Setup- und Domain-Informationen, Beispiel-Endpoint-Aufrufen und mehr erhalten. Bitte wenden Sie sich für diese Informationen an Ihren primären Account-Inhaber. Sie können das Integrations-Paket auch im Dashboard auf der API-Seite abrufen oder zurücksetzen. Wechseln Sie zuerst zu Ihrem Primary Profile. Ayrshare Integration Package

​
Single Sign-On mit JWT-Authentifizierung

Ayrshare verwendet ein JWT (JSON Web Token), um Ihren Nutzer zu authentifizieren und Single Sign-On zur Social-Linking-Seite durchzuführen. Ein JWT ist ein sicherer Mechanismus zur Übertragung digital signierter Informationen und erlaubt Ayrshare, Sie und Ihren Nutzer zu authentifizieren.

​
Ein JWT generieren

Ihre App erstellt ein JWT, bestehend aus Ihrem API-Key, dem Profile Key des Nutzers und einigen weiteren Parametern. Es wird mit Ihrem privaten 1024-Bit-Schlüssel signiert.
Das JWT-Token ist 5 Minuten gültig. Für eine längere Ablaufzeit siehe Max Pack.
Bitte verwenden Sie den Generate JWT-Endpoint, damit Ayrshare das Token und die Social-Linking-URL erstellt. Öffnen Sie die Social-Linking-URL in einem neuen Tab oder Fenster, damit Ihre Nutzer ihre sozialen Netzwerke einfach verknüpfen können.
Die JWT-URL ist der empfohlene Onboarding-Weg für jeden Kunden. Ihre Nutzer authentifizieren sich eigenständig direkt bei jedem sozialen Netzwerk – Sie sammeln oder speichern niemals deren Social-Media-Zugangsdaten. Wenn Ihr Team ein Konto während des Testens manuell verknüpfen muss, können Sie das über das Dashboard tun, aber dies ist eine interne Erleichterung und nicht der Weg, auf dem Kunden onboardet werden sollten.

​
White-Labeling der Connect-Accounts-Seite

Da die vom JWT-URL geöffnete Connect-Seite die einzige Ayrshare-Oberfläche ist, die Ihre Nutzer jemals sehen, sollten Sie sie als Ihre eigene branden. Fügen Sie Ihr Logo und benutzerdefinierte Header hinzu, wählen Sie aus, welche sozialen Netzwerke erscheinen, legen Sie die Sprache der Seite fest und verwenden Sie Ihre eigenen Hilfelinks – und mit dem Max Pack wenden Sie eine vollständige benutzerdefinierte CSS-Datei, ein Favicon, einen Seitentitel und einen Footer an. Diese Optionen werden einmal von Ihrem Team über das Primary Profile konfiguriert und gelten für jede von Ihnen generierte JWT-URL.

Connect-Accounts-Seite mit White-Label versehen

Sehen Sie sich alle Branding- und Anpassungsoptionen für die Connect-Seite an.

​
Automatisches Abmelden einer Profilsitzung

So melden Sie sich automatisch aus der aktiven Profilsitzung abWenn ein Profil bereits angemeldet ist, führt das Senden des JWT eines anderen Profils nicht zu einem Profilwechsel. Dies ist so gestaltet, um die Nutzung für bereits angemeldete Nutzer schneller zu gestalten. Melden Sie sich beim Testen vom aktuellen Profil ab, bevor Sie einen SSO-Aufruf mit einem anderen Profil durchführen. Angemeldete Profile bleiben angemeldet, bis sie explizit abgemeldet werden.Wenn Sie jedoch einen geschäftlichen Bedarf haben – etwa weil Ihre Nutzer mehrere Profile besitzen, auf die sie häufig zugreifen, oder wenn Sie testen möchten –, fügen Sie den URL-Parameter zur SSO-URL hinzu:logout=trueZum Beispiel:https://profile.ayrshare.com?domain=[domain id]&jwt=[jwt token]&logout=trueDies erzwingt einen Logout und meldet dann das neue Profil an.Siehe außerdem den Generate JWT-Endpoint, um den Logout automatisch hinzuzufügen.Warnung: Die Verwendung des automatischen Logouts verursacht eine Performance-Verzögerung für Ihren Nutzer. Sofern Sie ihn nicht benötigen, empfehlen wir, keinen Logout zu erzwingen und ihn in der Produktion nicht zu verwenden.

​
Öffnen und Schließen der Social-Linking-URL

Die Social-Accounts-Seite hat eine „Close”-Schaltfläche, die das Fenster schließt und Ihren Nutzer zu Ihrer Seite zurückführt.

​
Öffnen der Social-Linking-URL

Beim Öffnen der Social-Linking-URL empfehlen wir, die JavaScript-Funktion window.open() anstelle eines Anchor-href zu verwenden. Die „Close”-Schaltfläche verwendet JavaScript zum Schließen des Fensters, und die meisten Browser erlauben nur das Schließen von Fenstern, die über ein Skript geöffnet wurden. Sie können den folgenden Beispielcode auf Ihrer Website verwenden, um das Social-Linkage-Fenster zu starten.
Window Open
oder
Window Open Function
Sie können steuern, wie die „Close”-Schaltfläche entweder den Social-Linking-Tab auf eine Seite Ihrer Wahl umleitet oder den ursprünglichen Opener-Tab/das Fenster umleitet und den Social-Linking-Tab schließt. Dies kann über den redirect-Parameter erfolgen, indem Sie den Query-Parametern der Redirect-URL origin=true hinzufügen. Weitere Details finden Sie beim Generate JWT-Endpoint.

​
Umleitung beim Schließen

Wenn Sie außerdem möchten, dass die Close-Schaltfläche zurück zu Ihrer Seite umleitet (oft nützlich auf Mobilgeräten), übergeben Sie den GET-Parameter redirect als URL-kodierten String, der mit https beginnt. Weitere Details finden Sie unter Generate JWT-Endpoint-Parameter.
JWT URL
Die Weiterleitung wird für dieses Profil gespeichert und in nachfolgenden SSO-Aufrufen verwendet, auch wenn der Parameter redirect nicht übergeben wird. Um die Close-Schaltfläche wieder auf Schließen zurückzusetzen, übergeben Sie den Parameter redirect=null.

​
Weitere Informationen

​
Benachrichtigungen beim Verknüpfen und Aufheben der Verknüpfung durch Nutzer

Wenn ein Nutzer ein soziales Netzwerk verknüpft oder die Verknüpfung aufhebt, können Sie eine Benachrichtigung per Webhook erhalten. Weitere Informationen finden Sie auf der Seite Social Action Webhooks. Sie können auch den user-Endpoint verwenden, um die verbundenen sozialen Netzwerke eines User Profiles abzurufen.

​
Mehrere Sätze sozialer Konten

​
Übersicht

Jedes User Profile verfügt über einen Satz von Social-Media-Konten und kann pro sozialem Netzwerk eine Verbindung herstellen. Wenn Ihre Nutzer oder Kunden mehrere Sätze von Social-Media-Konten haben – z. B. zwei Facebook-Seiten, zwei Instagram-Konten und zwei YouTube-Kanäle – können Sie diese mehreren Kontosätze mit folgenden Schritten verwalten:
  1. Mehrere User Profiles erstellen – Erstellen Sie separate User Profiles im Ayrshare-System für jeden Satz sozialer Konten, den Ihr Nutzer oder Kunde verwalten muss.
  2. Eindeutige Profile Keys speichern – Jedes User Profile hat einen eigenen, eindeutigen Profile Key, der vom Create-User-Profile-Endpoint zurückgegeben wird.
  3. Ihre Profile beschriften – Vergeben Sie für jedes User Profile einen Title oder Tag, um klar zu kennzeichnen, mit welchen Social-Media-Konten sie verknüpft sind (z. B. „Facebook Page A” und „Facebook Page B”).
  4. In Ihrer Datenbank zuordnen – Verknüpfen Sie in Ihrem eigenen System alle relevanten Profile Keys mit dem entsprechenden Nutzer oder Kunden.
  5. Passenden Profile Key verwenden – Verwenden Sie beim Posten von Inhalten oder beim Abrufen von Analytics für ein bestimmtes soziales Konto den Profile Key, der mit diesem Konto verknüpft ist. Um beispielsweise auf Facebook Page A zu posten, verwenden Sie den Profile Key des User Profiles, das mit Facebook Page A verbunden ist.

​
Beispiel

Betrachten wir ein praktisches Szenario für mehrere Kunden-Konten:
  • Kunde: Joe’s Restaurant-Kette mit zwei Standorten
Joe benötigt separate Social-Media-Konten für jeden Restaurant-Standort: Restaurant-Standort 1:
  • Facebook-Seite: „Joe’s Downtown Bistro”
  • Instagram: @joesdowntownbistro
  • LinkedIn: Joe’s Downtown Bistro – Unternehmensseite
Restaurant-Standort 2:
  • Facebook-Seite: „Joe’s Seaside Grill”
  • Instagram: @joesseasidegrill
  • LinkedIn: Joe’s Seaside Grill – Unternehmensseite
Umsetzungslösung:
  1. Erstellen Sie zwei separate User Profiles in Ayrshare:
  • User Profile 1: Titel „Joe’s Downtown Bistro Accounts”
  • User Profile 2: Titel „Joe’s Seaside Grill Accounts”
  1. Verbinden Sie die passenden sozialen Konten mit jedem Profil:
  • Profil 1: Verknüpft das Facebook, Instagram und LinkedIn des Downtown Bistro
  • Profil 2: Verknüpft das Facebook, Instagram und LinkedIn des Seaside Grill
  1. Speichern Sie beide Profile Keys in Ihrer Datenbank und verknüpfen Sie diese mit Joes Konto:
  2. Wenn Sie ein Menü-Update speziell für den Downtown-Standort posten, verwenden Sie Profile Key 1 in den API-Aufrufen. Wenn Sie eine Fisch-Aktion am Seaside-Standort bewerben, verwenden Sie Profile Key 2.
Indem Sie mehrere User Profiles erstellen, sie mit Title oder Tag passend beschriften und sie in Ihrem System einem einzelnen Nutzer oder Kunden zuordnen, können Sie mit Ayrshare mehrere Social-Media-Konten auf denselben Plattformen verwalten. Dieser Ansatz ermöglicht ein zielgerichtetes Posten und Analytics-Abrufen für jedes spezifische Konto.

​
Nächste Schritte

Weitere Details zur Nutzererfahrung finden Sie hier:

User Integration

Sobald Ihr Nutzer seine Social-Media-Verknüpfungen eingerichtet hat, können Sie in seinem Namen mit den /post- und /profile-Endpoints Beiträge veröffentlichen.

Post API

Profiles API