다이내믹 미디어

다이내믹 미디어를 사용하면 광고주가 어드밴티지+ 카탈로그 광고에 카탈로그의 동영상 자산을 게재할 수 있습니다.

시작하기 전에

다음과 같은 항목이 필요합니다.

• 기존 제품이 포함된 제품 카탈로그
• 다운로드 가능한 동영상 URL 형식으로 된 각 제품 품목에 관한 동영상

사용 방법에 대해 자세히 알아보려면 어드밴티지+ 카탈로그 광고 문서를 참조하세요.

제한 사항

• 제품 수는 20개 이상을 권장하지만 필수 최솟값은 없습니다.
• 각 동영상의 크기는 200MB를 초과해서는 안 됩니다. 길이 제한은 없습니다.
• 사용 가능한 동영상 형식: 3g2, 3gp, 3gpp, asf, avi, dat, divx, dv, f4v, flv, gif, m2ts, m4v, mkv, mod, mov, mp4, mpe, mpeg, mpeg4, mpg, mts, nsv, ogm, ogv, qt, tod, ts, vob 또는 wmv입니다.
• 동영상을 트리거해야 하는 다른 이벤트에 사용될 때까지 video_fetch_status는 NO_STATUS로 표시될 수 있습니다.

카탈로그에 동영상 추가하기

카탈로그에 있는 제품 품목에 동영상을 추가하는 3가지 방법으로는 카탈로그 피드 파일, 카탈로그 배치 API, 커머스 관리자를 통한 수동 업로드가 있습니다.

카탈로그 피드 파일을 사용하여 동영상 추가하기

1단계. 카탈로그 피드 파일 준비하기

다음 중 한 가지 절차를 사용하여 카탈로그 피드 파일을 구현할 수 있습니다.

• 절차 1: 메인 피드 변경

  • 기존 카탈로그 피드 파일에 video[0].url 열을 추가하고, 선택한 제품에 대해서만 동영상 URL을 입력하고, 다른 제품 행은 비워둡니다.
  • 동일한 제품에 대한 추가 동영상은 추가적인 열 (예: video[1].url, video[2].url, video[3].url등)을 이용하여 추가할 수 있습니다.
  • 별도의 열에 태그를 포함하여 동영상에 태그를 추가할 수 있습니다. 예: video[0].tag[0], video[0].tag[1], video[1].tag[0] 등.
• 절차 2: 보충 피드
  기존 피드 업로드를 보충하기 위한 추가 카탈로그 피드 파일을 준비합니다. 이 보충 피드는 기존의 제품 품목에 대해서만 동영상을 추가하거나 교체할 수 있습니다. video[0].url 열과 ID 열을 추가하여 동영상과 제품 품목 ID를 연결합니다.

선택 사항:
video[0].url 열 대신 video이라는 열을 만들고 동영상에 태그를 추가할 수 있습니다. video 열에는 제품 1개당 여러 개의 동영상과 JSON 형식으로 인코딩된 URL 1개당 여러 개의 태그를 포함할 수 있습니다. 제품 세트 필터에 태그 열을 사용하려면 이 열도 피드 파일에 추가해야 합니다.

XML 피드의 경우, 다음과 같이 <video> 태그를 사용하여 동영상 URL을 추가할 수 있습니다.

<video><url>https://{URL1}</url><tag>video_product_set1</tag><tag>video_product_set2 </tag></video><video><url>https://{URL2}</url><tag>video_product_set1</tag></video>

제품 항목 API에서 동영상 데이터 쿼리

카탈로그 API에서 videos, videos_metadata 및 video_fetch_status 필드를 사용하여 카탈로그 제품 동영상 상세 정보를 가져올 수 있습니다.

curl -i GET \ "http://graph.facebook.com/v25.0/<PRODUCT_ITEM_ID>?fields=videos,videos_metadata,video_fetch_status"

동영상 정보에 대한 자세한 내용은 제품 항목 상세 정보를 참조하세요.

카탈로그 배치 API를 사용하여 동영상 추가하기

제품 품목 업데이트는 /{product_catalog_id}/items_batch 엔드포인트를 사용하여 지원됩니다. video 필드(URL 배열)를 포함하여 POST API 호출을 보낼 수 있습니다.

curl \
  -d @body.json \
  -H "Content-Type: application/json"

