Quảng cáo click đến nhiều đích đến

Hướng dẫn này giải thích cách tạo và đăng quảng cáo click đến nhiều đích đến bằng API Marketing.

Khi nhấp vào quảng cáo click đến nhiều đích đến, người dùng sẽ được chuyển thẳng đến cuộc trò chuyện với doanh nghiệp của bạn trên một hoặc nhiều ứng dụng nhắn tin (Messenger, Instagram hoặc WhatsApp) mà họ có nhiều khả năng sẽ phản hồi nhất. Hãy sử dụng những quảng cáo này để tiếp cận mọi người trên quy mô lớn và cung cấp dịch vụ nổi bật, dành riêng cho từng cá nhân.

Quảng cáo nhiều đích đến là quảng cáo có thể chuyển đến tổ hợp đích đến bất kỳ: đoạn chat trên Messenger, đoạn chat trên Instagram, đoạn chat trên WhatsApp.

Nếu bạn muốn tạo quảng cáo chỉ chuyển đến một đích đến, hãy xem:

Tổng quan về quy trình tạo quảng cáo

Tài liệu này trình bày các bước bạn cần thực hiện để thiết lập tiện ích tích hợp cho quảng cáo click đến nhiều đích đến. Bạn sẽ cần:

  1. Tạo chiến dịch quảng cáo
  2. Tạo nhóm quảng cáo để liên kết quảng cáo với chiến dịch quảng cáo
  3. Tạo nội dung quảng cáo cho loại quảng cáo Nhiều đích đến mà bạn muốn phân phối
  4. Tạo quảng cáo bằng cách liên kết nội dung quảng cáo với nhóm quảng cáo

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

Bắt đầu bằng cách tạo chiến dịch quảng cáo. Để thực hiện, 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:

Thông số

TênMô tả

name

chuỗi

Bắt buộc.
Tên của chiến dịch click đến nhiều đích đến.

objective

enum

Bắt buộc.
Mục tiêu của chiến dịch.
Mục tiêu được hỗ trợ là OUTCOME_ENGAGEMENT, OUTCOME_SALESOUTCOME_TRAFFIC.

special_ad_categories

danh sách<Object>

Bắt buộc.
Hạng mục quảng cáo đặc biệt được liên kết với chiến dịch click đến nhiều đích đến. Hiện tại, chúng tôi không hỗ trợ hạng mục quảng cáo đặc biệt cho các quảng cáo click đến nhiều đích đến. Vì vậy, bạn cần đặt thông số này là NONE hoặc mảng trống. Hãy xem tài liệu tham khảo về Chiến dịch quảng cáo để biết thêm chi tiết.

status

enum

Không bắt buộc.
Tùy chọn hợp lệ là PAUSEDACTIVE.
Nếu trạng thái này là PAUSED, tất cả quảng cáo cũng như nhóm quảng cáo đang hoạt động đều sẽ bị tạm dừng và có trạng thái hiệu lực là CAMPAIGN_PAUSED.

Yêu cầu

curl -X POST \
  -F 'name=Click to Multi Destination Campaign' \
  -F 'objective=OUTCOME_ENGAGEMENT' \
  -F 'status=ACTIVE' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/campaigns

Phản hồi

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

{
  "id": "<AD_CAMPAIGN_ID>"
}

Cập nhật

Bạn có thể cập nhật chiến dịch bằng cách gửi yêu cầu POST đến /<AD_CAMPAIGN_ID>.

Đọc

Để xác minh rằng mình đã tạo thành công chiến dịch click đến nhiều đích đến, bạn có thể gửi yêu cầu GET đến /<AD_CAMPAIGN_ID>. Hãy xem danh sách đầy đủ các thông số có thể sử dụng trong tài liệu tham khảo về Chiến dịch quảng cáo.

Yêu cầu

curl -X GET -G \
  -d 'fields=name,status,objective' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/<AD_CAMPAIGN_ID>

Phản hồi

{
  "name": "Click to Multi Destination Campaign",
  "status": "ACTIVE",
  "objective": "OUTCOME_ENGAGEMENT",
  "id": "<AD_CAMPAIGN_ID>"
}

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

