여러 랜딩 페이지 연결 광고

이 가이드에서는 마케팅 API를 사용하여 여러 랜딩 페이지 연결 광고를 만들고 게시하는 방법을 설명합니다.

여러 랜딩 페이지 연결 광고는 해당 광고를 클릭한 사람을 메시지 앱이나 사용자가 답장을 보낼 가능성이 가장 높은 앱(Messenger, Instagram 또는 WhatsApp)에서 비즈니스와의 대화로 바로 연결해 줍니다. 이러한 광고를 활용하여 대규모로 사람들에게 도달하고 우수하고 개별화된 서비스를 제공해 보세요.

여러 랜딩 페이지 광고는 Messenger 채팅, Instagram 채팅, WhatsApp 채팅의 모든 랜딩 페이지 조합으로 연결할 수 있다는 것을 의미합니다.

한 랜딩 페이지로 이동하는 광고를 만드는 방법은 다음과 같습니다.

• Messenger 연결 광고
• Instagram 연결 광고
• WhatsApp 연결 광고

광고 만들기 개요

이 문서에서는 여러 랜딩 페이지 연결 광고를 위한 통합을 설정할 때 따라야 할 단계를 간략히 설명합니다. 다음과 같은 작업을 수행해야 합니다.

1. 광고 캠페인 만들기
2. 광고와 광고 캠페인을 연결하는 광고 세트 만들기
3. 게재하고자 하는 여러 랜딩 페이지 광고 유형에 대한 광고 크리에이티브 만들기
4. 광고 크리에이티브를 광고 세트와 연결하여 광고 만들기

시작하기 전에

이 가이드에서는 다음 항목을 보유하고 있는 상태라고 가정합니다.

• Meta 광고 계정
• 광고에 사용할 모든 자산(예: 이미지, 동영상 등)을 Meta 서버에 업로드함

1단계: 광고 캠페인 만들기

먼저 광고 캠페인을 만듭니다. 이를 위해서는 /act_<AD_ACCOUNT_ID>/campaigns 엔드포인트로 POST 요청을 보냅니다. 여기서 <AD_ACCOUNT_ID>는 Meta 광고 계정의 ID입니다. 요청에는 다음과 같은 항목을 포함해야 합니다.

매개변수

요청

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

응답

요청에 성공하면 앱이 새로 만든 캠페인의 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/v21.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입니다. 요청에는 다음과 같은 항목을 포함해야 합니다.

매개변수

사용 가능한 매개변수의 전체 리스트를 확인하려면 광고 계정 광고 세트 참고 자료를 참조하세요.

요청

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

응답

요청에 성공하면 앱이 새로 만든 광고 세트의 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/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>"
}

3단계: 광고 크리에이티브 만들기

광고 크리에이티브를 사용하면 광고에 자산을 추가할 수 있습니다. 광고 크리에이티브를 만들려면 /act_<AD_ACCOUNT_ID>/adcreatives 엔드포인트로 POST 요청을 보냅니다. 여기서 <AD_ACCOUNT_ID>는 Meta 광고 계정의 ID입니다. 요청에는 다음과 같은 항목을 포함해야 합니다.

매개변수

{
  "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 필드에서 광고의 인사 메시지, 아이스브레이커, 자동 입력 메시지를 맞춤 설정하여 여러 랜딩 페이지 연결 광고에 더욱 맞춤화된 사용자 경험을 만들 수 있습니다.

아이스브레이커에 대한 자세한 내용은 ice_breakers 참고 자료를 참조하세요.

제한 사항

• 아이스브레이커 제목은 80자 이내여야 합니다.
• 아이스브레이커 응답은 300자 이내여야 합니다.
• 메시지 텍스트는 300자 이내여야 합니다.

예

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":{
      "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"
}

광고 크리에이티브 만들기 예시

다음과 같이 page_welcome_message 필드를 크리에이티브에 추가합니다.

요청

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

응답

요청에 성공하면 앱이 새로 만든 광고 크리에이티브의 ID가 포함된 JSON 응답을 받게 됩니다.

{
  "id": "<AD_CREATIVE_ID>"
}

Instagram 콘텐츠를 사용하여 광고 크리에이티브 만들기

Instagram 게시물

자세한 내용은 게시물을 Instagram 광고로 사용을 참조하세요.

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

Instagram 이미지

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

Facebook 콘텐츠를 사용하여 광고 크리에이티브 만들기

자세한 내용은 게시물을 Instagram 광고로 사용: Facebook 게시물을 참조하세요.

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

여기에서 object_story_id는 postOwnerID_postID 형식의 게시물 ID이고 instagram_actor_id는 페이지에 연결된 Instagram 계정 ID 또는 페이지의 지원을 받는 Instagram 계정 ID입니다. 자세한 내용은 페이지로 Instagram 계정 설정을 참조하세요.

업데이트

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

4단계: 광고 만들기

광고를 사용하면 광고 크리에이티브 정보와 광고 세트를 연결할 수 있습니다. 광고를 만들려면 /act_<AD_ACCOUNT_ID>/ads 엔드포인트로 POST 요청을 보냅니다. 여기서 <AD_ACCOUNT_ID>는 Meta 광고 계정의 ID입니다. 요청에는 다음과 같은 항목을 포함해야 합니다.

매개변수

요청

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

응답

요청에 성공하면 앱이 새로 만든 광고의 ID가 포함된 JSON 응답을 받게 됩니다.

{
  "id": "<AD_ID>"
}

행동 유도

광고를 만들 때 행동 유도를 설정할 수도 있습니다.

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

자세한 내용은 자산 피드 사양 문서를 참조하세요.

업데이트

/<AD_ID>로 POST 요청을 보내서 광고를 업데이트할 수 있습니다.

읽기

여러 랜딩 페이지 연결 광고를 성공적으로 만들었는지 확인하려면 /<AD_ID>로 GET 요청을 보내면 됩니다. 사용 가능한 매개변수의 전체 리스트는 광고 참고 자료를 참조하세요.

요청

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