API Đồ thị

Version 2.9

Graph API | Marketing API

Các mục trong nhật ký thay đổi được phân loại như sau:

  • Tính năng mới — Các sản phẩm hoặc dịch vụ mới, bao gồm các nút, cạnh và trường thông tin mới.
  • Thay đổi — Các thay đổi cho sản phẩm hoặc dịch vụ hiện có (không bao gồm phần Ngừng sử dụng).
  • Ngừng sử dụng — Các sản phẩm hoặc dịch vụ hiện có sẽ bị gỡ bỏ.
  • Các thay đổi quan trọng trong 90 ngày — Các thay đổi và quyết định ngừng sử dụng sẽ có hiệu lực trong 90 ngày sau ngày phát hành phiên bản.

Tính năng mới, Thay đổi và Ngừng sử dụng chỉ ảnh hưởng đến phiên bản này. Các thay đổi quan trọng trong 90 ngày sẽ ảnh hưởng đến tất cả các phiên bản.

Các thay đổi quan trọng không được đưa vào đây vì không gắn liền với bản phát hành cụ thể.

Graph API

Released April 18, 2017 | Available until July 18, 2019

New Features

General

  • Read After Write - Graph API POST requests now support returning specified values of an object during the same request as a write, saving a round trip for clients. If a fields parameter is specified (explanation of the syntax), the request will first do the write, then read the created or updated object, selecting fields using the fields parameter, as the response. Read-after-write is now enabled for all versions of the Graph API. Visit our docs page to learn more.

  • New short_names Field on the User Object - The following field has been added to the user endpoint:

    • short_name - first_name assumes the universally friendly way to refer to a person is by their first name. However, in many cultures (especially Chinese, Japanese, Korean, Thai, Indic, and a few others), it's inappropriate to address people by their first name. The new short_name method understands the culture-specific rules for how to address a person with a short name. So, for a viewer in the US, they'll continue to see friends in China, Japan, Korea, and India addressed by their first name, but their friends in East and South Asia will see friends with full names.

Pages

  • Business App Page Mapping - The user node has two new edges, ids_for_pages and ids_for_apps, for de-referencing a person's ID for an app or a page. The ids_for_pages edge returns other IDs that person has for pages owned by the same business. Similarly, the ids_for_apps edge returns other IDs that person has for apps owned by the same business. See Connecting with People Across Apps and Bots in Messenger.

  • Page POST Support to Add Pages to Crosspost Videos - Approve and accept a crossposting relationships request from another page by POST /{page_id}/crossposting_pages.

  • Webhooks IDs Are Serialized as Strings - Numeric IDs are converted to strings in this webhooks update.

Permissions

Places Graph

  • Current Place - The following fields have been added:

    • GET /current_place/results - Helps determine what place a person is currently at by using location signals. User permission is required.
    • POST /current_place/feedback - Allows you to provide feedback about whether they were actually there. For more information, see Places Graph

  • GET /search?type=place - The following parameters have been added:

    • categories - Search by category.
    • matched_categories - Indicate which categories the resulting place matches. Must be used with categories.

Video APIs

  • Time Spent in Video Metrics for Page - The following metrics have been added. For more information, see Insights Metric /{object-id}/insights/{metric}.

    • page_video_view_time- The time spent on videos on the page.
    • post_video_view_time_by_country_id - The time spent on videos on the page by country.

Webhooks

  • Apps Can Receive Changed Values for User's Profile Updates with Webhooks Updates - When a user changes a field, your app can receive the new value as part of the update, saving the step of checking the value. Previously, whenever a user changed one of their fields, we would notify the app of the field that changed without sending the new value.

  • Documentation - Webhooks now has reference documentation for topics and fields you can subscribe to. This documentation is on Facebook Developers site under Webhooks Reference in the Graph API.

  • Sample Sender Tool - The new tool makes it easier for developers to test out the Webhooks update structure before subscribing to the topic. In the past, developers had to subscribe to a field and then try to trigger the update by making a change through Facebook. For example, an app might need to know when a user (users that installed the app and granted needed permissions) changes their profile picture. The app would subscribe to the profile picture field in the Webhooks framework. However, to test how this works, you had to change the profile picture on some user that had installed the app to see the structure of the update we send. The sample sender tool allows apps to test the update structure without having to make an unnecessary change. You can find the sample sender tool in the webhooks section of your app's dashboard.

  • Versioning - Webhooks versions are now the same as Graph API. Any existing Webhooks subscriptions will be running on the oldest supported version of the app. Previously, Webhooks subscriptions didn't support versioning. The only way to make changes was by making breaking changes. For more information on Webhooks versions, see Versioning.

