Phiên bản 2.11

API Marketing

Ngày phát hành 07/11/2017 | Ngày hết hạn 07/08/2018 | Bài viết trên blog

• Tính năng mới
• Các thay đổi quan trọng
• Trường hợp ngừng hoạt động
• Trường hợp ngừng hoạt động ngay

Tính năng mới

Thiết kế lại API Trình quản lý kinh doanh

Giờ đây, chúng tôi đã có mối quan hệ mới đại diện cho khách hàng và agency. Trước đây, chúng tôi không có user. Chúng tôi xử lý mọi quyền truy cập và lời mời truy cập vào doanh nghiệp cũng như tài sản doanh nghiệp thông qua bid/userpermissions, dẫn đến các vấn đề về hiệu quả. Điểm nổi bật về API mới:

• Người dùng trong doanh nghiệp - Người dùng mới được liên kết với một doanh nghiệp cụ thể và quyền của người dùng đó được giới hạn trong phạm vi doanh nghiệp này. Người dùng có thể quản lý trang cá nhân, quyền của họ, cũng như quyền truy cập tài sản được liên kết với doanh nghiệp đó.
• Lời mời - Mời mọi người truy cập vào một doanh nghiệp thông qua điểm cuối mới. Hãy kiểm tra và cập nhật trạng thái lời mời người dùng tại các điểm cuối này.
• Hạng mục tài sản - Chia các loại tài sản khác nhau thành nhiều hạng mục và cung cấp điểm cuối riêng cho từng hạng mục. Nhờ đó, hệ thống sẽ phân trang kết quả dễ dàng hơn khi bạn đọc tài sản. Tính năng này cũng góp phần giảm các vấn đề về hiệu quả nếu bạn quản lý hàng nghìn tài sản cho một doanh nghiệp. Trong bản thiết kế lại, chúng tôi đã thêm một số điểm cuối mới.

Cách truy cập vào người dùng trong doanh nghiệp:

• BUSINESS_ID/business_users
• BUSINESS_ID/system_users
• BUSINESS_ID/pending_users

Cách truy cập vào tài sản được chỉ định cho người dùng:

• BUSINESS_USER_ID/assigned_pages
• BUSINESS_USER_ID/assigned_ad_accounts
• BUSINESS_USER_ID/assigned_product_catalogs
• SYSTEM_USER_ID/assigned_pages
• SYSTEM_USER_ID/assigned_ad_accounts
• SYSTEM_USER_ID/assigned_product_catalogs
• PENDING_USER_ID/assigned_pages
• PENDING_USER_ID/assigned_ad_accounts
• PENDING_USER_ID/assigned_product_catalogs

Cách truy cập vào trang kinh doanh:

• BUSINESS_ID/owned_pages - Để lấy danh sách Trang mà doanh nghiệp sở hữu
• BUSINESS_ID/client_pages - Để lấy danh sách Trang mà khách hàng của doanh nghiệp sở hữu
• BUSINESS_ID/pending_owned_pages - Để lấy danh sách Trang mà doanh nghiệp sở hữu và đang chờ phê duyệt
• BUSINESS_ID/pending_client_pages - Để lấy danh sách Trang mà khách hàng của doanh nghiệp sở hữu và đang chờ phê duyệt

Cách truy cập vào tài khoản quảng cáo của doanh nghiệp:

• BUSINESS_ID/owned_ad_accounts - Để lấy danh sách tài khoản quảng cáo mà doanh nghiệp sở hữu
• BUSINESS_ID/client_ad_accounts - Để lấy danh sách tài khoản quảng cáo mà khách hàng của doanh nghiệp sở hữu
• BUSINESS_ID/pending_owned_ad_accounts - Để lấy danh sách tài khoản quảng cáo mà doanh nghiệp sở hữu và đang chờ phê duyệt
• BUSINESS_ID/pending_client_ad_accounts - Để lấy danh sách tài khoản quảng cáo mà khách hàng của doanh nghiệp sở hữu và đang chờ phê duyệt

