Quảng cáo click đến WhatsApp

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

Khi nhấp vào quảng cáo click đến WhatsApp, 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 WhatsApp. 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 click đến WhatsApp hỗ trợ quảng cáo có chứa hình ảnh, video, thẻ quay vòng hoặc bản trình chiếu. Bạn cũng có thể thêm gợi ý gọi điện vào quảng cáo của mình.

Nếu bạn muốn tạo quảng cáo chuyển người dùng đến đoạn chat trên Messenger hoặc Instagram, hãy xem hướng dẫn trong bài viết Quảng cáo click đến Messenger hoặc Quảng cáo click đến Instagram. Bạn cũng có thể tạo quảng cáo chọn đích đến mà người dùng có nhiều khả năng sẽ phản hồi nhất, hãy xem bài viết Quảng cáo click đến nhiều đích đến để biết thêm thông tin.

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 WhatsApp.

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 trên WhatsApp 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
  5. Đăng quảng cáo lên Facebook, Instagram và Messenger

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 dùng có thể thực hiện tác vụ ADVERTISE 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

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 WhatsApp.

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.
Lưu ý: Đối với chiến dịch có gợi ý gọi điện, objective phải là OUTCOME_ENGAGEMENT.

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 WhatsApp. 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 tiêu chuẩn

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

Yêu cầu cho chiến dịch gọi điện

curl -X POST \
  -F 'name=Click to WhatsApp Calling Campaign' \
  -F 'objective=OUTCOME_ENGAGEMENT' \
  -F 'status=PAUSED' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.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 bạn đã tạo thành công chiến dịch click đến WhatsApp, 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/v21.0/<AD_CAMPAIGN_ID>

Phản hồi

{
  "name": "Click to WhatsApp Campaign",
  "status": "PAUSED",
  "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 WhatsApp. 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 WhatsApp 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à WHATSAPP đối với quảng cáo click đến WhatsApp có một đích đến.

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 WhatsApp.

optimization_goal

enum

Bắt buộc.
Mục tiêu tối ưu hóa của nhóm quảng cáo. 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 nhau.


OUTCOME_ENGAGEMENT: Mục tiêu lượt tương tác có thể tối ưu hóa cho CONVERSATIONSLINK_CLICKS.
OUTCOME_SALES: Mục tiêu doanh số có thể tối ưu hóa cho CONVERSATIONS, OFFSITE_CONVERSIONS, LINK_CLICKS, IMPRESSIONSREACH.
OUTCOME_TRAFFIC: Mục tiêu lưu lượng truy cập có thể tối ưu hóa cho CONVERSATIONS, LANDING_PAGE_VIEWS, LINK_CLICKS, IMPRESSIONS, REACHPOST_ENGAGEMENT.

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 WhatsApp, promoted_object có các điều kiện sau đây:

Bắt buộc:

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

Không bắt buộc:

  • whatsapp_phone_number: Số điện thoại WhatsApp được liên kết với nhóm quảng cáo click đến WhatsApp.

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 gốc 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 WhatsApp. 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 \
  -H "Content-Type: application/json" \
  -d '{
    "access_token":"<ACCESS_TOKEN>",
    "bid_amount":"<BID_AMOUNT>",
    "billing_event":"IMPRESSIONS",
    "campaign_id":"<CAMPAIGN_ID>",
    "daily_budget":"<DAILY_BUDGET>",
    "destination_type":"WHATSAPP",
    "name": "<AD_SET_NAME>",
    "optimization_goal": "IMPRESSIONS",
    "promoted_object": {
      "page_id": "<PAGE_ID>"
    },
    "status": "PAUSED",
    "start_time": "<START_TIME>",
    "targeting": { 
      "geo_locations": { "countries":["US","CA"] },
      "device_platforms": ["mobile", "desktop"]
    } 
  }' \
"https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets"

Phản hồi

{
  "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 bạn đã tạo thành công nhóm quảng cáo click đến WhatsApp, 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,status' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<AD_SET_ID>

Phản hồi

{
  "name": "Click to WhatsApp Campaign",
  "status": "PAUSED",
  "objective": "OUTCOME_ENGAGEMENT",
  "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ả

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

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 WhatsApp bằng cách tùy chỉnh tin nhắn chào của quảng cáo trong trường page_welcome_message thuộc phần object_story_spec.

Lưu ý: Nếu bạn đang sử dụng tin nhắn WhatsApp để kích hoạt quy trình bot bất kỳ, hãy đảm bảo cập nhật thông tin này cùng BSP và agency của bạn để quy trình đó không bị gián đoạn.

Ví dụ

Thêm tin nhắn tự động điề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": "autofill_message",
    "message": {
      "autofill_message": {
        "content": "<AUTOFILL_MESSAGE>"
      },
      "text": "<GREETING_MESSAGE>"
    }
  }
}

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>"
          }
        ]
      }
    }
  }
}

