인스턴트 경험

인스턴트 경험은 피드의 광고에서 거의 즉시 읽어들이는 게시물 클릭 전체 화면 랜딩 페이지입니다.

시작하기 전에

인스턴트 경험을 만들고 관리하려면 다음과 같은 항목이 필요합니다.

• pages_manage_ads 권한
• pages_read_engagement 권한
• pages_show_list 권한
• 페이지에서 ADVERTISE 작업을 수행할 권한

제한 사항

• 비공개 인스턴트 경험만 업데이트할 수 있습니다.
• 인스턴트 경험 API는 Instagram에서 제한적으로 사용할 수 있습니다.
• Facebook 스토리에서는 인스턴트 경험을 사용한 광고를 지원하지 않습니다.

만들기

인스턴트 경험을 만들기 위해서는 Facebook 페이지의 ID(PAGE-ID)와 경험에 포함하려는 모든 요소(예: 사진, 버튼, 텍스트)가 필요합니다.

curl \
  -F 'background_color=FFFFFF' \
  -F 'body_element_ids=["<CANVAS_PHOTO_ID>"]' \
  -F 'is_hidden=' \
  -F 'is_published=' \
  -F 'name=Canvas Name' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<PAGE_ID>/canvases

요소

요소 삭제

요소를 삭제하려면 삭제하려는 요소 ID를 포함하여 DELETE 요청을 보냅니다.

curl -X DELETE \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<CANVAS_ELEMENT_ID>

기존 인스턴트 경험 가져오기

기존 인스턴트 경험에 대한 정보를 가져오려면 인스턴트 환경의 ID(CANVAS-ID)가 필요합니다.

curl -G \
  --data-urlencode 'fields=[ 
    "body_elements", 
    "canvas_link", 
    "id", 
    "is_hidden", 
    "is_published", 
    "name" 
  ]' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<CANVAS_ID>

페이지에 대해 모든 인스턴트 경험 가져오기

Facebook 페이지에 대한 모든 기존 인스턴트 경험의 정보를 가져오려면 페이지의 ID(PAGE-ID)가 필요합니다.

curl -G \
  --data-urlencode 'fields=[ 
    "background_color", 
    "body_elements", 
    "canvas_link", 
    "id", 
    "is_hidden", 
    "is_published", 
    "last_editor", 
    "name", 
    "owner", 
    "update_time" 
  ]' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<PAGE_ID>/canvases

인스턴트 경험 업데이트

인스턴트 경험을 업데이트하려면 경험이 비공개 상태여야 하고 인스턴트 경험의 ID(CANVAS-ID)와 업데이트할 요소 ID가 필요합니다.

curl \
  -F 'background_color=FFFFFF' \
  -F 'body_element_ids=["<CANVAS_PHOTO_ID>"]' \
  -F 'is_hidden=' \
  -F 'is_published=' \
  -F 'name=Canvas Name' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<CANVAS_ID>

템플릿 사용

템플릿을 사용하여 특정 비즈니스 목표를 위한 인스턴트 경험을 신속하게 만들 수 있습니다. 각 템플릿의 레이아웃은 고정되어 있지만 기본 콘텐츠를 자체 이미지, 동영상, 제품, 텍스트 및 링크로 대체할 수 있습니다.

템플릿의 요소 유형 가져오기

1단계. 템플릿의 문서 정보 가져오기

GET 요청을 보내서 특정 템플릿에 필요한 요소를 확인합니다. 다음 예시에서는 신규 고객 확보 템플릿을 사용합니다.

curl -i -X GET \
 "https://graph.facebook.com/VERSION/133471657203838?fields=document&access_token=ACCESS-TOKEN"

응답 예시

{
  "document": {
    "name": "Get New Customers",
    "id": "397246414010297"
  },
  "id": "133471657203838"
}

2단계. 요소 유형 가져오기

document 필드에 ID를 사용하여 특정 템플릿에 사용할 수 있는 특정 요소를 가져옵니다.

curl -i -X GET \
 "https://graph.facebook.com/VERSION/397246414010297?fields=body_elements&access_token=ACCESS-TOKEN"

