Phiên bản 3.0

API Marketing

Phát hành Ngày 01/05/2018 | Dùng được đến Ngày 01/02/2019 | Bài viết trên blog

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

Tính năng mới

Chiến lược giá thầu chi phí thấp nhất, trường thông tin bid_strategy

Chúng tôi đã giới thiệu trường thông tin mới bid_strategy cho {account-id}/adsets. Với trường này, bạn có thể chọn chiến lược đặt giá thầu quảng cáo dựa trên mục tiêu kinh doanh của mình. Mỗi chiến lược đều có ưu điểm và nhược điểm. Các tùy chọn bao gồm:

• LOWEST_COST - Nhận được nhiều kết quả nhất dựa trên optimization_goal là mức độ phân phối và ngân sách nhóm quảng cáo. Facebook sẽ tự động đặt giá thầu cao hơn nếu cần để chi tiêu ngân sách của bạn. Với tùy chọn này, bạn có thể đặt mức giá thầu tối đa hoặc không giới hạn.

• TARGET_COST - Đưa ra chi phí trung bình ổn định cho quảng cáo khi bạn tăng ngân sách nhóm quảng cáo.

Để biết thêm thông tin, hãy xem phần Tối ưu hóa và cách mua quảng cáo, Chiến lược giá thầu

Quảng cáo bộ sưu tập, Tạo

API mới để tạo quảng cáo bộ sưu tập - Trước đây, Facebook đều tạo canvas trong nền mỗi lần bạn tạo quảng cáo bộ sưu tập. Điều này khiến bạn chỉ có thể truy cập vào canvas cơ bản; bạn không thể sử dụng quảng cáo này để nhắm mục tiêu lại đối tượng bằng đối tượng tương tác với canvas. Giờ đây, khi tạo quảng cáo bộ sưu tập từ bộ sản phẩm, bạn cũng phải tạo canvas một cách rõ ràng với đúng thành phần. Khi bạn sử dụng canvas này trong quảng cáo bộ sưu tập, Facebook sẽ tự động tạo quảng cáo bộ sưu tập. Để biết thêm thông tin chi tiết, hãy xem Quảng cáo bộ sưu tập từ bộ sản phẩm.

Các thay đổi quan trọng

Quản lý quảng cáo

• Vô hiệu hóa cột bên phải - Chúng tôi vô hiệu hóa các quảng cáo chỉ nhắm mục tiêu đến vị trí right_hand_column trên Facebook, có mục tiêu không hợp lệ đối với right_hand_column trên {ad_account_id}/adsets. Chúng tôi hiện chỉ hỗ trợ vị trí quảng cáo bên phải cho các định dạng quảng cáo được hỗ trợ có những mục tiêu sau: Lưu lượng truy cập, Chuyển đổi và Doanh số theo danh mục sản phẩm.

• Chúng tôi đã ngừng sử dụng is_autobid và is_average_price_pacing trong cả yêu cầu GET và POST của phiên bản 3.0 trở lên.

Đối tượng và nhắm mục tiêu quảng cáo

• Đã thay đổi cú pháp quy tắc cho Đối tượng tùy chỉnh - Chúng tôi đã cập nhật cấu trúc cho các quy tắc dùng để tạo đối tượng tùy chỉnh từ trang web, đối tượng tùy chỉnh của ứng dụng di động, đối tượng tùy chỉnh tương tác với trang, đối tượng tương tác với quảng cáo tìm kiếm khách hàng tiềm năng, đối tượng tương tác với canvas và đối tượng tùy chỉnh offline. Nhờ vậy, bạn có thể tạo các quy tắc dựa trên hành vi tổng hợp, các quy tắc từ những nguồn sự kiện khác nhau, cũng như loại trừ các quy tắc. Hãy xem:

  • Đối tượng tùy chỉnh từ trang web, Quy tắc đối tượng,

  • Đối tượng tùy chỉnh từ ứng dụng di động, Quy tắc đối tượng,

  • Đối tượng tùy chỉnh tương tác với Trang,

  • Đối tượng tương tác với quảng cáo tìm kiếm khách hàng tiềm năng,

  • Đối tượng tương tác với canvas và

  • Đối tượng tùy chỉnh từ chuyển đổi offline.

Quảng cáo động

• Quyền truy cập danh mục sản phẩm - Để truy cập vào các mặt hàng trong danh mục, bạn phải chỉ định đúng ngành dọc của danh mục. Nếu yêu cầu của bạn không khớp với đúng ngành dọc của danh mục, bạn sẽ nhận được thông báo lỗi. Ví dụ: nếu có danh mục thương mại điện tử thì bạn cần truy cập bằng điểm cuối /products tương ứng, chẳng hạn như GET {catalog_id}/products, GET {product_feed_id}/products hoặc GET {product_set_id}/products. Bạn không thể truy cập vào danh mục bằng các điểm cuối cho những ngành dọc khác, chẳng hạn như GET {catalog_id}/autos, GET {product_feed_id}/hotels hoặc GET {product_set_id}/flights.

