마케팅 API

Shops 광고

Shops 광고는 잠재 고객의 구매 가능성이 더 높다고 판단되는 위치에 따라 잠재 고객을 웹사이트나 Shop으로 보내어 광고 성과를 향상하는 솔루션입니다.

시작하기 전에

웹사이트 및 Shop 전환 위치를 사용하여 제품 카탈로그 판매 또는 전환 광고를 만들려면 다음이 필요합니다.

1단계: 캠페인 만들기

/act_{ad_account_id}/campaigns로 POST 요청을 보내어 광고 캠페인을 만드는 것으로 시작합니다.

이 수준에서는 목표 필드를 통해 광고 목표를 설정해야 합니다. Shops 광고의 경우, 결과 기반 광고 경험(ODAX)이 아닌 광고에 지원되는 목표는 PRODUCT_CATALOG_SALES 및 CONVERSIONS이고 ODAX에 지원되는 목표는 OUTCOME_SALES입니다.

  • PRODUCT_CATALOG_SALES 목표의 경우, promoted_object는 제품 카탈로그 ID입니다. 제품 카탈로그는 Shops 광고에 사용할 수 있으려면 사이트 내 Shop에 연결되어야 합니다.
  • CONVERSIONS 목표의 경우, promoted_object 필드는 필수가 아닙니다.

ODAX가 아닌 목표의 예시

PRODUCT_CATALOG_SALES 목표로 캠페인을 만드는 예시

curl \
  -F 'name=Product Catalog Sales Campaign' \
  -F 'objective=PRODUCT_CATALOG_SALES' \
  -F 'promoted_object={"product_catalog_id":"<PRODUCT_CATALOG_ID>"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/campaigns

CONVERSIONS 목표로 캠페인을 만드는 예시

curl \
  -F 'name=Conversion Campaign' \
  -F 'objective=CONVERSIONS' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/campaigns

ODAX 목표의 예시

OUTCOME_SALES 목표로 PRODUCT_CATALOG_SALES 캠페인을 만드는 예시

curl \
  -F 'name=Conversion Campaign' \
  -F 'objective=OUTCOME_SALES' \
  -F 'promoted_object={"product_catalog_id":"<PRODUCT_CATALOG_ID>"}' \
  -F 'status=PAUSED' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \ 
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/campaigns

OUTCOME_SALES 목표로 CONVERSIONS 캠페인을 만드는 예시

curl \
  -F 'name=Conversion Campaign' \
  -F 'objective=OUTCOME_SALES' \
  -F 'status=PAUSED' \
  -F 'special_ad_categories=[]'
  -F 'access_token=<ACCESS_TOKEN>' \ 
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/campaigns

2단계: 광고 세트 만들기

Shops 광고의 경우, 광고 세트의 랜딩 페이지 유형을 SHOP_AUTOMATIC으로 지정해야 합니다.

  • 캠페인 목표가 PRODUCT_CATALOG_SALES로 설정된 경우, 해당 제품 세트에서 제품을 홍보하려면 promoted_object에 제품 세트 ID를 제공해야 합니다.
  • 캠페인 목표가 CONVERSIONS로 설정된 경우, promoted_object를 사이트 내 결제를 활성화한 커머스 계정으로 정의합니다.

Shops 광고의 기타 요구 사항:

  • Shops 광고는 제품 세트(목표가 PRODUCT_CATALOG_SALES인 경우) 또는 Meta 픽셀(목표가 CONVERSIONS인 경우)에서 전환 이벤트(CUSTOM_EVENT_TYPE)로 PURCHASE만 지원합니다.
  • Shops 광고는 오프라인 전환에 대한 최적화만 지원합니다(OFFSITE_CONVERSIONS를 optimization_goal로 설정).
  • Shops 광고는 비용 한도가 없는 입찰 전략만 지원합니다.
  • Shops 광고를 Shop에 게재하려면 타게팅에 사이트 내 결제를 지원하는 지역의 타겟을 포함해야 합니다(현재 미국).
  • Shops 광고를 Shop에 게재하려면 노출 위치에 사이트 내 결제를 지원하는 플랫폼을 하나 이상 포함해야 합니다(현재 Facebook 및 Instagram).