Sau khi bạn tạo chiến dịch quảng cáo, hãy 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:

Thông số

TênMô tả

bid_amount

int32 không dấu

Bắt buộc nếu bạn đặt bid_strategy là LOWEST_COST_WITH_BID_CAP hoặc COST_CAP.
Số tiền tối đa bạn muốn trả cho một kết quả dựa trên optimization_goal của mình.

bid_strategy

enum

Không bắt buộc.
Chiến lược giá thầu cho chiến dịch này phù hợp với mục tiêu kinh doanh cụ thể của bạn. Hãy xem tài liệu tham khảo về Chiến dịch quảng cáo để biết thêm chi tiết.
Giá trị:LOWEST_COST_WITHOUT_CAP, LOWEST_COST_WITH_BID_CAP, COST_CAP

billing_event

enum

Bắt buộc.
Bạn phải đặt thông số này là IMPRESSIONS đối với quảng cáo click đến nhiều đích đến. Meta sẽ lập hóa đơn cho bạn khi quảng cáo của bạn hiển thị với mọi người.

campaign_id

chuỗi số hoặc số nguyên

Bắt buộc.
Một chiến dịch click đến nhiều đích đến hợp lệ mà bạn muốn thêm nhóm quảng cáo này.

daily_budget

int64

Bắt buộc nếu bạn không đặt lifetime_budget.
Ngân sách hàng ngày được xác định bằng đơn vị tiền tệ trên tài khoản của bạn. Chỉ được phép đối với những nhóm quảng cáo có khoảng thời gian (thời gian chênh lệch giữa end_timestart_time) dài hơn 24 giờ.
daily_budget hoặc lifetime_budget phải lớn hơn 0.

destination_type

chuỗi

Bắt buộc.


  • Đặt là MESSAGING_INSTAGRAM_DIRECT_MESSENGER_WHATSAPP nếu bạn muốn sử dụng cả 3 đích đến (Messenger, WhatsApp và Instagram).
  • Đặt là MESSAGING_INSTAGRAM_DIRECT_MESSENGER nếu bạn muốn sử dụng Messenger và Instagram.
  • Đặt là MESSAGING_MESSENGER_WHATSAPP nếu bạn muốn sử dụng Messenger và WhatsApp.
  • Đặt là MESSAGING_INSTAGRAM_DIRECT_WHATSAPP nếu bạn muốn sử dụng WhatsApp và Instagram.

Lưu ý: Nếu thêm WhatsApp vào đích đến, hãy đảm bảo bạn đã kết nối số điện thoại của doanh nghiệp trên WhatsApp với trang của mình. Nếu thêm Instagram vào đích đến, hãy đảm bảo bạn đã kết nối tài khoản kinh doanh trên Instagram với trang của mình.

end_time

datetime

Bắt buộc khi bạn chỉ định lifetime_budget.
Khi tạo một nhóm quảng cáo có daily_budget, hãy chỉ định end_time=0 hoặc để trống trường này để đặt nhóm quảng cáo là chạy liên tục mà không có ngày kết thúc.
Ví dụ:2015-03-12 23:59:59-07:00 hoặc 2015-03-12 23:59:59 PDT. Nhãn thời gian UNIX theo giờ UTC.

lifetime_budget

int64

Bắt buộc nếu bạn không đặt daily_budget.
Ngân sách trọn đời của nhóm quảng cáo được xác định bằng đơn vị tiền tệ trên tài khoản của bạn. Nếu chỉ định thông số này, bạn cũng phải chỉ định end_time.
daily_budget hoặc lifetime_budget phải lớn hơn 0.

name

chuỗi

Bắt buộc.
Tên của nhóm quảng cáo click đến nhiều đích đến.

optimization_goal

enum

Bắt buộc.
Mục tiêu tối ưu hóa của nhóm quảng cáo. Bạn phải đặt thông số này là CONVERSATIONS đối với quảng cáo click đến nhiều đích đến. Tùy thuộc vào mục tiêu của chiến dịch, nhóm quảng cáo có thể đủ điều kiện sử dụng các mục tiêu tối ưu hóa khác.

promoted_object

