API Marketing

Quảng cáo cuộc gọi

Hướng dẫn này giải thích cách tạo và đăng quảng cáo cuộc gọi bằng API Marketing của Meta.

Trước khi bạn bắt đầu

Hướng dẫn này giả định rằng bạn:

Để thực hiện lệnh gọi thành công đến mọi điểm cuối trong hướng dẫn này, bạn sẽ cần có:

  • Mã truy cập Trang do một người có thể thực hiện tác vụ ADVERTIZE trên Trang đó yêu cầu
  • Bạn phải cấp các quyền sau cho người dùng ứng dụng:
    • ads_management
    • pages_manage_ads
    • pages_read_engagement
    • pages_show_list

Đề xuất

Nhớ đặt giờ làm việc cho doanh nghiệp bạn trong phần Cài đặt Trang Facebook.

Khi thử nghiệm một lệnh gọi API, bạn có thể thêm thông số access_token và đặt thông số này là mã truy cập của mình. Tuy nhiên, khi thực hiện lệnh gọi bảo mật từ ứng dụng của bạn, hãy sử dụng lớp mã truy cập.

Giới hạn

  • Đối tượng mục tiêu phải từ 18 tuổi trở lên
  • Số điện thoại bạn thêm vào Nút kêu gọi hành động phải cùng quốc gia với đối tượng mục tiêu

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

Để tạo chiến dịch quảng cáo, hãy gửi yêu cầu POST đến điểm cuối act_ad_account_id/campaigns, trong đó ad_account_id là ID tài khoản quảng cáo của bạn trên Meta. Yêu cầu của bạn phải bao gồm:

  • name
  • objective - đặt là một trong những mục tiêu được hỗ trợ dưới đây:
    • OUTCOME_AWARENESS
    • OUTCOME_ENGAGEMENT
    • OUTCOME_LEADS
    • OUTCOME_SALES
    • OUTCOME_TRAFFIC
  • special_ad_categories

Yêu cầu mẫu

Được định dạng để dễ đọc. Thay thế các giá trị in đậm, in nghiêng như ad_account_id bằng các giá trị của bạn.
curl -X POST "https://graph.facebook.com/v21.0/act_ad_account_id/campaigns" \
     -H "Content-Type: application/json" \
     -d '{
           "name":"Call_ad_campaign_name",
           "objective":"OUTCOME_TRAFFIC",
           "special_ad_categories":["NONE"],
         }'

Khi thành công, ứng dụng của bạn sẽ nhận được phản hồi JSON chứa ID chiến dịch.

{
  "id": "campaign_id"
}

Bước 2: Tạo nhóm quảng cáo

Để tạo nhóm quảng cáo, hãy gửi yêu cầu POST đến điểm cuối act_ad_account_id/adsets, trong đó ad_account_id là ID tài khoản quảng cáo của bạn trên Meta. Yêu cầu của bạn phải bao gồm:

  • bid_amount
  • billing_event được đặt là IMPRESSIONS
  • campaign_id
  • daily_budget
  • destination_type được đặt là PHONE_CALL
  • name
  • optimization_goal được đặt là QUALITY_CALL đối với quảng cáo cuộc gọi
  • targeting

Yêu cầu mẫu

Được định dạng để dễ đọc. Thay thế các giá trị in đậm, in nghiêng như ad_account_id bằng các giá trị của bạn.
curl -X POST "https://graph.facebook.com/v21.0/act_ad_account_id/adsets"
     -H "Content-Type: application/json" 
     -d '{
           "bid_amount":"Your_bid_amount",
           "billing_event":"IMPRESSIONS",
           "campaign_id":"Your_campaign_id",
           "daily_budget":"Your_daily_budget",
           "destination_type":"PHONE_CALL",
           "name:"Your_call_adset_name",
           "optimization_goal":"QUALITY_CALL",
           "targeting":{ 
             "geo_locations": { "countries":["US","CA"] },
             "device_platforms": ["mobile"],
             "publisher_platforms": ["facebook"] 
           } 
         }'

Khi thành công, ứng dụng của bạn sẽ nhận được phản hồi JSON dưới đây chứa ID nhóm quảng cáo.

{
  "id": "adset_id"
}

Bước 3: Tạo nội dung quảng cáo

Với nội dung quảng cáo, bạn có thể thêm các tài sản vào quảng cáo của mình. Quảng cáo quay vòng, quảng cáo hình ảnh, quảng cáo chỉ có văn bản và quảng cáo video được hỗ trợ.

Để tạo nội dung quảng cáo, hãy gửi yêu cầu POST đến điểm cuối /act_ad_account_id/adcreatives, trong đó ad_account_id là ID tài khoản quảng cáo của bạn trên Meta. Yêu cầu của bạn phải bao gồm:

  • name
  • object_story_spec
  • object_story_spec có đối tượng link_data xác định call_to_action với type được đặt là CALL_NOWvalue làm số điện thoại của doanh nghiệp bạn

Yêu cầu mẫu về quảng cáo hình ảnh

Được định dạng để dễ đọc. Thay thế các giá trị in đậm, in nghiêng như page_access_token bằng các giá trị của bạn.
curl -X POST "https://graph.facebook.com/v21.0/act_ad_account_id/adcreatives"
     -H "Content-Type: application/json" 
     -d '{
           "name":"Your_call_image_ad_name",
           "object_story_spec":{
             "page_id": "your_page_id",
             "link_data": {
               "picture": "Your_image_URL", 
               "link": "Your_business_page_URL", 
               "call_to_action": {
                 "type":"CALL_NOW",
                 "value":{ "link":"tel:+Your_business_phone_number_with_country_code" }
               }   
             }
           }
         }'

Khi thành công, ứng dụng của bạn sẽ nhận được phản hồi JSON dưới đây chứa ID nội dung quảng cáo.

{
  "id": "ad_creative_id"
}

Bước 4: Tạo quảng cáo

Nếu muốn tạo quảng cáo, bạn cần liên kết nội dung quảng cáo và nhóm quảng cáo. Để tạo quảng cáo, hãy gửi yêu cầu POST đến điểm cuối /act_ad_account_id/ads, trong đó ad_account_id là ID tài khoản quảng cáo của bạn trên Meta. Yêu cầu của bạn phải bao gồm:

Yêu cầu mẫu về quảng cáo có nội dung

Được định dạng để dễ đọc. Thay thế các giá trị in đậm, in nghiêng như ad_account_id bằng các giá trị của bạn.
curl -X POST "https://graph.facebook.com/v21.0/act_ad_account_id/ads"
     -H "Content-Type: application/json" 
     -d '{

           "adset_id": "Your_ad_set_id",
           "creative": { "creative_id": "Your_ad_creative_id" },
           "status": "PAUSED"
         }'

Khi thành công, ứng dụng của bạn sẽ nhận được phản hồi JSON dưới đây chứa ID quảng cáo.

{
  "id": "ad_id"
}

Bước tiếp theo

Truy cập vào hướng dẫn Bắt đầu để tìm hiểu cách gửi quảng cáo đi xét duyệt.

Tìm hiểu thêm

Tìm hiểu thêm về API Marketing và các tùy chọn khác cho quảng cáo cuộc gọi.

Trung tâm trợ giúp doanh nghiệp

API Marketing