> cat body.json
{
  "access_token": "<ACCESS_TOKEN>",
  "item_type": "PRODUCT_ITEM",
  "requests": [
    {
      "method": "CREATE",
      "data": {
        "id": "retailer-2",
        "availability": "in stock",
        "brand": "BrandName",
        "google_product_category": "t-shirts",
        "description": "product description",
        "image_link": "http://www.images.example.com/t-shirts/1.png",
        "title": "product name",
        "price": "10.00 USD",
        "shipping": [
          {
            "shipping_country": "US",
            "shipping_region": "CA",
            "shipping_service": "service",
            "shipping_price_value": "10",
            "shipping_price_currency": "USD"
          }
        ],
        "condition": "new",
        "link": "http://www.images.example.com/t-shirts/1.png",
        "item_group_id": "product-group-1",
        "video": [
          {"url": "http://www.jaspersmarket-example1.com/video-file.avi", "tag": ["Optional Tag1", "Optional Tag2"]}, 
          {"url": "http://www.jaspersmarket-example2.com/video-file.avi", "tag": ["Optional Tag1", "Optional Tag2"]}
        ]
      }
    },
    {
      "method": "UPDATE",
      "data": {
        "availability": "out of stock",
        "id": "retailer-3",
        "video": [
          {
            "url": "https://yourvideo.com/demo.mp4?q=1411"
          },
          {
            "url": "https://yourvideo.com/demo.mp4?q=1421"
          }
        ]
      }
    }
  ]
}

그래프 API 탐색기에서 이 예시를 참조하세요.

다이내믹 미디어로 광고 만들기

광고를 만들 때 카탈로그의 동영상을 활용하는 옵션의 유형으로 다음 세 가지가 있습니다.

• 슬라이드/컬렉션 다이내믹 미디어(권장)
• 가능할 때 동영상 표시(단일 동영상 형식에서만 가능)
• 단일 이미지에 다이내믹 미디어 옵트 인

참고: API를 사용하여 다이내믹 미디어 유형을 선택하는 선택하는 것은 광고 관리자에서 다이내믹 미디어 옵션을 선택하는 것과 유사합니다. 2025년 9월부터 적용되는 변경 사항에 따라, 어드밴티지+ 카탈로그 광고는 기본적으로 다이내믹 미디어를 사용하도록 옵트 인됩니다.

다이내믹 미디어 유형 광고

act_<AD_ACCOUNT_ID>/adcreatives 엔드포인트로 광고 크리에이티브 개체를 만드는 경우

• 2025년 9월부터 어드밴티지+ 카탈로그 광고가 기본적으로 카탈로그 제품 동영상을 게재하기 시작합니다. media_type_automation을 OPT_out으로 설정하여 카탈로그 제품 동영상이 광고에 나타나지 않도록 할 수 있습니다.
• media_type_automation 키는 슬라이드, 컬렉션, 단일 이미지 형식과 함께 작동합니다.

curl -X POST \ -F 'name=Dynamic Media Ad Creative' \ -F 'object_story_spec={ ... }' \ -F 'degrees_of_freedom_spec={ "creative_features_spec": { "media_type_automation": { "enroll_status": "OPT_IN" } } }' \ -F 'product_set_id=<PRODUCT_SET_ID>' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/adcreatives

마찬가지로 act_<AD_ACCOUNT_ID>/ads 엔드포인트로 어드밴티지+ 카탈로그 광고 개체를 만드는 경우, 기본적으로 광고는 사용 가능한 카탈로그 제품 동영상을 게재하기 시작합니다. media_type_automation고 키를 OPT_out으로 설정하여 카탈로그 제품 동영상이 광고에 나타나지 않도록 할 수 있습니다.

curl -X POST \ -F 'adset_id=<ADSET_ID>' \ -F 'creative={ "name": "Dynamic Media Ad Creative", "object_story_spec": { ... }, "degrees_of_freedom_spec": { "creative_features_spec": { "media_type_automation": { "enroll_status": "OPT_IN" } } }, "product_set_id": "<PRODUCT_SET_ID>" }' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/ads

다이내믹 미디어 광고(컬렉션 형식 적용)

• 다이내믹 미디어는 대표 미디어만 대체합니다. 클릭 전 경험 및 인스턴트 경험의 제품 썸네일은 항상 이미지가 됩니다.
• 다이내믹 미디어로 옵트 인하고 제품 동영상을 사용할 수 있는 경우 Facebook에서 다이내믹 동영상 대표 미디어를 제품 동영상으로 대체합니다. 컬렉션 형식의 어드밴티지+ 카탈로그 광고는 기본적으로 다이내믹 미디어로 옵트 인하고 2025년 9월부터 카탈로그 제품 동영상을 게재하기 시작합니다. media_type_automation을 계속해서 OPT_OUT으로 설정하여 카탈로그 제품 동영상이 광고에 표시되지 않도록 할 수 있습니다.
• 다이내믹 미디어는 옵트 인한 경우에만 다이내믹 동영상 대표 미디어를 대체합니다. 현재 고정된 대표 이미지와 동영상은 제품 동영상으로 대체되지 않습니다. 예를 들어 이미지 슬라이드쇼 경험은 제품 동영상으로 대체됩니다.