IMPRESSIONS에 청구되는 PRODUCT_CATALOG_SALES 목표가 설정된 캠페인을 포함한 Shops 광고의 광고 세트를 만드는 예시

curl \
  -F 'name=Product Catalog Sales Adset' \
  -F 'bid_amount=3000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'daily_budget=15000' \
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={"geo_locations": {"countries":["US"]} }' \
  -F 'destination_type=SHOP_AUTOMATIC' \
  -F 'promoted_object={"product_set_id":"<PRODUCT_SET_ID>","custom_event_type": "PURCHASE"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

IMPRESSIONS에 청구되는 CONVERSIONS 목표가 설정된 캠페인을 포함한 Shops 광고의 광고 세트를 만드는 예시

curl \
  -F 'name=Conversion Adset' \
  -F 'bid_amount=3000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'daily_budget=15000' \
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={"geo_locations": {"countries":["US"]}}' \
  -F 'destination_type=SHOP_AUTOMATIC' \
  -F 'promoted_object={"omnichannel_object":{"onsite":[{"commerce_merchant_settings_id":"<COMMERCE_ACCOUNT_ID>"}],
  "pixel":[{"pixel_id": "<PIXEL_ID>","custom_event_type": "PURCHASE"}]}}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<D_ACCOUNT_ID>/adsets

3단계: 크리에이티브 제공

Shops 광고의 광고 세트를 사용하여 다음을 만들 수 있습니다.

Shops 광고는 다음을 지원하지 않습니다.

  • 이미지/동영상 광고 형식(캠페인 목표가 PRODUCT_CATALOG_SALES인 경우)
  • 컬렉션 광고 형식
  • 페이지, Instagram 또는 WhatsApp에 메시지를 보내도록 설정된 행동 유도
  • 앱, 이벤트 또는 인스턴트 경험으로 설정된 랜딩 페이지(목표가 CONVERSIONS인 경우)

슬라이드 광고 또는 이미지/동영상 광고

Shops 광고가 아닌 광고와 마찬가지로 슬라이드 광고를 만들 수 있습니다. 캠페인 목표가 CONVERSIONS인 경우 이미지/동영상 광고를 만들 수도 있습니다.

object_story_spec에 지정된 page_id 및/또는 instagram_actor_id는 광고 세트에서 홍보하고자 하는 커머스 계정 또는 캠페인에서 홍보하고자 하는 카탈로그에 속하는 Shop을 하나 이상 포함해야 합니다. 또한 이들은 동일한 커머스 계정에 연결되어 있어야 합니다.

게다가 Shops 광고의 경우, 사이트 내 랜딩 페이지를 사이트 외부 랜딩 페이지의 대체 랜딩 페이지로 지정해야 합니다. 이를 위해서는 크리에이티브의 asset_feed_spec에서 onsite_destination 필드를 설정합니다.

사이트 내 랜딩 페이지는 다음 중 하나여야 합니다.

  • Shop 매장 페이지
    Shop이 광고 세트에서 홍보하는 커머스 계정에 속해야 합니다.

  • 제품 세트
    제품 세트는 광고 세트에서 홍보하는 커머스 계정의 카탈로그에 속해야 하며 재고가 있는 제품이 하나 이상 표시되어야 합니다.

  • 제품
    제품은 광고 세트에서 홍보하는 커머스 계정의 카탈로그에 속해야 합니다.

asset_feed_spec에서 onsite_destinations 필드가 Shop 매장 페이지로 설정된 예시

asset_feed_spec= {
  "onsite_destinations": [
    {
      "storefront_shop_id": "<SHOP_STOREFRONT_ID>"
    }
  ]
}

asset_feed_spec에서 onsite_destinations 필드가 제품 세트로 설정된 예시

asset_feed_spec= {
  "onsite_destinations": [
    {
      "shop_collection_product_set_id": "<PRODUCT_SET_ID>"
    }
  ]
}

asset_feed_spec에서 onsite_destinations 필드가 특정 제품으로 설정된 예시

asset_feed_spec= {
  "onsite_destinations": [
    {
      "details_page_product_id": "<PRODUCT_ID>"
    }
  ]
}

이미지 광고 크리에이티브의 예시