반환된 리스트에는 신규 고객 확보 템플릿에서 사용할 수 있는 요소 유형이 포함됩니다.

    {
  "body_elements": [
    {
      "name": "Cover Image or Video",
      "element_type": "PHOTO",
      "id": "397271930674412"
    },
    {
      "name": "Text",
      "element_type": "RICH_TEXT",
      "id": "397271920674413"
    },
    {
      "name": "Text",
      "element_type": "RICH_TEXT",
      "id": "397271910674414"
    },
    {
      "name": "Button",
      "element_type": "BUTTON",
      "id": "397271914007747"
    },
    {
      "name": "Carousel",
      "element_type": "CAROUSEL",
      "id": "397271940674411"
    },
    {
      "name": "Text",
      "element_type": "RICH_TEXT",
      "id": "397271917341080"
    },
    {
      "name": "Button",
      "element_type": "BUTTON",
      "id": "397271924007746"
    }
  ],
  "id": "397246414010297"
}

게시

인스턴트 경험 광고를 게시하려면 POST 요청을 인스턴트 경험 ID(CANVAS-ID)로 보내고 is_published 필드를 true로 설정합니다.

curl \
  -F 'is_published=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<CANVAS_ID>

광고 크리에이티브 만들기

기존 인스턴트 경험의 링크(CANVAS-ID)를 사용하여 광고 크리에이티브를 만듭니다.