Thêm tin nhắn có gợi ý gọi điện

curl \
  -F 'object_story_spec={
      "page_id": "<PAGE_ID>"
      "link_data": {
     "image_hash":<IMAGE_HASH>
            "call_to_action": {
              	"type": "WHATSAPP_MESSAGE",
              	"value": {
                  	"app_destination": "WHATSAPP"
             	 }
          },
          "link": "https://api.whatsapp.com/send",
          "name": <AD_HEADLINE>",
          "page_welcome_message":
       "type": "VISUAL_EDITOR",
        "version": 2,
        "landing_screen_type": "ctwa_call_prompt",
        "media_type": "text",
        "text_format": {
          "message": {
            "text": "<MESSAGE>"", 
            "call_prompt_data": {
              "call_prompt_message": "<CALL_PROMPT_MESSAGE>"
            }
          }
        },
        "user_edit": false
      },
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Phản hồi

{
  "id": "<AD_CREATIVE_ID>"
}

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

Yêu cầu

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
        "name": "Sample ad creative",
        "object_story_spec": {
          "page_id": "<PAGE_ID>",
          "link_data": {
            "name": "<AD_HEADLINE>",
            "message": "<AD_PRIMARY_TEXT>",
            "description": "<AD_DESCRIPTION>",
            "image_hash": "<IMAGE_HASH>",
            "link": "https://api.whatsapp.com/send",
            "page_welcome_message": "<PAGE_WELCOME_MESSAGE>",
            "call_to_action": {
              "type": "WHATSAPP_MESSAGE",
              "value": {
                "app_destination": "WHATSAPP"
              }
            }
          }
        },
        "degrees_of_freedom_spec": {
          "creative_features_spec": {
            "standard_enhancements": {
              "enroll_status": "OPT_IN"
            }
          }
        }
      }' \
"https://graph.facebook.com/v21.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>"
}

Tạo nội dung quảng cáo bằng nội dung trên Instagram

Bạn cũng có thể sử dụng nội dung hiện có trên Instagram để tạo nội dung quảng cáo.

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
        "source_instagram_media_id": "<INSTAGRAM_MEDIA_ID>",
        "instagram_user_id": "<INSTAGRAM_USER_ID>",
        "object_id": "<PAGE_ID>",
        "call_to_action": {
          "type": "WHATSAPP_MESSAGE",
            "value": {
              "link": "https://api.whatsapp.com/send",
              "app_destination": "WHATSAPP"
            }
          }
        },
        "degrees_of_freedom_spec": {
          "creative_features_spec": {
            "standard_enhancements": {
              "enroll_status": "OPT_IN"
            }
          }
        }
      }' \
  https://graph.facebook.com/latest-api-version />/act_<AD_ACCOUNT_ID>/adcreatives

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 WhatsApp, 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{link_data{call_to_action,page_welcome_message}}' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<AD_CREATIVE_ID>

Phản hồi

{
  "name": "Sample ad creative",
  "object_story_spec" {
    "page_welcome_message": {
      "type": "VISUAL_EDITOR",
      "version": 2,
      "landing_screen_type": "welcome_message",
      "media_type": "text",
      "text_format": {
        "customer_action_type": "autofill_message",
        "message": {
          "autofill_message": {
            "content": "Sample autofill message"
          },
        "text": "Sample greeting message"
        }
      }
    }
  },
  "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 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 \
  -H "Content-Type: application/json" \
  -d '{
        "name": "Sample ad",
        "adset_id": "<AD_SET_ID>",
        "creative": {
          "creative_id": "<AD_CREATIVE_ID>"
        },
        "status": "PAUSED"
     }' \
  "https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads"

Phản hồi

{
  "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 WhatsApp, 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,campaign_id \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<AD_ID>

Phản hồi

{
  "status": "PAUSED",
  "adset_id": "<AD_SET_ID>",
  "campaign_id": "<AD_CAMPAIGN_ID>",
  "id": "<AD_ID>"
}

Bước 5: Đăng quảng cáo

Xác minh rằng quảng cáo của bạn tồn tại trong Trình quản lý quảng cáo. Khi bạn đã sẵn sàng đăng các thay đổi, hãy chọn chiến dịch của bạn, nhóm quảng cáo cho chiến dịch đó và quảng cáo rồi nhấp vào nút Đăng.

Bạn cũng có thể đăng quảng cáo bằng API. Bạn chỉ cần gửi yêu cầu POST đến /<AD_ID> và đặt thông số statusACTIVE, trong đó <AD_ID> là quảng cáo mà bạn muốn đăng.

Meta sẽ xét duyệt quảng cáo của bạn và trạng thái sẽ là PENDING_REVIEW. Sau khi được phê duyệt, trạng thái sẽ tự động cập nhật thành ACTIVE và hệ thống sẽ phân phối quảng cáo của bạn.