API Marketing

Quảng cáo cộng tác

Quảng cáo cộng tác là giải pháp được xây dựng dựa trên quảng cáo danh mục Advantage+. Khi sử dụng quảng cáo này, nhà quảng cáo thương hiệu có thể cộng tác an toàn với nhà bán lẻ hoặc đối tác marketing và đạt được các mục tiêu quảng cáo, chẳng hạn như bán sản phẩm mục tiêu bằng nội dung do nhà bán lẻ cung cấp.

Nhà bán lẻ hoặc đối tác marketing cần chia sẻ một phân khúc danh mục có tất cả sản phẩm của họ với nhà quảng cáo thương hiệu. Phân khúc này là một phần danh mục của họ hoặc một siêu tập hợp nhóm sản phẩm. Sau đó, nhà quảng cáo thương hiệu có thể chấp nhận phân khúc danh mục nêu trên và bắt đầu chạy quảng cáo danh mục Advantage+ dựa trên phân khúc danh mục này. Nhà quảng cáo thương hiệu không thể chỉnh sửa phân khúc danh mục, nhưng có thể tạo nhóm sản phẩm của riêng mình dựa trên phân khúc danh mục đó.

Về cơ bản, nhà quảng cáo chạy chiến dịch quảng cáo danh mục Advantage+ để bán hàng theo danh mục sản phẩm. Vì vậy, họ có thể sử dụng báo cáo quảng cáo tiêu chuẩn trên Facebook. Báo cáo này hiện có cả những số liệu liên quan đến phân khúc danh mục.

Ngoài ra, bạn có thể sử dụng báo cáo ở cấp độ sản phẩm và báo cáo ở cấp độ nhà bán lẻ để chỉ hiển thị lượt mua của thương hiệu cho nhà quảng cáo thương hiệu.

Bước thực hiện nâng cao

Dành cho nhà bán lẻ và đối tác marketing:

  • Bước 1: Tích hợp vào Quảng cáo cộng tác
  • Bước 2: Tạo phân khúc danh mục - Phân khúc này phải chứa các sản phẩm thuộc về một trong những đối tác thương hiệu tiềm năng.
  • Bước 3: Chia sẻ phân khúc danh mục với đối tác thương hiệu
  • (Dành riêng cho đối tác marketing) Bước 4: Cung cấp công cụ khám phá cho thương hiệu

Dành cho thương hiệu:

  • Bước 1: Chấp nhận phân khúc danh mục
  • Bước 2: Tạo chiến dịch quảng cáo dựa trên phân khúc danh mục
  • Bước 3: Xem báo cáo - Xem báo cáo liên quan đến các sản phẩm trong phân khúc danh mục.
  • Bước 4 (không bắt buộc): Gỡ lỗi - Dùng công cụ để chẩn đoán và giải quyết vấn đề. Hãy xem bài viết Quảng cáo danh mục Advantage+, Công cụ gỡ lỗi.

Bước thực hiện dành cho nhà bán lẻ và đối tác marketing

Bước 1: Tích hợp vào Quảng cáo cộng tác

Để hoàn tất bước này, ứng dụng của bạn cần có quyền business_management và catalog_management.

Hiện tại, bạn không thể hoàn tất bước này qua API, mà phải hoàn tất qua giao diện người dùng. Để bắt đầu quy trình nêu trên, hãy nhấp vào "Trở thành đối tác bán lẻ" trong Danh mục nhà bán lẻ quảng cáo cộng tác.

Bước 2: Tạo phân khúc danh mục

Để hoàn tất bước này, ứng dụng của bạn cần có quyền business_management và catalog_management.

Tạo phân khúc danh mục dựa trên một trong những danh mục hiện có của bạn. Phân khúc này phải chứa tất cả sản phẩm mà bạn muốn chia sẻ với đối tác thương hiệu.

Để tạo phân khúc danh mục qua API, hãy gửi yêu cầu POST đến cạnh owned_product_catalogs. Sau đây là các trường bắt buộc khi tạo phân khúc danh mục:

  • parent_catalog_id: Danh mục tổng mà bạn dùng để tạo phân khúc. Danh mục này cần tuân theo Quảng cáo cộng tác. Bạn có thể tìm thấy trạng thái của danh mục trong Công cụ quản lý thương mại.
  • catalog_segment_filter: Quy tắc được mã hóa JSON dùng để tạo phân khúc danh mục.

Bước 3: Chia sẻ phân khúc danh mục

Để hoàn tất bước này, ứng dụng của bạn cần có quyền business_management và catalog_management.

Chia sẻ phân khúc danh mục của bạn với đối tác thương hiệu. Để thực hiện việc này qua API, hãy gửi yêu cầu POST đến /{catalog_segment_id}/agencies. Bạn có thể thêm các trường sau đây vào lệnh gọi của mình:

TrườngMô tả

business

loại: chuỗi số hoặc số nguyên

Bắt buộc.

