Quảng cáo của đối tác được quản lý: Tài liệu tham khảo về API

API quảng cáo của đối tác được quản lý khác bao gồm:

• API Quản lý người bán
• API Quản lý quảng cáo của đối tác
• Hướng dẫn sử dụng API không đồng bộ

API Tìm kiếm doanh nghiệp của người bán

Hãy sử dụng API này để tìm kiếm ID doanh nghiệp của người bán hoặc vendor_id cụ thể.

Loại mã truy cập

Để gọi API này, hãy sử dụng mã truy cập do người dùng hệ thống là quản trị viên của Trình quản lý kinh doanh chính (Trình quản lý kinh doanh của trang web thương mại) tạo.

Yêu cầu GET mẫu

curl -X GET \
  -F "child_business_external_id=<VENDOR_ID>" \
  "https://graph.facebook.com/v<API_VERSION>/<Business_id>/owned_businesses?access_token=<ACCESS_TOKEN>"

Phản hồi mẫu

{
    "child_business_id": 3213232
}

API Truy cập siêu dữ liệu doanh nghiệp của người bán

Hãy sử dụng API này để truy xuất siêu dữ liệu về người bán thuộc doanh nghiệp con của người bán sử dụng Quảng cáo của đối tác được quản lý. Siêu dữ liệu trong phản hồi API gồm có:

• Tài sản cho Quảng cáo của đối tác được quản lý: trang, tài khoản quảng cáo, phương thức thanh toán
• Thông tin mẫu tùy chỉnh của người bán
• Thông tin doanh nghiệp của người bán: tên

Loại mã truy cập

Để gọi API này, hãy sử dụng mã truy cập do người dùng hệ thống là quản trị viên của Trình quản lý kinh doanh chính (Trình quản lý kinh doanh của trang web thương mại) tạo.

Loại ID doanh nghiệp

Hãy sử dụng ID Trình quản lý kinh doanh phụ cho lệnh gọi API.

Yêu cầu GET mẫu

curl -X GET \
  "https://graph.facebook.com/v<API_VERSION>/<Business_id>/?fields=collaborative_ads_managed_partner_business_info&access_token=<ACCESS_TOKEN>"

Phản hồi mẫu

{
  "collaborative_ads_managed_partner_business_info": {
    "seller_business_status": "ready",
    "seller_business_info": {
      "seller_external_website_url": "https://www.website.com",
      "partner_facebook_page": {
        "id":"9999999"
      }
    },
    "ad_account": {
      "id": "act_11111111",
      "currency": "USD"
    },
    "page": {
      "id": "3333333"
    },
    "catalog_segment": {
      "id": "2222222"
    },
    "extended_credit": {
      "receiving_credit_allocation_config": {
        "partition_type": "FIXED",
        "id":"66666666"
      },
      "max_balance": {
        "amount":"5,000.00",
        "amount_in_hundredths":"500000",
        "currency":"USD",
        "offsetted_amount":"500000"
      },
      "id":"888888888"
    },
    "active_seller_campaign": {
      "status": "ACTIVE",
      "id": "1111111"
    },
    "template": [
      {
        "budget_percentage": 0.5,
        "campaign_template_id": "4444444",
        "adgroup_template_ids": [
          "5555555"
        ],
        "targeting_type": "retargeting"      
      },
      {
        "budget_percentage": 0.5,
        "campaign_template_id": "6666666",
        "adgroup_template_ids": [
          "7777777"
        ],
        "targeting_type": "prospecting"
      } 
    ]
  },
  "id": "<child_business_manager_id>"
}
    

Lấy mã người dùng hệ thống phụ

Đối với Trình quản lý kinh doanh phụ đã được tích hợp, hãy sử dụng API này để chia sẻ ứng dụng và lấy mã truy cập của ứng dụng đó. Bạn có thể dùng mã này cho mọi lệnh gọi tiếp theo để tạo hoặc quản lý quảng cáo.

Yêu cầu POST mẫu

