ビジネス向け API 統合

Business プランまたは Launch プラン統合の重要な部分は、ユーザーまたはクライアントのために Ayrshare で新しいプロファイルアカウントを作成し、ユーザーがソーシャル連携ページを使用して自分のソーシャルネットワークをリンクできるようにすることです。各ユーザーは Ayrshare の User Profile として設定されます。User Profile は、各ソーシャルネットワークに 1 つの接続を持ちます。

これはお客様をオンボーディングする標準的な方法です。 ユーザーは以下で説明するホワイトラベル化された接続ページを通じて、自身のソーシャルアカウントを接続します — Ayrshare にログインすることも、ダッシュボードに触れることもありません。ダッシュボードは社内チーム(プロファイルの作成と管理、テスト、クライアントに代わっての投稿など)のために予約されています。

統合ワークフロー

Ayrshare をアプリケーションに統合するには、2 つの API 呼び出しを行う必要があります:

Create Profiles エンドポイントを呼び出して、ユーザー用の新しい Ayrshare プロファイルを作成します。
リンクセッションの作成を呼び出して、ソーシャル連携 URL を取得します。

ソーシャル連携 URL はユーザーをソーシャル連携ページにサインインさせるため、ユーザーは自分の Ayrshare アカウントを持たずにそのページに到達できます。このページを新しいタブ、ウィンドウ、またはビューコントローラーで表示し、ユーザーがソーシャルメディアアカウントを接続できるようにします。

ユーザーがソーシャルメディアアカウントをリンクした後、API を介して投稿の公開、アナリティクスの取得、アカウントの管理ができるようになります。

セキュリティ上の理由から、ソーシャルメディアプラットフォームはユーザーがブラウザを通じて認証することを要求しており、バックエンドサーバー呼び出しでは実行できません。これにより、ユーザーは各プラットフォームの公式ログインページで直接ログインすることで、ソーシャルメディアアカウントを安全に接続できます。ソーシャルネットワークは、Ayrshare などの承認されたパートナードメインを通じてのみ認証が行われるように制限しています。また、iFrame もブロックしているため、Ayrshare 連携ページをサイトの iFrame 内に埋め込んだり表示したりすることはできません。

Ayrshare User Profile の作成

API でプロファイルを作成する

新しいユーザーがシステムに登録するとき、またはクライアントがアプリのソーシャルネットワークリンクをクリックするとき、/profiles/create-profile RESTful エンドポイント、または NPM や PyPi パッケージを使用して、新しい Ayrshare プロファイルアカウントを作成します。

Profiles

この呼び出しから返されるのは、ユーザーの PROFILE KEY です。このキーは、ユーザーに代わって投稿し、アカウントを管理するために使用されます。安全な場所に保管する必要があります。

ダッシュボードでプロファイルを作成する(社内チーム)

社内チームは Developer Dashboard から直接 User Profile を作成することもできます — テスト、プロファイルの手動オンボーディング、単発の管理に役立ちます。これはチームツールであり、お客様向けのフローではありません: お客様にはダッシュボードへのアクセスが提供されることはなく、常に接続ページを通じてオンボーディングされます。本番環境のオンボーディングでは、API を使用してプログラム的にプロファイルを作成し、各新規ユーザーが自動的にプロビジョニングされるようにします。

Manage User Profiles in Dashboard

統合パッケージ

Business プランまたは Launch プランのクライアントとしてのオンボーディング中に、重要なセットアップおよびドメイン情報、エンドポイント呼び出しの例などを含むパーソナライズされた統合パッケージを受け取りました。この情報については、プライマリアカウントホルダーに確認してください。ダッシュボードの API ページで、統合パッケージを取得またはリセットすることもできます。まず Primary Profile に切り替えてください。

ソーシャル連携ページへのシングルサインオン

Ayrshare がユーザーをソーシャル連携ページにサインインさせます。お客様はリンクセッションを作成し、返された url を開くだけです。アプリで何かを構築する必要も、署名する必要もありません。

ソーシャル連携 URL の作成

ヘッダーにユーザーの Profile-Key を指定してリンクセッションの作成を呼び出します。短時間だけ有効な不透明なセッショントークンを含む url が返されます:

