Skip to main content
広告の操作は広告プラットフォームを引数として受け取るため、同じ操作が Ayrshare がサポートするすべての広告プラットフォームで動作します。現在サポートされているのは FACEBOOK と INSTAGRAM です。 各操作は対応する REST の広告エンドポイントを呼び出し、そのレスポンスを変更せずに返します。認証と制限は REST と同じです。呼び出しが失敗すると GraphQL エラーが返されます。extensions.status には REST のステータスが、REST のエラーに Ayrshare のエラーコードがある場合は extensions.code にそのコードが含まれます。エラーを参照してください。広告の操作には広告アドオンが必要です。アドオンがない場合、すべての呼び出しは extensions.status が 403、extensions.code が 399 のエラーを返します。

操作

すべての操作は、User Profile を操作するためのオプションの profileKey も受け取ります。いずれも REST のレスポンスを JSON として返すため、フィールドの選択は受け付けません。

広告アカウントを一覧表示する

まずここから始めます。操作で accountId が求められる場合は、このレスポンスに含まれる accountId の値を使用してください。

ターゲティングオプションを検索する

kind で検索の種類を選択します。オーディエンスのターゲティングには INTERESTS、地域には REGIONS または CITIES を使用します。各 kind は、それぞれに対応する引数のみを受け付けます。たとえば、countryCode と regionId は CITIES でのみ機能し、INTERESTS には search が必要です。

広告を一覧表示する

campaignId、accountId、adId、postId、socialPostId のうち少なくとも 1 つを渡してください。socialPostId はネットワーク独自の投稿 ID で、Ayrshare 経由で公開されていない投稿に使用します。

広告の費用を確認する

広告を一時停止または再開する

updateAd は実際の広告費に影響します。PAUSED は支出を停止し、ACTIVE は再開し、DELETED または ARCHIVED は広告を終了します。同じステータスは広告の広告セットとキャンペーンにも設定されるため、その広告セットまたはキャンペーン内の他の広告も同様に変更されます。
これらの操作による投稿のブーストは近日提供予定です。それまでは、boostFacebookPost または instagramBoostPost、あるいは Facebook または Instagram の REST ブーストエンドポイントを使用してください。
facebookAdAccounts や instagramAds などのプラットフォームごとの操作も、変更なく引き続き動作します。