• Chuỗi trống trong thẻ mẫu - Chúng tôi không còn cho phép dùng chuỗi trống làm thông số cho Quảng cáo động, tùy chọn thẻ mẫu. Ví dụ: nếu dùng một chuỗi trống cho {{trip.checkin_date date_format:}}, bạn sẽ nhận được thông báo lỗi. Để biết thông tin cơ bản, hãy xem Quảng cáo động, Quản lý quảng cáo.

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

• Hết thời gian chờ thông tin chi tiết - Nếu nhận thấy một yêu cầu API Thông tin chi tiết có thể hết thời gian chờ trước khi hoàn thành, chúng tôi sẽ trả về thông báo lỗi với mã lỗi 100 và mã phụ 1504033. Chúng tôi đánh giá điều này dựa trên quy mô yêu cầu và tiến độ xử lý tương đối so với giới hạn thời gian chờ. Nếu nhận được thông báo lỗi này, bạn nên thực hiện yêu cầu API Thông tin chi tiết không đồng bộ cho dữ liệu này. Xem phần Tác vụ không đồng bộ đến API Thông tin chi tiết

• Giá trị âm trong dữ liệu sự kiện - Nếu bạn đăng dữ liệu sự kiện lên {data_set_id}/events với giá trị âm, thao tác này sẽ không thành công. Điều này sẽ ảnh hưởng đến trường thông tin data cho POST /{data_set_id-id}/events.

• Thông tin chi tiết về tối ưu hóa ngân sách chiến dịch - adset_budget_value hiện trả về using campaign budget khi chiến dịch quảng cáo sử dụng tùy chọn tối ưu hóa ngân sách chiến dịch. Điều này sẽ ảnh hưởng đến:

  • GET {adaccount-id}/insights,

  • GET {campaign-id}/insights,

  • GET {adset-id}/insights,

  • GET {ad-id}/insights,

  • POST {adaccount-id}/insights,

  • POST {campaign-id}/insights,

  • POST {adset-id}/insights,

  • POST {ad-id}/insights.

• Sắp xếp mặc định cho Pixel - Nếu bạn gọi cạnh GET {account_id}/adspixel trên tài khoản kinh doanh hoặc tài khoản quảng cáo, chúng tôi sẽ trả về kết quả (được sắp xếp theo mặc định) theo tên pixel chứ không phải lần kích hoạt pixel gần đây nhất.

• Đổi tên trường thông tin số liệu thống kê pixel - Chúng tôi đã đổi tên trường thông tin timestamp trên cạnh số liệu thống kê pixel thành start_time. Trường này biểu thị thời gian mà chúng tôi bắt đầu tổng hợp dữ liệu hàng giờ về số lượt kích hoạt pixel. Chúng tôi hiện trả về giá trị này theo định dạng đạt tiêu chuẩn ISO 8601 và có bù trừ múi giờ. Điều này giúp khắc phục vấn đề trong đó chúng tôi trả về nhãn thời gian Unix không hợp lệ. Các điểm cuối sau đây sẽ bị ảnh hưởng: GET {ads-pixel-id}/stats.

Ngừng hoạt động

Trình quản lý kinh doanh

Ngừng sử dụng điểm cuối POST {pixel-id}/shared_agencies. Vui lòng sử dụng giao diện người dùng Trình quản lý kinh doanh để chia sẻ pixel quảng cáo với agency.

Quản lý quảng cáo

• Ngừng sử dụng kpi_custom_conversion_id, kpi_type và kpi_results từ /{ad_campaign_id} và /ad_account_ID/campaigns.

• Ngừng sử dụng cờ "redownload" từ các điểm cuối sau đây để đơn giản hóa API:

  • POST {ad-id}/,

  • POST {adset-id}/,

  • POST act_{ad-account-id},

  • POST act_{ad-account-id}/ads,

  • POST act_{ad-account-id}/adsets

  Bạn vẫn có thể đọc thông tin này bằng cách dùng thông số "fields".

• Ngừng sử dụng trường thông tin zipbytes từ POST act_{ad-account-id}/adimages và hủy bỏ khả năng tải lên file ZIP tại cạnh đó. Vui lòng sử dụng hình ảnh có đuôi file: jpg, jpeg, gif, bmp, png, tiff hoặc tif.

• Ngừng sử dụng phương thức tạo quảng cáo bộ sưu tập như hiện tại. Đây là phương thức thực hiện một lệnh gọi API với thông số là tất cả các tài sản được yêu cầu. Thay vào đó, bạn cần tạo canvas trước rồi dùng liên kết canvas để tạo quảng cáo bộ sưu tập. Nhờ vậy, bạn có thể truy cập vào đối tượng canvas cơ bản để nhắm mục tiêu lại đối tượng chẳng hạn. Xem phần Quảng cáo bộ sưu tập.