Linking URL

https://profile.ayrshare.com?session=ayr_ls_kJ8mQ2vX9pLnR4tYwZ6aBcD1eFgH3iJkLmN0oPqRsTu&domain=YOUR_DOMAIN

返された URL をそのままユーザーに送り、新しいタブまたはウィンドウで開くと、ユーザーが簡単にソーシャルネットワークをリンクできます。トークンはこの URL の中にのみ存在し、この URL はユーザーを自身のプロファイルにサインインさせるため、パスワードと同様に扱い、1 つの URL は 1 人のユーザーにのみ送信してください。

URL の有効期間はデフォルトで 5 分 です。expiresIn で別の有効期間を最大 2880 分 (48 時間) まで指定できます。これには Max Pack が必要です。

リンクが開かれたかどうかの確認や、期限切れ前の失効も行えます。

リンク用 URL の生成(generateJWT)は同じ処理を行い、引き続き変更なしで動作するため、すでに配布済みのリンクは影響を受けません。新しい統合では非推奨ですが、削除予定はありません。その privateKey、base64、verify パラメータは引き続き受け付けられて無視されます — お客様側で署名されるものはなく、当社が発行した秘密鍵はもう必要ありません。

ソーシャル連携 URL はすべてのお客様に推奨されるオンボーディングパスです。ユーザーは各ソーシャルネットワークで直接自分で認証します — お客様のソーシャル認証情報を収集したり保存したりすることはありません。テスト中にチームがアカウントを手動でリンクする必要がある場合はダッシュボードから行うことができますが、これは社内の便利機能であり、お客様のオンボーディング方法ではありません。

アカウントを連携する方法は 3 つあり、このページはその 1 つを説明しています。 上記のホスト型リンクページは、当社がホストし貴社がブランディングするページで、許可しているすべてのネットワークをユーザーに表示します。連携を貴社自身のダッシュボードの中で完結させたい場合は、 Ayrshare Connect ウィジェットが当社のボタンを貴社のレイアウトに直接埋め込み、ダイレクトモードは貴社自身が管理するポップアップからネットワークを一度に 1 つ開きます。どちらのページも同じ比較表から始まります。

Connect Accounts ページのホワイトラベル化

ソーシャル連携 URL によって開かれる接続ページは、ユーザーが目にする唯一の Ayrshare インターフェースであるため、独自のブランドにする必要があります。ロゴとカスタムヘッダーを追加し、表示するソーシャルネットワークを選択し、ページ言語を設定し、独自のヘルプリンクを使用します — さらに Max Pack を使用すると、完全なカスタム CSS ファイル、favicon、ページタイトル、フッターを適用できます。これらのオプションは、Primary Profile からチームによって一度設定され、作成するすべてのソーシャル連携 URL に適用されます。

White-Label the Connect Accounts Page

接続ページのすべてのブランディングおよびカスタマイズオプションを確認します。

プロファイルセッションの自動ログアウト

アクティブなプロファイルセッションを自動的にログアウトする方法プロファイルがすでにログインしている場合、別のプロファイルのソーシャル連携 URL を送信してもプロファイルは切り替わりません。これは、すでにログインしているユーザーの体験を高速にするために行われます。テスト時には、別のプロファイルで SSO 呼び出しを行う前に、現在のプロファイルからログアウトしてください。サインインされたプロファイルは、明示的にログアウトされるまでサインインされたままです。ただし、ユーザーが頻繁にアクセスする複数のプロファイルを持っている場合や、テストしたい場合など、ビジネス上のニーズがある場合は、SSO URL に URL パラメーターを含めます:logout=trueたとえば:https://profile.ayrshare.com?session=[session token]&domain=[domain id]&logout=trueこれにより、ログアウトが強制され、新しいプロファイルにログインします。リンクセッションの作成の logout ボディパラメーターを設定して、自動的に追加させることもできます。警告: 自動ログアウトを使用すると、ユーザーにパフォーマンス遅延が発生するため、必要でない限り、ログアウトを強制しないこと、本番環境で使用しないことをお勧めします。