curl \
  -F 'id=<CHILD_BUSINESS_MANAGER>' \
  -F 'app_id=<App_ID>' \
  -F 'scope=ads_management,business_management' \
  -F 'access_token=<Parent BM Admin System User Access Token>' \
  -F 'appsecret_proof=<APP_SECRET>' \
  "https://graph.facebook.com/<API_VERSION>/<CHILD_BUSINESS_MANAGER_ID>/access_token"

Phản hồi mẫu

{ 
  "access_token": "<CHILD_BM_ACCESS_TOKEN>"
}

API Cập nhật cấu hình doanh nghiệp của người bán

Hãy sử dụng API này để cập nhật thông tin doanh nghiệp của người bán. Bạn có thể cập nhật thông tin doanh nghiệp của người bán (ví dụ: URL trang web bên ngoài hoặc địa chỉ email) và/hoặc tài sản của người bán cho Quảng cáo của đối tác được quản lý (ví dụ: tài khoản quảng cáo đang hoạt động hoặc mẫu chiến dịch tùy chỉnh để tạo quảng cáo). Hãy xem phần Thông số hiện có để biết thêm thông tin.

Để tạo và lấy thông tin Doanh nghiệp của Người bán, hãy xem phần API Tạo doanh nghiệp của người bán. Để tìm ID doanh nghiệp của người bán hiện có, hãy xem phần API Tìm kiếm doanh nghiệp của người bán.

Loại mã truy cập

Để gọi API này, hãy sử dụng mã truy cập của từng Trình quản lý kinh doanh phụ (Trình quản lý kinh doanh của người bán) riêng biệt.

Thông số hiện có

Yêu cầu POST mẫu

curl \
  -F "seller_external_website_url='http://shop.com'" \
  -F "ad_account=<SELLER_ACTIVE_AD_ACCOUNT_ID>" \
  "https://graph.facebook.com/v<API_VERSION>/<Child_Business_id>/managed_partner_business_setup?access_token=<ACCESS_TOKEN>"

Phản hồi mẫu

{
    "id": 3213232, // id of child business
    "meta_data": {
        "seller_business_info": {
            "seller_email_address": "goodseller@fb.com"
            "seller_external_website_url": "www.website.com"
        },
        "ad_account": {
            "id": "434343",
            "spend_limit": "500",
        },
        "page": {
            "id": "123412341",
        },
        "template": [
          {
            "budget_percentage": 0.5,
            "campaign_template_id": "4444444",
            "adgroup_template_ids": [
              "5555555"
            ],
            "targeting_type": "retargeting"      
          },
          {
            "budget_percentage": 0.5,
            "campaign_template_id": "6666666",
            "adgroup_template_ids": [
              "7777777"
            ],
            "targeting_type": "prospecting"
          } 
        ]     
    }
}

Mã lỗi

Sử dụng mẫu

Mẫu là một tài sản được trang web thương mại đặt cấu hình và sử dụng trong dịch vụ Quảng cáo của đối tác được quản lý. Mẫu chứa thông tin chi tiết và tùy chọn cài đặt (còn gọi là "thành phần") giúp thúc đẩy chiến dịch của người bán mà trang web thương mại chạy thay mặt cho người bán.

Thành phần của mẫu gồm có nhóm quảng cáo và quảng cáo, bao gồm cả thông tin như tùy chọn nhắm mục tiêu, nội dung quảng cáo, định dạng, v.v. Mỗi mẫu chiến dịch đều có 4 thành phần bắt buộc, đó là:

• Thành phần nhóm quảng cáo để tìm kiếm khách hàng tiềm năng
• Thành phần quảng cáo
• Thành phần nhóm quảng cáo để nhắm mục tiêu lại
• Thành phần quảng cáo

Loại mẫu

Có 2 loại mẫu, đó là mặc định và tùy chỉnh:

Yêu cầu đối với mẫu tùy chỉnh

Trước khi tạo mẫu tùy chỉnh, trước tiên, trang web thương mại phải tạo Trình quản lý kinh doanh của nhà sản xuất - việc này giúp đảm bảo rằng các chiến dịch được dùng để tạo mẫu sẽ tuân thủ yêu cầu và phương thức tùy chỉnh của Quảng cáo cộng tác cho chiến dịch của người bán. Với vai trò là nhà sản xuất, Trình quản lý kinh doanh có thể được dùng để tạo quảng cáo nguồn cho mục đích tạo mẫu.

