마케팅 API

다이내믹 미디어

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

시작하기 전에

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

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

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

제한 사항

  • 현재 이 기능은 카탈로그당 최대 30,000개의 제품에 대해 동영상을 지원할 수 있습니다.
  • 제품 수는 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입니다.

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

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

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

카탈로그 피드 파일을 사용하면 최대 30,000개의 제품에 제품 수준 동영상 URL을 제공할 수 있습니다.

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

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

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

선택 사항:
video[0].url 열 대신 동영상이라는 열을 만들고 동영상에 태그를 추가할 수 있습니다. 제품 세트 필터에 태그 열을 사용하려면 이 열도 피드 파일에 추가해야 합니다.

동영상 열 형식 예시:
[{"url": "http://www.jaspersmarket.com/video-file.avi", tag: ["Optional Tag1", "Optional Tag2"]}]

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

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

카탈로그 배치 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": "https://yourvideo.com/demo.mp4?q=1411"
          },
          {
            "url": "https://yourvideo.com/demo.mp4?q=1421"
          }
        ]
      }
    },
    {
      "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를 사용하여 다이내믹 미디어 유형을 선택하는 것은 광고 관리자에서 다이내믹 미디어 옵션을 선택하는 것과 유사합니다.

다이내믹 미디어 유형 광고

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

  • media_type_automation 키를 OPT_IN으로 설정합니다.
  • 이 키는 슬라이드 및 컬렉션 형식에 모두 사용할 수 있습니다.
curl \
-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/v18.0/act_<AD_ACCOUNT_ID>/adcreatives

또는 act_<AD_ACCOUNT_ID>/ads 엔드포인트를 사용하여 광고 개체를 만드는 경우 media_type_automation 키를 OPT_IN으로 설정합니다.

curl \
  -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/v19.0/act_<AD_ACCOUNT_ID>/ads

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

  • 다이내믹 미디어는 대표 미디어만 대체합니다. 클릭 전 경험 및 인스턴트 경험의 제품 썸네일은 항상 이미지가 됩니다.
  • 다이내믹 미디어로 옵트인하고 제품 동영상을 사용할 수 있는 경우 Facebook에서 다이내믹 동영상 대표 미디어를 제품 동영상으로 대체합니다.
  • 다이내믹 미디어는 옵트인한 경우에만 다이내믹 동영상 대표 미디어를 대체합니다. 현재 고정된 대표 이미지와 동영상은 제품 동영상으로 대체되지 않습니다. 예를 들어 이미지 슬라이드쇼 경험은 제품 동영상으로 대체됩니다.

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

curl \
-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/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

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

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

curl \
  -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/v19.0/act_<AD_ACCOUNT_ID>/ads