ID của doanh nghiệp sẽ được chia sẻ danh mục.

permitted_tasks

loại: mảng < enum {MANAGE, ADVERTISE} >

Bắt buộc.

Tác vụ mà doanh nghiệp sẽ được phép thực hiện. Tùy chọn có thể sử dụng là: ['ADVERTISE', 'MANAGE'].

utm_settings

loại: đối tượng JSON {enum{campaign_source,campaign_medium,campaign_name}: string}

Không bắt buộc.

Bạn có thể chỉ định campaign_source, campaign_medium và campaign_name.


Ví dụ: {campaign_source: “fb_campaign_source”}.

(Dành riêng cho Đối tác marketing) Bước 4: Cung cấp công cụ khám phá cho thương hiệu

Để hoàn tất bước này, ứng dụng của bạn cần có quyền business_management. Lệnh gọi API phải chứa mã truy cập dành cho người dùng và người dùng đó cần có quyền đối với đối tác, doanh nghiệp hoặc yêu cầu cộng tác gợi ý.

Với vai trò đối tác marketing, bạn cần cung cấp một phương thức để thương hiệu khám phá các đối tác tiềm năng về Quảng cáo cộng tác. Bạn có thể sử dụng những điểm cuối sau đây để tìm nhà bán lẻ:

Nếu thương hiệu tìm thấy đối tác, bạn có thể liên hệ với nhà bán lẻ kèm theo yêu cầu cộng tác. Bạn có thể thực hiện việc đó bằng cách gửi yêu cầu POST sau đây đến /{cpas-collaboration-request-id}:

{business-id}/collaborative_ads_collaboration_requests?
brands=”[“[BRAND NAME]”, “[BRAND NAME 2]”]”&
contact_email=[CONTACT_EMAIL]&
contact_first_name=[CONTACT_FIRST_NAME]&
contact_last_name=[CONTACT_LAST_NAME]&
phone_number=[PHONE NUMBER]&
receiver_business=[RECEIVING BUSINESS ID]
requester_agency_or_brand=[REQUESTING ENTITY - AGENCY, BRAND or MERCHANT]

Theo dõi các lần liên hệ của bạn bằng những điểm cuối sau đây:

Bước thực hiện dành cho thương hiệu

Bước 1: Chấp nhận phân khúc danh mục

Nếu thương hiệu của bạn chưa chấp nhận Điều khoản dịch vụ cho doanh nghiệp mới được chia sẻ, bạn phải làm điều đó.

Sau khi nhận được tài sản được chia sẻ, người dùng quản trị doanh nghiệp cần:

  1. Chuyển đến Trung tâm cộng tác.
  2. Chọn doanh nghiệp mà bạn đang thay mặt chấp nhận Điều khoản dịch vụ.
  3. Chọn Đối tác trong phần điều hướng bên trái.
  4. Nhấp vào nút Chấp nhận tài sản để bắt đầu quy trình chấp nhận.

Sau khi chấp nhận các điều khoản, thương hiệu của bạn có thể thêm mọi người vào phân khúc danh mục bằng điểm cuối /{product-catalog-id}/assigned_users. Lưu ý: Bạn cần có quyền business_management để thực hiện việc này.

Bước 2: Tạo chiến dịch quảng cáo

Để hoàn tất bước này, ứng dụng của bạn cần có quyền business_management và ads_management.

Thương hiệu của bạn có thể sử dụng phân khúc danh mục đã chấp nhận để tạo chiến dịch quảng cáo. Bạn nên sử dụng tài khoản quảng cáo riêng biệt cho mỗi nhà bán lẻ mà bạn muốn chạy Quảng cáo cộng tác. Sau khi tài khoản quảng cáo chuyên dụng được liên kết với một nhà bán lẻ, tài khoản này chỉ có thể chọn phân khúc danh mục thuộc về nhà bán lẻ cụ thể đó.

Để tạo và chạy quảng cáo, bạn sẽ thao tác như thường làm với danh mục sản phẩm của mình, nhưng cần cung cấp catalog_segment_ID thay vì ID danh mục:

curl \
  -F 'name=Product Catalog Sales Campaign' \
  -F 'objective=PRODUCT_CATALOG_SALES' \
  -F 'promoted_object={"product_catalog_id":"<CATALOG_SEGMENT_ID>"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/campaigns

Khi thành công, bạn sẽ nhận được ID chiến dịch quảng cáo mới:

{
"id": "<CAMPAIGN_ID>"
}

Có 4 trường mà bạn thường có thể đặt với quảng cáo danh mục Advantage+, nhưng lại không thể đặt với phân khúc danh mục:

  • multi_share_end_card được đặt là false theo mặc định và bạn không thể thay đổi
  • Bạn không thể thay đổi description trong template_data
  • template_url_spec mà bạn có thể sử dụng cho URL liên kết sâu phải trỏ đến trang web của người bán
  • Quy cách theo dõi tùy chỉnh bị vô hiệu hóa