Nhóm quảng cáo nhắm mục tiêu lại, nhóm quảng cáo tìm kiếm khách hàng tiềm năng và các thành phần quảng cáo phải có sẵn để thêm và/hoặc đặt cấu hình mẫu chiến dịch tùy chỉnh cho người bán.

Chiến dịch dùng để tạo mẫu phải được liên kết với tài khoản quảng cáo của Quảng cáo cộng tác, đồng thời phải có các tùy chọn cài đặt sau đây:

• Mục tiêu chiến dịch phải là Doanh số theo danh mục.
• Trong Trình quản lý quảng cáo, tùy chọn Tối ưu hóa ngân sách phải được bật ở cấp độ chiến dịch, với chiến dịch giá thầu là "Lowest Cost" (Chi phí thấp nhất).
• Định dạng quảng cáo phải là thẻ quay vòng, không có lớp phủ tĩnh, hình ảnh hay video.

Quy trình tạo mẫu tùy chỉnh

Bước 1: Tạo mẫu chiến dịch tùy chỉnh

1. Chuyển đến tab Tài sản trong Trung tâm cộng tác. Ở tab đó, phần Danh sách cung ứng mẫu sẽ hiển thị tập hợp các mẫu và thành phần mẫu mà bạn có thể dùng cho chiến dịch của người bán.
2. Nhấp vào Tạo mẫu để mở thẻ công cụ tạo bước.
3. Tìm kiếm chiến dịch nguồn hợp lệ hiện có bằng cách cung cấp ID quảng cáo hoặc ID nhóm quảng cáo.
4. Để tạo thành phần mẫu, hãy chọn nhóm quảng cáo và/hoặc quảng cáo được trích xuất từ ID nguồn. Bạn cần tạo cả 4 thành phần (2 quảng cáo và 2 nhóm quảng cáo) cho mẫu tùy chỉnh.
5. Lưu mẫu bằng cách cung cấp tên và nội dung mô tả.

Những thông tin chi tiết cụ thể của người bán như Phân khúc danh mục, Nhóm sản phẩm, trang Facebook và URL đích đến sẽ bị loại bỏ khỏi chiến dịch nguồn trong quá trình tạo mẫu. Chiến dịch cuối cùng được tạo bằng mẫu sẽ có thông tin cụ thể của người bán cho các trường này với ngân sách chiến dịch trọn đời và chiến lược giá thầu chi phí thấp nhất.

Bước 2: Áp dụng mẫu tùy chỉnh cho người bán

Bạn có thể sử dụng mẫu tùy chỉnh như sau:

• Sử dụng lúc tích hợp người bán để chỉ định các mẫu cụ thể cho chiến dịch mới của người bán.
• Thay đổi mẫu để người bán bắt đầu chiến dịch dịp lễ hoặc chiến dịch đặc biệt khác.

Nếu bạn muốn thay đổi mẫu chiến dịch cho người bán, hãy đảm bảo có các thành phần mẫu mà bạn muốn sử dụng để thay thế những thành phần đó trong mẫu chiến dịch hiện tại. Bạn có thể thay thế 1 hoặc tất cả thành phần. Nếu đang tạo mẫu mới cho những người bán không có mẫu tùy chỉnh nào, bạn cần chuẩn bị sẵn cả 4 thành phần (2 quảng cáo và 2 nhóm quảng cáo).

Bạn có thể áp dụng mẫu cho người bán theo một trong những cách sau đây:

Quy trình giao diện người dùng áp dụng mẫu cho một người bán