Bắt buộc.
Đối tượng được quảng cáo trên mọi quảng cáo thuộc nhóm quảng cáo này. Đối với quảng cáo click đến nhiều đích đến, promoted_object có các điều kiện sau đây:

  • page_id: Bắt buộc. ID của Trang Facebook.

Hãy xem bài viết Nhóm quảng cáo, đối tượng được quảng cáo để biết thêm chi tiết.

start_time

datetime

Không bắt buộc.
Thời gian bắt đầu của nhóm quảng cáo. Trường này sẽ mặc định là thời gian hiện tại nếu bạn không cung cấp giá trị nào.
Ví dụ:2015-03-12 23:59:59-07:00 hoặc 2015-03-12 23:59:59 PDT. Nhãn thời gian UNIX theo giờ UTC.

status

enum

Không bắt buộc.
Trạng thái của nhóm quảng cáo. Trạng thái này có thể khác với trạng thái hiệu lực do chiến dịch chính của nhóm quảng cáo. Trường này sẽ mặc định là ACTIVE nếu bạn không cung cấp giá trị nào.
Giá trị:ACTIVE, PAUSED, DELETED, ARCHIVED

targeting

Đối tượng nhắm mục tiêu

Bắt buộc.
Cấu trúc nhắm mục tiêu của quảng cáo click đến Instagram. Hãy xem bài viết Nhắm mục tiêu để biết thêm chi tiết.

time_start

datetime

Không bắt buộc.
Có thể thay thế cho start_time.

time_stop

datetime

Bắt buộc khi bạn chỉ định lifetime_budget.
Có thể thay thế cho end_time.

Hãy truy cập vào tài liệu tham khảo về Nhóm quảng cáo của tài khoản quảng cáo để xem danh sách đầy đủ các thông số có thể sử dụng.

Yêu cầu

curl -X POST \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=<DAILY_BUDGET>' \
  -F 'destination_type=<DESTINATION_TYPE>' \
  -F 'name=<AD_SET_NAME>' \
  -F 'optimization_goal=CONVERSATIONS' \
  -F 'promoted_object={
      "page_id": "<PAGE_ID>"
    }' \
  -F 'status=ACTIVE' \
  -F 'start_time=<START_TIME>' \
  -F 'targeting={ 
        "geo_locations": { "countries":["US","CA"] },
        "device_platforms": ["mobile", "desktop"]
  }' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

Phản hồi

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

{
  "id": "<AD_SET_ID>"
}

Cập nhật

Bạn có thể cập nhật nhóm quảng cáo bằng cách gửi yêu cầu POST đến /<AD_SET_ID>.

Đọc

Để xác minh rằng mình đã tạo thành công nhóm quảng cáo click đến nhiều đích đến, bạn có thể gửi yêu cầu GET đến /<AD_SET_ID>. Hãy xem danh sách đầy đủ các thông số có thể sử dụng trong tài liệu tham khảo về Nhóm quảng cáo.

Yêu cầu

curl -X GET -G \
  -d 'fields=name,destination_type,optimization_goal,bid_strategy' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/<AD_SET_ID>

Phản hồi