Changes

General

  • The Batch API returns an error rather than a null response for aborted request items in the Batch API. For more information, see Graph API, Making Batch Requests.

  • GET /{url}/share - The share endpoint has been removed and replaced with:

    • engagement field with subfields:
      • comment_count
      • comment_plugin_count
      • reaction_count
      • share_count

Pages

  • /{page-id}/feed - Backdated posts are included in the {page_id}/feed request if the backdated_time of the post is within the since and until time range. The created_time is the actual creation time. (See changes to Posts below.)

  • page-restaurant-services - All fields now return false or true instead of 0 or 1.

  • GET /{post-id} - The following field has been added to this endpoint:
    • promotable_id - Previously, certain posts could not be promoted, only their contents. In such cases, the id field would return the contents ID, rather than the ID for the post. Posts now always return their own ID in the id field, and a new field, promotable_id, is added to the GET {post-id} endpoint to be used when promoting the post.

Posts

  • Backdating a post will no longer update the post's created_time value. Instead, it will duplicate the original, but with created_time and backdated_time set to the new value. The original post will keep its old created_time value and gain the new backdated_time and value. Finally, GET {post-id}/feed will no longer return the original post, but instead will return the newly created duplicate.

Video API

  • Expose dash preview URL for live video instead of RTMP URL.

  • GET /{page_id}/crosspost_pending_approval_pages - List all the Pages your Page has sent crossposting requests, but that have not accepted yet.

  • GET /{page_id}/crosspost_whitelisted_pages - List all the pages you have given crossposting permission.

  • POST /{video_id}/allow_crossposting_for_pages = [{"page_id": {page_id}, "allow": {true/false}] - Allow or disallow the permission for certain Pages in your crossposting allow list to crosspost a specific video.

  • POST /{page_id}/crossposting_pages=[{"page_id": {page_id}, "allow": false, "action": "EXPIRE_ALL_CROSSPOSTS_ON_SHARED_ASSETS"}] - Remove pages from your crossposting allow list and expire all previously crossposted content.

  • POST /{page_id}/crossposting_pages=[{"page_id": {page_id}, "allow": false, "action": "NO_ACTION"}] - Remove pages from your crossposting allow list without affecting previously crossposted content.

Webhooks

  • GET /{app-id}/subscriptions - This endpoint now returns versions for fields. Before Webhooks versioning was introduced, the endpoint returned only a list of subscribed fields. Now the endpoints return the list of fields with their respective versions.

Deprecations

Messages

  • GET /{message-id} - The following field has been deprecated:
    • subject
  • GET /{thread-id} - The following field has been deprecated:
    • tags

90-Day Breaking Changes

  • The following fields are deprecated for edges and dialogs that allow attaching links to posts:

    • caption
    • description
    • name
    • picture
    • thumbnail

  • The edges and dialogs for which these are deprecated include:

    • POST /{event-id}/feed
    • POST /{group-id}/feed
    • POST /{page-id}/feed
    • POST /{user-id}/feed
    • share and feed dialogs

Video

  • Insights Edge - All paid and organic metrics are deprecated.

Webhooks

  • The following Webhooks fields from the user topic are deprecated:

    • about_me
    • birthday_date
    • contact_email
    • current_location
    • education_history
    • hometown_location
    • sex
    • statuses
    • tv
    • work_history

  • Instead use:

    • about
    • birthday
    • education
    • email
    • gender
    • hometown
    • location
    • status
    • television
    • work

Tính năng mới trong API Tiếp thị v2.9

Nội dung quảng cáo

Tạo chiến dịch Canvas trên Facebook qua API Tiếp thị. Bằng cách sử dụng cảnh tượng, âm thanh và chuyển động, định dạng video cho phép nhà quảng cáo đạt được mục tiêu về thương hiệu và phản hồi trực tiếp một cách hiệu quả. Hãy xem API Tiếp thị, Quảng cáo Canvas.

Quảng cáo động

  • Chất lượng danh mục quảng cáo động - Chúng tôi sắp giới thiệu API mới để giúp bạn chạy quảng cáo động thành công: API Kiểm tra và API Chất lượng. Với API Kiểm tra, bạn có thể xác minh rằng nguồn tín hiệu của mình cung cấp đủ thông tin để phân phối quảng cáo phù hợp bằng quảng cáo động. Với API Chất lượng, bạn có thể kiểm tra và xác minh rằng danh mục và nguồn cấp của mình có đủ thông tin về việc đủ chất lượng để phân phối quảng cáo động. Để biết thêm thông tin, hãy xem Quảng cáo động, Chất lượng tín hiệu và danh mục.

  • Nhiều hình ảnh cho một mặt hàng - Hiển thị nhiều hình ảnh của cùng một mặt hàng trong quảng cáo động ở định dạng quay vòng. Chúng tôi hiện hỗ trợ tối đa 20 hình ảnh từ một danh mục để biểu thị một mặt hàng ở định dạng quay vòng cho quảng cáo động. Điều này cho phép bạn hiển thị một mặt hàng như khách sạn hoặc điểm đến bằng nhiều hình ảnh. Để hỗ trợ điều này, chúng tôi cung cấp các tùy chọn mới: force_single_link = true và show_multiple_images = true. Để biết chi tiết, hãy xem Quảng cáo động, Quản lý quảng cáo, Mẫu nội dung.

Quản lý quảng cáo

  • Nội dung quảng cáo - Bạn hiện có thể sao chép chiến dịch, nhóm quảng cáo và quảng cáo có sẵn bằng cách sử dụng API Nội dung quảng cáo của chúng tôi. Bằng cách này, bạn không cần tạo lại quảng cáo từ đầu mỗi lần; thay vào đó, bạn có thể sao chép chiến dịch, nhóm quảng cáo hoặc quảng cáo hoạt động & tạo vỏ mẫu quảng cáo. Hãy xem Nội dung quảng cáo, Vị trí quảng cáo và Xem trước.

  • Số người tiếp cận hàng ngày ước tính - Chúng tôi có một điểm cuối mới /delivery_estimate ở cấp độ tài khoản quảng cáo và nhóm quảng cáo. Điểm cuối này cho phép bạn có được ước tính giá thầu và dự đoán kết quả với số người tiếp cận hàng ngày và số lượt chuyển đổi của nhóm quảng cáo cho trước. Hãy xem Nhắm mục tiêu, Số người tiếp cận hàng ngày ước tính.

  • API Công cụ quy tắc — Sử dụng API Công cụ quy tắc để quản lý quảng cáo dễ dàng, hiệu quả và thông minh hơn, dựa trên quy tắc kinh doanh mà bạn đặt ra. Công cụ quy tắc sử dụng mô hình đẩy dữ liệu, nên thay vì phải liên tục truy vấn API của chúng tôi để có thông tin cập nhật về quảng cáo của bạn, chúng tôi sẽ chủ động gửi cho bạn thông báo đẩy và thực hiện hành động bạn đã chỉ định khi đạt các điều kiện quy tắc. Chi tiết khác về API công cụ quy tắc tại đây.

  • API Lô - Nhóm các yêu cầu và gửi không đồng bộ. Nhóm vài lệnh gọi API Đồ thị vào một yêu cầu HTTP và thực hiện không đồng bộ mà không phải chặn. Bạn cũng có thể chỉ định yếu tố phụ thuộc giữa các thao tác có liên quan. Facebook sẽ xử lý song song từng thao tác độc lập và xử lý thao tác phụ thuộc theo tuần tự. Hãy xem Yêu cầu hàng loạt và yêu cầu không đồng bộ, API Lô.

Vị trí quảng cáo

  • Vị trí quảng cáo hiệu quả - Bạn có thể chỉ định vị trí quảng cáo trong thông số nhắm mục tiêu, tuy nhiên, bạn có thể không biết liệu Facebook đã thực sự phân phối quảng cáo của mình đến tất cả các vị trí quảng cáo chưa. Nếu bạn chọn vị trí quảng cáo không hợp lệ cho mục tiêu cho trước, Facebook sẽ không phân phối trên vị trí quảng cáo này. Trước đây, bạn phải chạy quảng cáo và thử nghiệm để xác định kết quả thực. Với API vị trí quảng cáo effective_, bạn có thể xác định vị trí quảng cáo thực mà Facebook phân phối cho vị trí quảng cáo bạn đã chọn và mục tiêu quảng cáo cho trước. Thông qua API đề xuất, bạn cũng có thể tìm hiểu lý do vì sao một số vị trí quảng cáo bị lọc ra. Hãy xem Nhắm mục tiêu, Nâng cao, Vị trí quảng cáo hiệu quả.

Thay đổi lớn trong API Tiếp thị API v2.9

Quản lý quảng cáo

  • Vị trí quảng cáo video được đề xuất - Đây là một phần của vị trí quảng cáo nguồn cấp cho Facebook; bạn đã chọn vị trí quảng cáo này tự động nếu sử dụng vị trí quảng cáo nguồn cấp. Kể từ phiên bản 2.9, chúng tôi tách vị trí quảng cáo video được đề xuất khỏi vị trí quảng cáo nguồn cấp để bạn có thể bỏ chọn vị trí quảng cáo video được đề xuất ngay cả khi bạn chọn vị trí quảng cáo nguồn cấp. Đối với phiên bản 2.8 và trước đó, nếu bạn sử dụng vị trí quảng cáo nguồn cấp cho Facebook, chúng tôi sẽ không tự động phân phối quảng cáo đến vị trí video được đề xuất nữa khi bạn chọn vị trí quảng cáo nguồn cấp.

  • Mục tiêu nhận thức tại địa phương - Chúng tôi đã ngừng sử dụng mục tiêu chiến dịch LOCAL_AWARENESS. Kể từ phiên bản 2.9, chúng tôi sẽ không chấp nhận LOCAL_AWARENESS là mục tiêu để tạo chiến dịch mới nữa. Nâng cao nhận thức tại địa phương cho một nhóm quảng cáo vị trí với chiến dịch REACH. Chúng tôi không còn hỗ trợ LOCAL_AWARENESS cho nhiều vị trí nữa. Nếu bạn có sẵn chiến dịch có mục tiêu này, bạn vẫn có thể đọc hoặc chỉnh sửa chiến dịch đó và bạn có thể tạo nhóm quảng cáo cũng như quảng cáo mới trong chiến dịch. Nếu bạn sao chép chiến dịch từ chiến dịch có sẵn, loại chiến dịch sẽ xác định xem bạn có thể sao chép chiến dịch đó không. Với một vị trí LOCAL_AWARENESS, chúng tôi sao chép có chỉ định REACH. Đối với LOCAL_AWARENESS và nhiều vị trí, bạn không thể sao chép chiến dịch.

  • Mục tiêu quảng cáo di động - Để đơn giản hóa mục tiêu quảng cáo di động của chúng tôi, chúng tôi sẽ không sử dụng CanvasAppEngagement, CanvasAppInstalls, MobileAppInstalls và MobileAppEngagement nữa. Tên tương ứng của các mục tiêu này là CAE, MAE, CAI và MAI. Bắt đầu từ phiên bản 2.9, bạn không thể tạo chiến dịch mới với 4 mục tiêu này. Thay vào đó, chúng tôi hỗ trợ:

    • Nhóm quảng cáo CAE của chiến dịch LINK_CLICKS, bạn cần sử dụng LINK_CLICKS để tạo chiến dịch cho quảng cáo CAE.

    • Nhóm quảng cáo MAE với chiến dịch mục tiêu LINK_CLICKS hoặc CONVERSIONS, bạn cần thay đổi thành LINK_CLICKS hoặc CONVERSIONS để tạo chiến dịch cho quảng cáo MAE.

    • Nhóm quảng cáo CAI với APP_INSTALLS, bạn nên sử dụng APP_INSTALLS để tạo chiến dịch cho quảng cáo CAI.

    • MAI với APP_INSTALLS, bạn nên sử dụng APP_INSTALLS để tạo chiến dịch cho quảng cáo MAI.

  • Mục tiêu quảng cáo di động, Tính tương thích - Khi bạn sao chép chiến dịch CAE, MAE, CAI và MAI bằng API Tiếp thị hoặc công cụ của Facebook, chúng tôi sẽ tự động chuyển các mục tiêu không dùng nữa này sang mục tiêu tương ứng trong phiên bản 2.9:

    • Chiến dịch MAI hoặc CAI chuyển đổi thành mục tiêu APP_INSTALLS.

    • Chiến dịch CAE chuyển đổi thành chiến dịch LINK_CLICKS.

    • Chiến dịch MAE chuyển đổi thành chiến dịch LINK_LICKS hoặc CONVERSIONS dựa trên sự tối ưu hóa bạn cung cấp cho nhóm quảng cáo trong chiến dịch. Nếu có bất kỳ nhóm quảng cáo con nào được tối ưu hóa cho OFFSITE_CONVERSION, chúng tôi sẽ chuyển đổi chiến dịch MAE của bạn thành chiến dịch CONVERSIONS, nếu không, chúng tôi sẽ chuyển chiến dịch MAE của bạn thành chiến dịch LINK_CLICKS.

  • Danh mục bị chặn - Chúng tôi sẽ ngừng sử dụng một số danh mục trên Audience Network, Video trực tuyến và Bài viết tức thời mà thiên về các danh mục thống nhất hơn trên các vị trí quảng cáo này. Các danh mục này cho phép bạn ngăn quảng cáo hiển thị với nội dung gây khó chịu nhất định, chẳng hạn như đánh bạc, rượu, v.v. Danh mục politics và religion đã bị ngừng sử dụng. Các danh mục sau khả dụng:

    • Đối với Bài viết tức thời và Audience Network: debated_social_issues, mature_audiences, tragedy_and_conflict, dating, gambling.

    • Đối với Video trực tuyến: debated_social_issues, mature_audiences, tragedy_and_conflict.

  • SUPPLEMENTAL_MEDIA_ID đã bị ngừng sử dụng trong nội dung quảng cáo ở cấp độ tài khoản quảng cáo và quảng cáo. Bạn không thể đọc trường này nữa.

  • ACTION_SPEC đã bị ngừng sử dụng trong nội dung quảng cáo. Trường này đã được sử dụng với tin được tài trợ mà chúng tôi không hỗ trợ nữa.

  • Trường actor_image_hash, actor_image_url và actor_name trong nội dung quảng cáo đã bị ngừng sử dụng trong phiên bản 2.9 và 2.8. Các trường này đã được sử dụng với action_spec mà chúng tôi cũng đã ngừng sử dụng.

  • link_title và link_description trong call_to_action từ nội dung quảng cáo đã bị ngừng sử dụng. Để đặt tiêu đề và viết mô tả cho nội dung quảng cáo, hãy sử dụng name và description trong link_data hoặc title và link_description trong video_data.

  • run_status=3 - Bạn có thể xóa nội dung quảng cáo có giá trị và trường này. Điều này đã gây ra nhầm lẫn nên chúng tôi đã đổi tên run_status thành status và giá trị từ Int thành giá trị String DELETED. Để xóa nội dung quảng cáo, hãy sử dụng status=DELETED.

  • COVER_PHOTO_ID từ GET trên điểm cuối nội dung {creative_id} và {ad_account_id}/adcreatives đã bị ngừng sử dụng. Trường này hiếm khi được sử dụng và chỉ cho phép sử dụng nội bộ và giới hạn.

  • image_url hoặc image_hash - Bạn hiện chỉ có thể cung cấp một trong các trường này trong video_data cho object_story_spec của nội dung quảng cáo. Hãy xem Nội dung quảng cáo, Tham khảo.

  • OBJECT_INSTAGRAM_ID từ GET cho điểm cuối nội dung đã bị ngừng sử dụng, bao gồm {creative_id} và AD_ACCOUNT_ID/adcreatives. Trường này chỉ cho phép sử dụng nội bộ.

  • instagram_story_id đã được sử dụng để tìm nạp ID bài viết trên Instagram trong nội dung quảng cáo ở v2.8 trở xuống. Nếu bạn sử dụng trường này khi cung cấp nội dung quảng cáo, chúng tôi đã đưa ra một ngoại lệ nhưng đã bỏ qua thông số này và chuyển lại kết quả với instagram_story_id. Nếu sử dụng phản hồi, bạn sẽ gặp lỗi. Để giải quyết vấn đề này, chúng tôi đổi tên instagram_story_id thành effective_instagram_story_id và bạn không nên sử dụng trường này để cung cấp nội dung quảng cáo.

  • Loại trả về spent, today_spent và yesterday_spent cho tất cả mục tiêu quảng cáo hiện là String, chứ không phải Integer. Điều này ảnh hưởng đến chiến dịch, nhóm quảng cáo và quảng cáo.

Quảng cáo động

  • Bộ sản phẩm không được giống nhau - Chúng tôi không cho phép bộ sản phẩm giống nhau trong cùng một danh mục. Nếu bạn cố tạo bộ sản phẩm giống nhau từ cùng một danh mục, API của chúng tôi sẽ trả về FacebookApiException với mã 10803 chứa ID của bộ sản phẩm giống nhau.

  • quoted_fields trong POST /{product_feed_id} đã bị ngừng sử dụng. Trong v2.6, chúng tôi đã xóa quoted_fields trong POST /{product_feed_id/product_feeds}. Như một phần của quá trình loại bỏ bổ sung, chúng tôi hiện cũng không sử dụng trường này.

  • Điểm cuối POST {catalog-id}/batch hiện trả về STRING như một phần của sự cải tiến liên tục đối với danh mục sản phẩm Quảng cáo động.

  • Không thể cập nhật đối tượng - Nếu bạn đang sử dụng quảng cáo động và cố cập nhật đối tượng cho những quảng cáo này, yêu cầu của bạn sẽ không thành công và bị lỗi. Để thay đổi, bạn cần xóa đối tượng được liên kết với quảng cáo động và tạo đối tượng mới. Hãy xem Quảng cáo động, Đối tượng và Đối tượng tùy chỉnh

  • template_url_spec thay thế template_url. Điều này cho phép bạn thực hiện việc theo dõi lượt nhấp và đặt URL theo ngữ cảnh ngoài URL danh mục sản phẩm vào quảng cáo. Ví dụ: đưa ngày nhận phòng và trả phòng đã chọn của ai đó vào quảng cáo. Hãy xem Quảng cáo động, Quản lý quảng cáo.

Tín hiệu và nhắm mục tiêu

  • Đổi tên nguồn sự kiện - Trước đây, khi tạo hoặc truy vấn chuyển đổi tùy chỉnh, bạn sử dụng trường có nhãn pixel_id, pixel_rule và pixel_aggregation_rule. Vì chúng tôi đang hỗ trợ cho dữ liệu chuyển đổi ngoại tuyến và dữ liệu chuyển đổi tùy chỉnh từ ứng dụng, chúng tôi sẽ ghi lại nhãn các trường để biểu thị phạm vi mở rộng. Các trường này hiện được biết đến là event_source_id, rule và aggregation_rule.

  • Pixel theo dõi chuyển đổi - Pixel này đã bị ngừng sử dụng từ 15/2/2017. Như một phần của quá trình này, chúng tôi đã xóa tất cả các cạnh và nút để tạo, cập nhật, đọc hoặc tham chiếu pixel theo dõi chuyển đổi cho tất cả phiên bản của API.

  • friends_of_connection liên kết với ID sự kiện đã bị ngừng sử dụng như một tùy chọn nhắm mục tiêu quảng cáo. Điều này nghĩa là bạn không thể nhắm mục tiêu bạn bè của những người đã chấp nhận lời mời tham gia sự kiện của mình trên Facebook.

  • Hỗ trợ delivery_estimate - Chúng tôi đã thay đổi ước tính số người tiếp cận để hỗ trợ delivery_estimate mới ra mắt:

    • Đã xóa trường bid_estimations khỏi điểm cuối /reach_estimates và đã chuyển tất cả chức năng có giấy phép sang /delivery_estimate

    • /AD_ID/reachestimate đã bị ngừng sử dụng. Để truy cập thông tin này, hãy sử dụng /ADSET_ID/delivery_estimate.

    • Đã xóa trường data.

Thông tin chi tiết

  • Ngừng sử dụng date_preset - Chúng tôi sắp ngừng sử dụng vài giá trị date_preset mà chúng tôi thay thế bằng giá trị mới. Giá trị mới được thiết kế để dễ sử dụng hơn và phù hợp với kỳ vọng của nhà quảng cáo đồng thời sẽ không bao gồm dữ liệu từ ngày hiện tại. Ví dụ: yêu cầu được tạo vào ngày 8/2 và sử dụng khoảng ngày "7 ngày qua" sẽ dẫn đến báo cáo bao gồm toàn bộ ngày 1/2 đến 23:59 ngày 7/2 và loại trừ ngày 8/2. Các giá trị sau đã bị ngừng sử dụng:

    • last_3_days được thay bằng last_3d

    • last_7_days được thay bằng last_7d

    • last_14_days được thay bằng last_14d

    • last_28_days được thay bằng last_28d

    • last_30_days được thay bằng last_30d

    • last_90_days được thay bằng last_90d

    • last_week được thay bằng last_week_sun_sat và last_week_mon_sun

    • this_week được thay bằng this_week_sun_today và this_week_mon_today

    • last_3_months đã bị ngừng sử dụng.

    • Đối với phiên bản 2.8 trở xuống, chúng tôi hỗ trợ cả những giá trị mới này và giá trị đặt trước ngày cũ.

  • Đặt mặc định date_preset - Nếu bạn tạo truy vấn thông tin chi tiết không có date_preset, chúng tôi sẽ đặt mặc định thành last_30_days, bao gồm hoạt động từ 12:00 hôm nay theo múi giờ của tài khoản quảng cáo. Kể từ phiên bản 2.9, giá trị này được đặt mặc định thành last_30d. Điều này bao gồm toàn bộ 30 ngày trước, kết thúc vào 23:59 tối qua, theo múi giờ của tài khoản của bạn và không bao gồm hôm nay.

  • video_complete_watched_actions đã bị ngừng sử dụng. Trường này cung cấp thông tin giống với video_30_sec_watched_actions.

  • unique_impression và unique_social_impressions đã bị ngừng sử dụng. Thay vào đó, vui lòng sử dụng reach và social_reach.

  • newsfeed_clicks, newsfeed_impressions, newsfeed_avg_position, video_avg_sec_watched_actions, video_avg_pct_watched_actions là các số liệu cũ đang bị ngừng sử dụng.

  • Sau đây là nội dung cũ bị ngừng sử dụng trong action_type:: follow, gift_sale, video_play và vote.

  • click_to_play_video hiện có thể truy cập qua phân tích action_video_type.

  • API Thông tin chi tiết đã ngừng sử dụng trường phân tích placement cho dữ liệu phân phối. Chỉ ["publisher_platform", "platform_position"] được hỗ trợ trong phiên bản 2.9. Trong phiên bản 2.8, chúng tôi vẫn hỗ trợ cả trường phân tích ["placement"] hoặc ["publisher_platform", "platform_position"].

  • attribution_spec - Trước đây, bạn sử dụng 2 trường riêng cho khoảng thời gian ghi nhận nhấp và xem trong API Thông tin chi tiết. Hiện tại, bạn nên sử dụng attribution_spec để đặt cả hai trường. Khi bạn đặt attribution_spec, bạn sẽ ghi đè mọi cài đặt hiện có. Nếu bạn đã đặt cả nhấp và xem, khi đặt attribution_spec thành event_type = CLICK_THROUGH, bạn chỉ xóa ghi nhận xem.