ATProto Browser

Record data

{
  "uri": "at://did:plc:6zpjzzdzet62go7lnaoq4xog/com.whtwnd.blog.entry/3kscekf7dxs2d",
  "cid": "bafyreibz4n6b6obw3jq6ei5naqqxslg36nhx6c6rghpydygat3vkj3u5ni",
  "value": {
    "$type": "com.whtwnd.blog.entry",
    "theme": "github-light",
    "title": "FeedFeedbackAPIってなんなんだー？",
    "content": "~~Blueskyのウワサ(ｸｼｭﾝ)[^donald]~~\n[^donald]:ちょうど懐かしい動画を見たところでして……        \n# これなに\nBlueskyの公式アプリのバージョン1.81.0にて、カスタムフィードに対してのフィードバック\"Show more like this(このような投稿の表示を増やす)☺\",\"Show less like this(このような投稿の表示を減らす)☹\"が送信できるようになりました。[^1.81.0][^feedback]\n[^1.81.0]: https://bsky.app/profile/bsky.app/post/3ks36igfly32h\n[^feedback]:後述しますが他にもフィードバックが送られています。\n\nこれは先日のProduct Roadmapにあった\n[\"New feedback mechanisms which the algorithmic feeds can request, such as “show more” and “show less” buttons, and a way to track which posts have been seen to stop duplicates from showing so often.\"](https://bsky.social/about/blog/05-07-2024-product-roadmap#:~:text=New%20feedback%20mechanisms%20which%20the%20algorithmic%20feeds%20can%20request%2C%20such%20as%20%E2%80%9Cshow%20more%E2%80%9D%20and%20%E2%80%9Cshow%20less%E2%80%9D%20buttons%2C%20and%20a%20way%20to%20track%20which%20posts%20have%20been%20seen%20to%20stop%20duplicates%20from%20showing%20so%20often.)によるもので、フィードバックによって表示される内容を変化させることができるようになるみたいです。\n\nリリース内容にもありますが、この機能は1.81.0時点では[公式のDiscoverフィード](https://bsky.app/profile/did:plc:z72i7hdynmk6r22z27h6tvur/feed/whats-hot)に対してのみ動作します。ですが今後は他のカスタムフィードにも開放されるようなので、GitHubのコードに潜って探訪した記録を残しておこうと思います。\n\n\n# スキーマ実装:[atproto#2383](https://github.com/bluesky-social/atproto/pull/2383)\n- app.bsky.feed.defs#feedViewPost\n  - feedContextが追加 [^feedViewPost]\n\n    こちらは[app.bsky.feed.getFeed](https://docs.bsky.app/docs/api/app-bsky-feed-get-feed)で取得されるPostに付加されるもののようです。（PDS→クライアント）\n      ``` json\n    \"feedContext\": {\n        \"type\": \"string\",\n        \"description\": \"Context provided by feed generator that may be passed back alongside interactions.\",\n        \"maxLength\": 2000\n    }\n    ```\n[^feedViewPost]:https://github.com/bluesky-social/atproto/blob/4184a652225eaf2de5f4d4702562e84c2fd3fde7/lexicons/app/bsky/feed/defs.json#L53-L57\n\n- app.bsky.feed.defs#generatorView\n    - acceptsInteractionsが追加 [^generatorView]\n\n      こちらは[app.bsky.feed.getFeedGenerator](https://docs.bsky.app/docs/api/app-bsky-feed-get-feed-generator)でフィードジェネレーターの情報を返す際にインタラクションを受け取ることができるかを返すようです。\n      ```json\n      \"acceptsInteractions\": {\n        \"type\": \"boolean\"\n      }\n      ```\n[^generatorView]:https://github.com/bluesky-social/atproto/blob/4184a652225eaf2de5f4d4702562e84c2fd3fde7/lexicons/app/bsky/feed/defs.json#L150\n\n- app.bsky.feed.defs#skeletonFeedPost\n    - feedContextが追加 [^skeltonFeedPost]\n\n      こちらも[app.bsky.feed.getFeedSkeleton](https://docs.bsky.app/docs/api/app-bsky-feed-get-feed-skeleton)で返すPostに付加するもののようです。（フィードジェネレーター→AppView→PDS→クライアントのfeedViewPostへ）\n      ``` json\n        \"feedContext\": {\n          \"type\": \"string\",\n          \"description\": \"Context that will be passed through to client and may be passed to feed generator back alongside interactions.\",\n          \"maxLength\": 2000\n        }\n      ```\n[^skeltonFeedPost]:https://github.com/bluesky-social/atproto/blob/4184a652225eaf2de5f4d4702562e84c2fd3fde7/lexicons/app/bsky/feed/defs.json#L171-L175\n\n- app.bsky.feed.defs#interaction が追加[^interaction]\n\n    フィードジェネレーター側へ送られるフィードバック（interaction）と、getFeedSkeletonで渡したfeedContextが定義されています。\n    ``` json\n    \"interaction\": {\n      \"type\": \"object\",\n      \"properties\": {\n        \"item\": { \"type\": \"string\", \"format\": \"at-uri\" },\n        \"event\": {\n          \"type\": \"string\",\n          \"knownValues\": [\n            \"app.bsky.feed.defs#requestLess\",\n            \"app.bsky.feed.defs#requestMore\",\n            \"app.bsky.feed.defs#clickthroughItem\",\n            \"app.bsky.feed.defs#clickthroughAuthor\",\n            \"app.bsky.feed.defs#clickthroughReposter\",\n            \"app.bsky.feed.defs#clickthroughEmbed\",\n            \"app.bsky.feed.defs#interactionSeen\",\n            \"app.bsky.feed.defs#interactionLike\",\n            \"app.bsky.feed.defs#interactionRepost\",\n            \"app.bsky.feed.defs#interactionReply\",\n            \"app.bsky.feed.defs#interactionQuote\",\n            \"app.bsky.feed.defs#interactionShare\"\n          ]\n        },\n        \"feedContext\": {\n          \"type\": \"string\",\n          \"description\": \"Context on a feed item that was orginally supplied by the feed generator on getFeedSkeleton.\",\n          \"maxLength\": 2000\n        }\n      }\n    },\n    ```\n[^interaction]:https://github.com/bluesky-social/atproto/blob/4184a652225eaf2de5f4d4702562e84c2fd3fde7/lexicons/app/bsky/feed/defs.json#L197-L224\n\n- 以下、interactionのknownValuesたち \n    - app.bsky.feed.defs#requestLess が追加 [^requestLess]\n\n      Postのメニューから\"Show less like this(このような投稿の表示を増やす)☹\"を選択された場合に送信されます。\n      ``` json\n      \"requestLess\": {\n        \"type\": \"token\",\n        \"description\": \"Request that less content like the given feed item be shown in the feed\"\n      },\n      ```\n    [^requestLess]:https://github.com/bluesky-social/atproto/blob/4184a652225eaf2de5f4d4702562e84c2fd3fde7/lexicons/app/bsky/feed/defs.json#L225-L228\n\n    - app.bsky.feed.defs#requestMore が追加 [^requestMore]\n \n      Postのメニューから\"Show more like this(このような投稿の表示を減らす)☺\"を選択された場合に送信されます。\n      ``` json\n      \"requestMore\": {\n        \"type\": \"token\",\n        \"description\": \"Request that more content like the given feed item be shown in the feed\"\n      },\n      ```\n    [^requestMore]:https://github.com/bluesky-social/atproto/blob/4184a652225eaf2de5f4d4702562e84c2fd3fde7/lexicons/app/bsky/feed/defs.json#L229-L232\n\n    - app.bsky.feed.defs#clickthroughItem が追加 [^clickthroughItem]\n\n      Postをクリック(タップ)してPostの画面を開いた場合に送信されます。\n      ``` json\n      \"clickthroughItem\": {\n        \"type\": \"token\",\n        \"description\": \"User clicked through to the feed item\"\n      },\n      ```\n    [^clickthroughItem]:https://github.com/bluesky-social/atproto/blob/4184a652225eaf2de5f4d4702562e84c2fd3fde7/lexicons/app/bsky/feed/defs.json#L233-L236\n\n    - app.bsky.feed.defs#clickthroughAuthor が追加 [^clickthroughAuthor]\n\n      Postのアバターや名前をクリックしてプロフィール画面を開いた場合に送信されます。\n      ``` json\n      \"clickthroughAuthor\": {\n        \"type\": \"token\",\n        \"description\": \"User clicked through to the author of the feed item\"\n      },\n      ```\n    [^clickthroughAuthor]:https://github.com/bluesky-social/atproto/blob/4184a652225eaf2de5f4d4702562e84c2fd3fde7/lexicons/app/bsky/feed/defs.json#L237-L240\n\n    - app.bsky.feed.defs#clickthroughReposter が追加 [^clickthroughReposter]\n\n      Postの「～～がリポスト」をクリックしてリポスト者を開いた場合に送信されます。\n      ``` json\n      \"clickthroughReposter\": {\n        \"type\": \"token\",\n        \"description\": \"User clicked through to the reposter of the feed item\"\n      },\n      ```\n    [^clickthroughReposter]:https://github.com/bluesky-social/atproto/blob/4184a652225eaf2de5f4d4702562e84c2fd3fde7/lexicons/app/bsky/feed/defs.json#L241-L244\n\n    - app.bsky.feed.defs#clickthroughEmbed が追加 [^clickthroughEmbed]\n\n      Postのリンクカードや引用など埋め込みをクリックして開いた場合に送信されます。\n      ``` json\n      \"clickthroughEmbed\": {\n        \"type\": \"token\",\n        \"description\": \"User clicked through to the embedded content of the feed item\"\n      },\n      ```\n    [^clickthroughEmbed]:https://github.com/bluesky-social/atproto/blob/4184a652225eaf2de5f4d4702562e84c2fd3fde7/lexicons/app/bsky/feed/defs.json#L245-L248\n\n    - app.bsky.feed.defs#interactionSeen が追加 [^interactionSeen]\n\n      Postを一定時間表示させた場合に送信されます。\n      ``` json\n      \"interactionSeen\": {\n        \"type\": \"token\",\n        \"description\": \"Feed item was seen by user\"\n      },\n      ```\n    [^interactionSeen]:https://github.com/bluesky-social/atproto/blob/4184a652225eaf2de5f4d4702562e84c2fd3fde7/lexicons/app/bsky/feed/defs.json#L249-L252\n\n    - app.bsky.feed.defs#interactionLike が追加 [^interactionLike]\n\n      Postにいいねした場合に送信されます。\n      ``` json\n      \"interactionLike\": {\n        \"type\": \"token\",\n        \"description\": \"User liked the feed item\"\n      },\n      ```\n    [^interactionLike]:https://github.com/bluesky-social/atproto/blob/4184a652225eaf2de5f4d4702562e84c2fd3fde7/lexicons/app/bsky/feed/defs.json#L253-256\n\n    - app.bsky.feed.defs#interactionRepost が追加 [^interactionRepost]\n\n      PostをRepostした場合に送信されます。\n      ``` json\n      \"interactionRepost\": {\n        \"type\": \"token\",\n        \"description\": \"User reposted the feed item\"\n      },\n      ```\n    [^interactionRepost]:https://github.com/bluesky-social/atproto/blob/4184a652225eaf2de5f4d4702562e84c2fd3fde7/lexicons/app/bsky/feed/defs.json#L257-260\n\n    - app.bsky.feed.defs#interactionReply が追加 [^interactionReply]\n\n      Postに返信しようとした場合に送信されます。\n      ``` json\n      \"interactionReply\": {\n        \"type\": \"token\",\n        \"description\": \"User replied to the feed item\"\n      },\n      ```\n    [^interactionReply]:https://github.com/bluesky-social/atproto/blob/4184a652225eaf2de5f4d4702562e84c2fd3fde7/lexicons/app/bsky/feed/defs.json#L261-L264\n\n    - app.bsky.feed.defs#interactionQuote が追加 [^interactionQuote]\n\n      Postを引用しようとした場合に送信されます。\n      ``` json\n      \"interactionQuote\": {\n        \"type\": \"token\",\n        \"description\": \"User quoted the feed item\"\n      },\n      ```\n    [^interactionQuote]:https://github.com/bluesky-social/atproto/blob/4184a652225eaf2de5f4d4702562e84c2fd3fde7/lexicons/app/bsky/feed/defs.json#L265-L268\n\n    - app.bsky.feed.defs#interactionShare が追加 [^interactionShare]\n\n      Postを共有しようとした場合に送信されます。\n      ``` json\n      \"interactionShare\": {\n        \"type\": \"token\",\n        \"description\": \"User shared the feed item\"\n      }\n      ```\n    [^interactionShare]:https://github.com/bluesky-social/atproto/blob/4184a652225eaf2de5f4d4702562e84c2fd3fde7/lexicons/app/bsky/feed/defs.json#L269-L272\n\n## PDS/Appview実装:[atproto#2402](https://github.com/bluesky-social/atproto/pull/2402)\nアプリから送信されたInteraction、フィードジェネレーターからのfeedContextをPDSを通してAppViewと送受信する実装です。\n\n# 公式アプリ実装:[social-app#3498](https://github.com/bluesky-social/social-app/pull/3498)\nスキーマ側で実装されたIntaractionがどのように送信されているかを見ていきます。\n\n- [packages.json](https://github.com/bluesky-social/social-app/pull/3498/files#diff-7ae45ad102eab3b6d7e7896acd08c427a9b25b346470d7bc6507b6481575d519)\n    - [lodash/throttle](https://lodash.com/docs/4.17.15#throttle)が追加されており、後ほど出てきますが一定間隔でInteractionを送信するのに使用されています。\n- [src/state/feed-feedback.tsx](https://github.com/bluesky-social/social-app/blob/4fad18b2fa3c12ffdf1d49afac5228f7df658bc2/src/state/feed-feedback.tsx)\n    - FeedFeedbackの実体です。\n\n## fixes(1.82.0で実装):[social-app#3968](https://github.com/bluesky-social/social-app/pull/3968)\n1.81.0リリース後に行われている修正(改善)です。\n- interactionSeenの判定する時間を1.5秒に変更\n- リプライ元のPostについてもFeedContextを返すように修正（ちゃんと動き読めてないかも）\n\n## Include feedContext in DOM as data-(1.84.0で実装) :[social-app#4206](https://github.com/bluesky-social/social-app/pull/4206)\n- skeletonFeedPostのfeedContextが各Postのdivタグに`data-feed-context`として出力されるように変更\n",
    "createdAt": "2025-02-04T10:06:23.660Z",
    "visibility": "author"
  }
}