다이내믹 미디어가 포함된 컬렉션의 크리에이티브 사양 예시

curl -X POST \ -F 'name=Dynamic Media Ad Creative' \ -F 'object_story_spec={ "template_data": { ... "format_option": "collection_video", "link": "https://fb.com/canvas_doc/<CANVAS_ID>", "message": "Your Collection Ad", ... } }' \ -F 'degrees_of_freedom_spec={ "creative_features_spec": { "media_type_automation": { "enroll_status": "OPT_IN" } } }' \ -F 'product_set_id=<PRODUCT_SET_ID>' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/adcreatives

다이내믹 미디어 광고(가능할 때 동영상 표시)

object_story_spec에서 format_option을 single_video로 변경합니다. 이는 단일 이미지/동영상 형식에서만 이용 가능합니다.

curl -X POST \ -F 'adset_id=<ADSET_ID>' \ -F 'creative={ "name": "Dynamic Media Ad Creative", "object_story_spec": { "page_id": "<PAGE_ID>", "template_data": { ... "format_option": "single_video", ... } }, "product_set_id": "<PRODUCT_SET_ID>" }' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/ads

다이내믹 미디어 광고(단일 이미지에 다이내믹 미디어 옵트 인)

media_type_automation이 옵트 인되면 object_story_spec에서 format_option이 single_image일 때 다이내믹 미디어가 표시됩니다.

2025년 9월부터 format_option을 single_image로 사용하는 어드밴티지+ 카탈로그 광고는 기본적으로 다이내믹 미디어로 옵트 인되고 광고에 사용 가능한 카탈로그 제품 동영상을 표시합니다. media_type_automation을 OPT_OUT으로 설정하여 카탈로그 제품 동영상이 광고에 나타나지 않도록 할 수 있습니다.

curl -X POST \ -F 'adset_id=<ADSET_ID>' \ -F 'creative={ "name": "Dynamic Media Ad Creative", "object_story_spec": { "page_id": "<PAGE_ID>", "template_data": { "format_option": "single_image" } }, "degrees_of_freedom_spec": { "creative_features_spec": { "media_type_automation": { "enroll_status": "OPT_IN" } } } }, "product_set_id": "<PRODUCT_SET_ID>" }' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/ads

선택 사항: 자동 동영상 자르기 옵트 인 또는 옵트 아웃

video_crop_style 필드를 사용하여 자동 동영상 자르기를 관리합니다. 사용 가능한 값은 AUTO 또는 NONE입니다.

자동 동영상 자르기를 옵트 아웃하려면 video_crop_style을 NONE으로 설정하거나 media_type_automation 설정에서 맞춤 설정을 제거하세요.

curl -X POST \ -F 'adset_id=<ADSET_ID>' \ -F 'creative={ "name": "Dynamic Media Ad Creative", "object_story_spec": { ... }, "degrees_of_freedom_spec": { "creative_features_spec": { "media_type_automation": { "customizations": { "video_crop_style": "NONE" }, "enroll_status": "OPT_IN" } } }, "product_set_id": "<PRODUCT_SET_ID>" }' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/ads

자동 자르기는 노출 위치 크기 요구 사항을 충족하지 않는 동영상에만 적용되며, 자동 자르기는 현재 주로 플레이어의 뷰포트에 동영상을 맞추는 데 사용하도록 설계되었습니다.

광고 노출 위치의 화면 비율과 일치하는 동영상이 있으면 해당 동영상이 반환됩니다. 주어진 제품 동영상의 모든 화면 비율이 제공되는 경우 자동 자르기가 적용되지 않습니다. 그 외의 경우 광고는 해당 항목의 동영상을 선택하고 자동 자르기 설정을 확인합니다. AUTO는 자동으로 잘린 동영상을 반환하고 NONE은 원본 동영상을 반환합니다.

다이내믹 미디어 인사이트

광고 관리자의 동영상 참여 지표도 API에서 쿼리할 수 있습니다. 다음 차트에서 비교해 보세요.

요청 예시

curl GET \ -d 'access_token=<ACCESS_TOKEN>' \ -d 'fields=impressions,video_continuous_2_sec_watched_actions,actions,video_thruplay_watched_actions' \ https://graph.facebook.com/v25.0/<AD_ID>/insights

자세한 내용은 인사이트 API 문서를 참조하세요.