curl \
  -F 'name=Sample Creative' \
  -F 'asset_feed_spec= {
        "onsite_destinations": [
          {
            "storefront_shop_id": "<SHOP_STOREFRONT_ID>"
          }
        ]
      }' \
  -F 'object_story_spec={ 
    "link_data": { 
      "image_hash": "<IMAGE_HASH>", 
      "link": "<OFFSITE_LANDING_URL>", 
      "message": "try it out" 
    }, 
    "page_id": "<PAGE_ID>",
    "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>" 
  }' \
  -F 'degrees_of_freedom_spec={
      "creative_features_spec": {
        "standard_enhancements": {
          "enroll_status": "OPT_OUT"
        }
      }
    }' \ 
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

슬라이드 형식을 포함한 어드밴티지+ 카탈로그 광고

제품 세트에서 제품을 홍보하는 슬라이드 광고를 만들려면 어드밴티지+ 카탈로그 광고 시작하기 - 3단계: 광고 크리에이티브 제공을 따르세요.

object_story_spec에 지정된 page_id 및/또는 instagram_actor_id는 광고 세트에서 홍보하고자 하는 커머스 계정 또는 캠페인에서 홍보하고자 하는 카탈로그에 속하는 Shop을 하나 이상 포함해야 합니다. 또한 이들은 동일한 커머스 계정에 연결되어 있어야 합니다.

크리에이티브에 있는 제품 세트의 경우:

  • PRODUCT_CATALOG_SALES를 목표로 설정한 캠페인을 설정하는 경우, 선택하는 제품 세트가 캠페인에서 설정한 카탈로그에 속하고 광고 세트에서 홍보하려는 제품 세트와 동일해야 합니다.
  • CONVERSIONS를 목표로 설정한 캠페인을 설정하는 경우, 선택하는 제품 세트가 광고 세트에서 홍보하고자 하는 커머스 계정의 카탈로그에 속해야 합니다.

Shops 광고에 지원되는 추가적인 기능은 Shops에 대한 최적화입니다. 광고 성과를 개선할 것으로 예상되는 경우, Facebook에서 자동으로 다른 최적화를 광고에 추가합니다. 이를 옵트 인하려면 크리에이티브의 asset_feed_spec에서 shops_bundle을 true로 설정하세요(여기에는 현재 자동화된 제품 태그와 쇼핑 이유가 포함되어 있고 향후 다른 최적화가 포함될 수 있습니다).

현재 지원되는 Shop 최적화는 다음과 같습니다.

  • 자동화된 제품 태그: Facebook이 광고에서 제품을 자동으로 태그할 수 있습니다. 제품 태그는 사용자를 Shop의 관련 제품 페이지로 바로 이동시킵니다.
  • 쇼핑 이유: Facebook이 Shop에서 '무료 배송', '인기 상승', '품절 임박'과 같은 제품 정보를 자동으로 강조 표시할 수 있습니다. Facebook에서 고객이 Shop의 특정 품목을 할인가로 구매할 수 있게 해 주는 기존 쿠폰을 추가할 수도 있습니다.

자동화된 제품 태그를 옵트 인하려면 object_story_spec의 template_data에서 automated_product_tags를 true로 설정합니다. 쇼핑 이유를 옵트 인하려면 크리에이티브의 asset_feed_spec에서 reasons_to_shop을 true로 설정합니다.

완전히 자동화된 Shop 최적화를 옵트 인한 광고 세트를 홍보하는 슬라이드 광고의 예시


shops_bundle 옵트 인