ソーシャル連携 URL の開閉

Social Accounts ページには、ウィンドウを閉じてユーザーをサイトに戻す「Close」ボタンがあります。

ソーシャル連携 URL を開く

ソーシャル連携 URL を開く際は、アンカー href の代わりに JavaScript の window.open() 関数を使用することをお勧めします。「Close」ボタンは JavaScript を使用してウィンドウを閉じ、ほとんどのブラウザはスクリプトを介して開かれたウィンドウのみを閉じることを許可します。 Web サイトで次のサンプルコードを使用して、ソーシャル連携ウィンドウを起動できます。

Window Open

<div onclick="window.open('https://profile.ayrshare.com?domain...', '_blank')">
  Link Social Networks
</div>

または

Window Open Function

<button onclick="openNewTabAndRedirect()">Open New Tab and Redirect</button>
<script>
  function openNewTabAndRedirect() {
    // Open a new tab
    var newTab = window.open("https://profile.ayrshare.com?domain...");

    // Optional: Focus on the new tab
    newTab.focus();
  }
</script>

「Close」ボタンを制御して、ソーシャル連携タブを選択したページにリダイレクトするか、元のオープナータブ/ウィンドウをリダイレクトしてソーシャル連携タブを閉じることができます。これは、redirect パラメーターを使用して、リダイレクト URL のクエリパラメーターに origin=true を追加することで実行できます。詳細についてはリンクセッションの作成を参照してください。

閉じるときのリダイレクト

さらに、Close ボタンでページにリダイレクトし直したい場合(モバイルで役立つことが多い)、redirect GET パラメーターに https で始まる URL エンコードされた 文字列を渡します。詳細についてはリンクセッションの作成のボディパラメーターを参照してください。

Linking URL

https://profile.ayrshare.com?session=[session token]&domain=[domain id]&redirect=https%3A%2F%2Fmywebsite.com

リダイレクトはそのプロファイルのために保存され、redirect パラメーターが渡されなくても、後続の SSO 呼び出しで使用されます。 Close ボタンを閉じる動作にリセットするには、パラメーター redirect=null を渡します。

詳細情報

ユーザーのリンク/リンク解除通知

ユーザーがソーシャルネットワークをリンクまたはリンク解除すると、webhook 経由で通知を受け取ることができます。詳細については Social Action Webhooks ページを参照してください。 User Profile の接続されているソーシャルネットワークを取得するために、user エンドポイントを使用することもできます。

複数セットのソーシャルアカウント

概要

各 User Profile は 1 セットのソーシャルメディアアカウントを持ち、各ソーシャルネットワークに 1 つの接続を作成できます。ユーザーまたはクライアントが 2 つの Facebook Page、2 つの Instagram アカウント、2 つの YouTube チャンネルなど、複数セットのソーシャルメディアアカウントを持っている場合、次の手順に従うことでこれらの複数セットのソーシャルメディアアカウントを管理できます:

複数の User Profile を作成する - ユーザーまたはクライアントが管理する必要があるソーシャルアカウントのセットごとに、Ayrshare システム内に別々の User Profile を作成します。
一意の Profile Key を保存する - 各 User Profile には、User Profile 作成エンドポイントから返される独自の Profile Key があります。
プロファイルにラベルを付ける - どのソーシャルメディアアカウントに関連付けられているかを明確に識別するために、各 User Profile にタイトルまたはタグを付けます(例: “Facebook Page A” と “Facebook Page B”)。
データベースでマッピング - 独自のシステムで、すべての関連する Profile Key をそれぞれのユーザーまたはクライアントに関連付けます。
適切な Profile Key を使用する - 特定のソーシャルアカウントのコンテンツを投稿したり、アナリティクスを取得したりする際は、そのアカウントに関連付けられた Profile Key を使用します。たとえば、Facebook Page A に投稿するには、Facebook Page A に接続されている User Profile の Profile Key を使用します。

例

複数のクライアントアカウントの実践的なシナリオを考えてみましょう:

クライアント: 2 つの店舗を持つ Joe’s Restaurant Chain