{
  "name": "<AD_SET_NAME>",
  "destination_type": "<DESTINATION_TYPE>",
  "optimization_goal": "CONVERSATIONS",
  "bid_strategy": "LOWEST_COST_WITHOUT_CAP'"
  "id": "<AD_SET_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. Để 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:

Thông số

TênMô tả

asset_feed_spec

Bắt buộc.
Chỉ định đích đến của quảng cáo click đến Nhiều đích đến

Bắt buộc:

  • optimization_type: Bạn phải đặt thông số này là DOF_MESSAGING_DESTINATION đối với quảng cáo click đến nhiều đích đến.
  • call_to_actions: Mảng đích đến được chọn của quảng cáo click đến nhiều đích đến. Thông số này cần phải khớp với destination_type được chỉ định trong nhóm quảng cáo.

Messenger

{
  "type": "MESSAGE_PAGE",
    "value": {
       "app_destination": "MESSENGER",
       "link": "https://fb.com/messenger_doc/"
    }
} 

WhatsApp

{
  "type": "WHATSAPP_MESSAGE",
    "value": {
       "app_destination": "WHATSAPP",
       "link": "https://api.whatsapp.com/send"
    }
}

Instagram

{
  "type": "INSTAGRAM_MESSAGE",
    "value": {
       "app_destination": "INSTAGRAM_DIRECT",
       "link": "https://www.instagram.com"
    }
}

name

chuỗi

Bắt buộc.
Tên của nội dung quảng cáo.

object_story_spec

Bắt buộc.
Một đối tượng chứa thông tin về tin nhắn. Hãy xem bài viết Quy cách tin cho đối tượng nội dung quảng cáo để biết thêm chi tiết.


Bắt buộc:

  • page_id: ID của Trang Facebook
  • instagram_actor_id: ID tài khoản Instagram. Có 3 cách để lấy ID tài khoản Instagram: tài khoản Instagram thuộc sở hữu của Trình quản lý kinh doanh, tài khoản Instagram đã kết nối với Trang và tài khoản Instagram dựa trên Trang.

Không bắt buộc:

  • link_data: Quy cách cho bài viết có liên kết trên trang hoặc quảng cáo quay vòng
  • photo_data: Quy cách cho bài viết có ảnh trên trang
  • text_data: Quy cách cho bài viết có văn bản trên trang
  • video_data: Quy cách cho bài viết có video trên trang

degrees_of_freedom_spec

Không bắt buộc.
Hãy xem bài viết Điểm cải thiện tiêu chuẩn cho nội dung Advantage+ để biết thêm chi tiết.

Hãy truy cập vào tài liệu tham khảo về Nội dung quảng cáo để xem danh sách đầy đủ các thông số có thể sử dụng.

Điền tin nhắn chào mừng trên Trang

Tin nhắn mặc định mà khách hàng nhìn thấy là "Xin chào! Cho mình xin thêm thông tin được không?". Bạn có thể tạo trải nghiệm người dùng phù hợp hơn cho quảng cáo click đến nhiều đích đến bằng cách tùy chỉnh tin nhắn chào, tin nhắn bắt chuyện và tin nhắn tự động điền của quảng cáo trong trường page_welcome_message thuộc phần object_story_spec.

Ví dụ

Thêm tin nhắn bắt chuyện kèm theo tin nhắn chào.

"page_welcome_message": {
  "type": "VISUAL_EDITOR",
  "version": 2,
  "landing_screen_type": "welcome_message",
  "media_type": "text",
  "text_format": {
    "customer_action_type": "ice_breakers",
    "message": {
      "text": "<GREETING_MESSAGE>",
      "ice_breakers": [
        {
          "title": "<ICEBREAKER>"
        },
        {
          "title": "<ICEBREAKER>"
        },
        {
          "title": "<ICEBREAKER>"
        }
      ]
    }
  }
}

Ví dụ về tạo nội dung quảng cáo

Yêu cầu

curl -X POST \
-F 'name=<CREATIVE_NAME>' \
-F 'object_story_spec={
     "page_id": "438346666550309",
     "link_data": {
       "name": "<AD_HEADLINE>",
       "message": "<AD_PRIMARY_TEXT>",
       "image_hash": "<IMAGE_HASH>"
       "link": "https://fb.com/messenger_doc/",
       "page_welcome_message": "<PAGE_WELCOME_MESSAGE>",
       "call_to_action": {
         "type": "MESSAGE_PAGE",
         "value": {
           "app_destination": "MESSENGER"
         }
       }
     }
   }' \
-F 'asset_feed_spec={
     "optimization_type": "DOF_MESSAGING_DESTINATION",
     "call_to_actions": [
       {
         "type": "MESSAGE_PAGE",
         "value": {
           "app_destination": "MESSENGER",
           "link": "https://fb.com/messenger_doc/"
         }
       },
       {
         "type": "WHATSAPP_MESSAGE",
         "value": {
           "app_destination": "WHATSAPP",
           "link": "https://api.whatsapp.com/send"
         }
       },
       {
         "type": "INSTAGRAM_MESSAGE",
         "value": {
           "app_destination": "INSTAGRAM_DIRECT",
           "link": "https://www.instagram.com"
         }
       }
     ]
   }' \
-F 'degrees_of_freedom_spec={
     "creative_features_spec": {
       "standard_enhancements": {
         "enroll_status": "OPT_IN"
       }
     }
   }' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