• Ngừng sử dụng định dạng quảng cáo quay vòng cho các quảng cáo có mục tiêu là Tương tác với bài viết trên Trang. Cách sử dụng này không còn hợp lệ nữa. Xem phần Xác thực, Mục tiêu và nội dung.

Đặt giá thầu và cách mua quảng cáo

• Ngừng sử dụng trường thông tin is_autobid và is_average_price_pacing từ điểm cuối: POST {ad-account-id}/adsets và POST {adset-id}. Thay vào đó, hãy sử dụng trường thông tin bid_strategy mới để chỉ định chiến lược giá thầu cụ thể cho nhóm quảng cáo. Để biết thêm thông tin, hãy xem phần Đặt giá thầu và tối ưu hóa.

• Ngừng sử dụng các trường thông tin trong delivery_estimate cho quảng cáo và tài khoản quảng cáo. Kết quả không đáp ứng nhu cầu của nhà quảng cáo. Hơn nữa, nhiều nhà quảng cáo chưa đạt được mục tiêu kinh doanh tốt nhất với giá thầu mà Facebook gợi ý. Sau đây là các trường thông tin và thông số không dùng nữa:

  • Trường thông tin bid_estimate,

  • Thông số currency,

  • Thông số daily_budget,

  • Thông số optimize_for

  Bạn nên sử dụng giá trị kinh doanh thực sự nhận được từ quảng cáo trên Facebook và đặt giá thầu dựa trên giá trị này. Nếu chưa biết giá trị này, bạn n��n sử dụng tính năng đặt giá thầu tự động. Để biết thông tin cơ bản, hãy xem Trung tâm trợ giúp quảng cáo, Đấu giá quảng cáo cũng như Tối ưu hóa và cách mua quảng cáo.

• Ngừng sử dụng kết quả trả về từ trường thông tin curve_budget_reach trên GET /{rf-prediction-id}. Chúng tôi hiện trả về bản đ�� và ngừng sử dụng giá trị trả về dạng chuỗi được xếp thứ tự JSON. Điều này sẽ ảnh hưởng đến: GET /{rf-prediction-id}.

• Ngừng sử dụng cạnh GET /{ad-account-id}/ratecard.

• Ngừng sử dụng một số trường thông tin liên quan đến lập hóa đơn trên /ad_accounts. Các trường này bao gồm:

  • next_bill_date

  • active_billing_date_preference

  • pending_billing_date_preference

  • active_asl_schedule

  • salesforce_invoice_group_id

  • transactions

  • adspaymentcycle

  • show_checkout_experience

• Ngừng sử dụng trường thông tin pixel_id và external_event_sourceGET /customaudience.

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

• Ngừng sử dụng matched_unique_users trên OFFLINE_EVENT_SET_ID trả về bởi GET /{data-set-id} và GET /{data-set-upload-id}. Xem API Chuyển đổi offline.

• Ngừng sử dụng cạnh attributed_events và trường thông tin attribute_stats trên GET /{data_set_id} API. Sử dụng API GET /{data_set_id}/stats để lấy số liệu thống kê về sự kiện được ghi nhận.

• Ngừng sử dụng trường thông tin matched_unique_users trên OFFLINE_EVENT_SET_ID trả về bởi GET /{data-set-id} và GET /{data-set-upload-id}.

• Ngừng sử dụng các giá trị trả về mặc định tại GET {data_set_upload_id}. Thao tác này sẽ không trả về các trường thông tin sau theo mặc định: first_upload_time, last_upload_time, api_calls, valid_entries, matched_entries, duplicate_entries, event_time_min, event_time_max, event_stats và matched_unique_users.

• Ngừng sử dụng các giá trị trả về mặc định tại GET {data_set_id}/stats. Theo mặc định, thao tác này sẽ chỉ trả về số liệu thống kê về số lượng. Để chỉ định những số liệu thống kê nào sẽ trả về, hãy sử dụng thông số fields hoặc thông số summary cho số liệu thống kê tích lũy, chẳng hạn như average_upload_delay.

• Ngừng sử dụng các giá trị trả về mặc định cho GET {data_set_id}. Theo mặc định, thao tác này sẽ không trả về các trường thông tin sau: attribute_stats, duplicate_entries, event_stats, event_time_max, event_time_min, matched_entries, matched_unique_users, usage, valid_entries.

• Ngừng sử dụng cạnh GET {data-set-upload-id}/stats. Thay vào đó, hãy sử dụng trường thông tin valid_entries hoặc matched_entries từ GET {data-set-upload-id}.

• Ngừng sử dụng canvas_component_avg_pct_view từ API Thông tin chi tiết.