쿠폰 API는 초대 전용 비공개 베타 프로그램으로 운영되고 있습니다. 프로그램에 초대를 받았다면 Meta 담당자에게 액세스 방법을 문의하세요.
이 API를 사용하면 제품 카탈로그에 쿠폰 정보를 추가하여 Facebook과 Instagram에서 쿠폰을 판촉할 수 있습니다. Facebook 또는 Instagram 결제를 사용하도록 설정한 판매자의 경우, 구매자가 Meta 앱 제품군 내에서 바로 쿠폰을 사용할 수 있습니다.
쿠폰 피드를 통해 쿠폰을 만들거나 커머스 관리자를 통해 직접 쿠폰을 만들 수 있습니다.
새로운 쿠폰 피드를 만들려면 /{product_catalog_id}/product_feeds 에지로 POST
요청을 보내고 feed_type
을 OFFER
로 설정합니다. 이 에지에 게시하면 product_catalog_id
필드에 지정된 카탈로그에 대해 쿠폰 유형의 제품 피드가 생성됩니다.
쿠폰 피드가 생성되고 나면 /{product_feed_id}/uploads
에지로 POST
요청을 보내서 쿠폰 데이터를 업로드할 수 있습니다.
아래에 나와 있는 사용 가능한 필드 대부분은 피드 파일에서 칼럼으로 설정할 수 있습니다. 다만 읽기 전용으로 표시된 필드는 피드를 만들 때 설정할 수 없습니다.
제품 세트는 제품 카탈로그 내에서 관련된 품목의 그룹입니다.
쿠폰이 유효한 제품을 의미합니다.
쿠폰을 적용하려면 충족해야 하는 필수 조건을 의미합니다. 예를 들어 사용자가 특정 수량 이상의 제품을 구매하거나 해당 제품의 최소 특정 소계 수량이나 가치에 도달할 경우에만 쿠폰이 유효하도록 설정할 수 있습니다. 현재 필수 제품은 타겟 제품에서 파생됩니다. 예를 들어 모든 신발을 20% 할인해 주는 쿠폰은 장바구니에 있는 신발이 최소 소계/수량 요구 사항을 충족해야 적용이 가능합니다.
쿠폰 적용 유형은 자체 웹사이트 또는 Facebook 결제 시 쿠폰을 적용하는 방식을 지정합니다. 예를 들어 적용 유형을 사용하여 결제 시 쿠폰을 자동으로 적용할지, 쿠폰 코드를 입력해야 쿠폰을 사용할 수 있는지 결정할 수 있습니다. 적용 유형은 쿠폰을 다른 쿠폰과 결합했을 때 쿠폰이 적용되는 방식에도 영향을 미칩니다. 자세한 내용은 쿠폰 결합을 참조하세요.
모든 쿠폰 유형을 구성하는 데 사용할 수 있는 필드는 아래와 같습니다.
필드 | 설명 |
---|---|
유형: | 읽기 전용. 이 품목의 고유한 식별자(Facebook ID)입니다. |
유형: | 필수 항목. 판매자가 제공한 쿠폰 식별자입니다. 이 필드는 카탈로그 내에서 쿠폰을 고유하게 식별하는 데 사용합니다. |
유형: | 선택 사항. 쿠폰 품목의 제목입니다. 현재 이 제목은 커머스 관리자 내에서 쿠폰의 식별을 돕는 데만 사용되고 구매자에게는 표시되지 않습니다. |
유형: | 읽기 전용. 쿠폰의 자동 생성된 설명입니다. |
유형: | 필수 항목. 쿠폰을 적용하는 방법과 시점을 결정합니다. 사용 가능한 옵션은 다음과 같습니다.
|
유형: | 고객이 결제 시 쿠폰을 사용하기 위해 입력하며, 대소문자를 구분하지 않는 쿠폰 코드의 리스트입니다. 최대 100개의 쿠폰 코드가 허용됩니다. 예: 쿠폰 코드는 이 필드를 설정하는 경우 |
유형: | 선택 사항. 쿠폰과 함께 판촉되고, 구매자가 쿠폰 필수 조건을 충족하는 경우 결제 시 자동 입력되며, 대소문자를 구분하지 않는 단일 쿠폰 코드입니다. 기본적으로 쿠폰 코드가 있는 쿠폰은 Facebook 또는 Instagram 쇼핑 화면(예: 제품 상세 페이지)에서 구매자에게 가시적으로 판촉되지 않습니다. 이는 비공개 또는 비밀 코드가 의도치 않게 구매자에게 유출되는 것을 방지하기 위해서입니다. 쿠폰을 판촉하는 데 사용할 공개 쿠폰 코드를 지정하면 이 동작을 변경할 수 있습니다. 공개 코드가 있는 쿠폰은 공개 쿠폰 코드는 길이가 20자를 초과할 수 없고 카탈로그에는 공개 쿠폰 코드가 있는 쿠폰을 한 번에 10개까지만 포함할 수 있습니다. 공개 쿠폰 코드는 이 필드를 설정하는 경우 |
유형: | 필수 항목. 쿠폰이 시작되는 시점의 UNIX 타임스탬프(초)입니다. 입력 값은 UNIX 타임스탬프(초)이거나 ISO-8601 형식의 날짜 문자열(예: 2021-09-25T12:34:56Z)일 수 있습니다. |
유형: | 선택 사항. 기본값은 쿠폰이 종료되는 시점의 UNIX 타임스탬프(초)입니다. 비어 있거나 입력 값은 UNIX 타임스탬프(초)이거나 ISO-8601 형식의 날짜 문자열(예: 2021-09-25T12:34:56Z)일 수 있습니다. |
유형: | 선택 사항. 기본값은 0입니다. 고객이 제품을 최소 수량 이상 구매할 경우에만 쿠폰이 유효하면 이 필드를 사용하세요. 이 필드는 쿠폰이 유효하려면 고객이 구매해야 하는 제품 수량을 나타냅니다. 예: '셔츠 5벌 구매 시 20% 할인'.
|
유형: | 선택 사항. 기본값은 고객 주문이 특정 소계 금액을 충족할 경우에만 쿠폰이 유효하면 이 필드를 사용하세요. 쿠폰이 적용되려면 필수 제품의 소계가 이 금액과 같거나 그보다 커야 합니다. 명시적인 필수 제품이 설정되지 않은 경우, 타겟 제품이 필수 제품으로 사용됩니다. 이 필드는 금액 뒤에 3자리 ISO 통화 코드를 붙이고 금액과 통화 코드 사이에 공백을 두는 형식으로 지정해야 합니다. 예: 문자열 '30.99 USD'는 쿠폰이 적용되는 데 필요한 소계가 $30.99임을 나타냅니다.
|
유형: | 선택 사항. 기본값은 0(무제한)입니다. 사용자 한 명이 쿠폰을 사용할 수 있는 최대 횟수입니다. 이 필드를 1로 설정하여 일회용 쿠폰 코드를 만듭니다. 이 필드는 |
유형: | 필수 항목. 쿠폰에서 제공하는 할인 유형입니다. 사용 가능한 옵션은 다음과 같습니다.
|
유형: |
쿠폰의 할인 금액입니다. 금액 뒤에 3자리 ISO 통화 코드를 붙이고 금액과 통화 사이에 공백이 있어야 합니다. 예를 들어 문자열 '30.99 USD'는 $30.99 할인을 나타냅니다. 이 필드는 |
유형: |
쿠폰의 백분율 할인입니다. 0~100 사이의 정수여야 합니다. 예를 들어 '30'은 30% 할인을 나타냅니다. 이 필드는 |
유형: | 필수 항목. 쿠폰 할인이 적용되는 세분화 수준입니다. 사용 가능한 옵션은 다음과 같습니다.
세분화 수준이 |
유형: | 선택 사항. 구매자의 쿠폰 사용을 관리하는 추가적인 이용 약관입니다. 2,500자 이내여야 합니다. Facebook은 쿠폰 구성에 따라 쿠폰을 설명하는 약관을 자동 생성합니다. 이러한 약관 외에도 내용은 Meta의 콘텐츠 정책을 준수해야 합니다. |
쿠폰이 유효한 타겟 품목과 구매자가 쿠폰을 사용하기 위해 구매해야 하는 필수 품목은 모두 제품 세트에서 정의됩니다. 쿠폰 API는 이러한 제품 세트를 지정하는 여러 가지 방식을 지원하지만 쿠폰당 제품 세트 유형별로 한 가지 방법만 사용할 수 있습니다.
필드 | 설명 |
---|---|
유형: | 필수 항목. 이 필드는 제품 카탈로그 전체에 적용되는 쿠폰과 카탈로그 내 품목의 특정 하위 집합으로 제한되는 쿠폰을 구분하는 데 사용됩니다. 사용 가능한 옵션은 다음과 같습니다.
|
유형: | 선택 사항. 쿠폰을 적용할 수 있는 제품을 식별하기 위한 필터 규칙입니다. 제품을 제품 세트에 추가하는 데 사용했던 것과 동일한 필터 규칙 로직을 사용합니다. 지정된 필터 규칙이 기존 제품 세트의 필터와 일치할 경우, 이 쿠폰은 해당 제품 세트를 타게팅합니다. 그러지 않은 경우, 새로운 제품 세트가 생성됩니다. 이 필드는 |
유형: | 선택 사항. 쿠폰을 적용할 수 있는 제품의 제품 품목 판매점 ID 리스트입니다. 이 필드는 |
유형: | 선택 사항. 쿠폰을 적용할 수 있는 제품의 제품 그룹 판매점 ID 리스트입니다. 제품 그룹에 포함된 모든 제품 에디션에 쿠폰을 적용할 수 있습니다. 이 필드는 |
유형: | 선택 사항. 쿠폰을 적용할 수 있는 제품을 포함하는 제품 세트의 판매점 ID 리스트입니다. 쿠폰은 지정된 제품 세트를 평가하여 얻은 모든 제품의 합집합에 적용됩니다. |
유형: | 선택 사항. 구매자가 쿠폰을 사용하기 위해 반드시 구매해야 하는 제품을 식별하기 위한 필터 규칙입니다. 제품을 제품 세트에 추가하는 데 사용했던 것과 동일한 필터 규칙 로직을 사용합니다. 일반적으로 'X를 구매하면 Y가 무료' 스타일 쿠폰에 사용됩니다. 지정된 필터 규칙이 기존 제품 세트의 필터와 일치할 경우, 이 쿠폰은 해당 제품 세트를 사용하여 필수 제품을 정의합니다. 그러지 않은 경우, 새로운 제품 세트가 생성됩니다. 이 필드를 설정하는 경우 |
유형: | 선택 사항. 구매자가 쿠폰을 사용하기 위해 구매해야 하는 제품 품목의 판매점 ID입니다. 리스트에 포함된 모든 품목은 구매자가 쿠폰을 사용하기 위한 필수 품목으로 사용할 수 있습니다. 일반적으로 'X를 구매하면 Y가 무료' 스타일 쿠폰에 사용됩니다. 이 필드를 설정하는 경우 |
유형: | 선택 사항. 구매자가 쿠폰을 사용하기 위해 구매해야 하는 제품 그룹의 판매점 ID입니다. 각 그룹에 포함된 모든 제품 에디션은 구매자가 쿠폰을 사용하기 위한 필수 품목으로 사용할 수 있습니다. 일반적으로 'X를 구매하면 Y가 무료' 스타일 쿠폰에 사용됩니다. 이 필드를 설정하는 경우 |
유형: | 선택 사항. 구매자가 쿠폰을 사용하기 위해 구매해야 하는 품목을 포함하는 제품 세트의 판매점 ID입니다. 제품 세트를 평가하여 얻은 합집합에서 나온 모든 품목은 구매자가 쿠폰을 사용하기 위한 필수 품목으로 사용할 수 있습니다. 일반적으로 'X를 구매하면 Y가 무료' 스타일 쿠폰에 사용됩니다. 이 필드를 설정하는 경우 |
유형: | 선택 사항. 카탈로그에서 이미 가격이 인하된 제품에 쿠폰이 적용되는지 여부이며, 이는 제품 품목의 이 필드를 이 필드를 설정하면 쿠폰의 타겟 제품과 필수 제품에 모두 적용됩니다. |
쿠폰 API는 구매자가 구매할 때 제품 가격을 할인하는 쿠폰과 해당 제품의 배송 비용을 할인하는 쿠폰을 모두 지원합니다. 제품에 사용하는 쿠폰과 마찬가지로 배송 쿠폰은 쿠폰 코드를 입력하여 적용하거나 추가적인 구매자 필수 조건이 있거나 없는 상태에서 자동으로 적용할 수 있습니다.
배송 쿠폰을 만들려면 target_type
을 SHIPPING
으로 설정해야 합니다. 현재 무료 배송 쿠폰만 지원되므로 value_type
는 항상 PERCENTAGE
여야 하고 percent_off
는 100으로 설정해야 합니다.
필드 | 설명 |
---|---|
유형: | 필수 항목. 쿠폰이 적용되는 개체 유형입니다.
|
유형: |
쿠폰이 유효한 배송 서비스 등급의 리스트입니다(예: 예를 들어 표준 및 긴급 배송에는 적용되지만 익일 배송에는 적용되지 않는 배송 쿠폰을 지정하려면 다음을 사용하세요.
Facebook 또는 Instagram 결제를 활성화한 판매자의 경우, 배송 프로필 API를 사용하여 커머스 계정의 배송 프로필을 관리할 수 있습니다. |
'X를 사면 Y가 무료' 스타일 쿠폰을 사용하면 구매자가 해당 'X 제품'의 정해진 수량을 구매하면 'Y제품' 1개 이상을 할인된 가격 또는 무료로 구매할 수 있습니다. X를 사면 Y가 무료 쿠폰은 구매자가 할인을 받기 위해 X 제품 세트의 최소 지출 임계값에 도달해야 하는 경우에도 지원됩니다. X를 사면 Y가 무료 쿠폰은 target_quantity
필드를 설정하고 min_quantity
또는 min_subtotal
필드를 설정하여 만듭니다.
일반적인 '1개 사면 1개 무료' 쿠폰과 같은 특정 상황에서는 X와 Y가 동일한 제품 세트를 의미할 수 있습니다. 그러나 prerequisite_filter
, prerequisite_product_retailer_ids
, prerequisite_product_group_retailer_ids
, prerequisite_product_set_retailer_ids
를 사용하여 타겟 Y 제품과는 다른 X 제품 세트를 지정할 수도 있습니다. 이러한 필드를 구성하는 방법은 적격 제품 지정을 참조하세요.
필드 | 설명 |
---|---|
유형: | 선택 사항. 기본값은 0(무제한)입니다. 쿠폰을 사용할 때마다 할인되는 제품의 수입니다. 이 필드를 사용하여 구매자가 쿠폰 사용 필수 조건을 충족했을 때 몇 개의 제품을 할인할지 설정합니다. 예를 들어 '2개 사면 50% 할인' 쿠폰의 타겟 수량은 1이고 '5개 사면 2개 무료' 쿠폰의 타겟 수량은 2입니다. |
유형: | 선택 사항. 기본값은 0(무제한)입니다. 이 쿠폰을 주문당 사용할 수 있는 횟수입니다. 이 필드를 사용하여 구매자가 한 번 구매할 때 제품에 쿠폰을 적용할 수 있는 횟수를 제한합니다. 예를 들어 '셔츠 1벌 구매하면 1벌 무료' 쿠폰에서 기본적으로 셔츠 6벌을 구매하는 구매자는 3벌을 정가로 구매하고 3벌을 무료로 받게 됩니다. 그러나 동일한 예시에서 이 필드를 설정하는 경우 |
Facebook 또는 Instagram에서 결제를 활성화한 판매자의 경우, 단일 거래에서 여러 개의 쿠폰 결합이 제한적으로 지원됩니다. 어떤 쿠폰이 다른 쿠폰과 결합될 수 있는지는 주로 적용 유형과 타겟 유형에 따라 결정됩니다. 현재 이 동작은 판매자가 구성할 수 없습니다. 아래의 규칙에 쿠폰 중첩 동작이 요약되어 있습니다.
application_type
= SALE
)이 있는 경우, 해당 쿠폰은 최저 가격을 적용합니다. 이는 구매자 장바구니에 있는 모든 품목에 반복됩니다. 이 품목의 새로운 할인 가격은 향후의 모든 쿠폰 필수 품목 계산에 사용됩니다.target_type
(LINE_ITEM
또는 SHIPPING
)별로 BUYER_APPLIED
쿠폰 1개 또는 AUTOMATIC_AT_CHECKOUT
쿠폰 1개를 사용할 수 있습니다. 예를 들어 구매자는 무료 배송 쿠폰과 1개 사면 1개 무료 쿠폰을 적용할 수 있지만 제품 가격을 할인하는 쿠폰 2개를 사용할 수는 없습니다.현재 쿠폰 API를 통해 생성된 쿠폰은 특정 사용자 코호트에 선택적으로 판촉할 수 없습니다. 커머스 관리자에서 생성된 쿠폰은 사용자 자격 요건에 제한을 두어 구성할 수 있습니다. 쿠폰 API를 통해 생성된 판촉 쿠폰은 모든 구매자에게 표시되고 Facebook 또는 Instagram 결제 시 쿠폰의 필수 조건(쿠폰 코드 입력 포함)을 충족한 구매자는 쿠폰을 사용할 수 있습니다.
향후 쿠폰 API는 다국적 판매자에 대해 특정 국가로 쿠폰을 제한하거나, 특정 사용자 그룹(예: 첫 구매자, 판매자 Facebook 페이지의 팔로워)으로 쿠폰 사용 자격을 제한하는 기능을 지원할 수도 있습니다.