1. Chuyển đến tab Người bán trong Trung tâm cộng tác và chọn một người bán mà bạn muốn áp dụng mẫu tùy chỉnh.
2. Mở tab Tài sản đã chia sẻ cho người bán đó. Lúc đầu, người bán chưa đặt cấu hình mẫu chiến dịch tùy chỉnh.
3. Nhấp vào Thêm phần tùy chỉnh. Một hộp thoại sẽ bật lên. Tại đây, bạn có thể chọn các thành phần mẫu được tạo ở bước tạo mẫu để áp dụng cho người bán đã chọn.
4. Bạn có thể chỉ định giới hạn chi tiêu tối đa cho nhóm quảng cáo tìm kiếm khách hàng tiềm năng và nhóm quảng cáo nhắm mục tiêu lại. Giới hạn này được biểu thị dưới dạng tỷ lệ phần trăm của tổng ngân sách chiến dịch. Ngân sách sẽ liên tục phân bổ theo thời gian thực trên 2 nhóm quảng cáo đó dựa trên hiệu quả. Tức là tỷ lệ phần trăm ngân sách đã chi tiêu cho mỗi nhóm quảng cáo vào cuối chiến dịch có thể thấp hơn mức chi tiêu tối đa bạn đặt. Theo mặc định, giới hạn chi tiêu tối đa được chia đều cho 2 nhóm quảng cáo, nhưng bạn có thể thay đổi giới hạn này.
5. Nhấp vào Lưu và các thành phần mẫu bạn chọn sẽ được áp dụng cho người bán.

Quy trình giao diện người dùng áp dụng mẫu hàng loạt

Tính năng này nhằm mang lại khả năng mở rộng bằng cách cho phép trang web thương mại áp dụng thành phần mẫu cho nhiều người bán cùng một lúc.

1. Chuyển đến tab Người bán trong Trung tâm cộng tác và chọn một nhóm người bán mà bạn muốn áp dụng mẫu bằng cách sử dụng cột ô để đánh dấu.
2. Nhấp vào Áp dụng mẫu để tiếp tục quy trình áp dụng mẫu.
3. Một hộp thoại sẽ hiện ra dựa trên lựa chọn của người bán

• Nếu những người bán bạn chọn chưa có mẫu tùy chỉnh nào, hãy chọn 4 thành phần mẫu, đồng thời chỉ định tỷ lệ phần trăm giới hạn chi tiêu cho mục tiêu Tìm kiếm khách hàng tiềm năng và Nhắm mục tiêu lại. Theo mặc định, giới hạn chi tiêu được chia đều cho 2 nhóm quảng cáo.
• Nếu những người bán bạn chọn đã được áp dụng mẫu tùy chỉnh trước đó, hãy chọn tất cả, một hoặc một số thành phần mẫu để thay thế cho người bán đã chọn. Bạn có thể thay đổi vị trí nút chuyển để ghi đè tỷ lệ phần trăm giới hạn chi tiêu của Nhóm quảng cáo cho người bán.
• Nếu những người bán bạn chọn bao gồm cả người bán có và không có mẫu tùy chỉnh, một hộp thoại sẽ hiện ra để chọn "Người bán không có mẫu tùy chỉnh nào" hoặc "Người bán có mẫu tùy chỉnh" cho bước tiếp theo. Dựa trên lựa chọn đó, một hộp thoại từ 2 tùy chọn trước sẽ hiện ra.

Nhấp vào Lưu để kết thúc quy trình. Các thành phần mẫu đã chọn sẽ được áp dụng cho người bán bạn chọn.

API Cập nhật cấu hình doanh nghiệp của người bán

Hãy sử dụng API Cập nhật cấu hình doanh nghiệp của người bán để áp dụng mẫu tùy chỉnh cho người bán với thông số đầu vào sau đây: template.

"template":[
  {
    "budget_percentage":0.5,
    "campaign_template_id":"160235235998069",
    "adgroup_template_ids":[
      "447963739637509"
    ],
    "targeting_type":"retargeting"
  },
  {
    "budget_percentage":0.5,
    "campaign_template_id":"278452090413983",
    "adgroup_template_ids":[
      "458654975391261"
    ],
    "targeting_type":"prospecting"
  }
]

Bước 3: Tạo chiến dịch

Hãy tham khảo hướng dẫn tạo chiến dịch chính để tạo và chạy quảng cáo của người bán với các thông số đã chỉ định và mẫu tùy chỉnh được áp dụng trước đó. Để sử dụng mẫu chiến dịch tùy chỉnh được áp dụng cho người bán đó, hãy đặt use_seller_template thành true.