Cách truy cập vào danh mục sản phẩm của doanh nghiệp

• BUSINESS_ID/owned_product_catalogs - Để lấy danh sách danh mục sản phẩm mà doanh nghiệp sở hữu
• BUSINESS_ID/client_product_catalogs - Để lấy danh sách danh mục sản phẩm mà khách hàng của doanh nghiệp sở hữu

Cách truy cập vào ứng dụng kinh doanh:

• BUSINESS_ID/owned_apps - Để lấy danh sách ứng dụng mà doanh nghiệp sở hữu
• BUSINESS_ID/client_apps - Để lấy danh sách ứng dụng mà khách hàng của doanh nghiệp sở hữu
• BUSINESS_ID/pending_client_apps - Để lấy danh sách ứng dụng mà khách hàng của doanh nghiệp sở hữu và đang chờ phê duyệt

Để biết thêm thông tin, hãy xem các bài viết Trình quản lý kinh doanh, API, Trình quản lý kinh doanh, Người dùng hệ thống, API Quản lý tài sản doanh nghiệp và API Trình quản lý kinh doanh, Cách làm tốt nhất.

Quảng cáo quay vòng, Vị trí theo thời gian thực

Giờ đây, bạn có thể tạo quảng cáo quay vòng có file đính kèm hiển thị vị trí theo thời gian thực. Đã thêm các tùy chọn type=REALTIME và location_source_id = PAGE_ID trong place_data dành cho AD_CREATIVE_ID/object_story_spec. Tùy chọn này có sẵn ở trường object_story_spec trong:

• POST /AD_ACCOUNT_ID/adcreatives
• GET CREATIVE_ID

Lượt ghé thăm cửa hàng, Nhắm mục tiêu theo vị trí địa lý

Giờ đây, bạn có thể nhắm mục tiêu các khu vực địa lý vượt quá bán kính xung quanh vị trí cửa hàng. Chúng tôi đã thêm thông số geo_locations vào trường targeting_specs khi bạn tạo nhóm quảng cáo có mục tiêu là lượt ghé thăm cửa hàng. Do tính năng này hiện được cung cấp ở mức giới hạn, vui lòng liên hệ với Đại diện Facebook của bạn để truy cập. Hãy xem bài viết Mục tiêu lượt ghé thăm cửa hàng

• POST AD_ACCOUNT_ID/adsets có tùy chọn mới.
• Hỗ trợ mọi khu vực địa lý trong bài viết Quy cách nhắm mục tiêu, Vị trí ngoại trừ phương thức nhắm mục tiêu theo country_groups và nhắm mục tiêu theo loại vị trí travel_in.
• Tính năng tạo quảng cáo có mục tiêu là STORE_VISITS hiện đang được cung cấp ở mức giới hạn. Hãy xem bài viết Lượt ghé thăm cửa hàng

Nhóm quảng cáo, Loại đích đến

Tính năng này phản ánh loại đích đến được liên kết với quảng cáo. Nói cách khác, đây là nơi người dùng sẽ được chuyển đến khi nhấp vào quảng cáo hoặc nút kêu gọi hành động trong quảng cáo. Tính năng này cung cấp loại đích đến nhất quán cho mọi quảng cáo trong một nhóm quảng cáo để quảng cáo chỉ chứa các loại nội dung quảng cáo khác nhau. Hãy xem bài viết Nhóm quảng cáo, Loại đích đến.

• Đã thêm destination_type cho nhóm quảng cáo
• Có sẵn tại /ADSET_ID

Chỉ số đo lường hiệu quả

Đã thêm trường mới kpi_type vào AD_ACCOUNT_ID/CAMPAIGN_ID để mô tả loại chỉ số đo lường hiệu quả mà bạn muốn theo dõi cho chiến dịch hoặc các đối tượng quảng cáo trong chiến dịch. Để xem dữ liệu thông tin chi tiết theo kpi_type trong kpi_results, hãy thực hiện các lệnh gọi sau:

• GET CAMPAIGN_ID/insights
• GET ADSET_ID/insights
• GET AD_ID/insights