Bước 3: Xem báo cáo

Sau khi quảng cáo ở trạng thái đang chạy, Nhà quảng cáo thương hiệu có thể lấy số liệu về hiệu quả quảng cáo. Chúng tôi cung cấp một vài số liệu thông tin chi tiết mới ở các cấp độ đối tượng quảng cáo khác nhau. Hãy xem catalog_segment_value và những số liệu liên quan cho:

catalog_segment_value chứa số liệu chia nhỏ về sự kiện chuyển đổi, bao gồm cả lượt mua, lượt thêm vào giỏ hàng và lượt xem sản phẩm cho phân khúc danh mục ở mỗi cấp độ đối tượng quảng cáo. Số liệu này tổng hợp các sự kiện trên trang web, di động và nguồn đa kênh. Tìm hiểu thêm về Số liệu thông tin chi tiết ước tính và đang phát triển.

Bước 4: Gỡ lỗi và chẩn đoán vấn đề

Lúc này, thương hiệu cần khắc phục và gỡ lỗi mọi vấn đề khi chạy quảng cáo danh mục Advantage+ cho phân khúc danh mục.

Hãy xem bài viết Công cụ gỡ lỗi quảng cáo danh mục Advantage+.

Thông tin chi tiết

Sau đây là các số liệu ước tính liên quan đến Quảng cáo cộng tác. Hãy xem bài viết Giới thiệu về số liệu ước tính, số liệu đang phát triển và số liệu của bên thứ ba.

Để truy vấn bất kỳ số liệu báo cáo nào của chúng tôi:

  • Ứng dụng của bạn cần có quyền ads_management và business_management. Hãy xem bài viết Xét duyệt ứng dụng.
  • Bạn cần có mã truy cập dành cho người dùng và người dùng này phải được phép xem báo cáo cho tài khoản quảng cáo liên quan.

Bạn có thể truy vấn các đối tượng sau đây: tài khoản quảng cáo, chiến dịch quảng cáo, nhóm quảng cáo và quảng cáo.

Không hỗ trợ số liệu chia nhỏ action_converted_product_id ở cấp độ tài khoản quảng cáo.

MetricDescription

catalog_segment_value

Value from conversion events, including a breakdown of purchases, add-to-carts and view products for the catalog segment at each ad object level.

catalog_segment_value_omni_purchase_roas

Total return on ad spend (ROAS) from purchases of items shared between Brand and Retailer. This number is based on information received from one or more Retailer' connected Facebook Business Tools. The amount is attributed to your ads.

catalog_segment_value_website_purchase_roas

Total return on ad spend (ROAS) from website purchases of items shared between Brand and Retailer. This number is based on information received from one or more Retailers' connected Facebook Business Tools. The amount is attributed to your ads.

catalog_segment_value_mobile_purchase_roas

The total return on ad spend (ROAS) from mobile app purchases of items shared between Brand and Retailer. This number is based on information received from one or more Retailers' connected Facebook Business Tools. The amount is attributed to your ads.

catalog_segment_actions

Similar to catalog_segment_value, when using this metric a breakdown of actions is given for the catalog segment at each ad object level.

converted_product_value

Value of conversions driven by your ads for a given product ID. This number is recorded by your Retailer partner's Pixel or App SDK.


The API only returns Product IDs —see /{product-item-id} for information. If you want to get brand names as well, please use Ads Manager.

converted_product_quantity

Quantity of conversions driven by your ads for a given product ID. This number is recorded by your Retailer partner's Pixel or App SDK.


The API only returns Product IDs —see /{product-item-id} for information. If you want to get brand names as well, please use Ads Manager.

Số liệu chia nhỏ

Số liệu chia nhỏ được dùng để nhóm kết quả thông tin chi tiết của bạn thành các nhóm khác nhau. Hãy xem bài viết Số liệu chia nhỏ. Bạn có thể sử dụng các số liệu chia nhỏ sau đây với số liệu về Quảng cáo cộng tác:

  • Ngày: Lấy thông tin chi tiết trong một khoảng ngày cụ thể. Để sử dụng số liệu chia nhỏ này, hãy thêm time_range vào truy vấn của bạn. Ví dụ: &time_range[since]=2020-03-01&time_range[until]=2020-04-01.

  • Cấp độ sản phẩm: Lấy thông tin chi tiết về một sản phẩm cụ thể. Hãy sử dụng số liệu chia nhỏ này cho converted_product_value và converted_product_quantity metrics bằng cách thêm &action_breakdowns=action_converted_product_id vào truy vấn của bạn.

Kết hợp số liệu chia nhỏ

Hãy sử dụng các số liệu chia nhỏ kết hợp sau đây cho Quảng cáo cộng tác:

Không hỗ trợ số liệu chia nhỏ action_converted_product_id ở cấp độ tài khoản quảng cáo.

  • action_converted_product_id
  • action_type, action_converted_product_id