Joe は各レストランの店舗ごとに別々のソーシャルメディアアカウントを必要としています: レストラン店舗 1:

Facebook Page: “Joe’s Downtown Bistro”
Instagram: @joesdowntownbistro
LinkedIn: Joe’s Downtown Bistro business page

レストラン店舗 2:

Facebook Page: “Joe’s Seaside Grill”
Instagram: @joesseasidegrill
LinkedIn: Joe’s Seaside Grill business page

実装ソリューション:

Ayrshare で 2 つの別々の User Profile を作成します:

User Profile 1: “Joe’s Downtown Bistro Accounts” というタイトル
User Profile 2: “Joe’s Seaside Grill Accounts” というタイトル

各プロファイルに適切なソーシャルアカウントを接続します:

Profile 1: Downtown Bistro の Facebook、Instagram、LinkedIn をリンク
Profile 2: Seaside Grill の Facebook、Instagram、LinkedIn をリンク

両方の Profile Key をデータベースに保存し、Joe のアカウントに関連付けます:

Client: Joe's Restaurant Chain
- Profile Key 1: abc123... (Downtown location)
- Profile Key 2: xyz789... (Seaside location)

Downtown 店舗の特別メニューの更新を投稿する場合は、API 呼び出しで Profile Key 1 を使用します。Seaside 店舗のシーフードプロモーションを投稿する場合は、Profile Key 2 を使用します。

複数の User Profile を作成し、適切にタイトルまたはタグ付けし、システム内で単一のユーザーまたはクライアントに関連付けることで、Ayrshare を使用して同じプラットフォーム間で複数のソーシャルメディアアカウントを管理できます。このアプローチにより、特定のアカウントごとにターゲットを絞った投稿とアナリティクス取得が可能になります。

次のステップ

ユーザー体験の詳細については、こちらを参照してください:

User Integration

ユーザーがソーシャルメディアリンクを設定したら、/post および /profile エンドポイントを使用して、ユーザーに代わって投稿を開始できます。

Get Started

API Endpoints

Multiple Users

Dashboard

Additional

ビジネス向け API 統合

統合ワークフロー

Ayrshare User Profile の作成

API でプロファイルを作成する

Profiles

ダッシュボードでプロファイルを作成する(社内チーム)

Manage User Profiles in Dashboard

統合パッケージ

ソーシャル連携ページへのシングルサインオン

ソーシャル連携 URL の作成

Connect Accounts ページのホワイトラベル化

White-Label the Connect Accounts Page

プロファイルセッションの自動ログアウト

ソーシャル連携 URL の開閉

ソーシャル連携 URL を開く

閉じるときのリダイレクト

詳細情報

ユーザーのリンク/リンク解除通知

複数セットのソーシャルアカウント

概要

例

次のステップ

User Integration

Post API

Profiles API

​統合ワークフロー

​Ayrshare User Profile の作成

​API でプロファイルを作成する

Profiles

​ダッシュボードでプロファイルを作成する(社内チーム)

Manage User Profiles in Dashboard

​統合パッケージ

​ソーシャル連携ページへのシングルサインオン

​ソーシャル連携 URL の作成

​Connect Accounts ページのホワイトラベル化

White-Label the Connect Accounts Page

​プロファイルセッションの自動ログアウト

​ソーシャル連携 URL の開閉

​ソーシャル連携 URL を開く

​閉じるときのリダイレクト

​詳細情報

​ユーザーのリンク/リンク解除通知

​複数セットのソーシャルアカウント

​概要

​例

​次のステップ

User Integration

Post API

Profiles API

統合ワークフロー

Ayrshare User Profile の作成

API でプロファイルを作成する

ダッシュボードでプロファイルを作成する(社内チーム)

統合パッケージ

ソーシャル連携ページへのシングルサインオン

ソーシャル連携 URL の作成

Connect Accounts ページのホワイトラベル化

プロファイルセッションの自動ログアウト

ソーシャル連携 URL の開閉

ソーシャル連携 URL を開く

閉じるときのリダイレクト

詳細情報

ユーザーのリンク/リンク解除通知

複数セットのソーシャルアカウント

概要

例

次のステップ