여러 랜딩 페이지 연결 광고
이 가이드에서는 마케팅 API를 사용하여 여러 랜딩 페이지 연결 광고를 만들고 게시하는 방법을 설명합니다.
여러 랜딩 페이지 연결 광고는 해당 광고를 클릭한 사람을 메시지 앱이나 사용자가 답장을 보낼 가능성이 가장 높은 앱(Messenger, Instagram 또는 WhatsApp)에서 비즈니스와의 대화로 바로 연결해 줍니다. 이러한 광고를 활용하여 대규모로 사람들에게 도달하고 우수하고 개별화된 서비스를 제공해 보세요.
여러 랜딩 페이지 광고는 Messenger 채팅, Instagram 채팅, WhatsApp 채팅의 모든 랜딩 페이지 조합으로 연결할 수 있다는 것을 의미합니다.
한 랜딩 페이지로 이동하는 광고를 만드는 방법은 다음과 같습니다.
광고 만들기 개요
이 문서에서는 여러 랜딩 페이지 연결 광고를 위한 통합을 설정할 때 따라야 할 단계를 간략히 설명합니다. 다음과 같은 작업을 수행해야 합니다.
1단계: 광고 캠페인 만들기
먼저 광고 캠페인을 만듭니다. 이를 위해서는 /act_<AD_ACCOUNT_ID>/campaigns 엔드포인트로 POST 요청을 보냅니다. 여기서 <AD_ACCOUNT_ID>는 Meta 광고 계정의 ID입니다. 요청에는 다음과 같은 항목을 포함해야 합니다.
매개변수
| 이름 | 설명 |
|---|---|
문자열 | 필수 항목. |
enum | 필수 항목. |
list<Object> | 필수 항목. |
enum | 선택 사항. |
요청
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
응답
요청에 성공하면 앱이 새로 만든 캠페인의 ID가 포함된 JSON 응답을 받게 됩니다.
{
"id": "<AD_CAMPAIGN_ID>"
}
업데이트
/<AD_CAMPAIGN_ID>로 POST 요청을 보내서 캠페인을 업데이트할 수 있습니다.
읽기
여러 랜딩 페이지 연결 광고 캠페인을 성공적으로 만들었는지 확인하려면 /<AD_CAMPAIGN_ID>로 GET 요청을 보내면 됩니다. 사용 가능한 매개변수의 전체 리스트는 광고 캠페인 참고 자료를 참조하세요.
요청
curl -X GET -G \
-d 'fields=name,status,objective' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/<AD_CAMPAIGN_ID>응답
{
"name": "Click to Multi Destination Campaign",
"status": "ACTIVE",
"objective": "OUTCOME_ENGAGEMENT",
"id": "<AD_CAMPAIGN_ID>"
}
2단계: 광고 세트 만들기
광고 캠페인을 만들었다면 광고 세트를 만듭니다. 광고 세트를 만들려면 /act_<AD_ACCOUNT_ID>/adsets 엔드포인트로 POST 요청을 보냅니다. 여기서 <AD_ACCOUNT_ID>는 Meta 광고 계정의 ID입니다. 요청에는 다음과 같은 항목을 포함해야 합니다.
매개변수
| 이름 | 설명 |
|---|---|
부호 없는 int32 | bid_strategy가 |
enum | 선택 사항. |
enum | 필수 항목. |
숫자 문자열 또는 정수 | 필수 항목. |
int64 |
|
문자열 | 필수 항목.
참고: 랜딩 페이지에 WhatsApp을 포함하는 경우 WhatsApp 비즈니스 전화번호를 페이지에 연결해야 합니다. 랜딩 페이지에 Instagram을 포함하는 경우 Instagram 비즈니스 계정을 페이지에 연결해야 합니다. |
datetime |
|
int64 |
|
문자열 | 필수 항목. |
enum | 필수 항목. |
| 필수 항목.
자세한 내용은 광고 세트, 홍보 개체를 참조하세요. |
datetime | 선택 사항. |
enum | 선택 사항. |
타게팅 개체 | 필수 항목. |
datetime | 선택 사항. |
datetime |
|
사용 가능한 매개변수의 전체 리스트를 확인하려면 광고 계정 광고 세트 참고 자료를 참조하세요.
요청
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
응답
요청에 성공하면 앱이 새로 만든 광고 세트의 ID가 포함된 JSON 응답을 받게 됩니다.
{
"id": "<AD_SET_ID>"
}
업데이트
/<AD_SET_ID>로 POST 요청을 보내서 광고 세트를 업데이트할 수 있습니다.
읽기
여러 랜딩 페이지 연결 광고 세트를 성공적으로 만들었는지 확인하려면 /<AD_SET_ID>로 GET 요청을 보내면 됩니다. 사용 가능한 매개변수의 전체 리스트는 광고 세트 참고 자료를 참조하세요.
요청
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>응답
{
"name": "<AD_SET_NAME>",
"destination_type": "<DESTINATION_TYPE>",
"optimization_goal": "CONVERSATIONS",
"bid_strategy": "LOWEST_COST_WITHOUT_CAP'"
"id": "<AD_SET_ID>"
}
3단계: 광고 크리에이티브 만들기
광고 크리에이티브를 사용하면 광고에 자산을 추가할 수 있습니다. 광고 크리에이티브를 만들려면 /act_<AD_ACCOUNT_ID>/adcreatives 엔드포인트로 POST 요청을 보냅니다. 여기서 <AD_ACCOUNT_ID>는 Meta 광고 계정의 ID입니다. 요청에는 다음과 같은 항목을 포함해야 합니다.
매개변수
| 이름 | 설명 |
|---|---|
| 필수 항목. 필수 항목:
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"
}
}
|
문자열 | 필수 항목. |
| 필수 항목. 필수 항목:
선택 사항:
|
| 선택 사항. |
사용 가능한 매개변수의 전체 리스트는 광고 크리에이티브 참고 자료를 참조하세요.
페이지 환영 메시지 작성
고객에게 표시되는 기본 메시지는 '안녕하세요! 자세한 정보를 알려드릴까요?'입니다. object_story_spec 아래의 page_welcome_message 필드에서 광고의 인사 메시지, 아이스브레이커, 자동 입력 메시지를 맞춤 설정하여 여러 랜딩 페이지 연결 광고에 더욱 맞춤화된 사용자 경험을 만들 수 있습니다.
예
인사 메시지를 포함한 아이스브레이커를 추가합니다.
"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>"
}
]
}
}
}
광고 크리에이티브 만들기 예시
요청
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
응답
요청에 성공하면 앱이 새로 만든 광고 크리에이티브의 ID가 포함된 JSON 응답을 받게 됩니다.
{
"id": "<AD_CREATIVE_ID>"
}
업데이트
/<AD_CREATIVE_ID>로 POST 요청을 보내서 광고 크리에이티브를 업데이트할 수 있습니다.
읽기
여러 랜딩 페이지 연결 광고 크리에이티브를 성공적으로 만들었는지 확인하려면 /<AD_CREATIVE_ID>로 GET 요청을 보내면 됩니다. 사용 가능한 매개변수의 전체 리스트는 광고 크리에이티브를 참조하세요.
요청
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>응답
{
"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>"
}
4단계: 광고 만들기
광고를 사용하면 광고 크리에이티브 정보와 광고 세트를 연결할 수 있습니다. 광고를 만들려면 /act_<AD_ACCOUNT_ID>/ads 엔드포인트로 POST 요청을 보냅니다. 여기서 <AD_ACCOUNT_ID>는 Meta 광고 계정의 ID입니다. 요청에는 다음과 같은 항목을 포함해야 합니다.
매개변수
| 이름 | 설명 |
|---|---|
문자열 | 필수 항목. |
숫자 문자열 또는 정수 | 필수 항목. |
| 필수 항목. |
enum | 필수 항목. |
요청
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
응답
요청에 성공하면 앱이 새로 만든 광고의 ID가 포함된 JSON 응답을 받게 됩니다.
{
"id": "<AD_ID>"
}
업데이트
/<AD_ID>로 POST 요청을 보내서 광고를 업데이트할 수 있습니다.
읽기
여러 랜딩 페이지 연결 광고를 성공적으로 만들었는지 확인하려면 /<AD_ID>로 GET 요청을 보내면 됩니다. 사용 가능한 매개변수의 전체 리스트는 광고 참고 자료를 참조하세요.
요청
curl -X GET -G \
-d 'fields=status,adset_id \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/<AD_ID>응답
{
"status": "ACTIVE",
"adset_id": "<AD_SET_ID>",
"id": "<AD_ID>"
}