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à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:
Hướng dẫn này giả định rằng bạn:
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:
Tên | Mô tả |
---|---|
chuỗi | Bắt buộc. |
enum | Bắt buộc. |
danh sách<Object> | Bắt buộc. |
enum | Không bắt buộc. |
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/v21.0
/act_<AD_ACCOUNT_ID>/campaigns
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>" }
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>
.
Để 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.
curl -X GET -G \
-d 'fields=name,status,objective' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/<AD_CAMPAIGN_ID>
{ "name": "Click to Multi Destination Campaign", "status": "ACTIVE", "objective": "OUTCOME_ENGAGEMENT", "id": "<AD_CAMPAIGN_ID>" }
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:
Tên | Mô tả |
---|---|
int32 không dấu | Bắt buộc nếu bạn đặt bid_strategy là |
enum | Không bắt buộc. |
enum | Bắt buộc. |
chuỗi số hoặc số nguyên | Bắt buộc. |
int64 | Bắt buộc nếu bạn không đặt |
chuỗi | Bắt buộc.
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. |
datetime | Bắt buộc khi bạn chỉ định |
int64 | Bắt buộc nếu bạn không đặt |
chuỗi | Bắt buộc. |
enum | Bắt buộc. |
| Bắt buộc.
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. |
datetime | Không bắt buộc. |
enum | Không bắt buộc. |
Đối tượng nhắm mục tiêu | Bắt buộc. |
datetime | Không bắt buộc. |
datetime | Bắt buộc khi bạn chỉ định |
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.
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/v21.0
/act_<AD_ACCOUNT_ID>/adsets
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>" }
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>
.
Để 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.
curl -X GET -G \
-d 'fields=name,destination_type,optimization_goal,bid_strategy' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/<AD_SET_ID>
{ "name": "<AD_SET_NAME>", "destination_type": "<DESTINATION_TYPE>", "optimization_goal": "CONVERSATIONS", "bid_strategy": "LOWEST_COST_WITHOUT_CAP'" "id": "<AD_SET_ID>" }
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:
Tên | Mô tả |
---|---|
| Bắt buộc. Bắt buộc:
Messenger { "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" } } |
chuỗi | Bắt buộc. |
| Bắt buộc. Bắt buộc:
Không bắt buộc:
|
| Không bắt buộc. |
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.
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 object_story_spec
.
Để biết thêm thông tin về tin nhắn bắt chuyện, hãy xem ice_breakers
tài liệu tham khảo.
Tạo đối tượng page_welcome_message
để thêm tin nhắn bắt chuyện cùng 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":{ "ice_breakers":[ {"title":"Can I make a purchase?","response":"This is a response 1"}, {"title":"Can I see a menu?", "response":"This is a response 2"}, {"title":"Where are you located?", "response":"This is a response 3"}], "quick_replies":[], "text":"Hi {{user_first_name}}! Please let us know how we can help you."} }, "user_edit":false, "surface":"visual_editor_new" }
Thêm trường page_welcome_message
vào nội dung như sau.
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/v21.0
/act_<AD_ACCOUNT_ID>/adcreatives
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>" }
Hãy tham khảo bài viết Dùng bài viết làm quảng cáo trên Instagram để biết thêm chi tiết.
curl -X POST \
-F 'name=Sample ad creative from Instagram post' \
-F 'object_id=<PAGE_ID>' \
-F 'instagram_user_id=<INSTAGRAM_USER_ID>' \
-F 'source_instagram_media_id=<INSTAGRAM_POST_ID>' \
-F 'call_to_action={
"type": "INSTAGRAM_MESSAGE",
"value": {
"link": "https://www.instagram.com"
}
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/adcreatives
curl -X POST \
-F 'name=Sample ad creative from Instagram image' \
-F 'object_story_spec={
"page_id": "<PAGE_ID>",
"instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
"link_data": {
"message": "<AD_PRIMARY_TEXT>",
"picture": "<IMAGE_URL>"
"page_welcome_message": "<PAGE_WELCOME_MESSAGE>",
"call_to_action": {
"type": "INSTAGRAM_MESSAGE",
"value": {
"app_destination": "INSTAGRAM_DIRECT"
}
}
}
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/adcreatives
Hãy tham khảo bài viết Dùng bài viết làm quảng cáo trên Instagram: Bài viết trên Facebook để biết thêm chi tiết.
curl -i -X POST \
"https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT>/adcreatives
?object_story_id=<postOwnerID_postID>
&instagram_actor_id=<IG_USER_ID>
&call_to_action="{'type':MESSAGE_PAGE,'value':{'app_destination':'MESSENGER'}}"
&access_token=<ACCESS_TOKEN>"
Trong đó, object_story_id
là ID bài viết ở định dạng postOwnerID_postID
và instagram_actor_id
là ID tài khoản Instagram được kết nối với Trang hoặc ID tài khoản Instagram dựa trên Trang. Hãy xem thêm chi tiết trong bài viết Thiết lập tài khoản Instagram với Trang.
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>
.
Để 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.
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/v21.0
/<AD_CREATIVE_ID>
{ "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>" }
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:
Tên | Mô tả |
---|---|
chuỗi | Bắt buộc. |
chuỗi số hoặc số nguyên | Bắt buộc. |
| Bắt buộc. |
enum | Bắt buộc. |
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/v21.0
/act_<AD_ACCOUNT_ID>/ads
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>" }
Bạn cũng có thể đặt nút kêu gọi hành động khi tạo quảng cáo.
"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": "INSTAGRAM_MESSAGE", "value": { "app_destination": "INSTAGRAM_DIRECT", "link": "https://www.instagram.com" } } ] }
Hãy xem tài liệu về Quy cách nguồn cấp dữ liệu tài sản để biết thêm thông tin.
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>
.
Để 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.
curl -X GET -G \
-d 'fields=status,adset_id \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/<AD_ID>
{ "status": "ACTIVE", "adset_id": "<AD_SET_ID>", "id": "<AD_ID>" }