curl \
  -F 'name=Sample Creative' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'asset_feed_spec= {
        "shops_bundle": true
      }'\
  -F 'object_story_spec={ 
    "template_data": { 
      "call_to_action":  {
            "type": "SHOP_NOW"
          },
      "link": "<OFFSITE_LANDING_URL>",
      "multi_share_end_card": false,
      "name": "{{product.name}}"
    }, 
    "page_id": "<PAGE_ID>",
    "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

automated_product_tags 옵트 인

curl \
  -F 'name=Sample Creative' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'object_story_spec={ 
    "template_data": {
      "automated_product_tags": true
      "call_to_action":  {
            "type": "SHOP_NOW"
          },
      "link": "<OFFSITE_LANDING_URL>",
      "multi_share_end_card": false,
      "name": "{{product.name}}"
    }, 
    "page_id": "<PAGE_ID>",
    "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>"
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

reasons_to_shop 옵트 인

curl \
  -F 'name=Sample Creative' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'asset_feed_spec= {
        "reasons_to_shop": true
      }'\
  -F 'object_story_spec={ 
    "template_data": { 
      "call_to_action":  {
            "type": "SHOP_NOW"
          },
      "link": "<OFFSITE_LANDING_URL>",
      "multi_share_end_card": false,
      "name": "{{product.name}}"
    }, 
    "page_id": "<PAGE_ID>",
    "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

참고:

  • Shops 광고는 어드밴티지+ 카탈로그 광고의 카테고리를 지원하지 않습니다.
  • 자동화된 제품 태그 최적화는 Instagram에서만 지원됩니다.

카탈로그용 어드밴티지+ 크리에이티브

Shops 광고는 카탈로그용 어드밴티지+ 크리에이티브도 지원합니다. 이 기능은 각 계정 센터 계정이 반응을 보일 가능성이 가장 큰 항목을 기준으로 다양한 형식과 광고 크리에이티브를 노출합니다.

크리에이티브를 설정할 때 카탈로그용 어드밴티지+ 크리에이티브 - 3단계: 광고 크리에이티브 제공의 지침을 따르면 됩니다.

object_story_spec에 지정된 page_id 및/또는 instagram_actor_id는 광고 세트에서 홍보하고자 하는 커머스 계정 또는 캠페인에서 홍보하고자 하는 카탈로그에 속하는 Shop을 하나 이상 포함해야 합니다. 또한 이들은 동일한 커머스 계정에 연결되어 있어야 합니다.

크리에이티브에 있는 제품 세트의 경우:

  • PRODUCT_CATALOG_SALES를 목표로 설정한 캠페인을 설정하는 경우, 선택하는 제품 세트가 캠페인에서 설정한 카탈로그에 속하고 광고 세트에서 홍보하려는 제품 세트와 동일해야 합니다.
  • CONVERSIONS를 목표로 설정한 캠페인을 설정하는 경우, 선택하는 제품 세트가 광고 세트에서 홍보하고자 하는 커머스 계정의 카탈로그에 속해야 합니다.

카탈로그용 어드밴티지+ 크리에이티브의 예시

curl \
  -F 'name=Sample Creative' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'asset_feed_spec= {
    "optimization_type":"FORMAT_AUTOMATION",
    "ad_formats": ["CAROUSEL", "COLLECTION"],
    "images": [{"hash": "<CUSTOMIZED_IMAGE_HASH>"}],
    "descriptions": [{"text": "{{product.description}}", "From {{product.current_price}}", ...]
    } 
   }'\
  -F 'object_story_spec={ 
    "template_data": { 
      "call_to_action":  {
            "type": "SHOP_NOW"
          },
      "link": "<OFFSITE_LANDING_URL>",
      "multi_share_end_card": false,
      "name": "{{product.name}}"
    }, 
    "page_id": "<PAGE_ID>",
    “instagram_actor_id” : “<INSTAGRAM_ACTOR_ID>” 
  }' \
  -F 'degrees_of_freedom_spec={
      "creative_features_spec": {
        "standard_enhancements": {
          "enroll_status": "OPT_OUT"
        }
      }
    }' \ 
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

4단계: 광고 만들기

마지막으로 광고 크리에이티브를 참조하는 광고를 만들 수 있습니다.

curl \
-F 'status=PAUSED' \
-F 'name=Test' \
-F 'adset_id=<ADSET_ID>' \
-F 'creative= {
       "creative_id": "<CREATIVE_ID>"
    },
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/ads

어드밴티지+ 쇼핑 캠페인을 포함하는 Shops 광고

Shops 광고는 어드밴티지+ 쇼핑 캠페인과 함께 지원되며, 이 두 가지를 결합하면 더 나은 성과를 얻을 수 있을 것으로 예상됩니다.

Shops 광고를 포함한 어드밴티지+ 쇼핑 캠페인을 만들려면 어드밴티지+ 쇼핑 캠페인 - 2단계: 캠페인 만들기의 단계에 따라 먼저 캠페인을 만드세요.

