Phiên bản 2.11

API Marketing

Phát hành 7/11/2017 | Bài viết trên blog

• Tính năng mới
• Các thay đổi lớn
• Ngừng hoạt động
• Ngừng sử dụng ngay lập tức

Tính năng mới

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

Hiện tại, chúng tôi có mối quan hệ mới biểu thị khách hàng và đại lý. Trước đây, chúng tôi cũng không có user; chúng tôi đã xử lý mọi quyền truy cập và lời mời tham gia doanh nghiệp cũng như tài sản của họ thông qua bid/userpermissions, điều này đã dẫn đến các vấn đề về hiệu quả. Điểm nổi bật của API mới bao gồm như sau:

• Người dùng trong phạm vi doanh nghiệp - Người dùng mới được liên kết với một doanh nghiệp cụ thể và có các quyền thuộc phạm vi doanh nghiệp này. Người dùng có thể quản lý trang cá nhân, quyền và 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 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 của lời mời người dùng tại các điểm cuối này.
• Danh mục tài sản - Tách các loại tài sản khác nhau thành danh mục và cung cấp điểm cuối riêng cho từng danh mục. Điều này giúp dễ dàng phân trang kết quả khi bạn đọc tài sản. Thao tác này cũng giúp 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. Để 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 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 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 trang của doanh nghiệp:

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

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

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

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

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

Cách truy cập ứng dụng của doanh nghiệp:

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

Để biết thêm thông tin, hãy xem phần Trình quản lý doanh nghiệp, API, Trình quản lý doanh nghiệp, 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ý doanh nghiệp, Cách làm tốt nhất.

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

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

• POST /AD_ACCOUNT_ID/adcreatives
• GET CREATIVE_ID

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

Hiện tại, bạn có thể nhắm mục tiêu các khu vực địa lý ngoài phạm vi bán kính của 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à số lượt ghé thăm cửa hàng. Do có một số giới hạn nên hãy liên hệ với Đại diện Facebook để có quyền truy cập. Xem Mục tiêu số lượt ghé thăm cửa hàng

• POST AD_ACCOUNT_ID/adsets có tùy chọn mới.
• Hỗ trợ tất cả khu vực địa lý trong Thông số nhắm mục tiêu, Vị trí ngoại trừ nhắm mục tiêu theo country_groups và nhắm mục tiêu loại vị trí travel_in.
• Có một số giới hạn khi tạo quảng cáo với mục tiêu STORE_VISITS, xem phần Số lượt ghé thăm cửa hàng

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

Phần này phản ánh loại trang đích mà quảng cáo liên kết tới. Nói cách khác, đó là nơi người dùng đi tới khi họ nhấp vào một quảng cáo hoặc nút kêu gọi hành động trong quảng cáo. Điều này giúp cung cấp loại trang đích nhất quán cho tất cả các quảng cáo trong nhóm quảng cáo, sao cho quảng cáo chỉ chứa các loại nội dung quảng cáo khác nhau. Xem phần Nhóm quảng cáo, Loại trang đích.

• Thêm destination_type cho nhóm quảng cáo
• Có tại /ADSET_ID

Chỉ số hiệu quả chính

Thêm trường mới kpi_type vào AD_ACCOUNT_ID/CAMPAIGN_ID để mô tả loại chỉ số hiệu quả chính mà bạn muốn theo dõi cho chiến dịch hoặc mục tiêu 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 Chiến dịch quảng cáo, Tài liệu tham khảo.

Các thay đổi lớn

Quản lý quảng cáo

• Vô hiệu hóa 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 có nội dung không hợp lệ cho right_hand_column trên AD_ACCOUNT_ID/adsets sẽ trả về lỗi. Chúng tôi không cho phép vị trí quảng cáo chỉ dành cho right_hand_column có đị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ỉ dành cho right_hand_column, bạn chỉ có thể sử dụng định dạng một hình ảnh và định dạng quay vòng.

• Thay đổiGET VERSION/RF_PREDICTION_ID/pause_periods - Để trả về Array, chứ không phải String nhằm giúp xử lý dễ dàng hơn.

API Trình quản lý doanh nghiệp

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

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

Ngừng hoạt động

Quản lý quảng cáo

Ngừng sử dụng tối ưu hóa choVIDEO_VIEWS - Các chiến dịch có mục tiêu VIDEO_VIEWS có thể không sử dụng CLICKS, IMPRESSIONS, PAGE_ENGAGEMENT, POST_ENGAGEMENT hoặc REACH làm mục tiêu tối ưu hóa nữa:

• Việc tạo nhóm quảng cáo có các mục tiêu tối ưu hóa này sẽ trả về lỗi.
• Việc sao chép nhóm quảng cáo có mục tiêu tối ưu hóa REACH, sẽ tự động chuyển thành mục tiêu tối ưu hóa VIDEO_VIEWS.
• Việc 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 sẽ trả về lỗi. Lý do là vì việc tạo hoặc sao chép quảng cáo trong nhóm quảng cáo hiện có sẽ tìm cách sử dụng lại bất kỳ mục tiêu tối ưu hóa nào nêu trên.

Các cạnh bị ảnh hưởng bởi thay đổi này:

• 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ụng reach - Là optimization_goal cho mục tiêu mức độ nhận biết thương hiệu. Xóa đối với /adset; tùy chọn này chỉ có sẵn cho tối ưu hóa khả năng nhớ đến quảng cáo. Điều này giúp tránh nhầm lẫn cho bất kỳ ai sử dụng số người tiếp cận làm mục tiêu riêng.

Ngừng sử dụng tối ưu hóaBRAND_AWARENESS - Thay thế bằng AD_RECALL_LIFT. Điều này phản ánh một mô hình phân phối quảng cáo mới, hiệu quả hơn. Mục tiêu tối ưu hóa mới hỗ trợ nội dung kết 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à đặt giá thầu thủ công. BRAND_AWARENESS không còn có sẵn tại:

• 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 chi phí trên mỗi hành độngPOST_ENGAGEMENT - Bạn không thể sử dụng POST_ENGAGEMENT làm billing_event cho mục tiêu này nữa. Điều này sẽ giúp cân đối tốt hơn giữa phân phối quảng cáo và đo lường. Thay đổi này sẽ ảnh hưở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 Đánh giá nâng cao. Trường này còn được gọi là lịch trình báo cáo trong API Atlas. Chúng tôi đã thay thế trường này bằng recurrence_values. Xem phần Đánh giá nâng cao, Lịch trình báo cáo.

Quản lý doanh nghiệp

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

• BUSINESS_ID/userpermissions
• BUSINESS_ID/business_persona
• business_persona_id

Các điểm cuối ngừng sử dụng để 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

Các điểm cuối ngừng sử dụng để quản lý tài sản thuộc về một doanh nghiệp khác:

• 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

Ngừng sử dụng ngay lập tức

Các phần ngừng sử dụng này sẽ ảnh hưởng đến tất cả phiên bản API và sẽ có hiệu lực vào 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 kết nối với trang hợp lệ. Định dạng sau không còn hợp lệ và sẽ trả về lỗi.

Chữ ký không được 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 mà bạn đã tạo trước đây sẽ tiếp tục chạy, nhưng bạn không thể sửa đổi nội dung quảng cáo hay tạo quảng cáo mới sau khi thay đổi này có hiệu lực, nếu không sẽ có lỗi. Xem phần Quảng cáo sự kiện và quảng cáo địa phương và Quảng cáo, Tài liệu tham khảo.