Để biết thêm thông tin, hãy xem bài viết Chiến dịch quảng cáo, Tài liệu tham khảo.

Các thay đổi quan trọng

Quản lý quảng cáo

• Vô hiệu hóa phương thức nhắm mục tiêu quảng cáoright_hand_column - Các quảng cáo nhắm mục tiêu đến vị trí này và có nội dung không hợp lệ đối với right_hand_column trên AD_ACCOUNT_ID/adsets sẽ trả về lỗi. Bạn không được phép sử dụng vị trí quảng cáo chỉ ở right_hand_column cho định dạng quảng cáo video, bộ sưu tập hoặc canvas. Đối với vị trí quảng cáo chỉ ở right_hand_column, bạn chỉ có thể dùng định dạng quảng cáo một hình ảnh và quay vòng.

• Đã thay đổiGET VERSION/RF_PREDICTION_ID/pause_periods - Giờ đây, hệ thống sẽ trả về Array, thay vì String để cho phép xử lý dễ dàng hơn.

API Trình quản lý kinh doanh

• Đã đổi tên trường - Đã đổi tên trường admin_system_user thành admin và trường system_user thành employee. Thay đổi này ảnh hưởng đến các cạnh sau:

  • /{business-id}/userpermissions
  • /{business-id}/system_users

Trường hợp ngừng hoạt động

Quản lý quảng cáo

Đã ngừng sử dụng mục tiêu tối ưu hóaVIDEO_VIEWS - Các chiến dịch có mục tiêu VIDEO_VIEWS không còn sử dụng được mục tiêu tối ưu hóa CLICKS, IMPRESSIONS, PAGE_ENGAGEMENT, POST_ENGAGEMENT hoặc REACH:

• Nếu bạn tạo nhóm quảng cáo có những mục tiêu tối ưu hóa này, hệ thống sẽ trả về lỗi.
• Nếu bạn sao chép nhóm quảng cáo có mục tiêu tối ưu hóa REACH, hệ thống sẽ tự động chuyển đổi thành mục tiêu tối ưu hóa VIDEO_VIEWS.
• Nếu bạn sao chép nhóm quảng cáo có mục tiêu tối ưu hóa CLICKS, IMPRESSIONS, PAGE_ENGAGEMENT hoặc POST_ENGAGEMENT, hệ thống sẽ trả về lỗi. Nguyên nhân là do việc tạo hoặc sao chép một quảng cáo trong nhóm quảng cáo có sẵn sẽ cố gắng sử dụng lại bất kỳ mục tiêu tối ưu hóa nào trong số này.

Thay đổi này tác động đến các cạnh sau:

• POST ACCOUNT_ID/adsets
• POST AD_ACCOUNT_ID/ads
• POST CAMPAIGN_ID/copies
• POST ADSET_ID/copies
• POST AD_ID/copies

Đã ngừng sử dụngreach - Là optimization_goal cho mục tiêu mức độ nhận biết thương hiệu. Đã gỡ đối với /adset. Mục tiêu này chỉ có sẵn cho mục tiêu tối ưu hóa khả năng nhớ đến quảng cáo. Thay đổi này nhằm tránh nhầm lẫn cho những người dùng reach làm mục tiêu riêng.

Đã ngừng sử dụng mục tiêu tối ưu hóaBRAND_AWARENESS - Đã thay bằng AD_RECALL_LIFT. Thay đổi này phản ánh mô hình phân phối quảng cáo mới có hiệu quả hơn. Mục tiêu tối ưu hóa mới hỗ trợ nội dung quảng cáo hỗn hợp, chẳng hạn như quảng cáo tĩnh và quảng cáo video trong cùng một nhóm quảng cáo và phiên đặt giá thầu thủ công. BRAND_AWARENESS không còn trong:

• POST /ADSET_ID
• GET /ADSET_ID
• POST /AD_ACCOUNT_ID/adsets

Đã ngừng sử dụngfrequency_cap - Bao gồm các trường lifetime_frequency_cap và frequency_cap_reset_period trên:

• POST AD_ACCOUNT_ID/adsets
• GET /ADSET_ID
• POST /ADSET_ID

Thay vào đó, hãy sử dụng frequency_control_specs.

Đã ngừng sử dụng mục tiêu chi phí trên mỗi hành độngPOST_ENGAGEMENT - Bạn không còn sử dụng được POST_ENGAGEMENT làm billing_event cho mục tiêu này. Thay đổi này giúp thống nhất hoạt động phân phối quảng cáo và đo lường một cách hiệu quả hơn. Thay đổi này tác động đến điểm cuối: /AD_SET_ID.

Thông tin chi tiết về quảng cáo và đo lường

Đã ngừng sử dụngvideo_15_sec_watched_actions trên:

• GET AD_ACCOUNT_ID/insights
• GET CAMPAIGN_ID/insights
• GET ADSET_ID/insights
• GET AD_ID/insights
• POST AD_ACCOUNT_ID/insights
• POST CAMPAIGN_ID/insights
• POST ADSET_ID/insights
• POST AD_ID/insights

Đã ngừng sử dụngrecurrence_value - Từ API Đo lường nâng cao. Trong API Atlas, trường này có tên là lịch báo cáo. Chúng tôi đã thay thế trường này bằng recurrence_values. Hãy xem bài viết Đo lường nâng cao, Lịch báo cáo.

Quản lý doanh nghiệp

Đã ngừng sử dụng các điểm cuối để thiết kế lại API Trình quản lý kinh doanh:

• BUSINESS_ID/userpermissions
• BUSINESS_ID/business_persona
• business_persona_id

Đã ngừng sử dụng điểm cuối để quản lý tài sản của bạn:

• BUSINESS_ID/pages
• BUSINESS_ID/adaccounts
• BUSINESS_ID/product_catalogs
• BUSINESS_ID/apps

Để truy cập tài sản, hãy sử dụng BUSINESS_ID/owned_ASSET hoặc BUSINESS_ID/client_ASSET

Đã ngừng sử dụng các điểm cuối để quản lý tài sản do doanh nghiệp khác sở hữu:

• BUSINESS_ID/assigned_ad_accounts
• BUSINESS_ID/assigned_pages
• BUSINESS_ID/assigned_product_catalogs

Thay vào đó, hãy sử dụng BUSINESS_USER_ID/assigned_ASSET

Trường hợp ngừng hoạt động ngay

Các trường hợp ngừng hoạt động này sẽ tác động đến mọi phiên bản API và có hiệu lực từ ngày 14/11/2017.

Quảng cáo sự kiện và quảng cáo liên kết

Đã ngừng sử dụng tính năng tạo và chỉnh sửa Quảng cáo sự kiện hoặc Quảng cáo liên kết không được liên kết với trang hợp lệ. Định dạng sau không còn hợp lệ và sẽ trả về lỗi.

Các chữ ký không còn được sử dụng nữa:

• Quảng cáo sự kiện

  • Mục tiêu: EVENT_RESPONSES
  • Trường nội dung: body, object_id
• Quảng cáo liên kết

  • Mục tiêu: LINK_CLICKS
  • Trường nội dung: title, body, object_url (image_file hoặc image_hash)

Chữ ký được hỗ trợ

• Quảng cáo sự kiện

  • Mục tiêu: EVENT_RESPONSES
  • Trường nội dung: object_story_id hoặc object_story_spec
• Quảng cáo liên kết

  • Mục tiêu: LINK_CLICKS
  • Trường nội dung: object_story_id hoặc object_story_spec

Các Quảng cáo sự kiện và Quảng cáo liên kết có sẵn mà bạn đã tạo trước đó vẫn tiếp tục chạy, nhưng bạn không thể sửa đổi nội dung quảng cáo hoặc tạo quảng cáo mới sau khi thay đổi này có hiệu lực, nếu không hệ thống sẽ trả về lỗi. Hãy xem bài viết Quảng cáo sự kiện và quảng cáo tại địa phương và Quảng cáo, Tài liệu tham khảo.