Phản hồi

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

{
  "id": "<AD_CREATIVE_ID>"
}

Cập nhật

Bạn có thể cập nhật nội dung quảng cáo bằng cách gửi yêu cầu POST đến /<AD_CREATIVE_ID>.

Đọc

Để xác minh rằng mình đã tạo thành công nội dung quảng cáo click đến nhiều đích đến, bạn có thể gửi yêu cầu GET đến /<AD_CREATIVE_ID>. Hãy xem danh sách đầy đủ các thông số có thể sử dụng trong bài viết Nội dung quảng cáo.

Yêu cầu

curl -X GET -G \
  -d 'fields=name,object_story_spec{page_welcome_message},asset_feed_spec' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/<AD_CREATIVE_ID>

Phản hồi

{
  "name": "<CREATIVE_NAME>",
  "object_story_spec": {
    "page_welcome_message": {
      "type": "VISUAL_EDITOR",
      "version": 2,
      "landing_screen_type": "welcome_message",
      "media_type": "text",
      "text_format": {
        "customer_action_type": "ice_breakers",
        "message": {
          "text": "Sample greeting message",
          "ice_breakers": [
            {
              "title": "Sample icebreaker"
            },
            {
              "title": "Sample icebreaker"
            },
            {
              "title": "Sample icebreaker"
            }
          ]
        }
      }
    }
  },
  "asset_feed_spec": {
    "optimization_type": "DOF_MESSAGING_DESTINATION",
    "call_to_actions": [
      {
        "type": "MESSAGE_PAGE",
        "value": {
          "app_destination": "MESSENGER",
          "link": "https://fb.com/messenger_doc/"
        }
      },
      {
        "type": "WHATSAPP_MESSAGE",
        "value": {
          "app_destination": "WHATSAPP",
          "link": "https://api.whatsapp.com/send"
        }
      },
      {
        "type": "INSTAGRAM_MESSAGE",
        "value": {
          "app_destination": "INSTAGRAM_DIRECT",
          "link": "https://www.instagram.com"
        }
      }
    ]
  },
  "id": "<AD_CREATIVE_ID>"
}

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

Quảng cáo giúp bạn liên kết thông tin về nội dung quảng cáo với nhóm quảng cáo của mình. Để 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:

Thông số

TênMô tả

name

chuỗi

Bắt buộc.
Tên của nội dung quảng cáo.

adset_id

chuỗi số hoặc số nguyên

Bắt buộc.
ID của nhóm quảng cáo.

creative

Bắt buộc.
Nội dung quảng cáo được dùng cho quảng cáo này. Bạn có thể cung cấp creative_id của một nội dung quảng cáo hiện có hoặc tạo nội dung quảng cáo mới bằng cách thêm tất cả các trường bắt buộc. Hãy xem bài viết Nội dung quảng cáo để biết thêm chi tiết.

status

enum

Bắt buộc.
Trạng thái đã đặt cấu hình của quảng cáo.
Giá trị:ACTIVE, PAUSED, DELETED, ARCHIVED

Yêu cầu

curl -X POST \
  -F 'name=<AD_NAME>' \
  -F 'adset_id=<AD_SET_ID> \
  -F 'creative={
       "creative_id": "<AD_CREATIVE_ID>"
     }' \
  -F 'status=ACTIVE \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/ads

Phản hồi

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

{
  "id": "<AD_ID>"
}

Cập nhật

Bạn có thể cập nhật quảng cáo bằng cách gửi yêu cầu POST đến /<AD_ID>.

Đọc

Để xác minh rằng mình đã tạo thành công quảng cáo click đến nhiều đích đến, bạn có thể gửi yêu cầu GET đến /<AD_ID>. Hãy xem danh sách đầy đủ các thông số có thể sử dụng trong tài liệu tham khảo về quảng cáo.

Yêu cầu

curl -X GET -G \
  -d 'fields=status,adset_id \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/<AD_ID>

Phản hồi

{
  "status": "ACTIVE",
  "adset_id": "<AD_SET_ID>",
  "id": "<AD_ID>"
}