Shops 광고를 포함한 어드밴티지+ 쇼핑 캠페인의 광고 세트를 만들려면 Shops 광고를 단독으로 만들 때와 마찬가지로 destination_type을 SHOP_AUTOMATIC으로 설정하고 promoted_object에서 커머스 계정을 지정하세요.

curl \
  -F 'name=Advantage+ Shopping Adset' \
  -F 'bid_amount=3000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'daily_budget=15000' \
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={"geo_locations": {"countries":["US"]}}' \
  -F 'destination_type=SHOP_AUTOMATIC' \
  -F 'promoted_object={"omnichannel_object":{"onsite":[{"commerce_merchant_settings_id":"<COMMERCE_ACCOUNT_ID>"}],"pixel":[{"pixel_id": "<PIXEL_ID>","custom_event_type": "PURCHASE"}]}}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

자세한 내용은 어드밴티지+ 쇼핑 캠페인의 크로스 채널 전환 최적화를 참조하세요.

Shops 광고를 포함한 어드밴티지+ 쇼핑 캠페인을 위한 크리에이티브와 광고를 만들 때 사양은 Shops 광고를 단독으로 만들 때와 동일합니다. 자세한 내용은 위의 3단계: 크리에이티브 제공을 참조하세요.

Shops 광고의 커머스 자격 요건

Shops 광고의 관련 ID를 가져오려면 클라이언트로부터 catalog_management 권한을 얻어야 합니다.

페이지에 Shops 광고를 만들려면 해당 페이지에 사이트 내에 표시되는 Shop이 있어야 합니다. 이는 다음에서 가져올 수 있습니다.

curl -i -X GET \
"https://graph.facebook.com/v19.0/<PAGE_ID>/commerce_merchant_settings?fields=id,shops{id,fb_sales_channel{status,fb_page{id,name}},is_onsite_enabled,shop_status}&access_token=<PAGE_ACCESS_TOKEN>"

응답 샘플

{
  "id":"<commerce_account_id>",
  "shops": {
    "data": [
      {
        "fb_sales_channel": {
          "status": "STAGING",
          "fb_page": {
            "name": "Page 1",
            "id": "<page_id>"
          }
        },
        "id": "<shop_id_1>",
        "is_onsite_enabled": true,
        "shop_status": "INACTIVE"
      },
      {
        "fb_sales_channel": {
          "status": "ENABLED",
          "fb_page": {
            "name": "Page 2",
            "id": "<page_id>"
          }
        },
        "id": "<shop_id_2>",
        "is_onsite_enabled": true,
        "shop_status": "ACTIVE"
      }
    ],    
    // …
}

Shops 광고를 만들고자 하는 페이지에서 is_onsite_enabled가 true이고 shop_status가 ACTIVE인지 모두 확인합니다. 확인된 경우 이 가이드의 뒤쪽에 나와 있는 지침에 따라 페이지에 Shops 광고를 만들 수 있습니다.

Shops 광고를 만들기 위한 커머스 ID 가져오기

페이지에 Shops 광고를 만들려면 다음이 필요합니다.

이전의 쿼리를 실행하여 커머스 계정 ID와 Shop ID를 가져올 수 있습니다.

curl -i -X GET \
"https://graph.facebook.com/v19.0/<PAGE_ID>/commerce_merchant_settings?fields=id,shops{id,fb_sales_channel{fb_page{id,name}}}&access_token=<PAGE_ACCESS_TOKEN>"

커머스 계정은 여러 Shop을 가질 수 있으므로 Shops 광고를 만들고자 하는 페이지가 있는 Shop을 가져와야 합니다.

카탈로그 ID, 제품 세트 ID 및 제품 ID용

curl -i -X GET \
"https://graph.facebook.com/v19.0/<PAGE_ID>/commerce_merchant_settings?fields=id,product_catalogs{id,product_sets}&access_token=<PAGE_ACCESS_TOKEN>"

응답 샘플

{
  "id": "<commerce_account_id>",
  "product_catalogs": {
    "data": [
      {
        "id": "<product_catalog_id>",
        "product_sets": {
          "data": [
            {
              "id": "<product_set_id>",
              "name": "Product Set 1",
              "filter": "{\"product_item_id\":{\"is_any\":[]}}"
            },
          ],
        }
      }
    ]
  }
}