curl -X POST \
  -F 'image_hash="<IMAGE_HASH>"' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "link_data": {
         "image_hash": "<IMAGE_HASH>",
         "link": "<CANVAS_LINK>",
         "name": "Creative message",
         "call_to_action": {
           "type": "LEARN_MORE"
         }
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

광고 크리에이티브가 준비되면 광고 그룹, 광고 세트, 광고 캠페인을 만듭니다.

인스턴트 경험 광고 대화 상자

인스턴트 경험 대화 상자를 사용하여 웹사이트에서 Facebook 인스턴트 경험의 광고 생성 사용자 인터페이스를 제공할 수 있습니다. UI 구성 요소에 대한 자세한 내용은 대화 상자를 참조하세요.

다음 내용을 참조하여 Facebook SDK for JavaScript를 설정합니다.

• 빠른 시작 가이드
• 초기화 참고 자료

JavaScript SDK는 로그인한 사용자 권한으로 인스턴트 경험을 생성합니다. 제공된 페이지와 비즈니스에 대해 사용자에게 인스턴트 경험을 생성할 권한이 없다면 대화 상자에 오류가 나타납니다. 오류가 발생하지 않게 하려면 비즈니스에 속해 있고 해당 페이지에 대한 '광고 만들기' 권한이 있어야 합니다.

그런 다음, 다음과 같이 대화 상자를 트리거합니다.

FB.ui({         
  display: 'popup',
  method: 'instant_experiences_builder',
  business_id: '<BUSINESS_ID>',
  page_id: '<PAGE_ID>'
}, function(response) {
  // callback
});

플러그인에 다음과 같은 설정을 제공할 수 있습니다.

매개변수 canvas_id는 선택 사항이며 사용자가 기존 인스턴트 경험을 수정하거나 미리 볼 수 있도록 합니다. 인스턴트 경험이 완료되면 수정할 수 없습니다. 인스턴트 경험을 미리 보려면 인스턴트 경험 미리 보기 대화 상자를 사용하는 것이 좋습니다.

성공 시 플러그인에서 다음과 같은 응답을 제공합니다.

{
  "success": true,
  "id": "CANVAS-ID"
}

반환된 ID는 게재된 인스턴트 경험입니다. 이제 광고 캠페인에 이 ID를 사용할 수 있습니다. 응답이 없거나 undefined 응답이 반환되면 시청자가 인스턴트 경험을 완료하기 전에 대화 상자를 닫았다는 것을 의미합니다. 사용자가 인스턴트 경험을 저장했을 수는 있으나 아직 완료하지 않은 상태입니다. 그래프 API를 사용하여 페이지에 속한 모든 인스턴트 경험을 불러와서 완료되지 않은 경험이 있는지 확인할 수 있습니다.

인스턴트 경험 미리 보기

iframe 미리 보기 API

광고 미리 보기 API와 유사하게 iframe을 반환하는 미리 보기 API를 호출하여 인스턴스 경험에 대한 미리 보기를 생성할 수 있습니다.

curl -X GET \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v18.0/<CANVAS_ID>/preview
  
Open In Graph API Explorer

이 API는 다음과 같은 정보를 반환하며, 이는 반환된 iframe 요소를 HTML에 포함(embed)하여 확인할 수 있습니다.

{
"data": [
    {
      "body": "<iframe src=\"https://www.facebook.com/ads/canvas/preview?d=AQKELApdJxoVp2f3PHl8-pRtYuAh4-_eDupMDbh-pS9zde_EFxckhYQCXu7NYUi4PhhBA7uskIo2Ys3IjIVNGZiS&t=AQKGOPqGI-NWcv1YKbA\" width=\"405\" height=\"720\" scrolling=\"yes\" style=\"border: none;\"></iframe>"
    }
  ],
  "__www_request_id__": "AQnyr47Qp2r5M-ISqSiMgrw"
}

Facebook SDK

이 대화 상자를 사용하여 웹사이트를 방문한 Facebook 사용자에게 인스턴트 경험이 어떻게 표시되는지 확인하도록 인스턴트 경험 미리 보기를 제공할 수 있습니다. UI 구성 요소에 대한 자세한 내용은 대화 상자를 참조하세요.

다음 내용을 참조하여 Facebook SDK for JavaScript를 설정합니다.

• 빠른 시작 가이드
• 초기화 참고 자료

JavaScript SDK는 로그인한 사용자 권한으로 인스턴트 경험을 생성합니다. 사용자에게 인스턴트 경험을 확인하는 데 필요한 권한이 없으면 대화 상자에 오류가 나타납니다.

그런 다음, 다음과 같이 미리 보기 대화 상자를 트리거합니다.

FB.ui({         
  display: 'popup',
  method: 'instant_experiences_preview',
  canvas_id: 'CANVAS-ID'
});

플러그인에 다음과 같은 설정을 제공할 수 있습니다.

인스턴트 경험을 위한 타겟 만들기

참여 타겟(인스턴트 경험에 참여한 사용자로 구성된 타겟)을 만들려면 POST /act_AD-ACCOUNT/customaudiences 호출에서 rule 필드의 object_id 매개변수를 인스턴트 경험 ID(CANVAS-ID)로 설정합니다.

인스턴트 경험을 연 사람

curl \
  -F 'name=Instant Experience Engagement Audience' \
  -F 'description=People who opened this Instant Experience' \
  -F 'rule=[{"object_id":"<CANVAS_ID>","event_name":"instant_shopping_document_open"}]' \
  -F 'access_token=<ACCESS_TOKEN>' \  
https://graph.facebook.com/<VERSION>/act_<AD_ACCOUNT_ID>/customaudiences
Open In Graph API Explorer

인스턴트 경험의 링크를 클릭한 사람

curl \
  -F 'name=Instant Experience Engagement Audience' \
  -F 'description=People who clicked any links in this Instant Experience' \
  -F 'rule=[{"object_id":"<CANVAS_ID>","event_name":"instant_shopping_element_click"}]' \
  -F 'access_token=<ACCESS_TOKEN>' \  
https://graph.facebook.com/<VERSION>/act_<AD_ACCOUNT_ID>/customaudiences
Open In Graph API Explorer

맞춤 타겟에 대한 자세한 내용은 맞춤 타겟, 참고 자료를 참조하세요.

인스턴트 경험 및 Instagram 광고

Instagram에 인스턴트 경험을 구현하는 데는 Facebook의 인스턴트 경험에 사용되는 동일한 API 호출이 사용됩니다. Instagram 및 인스턴트 경험을 사용하는 데는 다음과 같은 제한이 있습니다.

• 노출 위치 - Instagram 피드 및 Instagram 스토리에 사용할 수 있습니다. Instagram 스토리를 선택하는 경우 이 노출 위치를 유일한 광고 노출 위치로 선택해야 합니다.
• 인스턴트 경험 요소 - 헤더와 제품 세트가 완전히 지원됩니다.

Instagram에서는 다음 인스턴트 경험 요소가 부분적으로 지원됩니다.

• 바닥글 - swipe to open을 지원하지 않습니다. 클라이언트에게는 Tap to open으로 렌더링됩니다.
• 슬라이드 - 다른 인스턴트 경험으로 연결되는 사진을 지원하지 않습니다. 클라이언트에게는 클릭할 수 없는 링크로 표시됩니다. 사진 및 동영상의 경우 높이에 맞추기, 너비에 맞추기 또는 기울여서 회전을 지원하지 않습니다. 너비에 맞추기로 렌더링됩니다.
• 버튼 - 다른 인스턴트 경험 또는 앱 스토어로 연결할 수 없습니다.
• 텍스트 - RTL 언어를 지원하지 않습니다.
• 동영상 - 360도 동영상을 지원하지 않습니다.
• 매장 찾기 - 지원하지 않습니다.

광고 인사이트

사용 가능한 지표의 개요와 설명은 광고 인사이트를 참조하세요.

기타 참고 자료

• Facebook 광고 가이드: 인스턴트 경험 사양
• 비즈니스 지원 센터: 인스턴트 경험에 대해 알아보기