판매자 프로모션 API 개요

프로모션을 사용하여 Google에서 판매하는 제품의 특별 이벤트를 홍보하세요. 프로모션은 Google 검색, 쇼핑, Chrome에서도 사용할 수 있습니다.

제품에 프로모션을 추가하면 쇼핑객에게 특별 이벤트 링크가 표시됩니다. 예: '15% 할인' 또는 '무료 배송'을 입력합니다. 혜택 링크를 통해 쇼핑객이 제품을 구매하도록 유도할 수 있습니다

자세한 내용은 프로모션을 참조하세요. 기본사항을 참조하세요.

기본 요건

Google은 귀하가 비즈니스 운영에 도움이 될 만한 프로모션을 표시할 수 있습니다. 다음 항목이 있어야 합니다.

또한 프로모션 프로그램에 판매자 계정을 등록해야 합니다. 만약 이미 등록되어 있는지 확실하지 않다면 판매자 중앙으로 이동합니다.

등록하지 않은 경우 요청을 양식을 작성해 주세요. 이 프로모션팀에서 구현을 시작할 준비가 되면 알려드립니다.

자세한 내용은 참여 기준 및 정책을 참조하세요.

데이터 소스 만들기

datasource.create API를 사용하여 프로모션 피드를 만듭니다. 기존 프로모션 피드를 사용할 수 있습니다. datasource.get을 사용하여 datasource.name

요청 형식은 다음과 같습니다.

POST https://merchantapi.googleapis.com/promotions/v1beta/accounts/{account}/dataSources/{datasource}

예

이 예시는 일반적인 요청과 응답을 보여줍니다.

요청:

POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/123/dataSources {"displayName": "test api feed", "promotionDataSource":{"targetCountry":"US", "contentLanguage":"en"}}

대답:

{
  "name": "accounts/123/dataSources/1000000573361824",
  "dataSourceId": "1000000573361824",
  "displayName": "test api feed",
  "promotionDataSource": {
    "targetCountry": "US",
    "contentLanguage": "en"
  },
  "input": "API"
}

프로모션 만들기

이 accounts.promotions.insert 드림 메서드를 사용하여 프로모션을 만들거나 업데이트할 수 있습니다. accounts.promotions.insert 메서드 promotions 리소스와 데이터 소스 이름을 입력으로 사용합니다. 이 함수는 새 프로모션 또는 업데이트된 프로모션이 표시됩니다.

프로모션을 만들려면 다음이 필요합니다. datasource.name입니다.

Google은 프로모션을 배포하기 전에 검토 및 승인합니다. 자세한 내용은 자세한 내용은 프로모션 승인 절차에 따라 다릅니다.

요청 형식은 다음과 같습니다.

POST https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*/}promotions:insert

다음 샘플 프로모션을 참고하세요.

샘플 1: 지역 프로모션에 해당하는 경우 모든 제품 및 모든 매장

POST https://merchantapi.googleapis.com/promotions/v1beta/accounts/123/promotions:insert

{
  "promotion": {
    "promotionId": "buy_2_get_10_off",
    "contentLanguage": "en",
    "targetCountry": "US",
    "redemptionChannel": [
      "IN_STORE"
    ],
    "attributes": {
      "longTitle": "Buy 2 and get 10$ OFF purchase",
      "productApplicability": "ALL_PRODUCTS",
      "offerType": "NO_CODE",
      "couponValueType": "BUY_M_GET_MONEY_OFF",
      "promotionDisplayTimePeriod": {
        "startTime": "2024-2-06T00:47:44Z",
        "endTime": "2024-5-06T00:47:44Z"
      },
      "promotionEffectiveTimePeriod": {
        "startTime": "2024-2-06T00:47:44Z",
        "endTime": "2024-5-06T00:47:44Z"
      },
      "moneyOffAmount": {
        "amountMicros": "1000000",
        "currencyCode": "USD"
      },
      "minimum_purchase_quantity": 2,
      "storeApplicability": "ALL_STORES",
      "promotionUrl": "http://promotionnew4url.com/",
      "promotionDestinations": [
        "LOCAL_INVENTORY_ADS"
      ],
    }
  },
  "dataSource": "accounts/123/dataSources/1000000573361824"
}

샘플 2: 특정 기프트 카드를 사용하여 선택한 제품에 적용되는 온라인 프로모션 코드

POST https://merchantapi.googleapis.com/promotions/v1beta/accounts/123/promotions:insert

{
 "promotion": {
   "promotionId": "25_pct_off",
   "contentLanguage": "en",
   "targetCountry": "US",
   "redemptionChannel": [
     "ONLINE"
   ],
   "attributes": {
     "longTitle": "10% off on selected items",
     "productApplicability": "SPECIFIC_PRODUCTS",
     "offerType": "GENERIC_CODE",
     "genericRedemptionCode": "SPRINGSALE",
     "couponValueType": "PERCENT_OFF",
     "promotionDisplayTimePeriod": {
       "startTime": "2024-2-06T00:47:44Z",
       "endTime": "2024-5-06T00:47:44Z"
     },
     "promotionEffectiveTimePeriod": {
       "startTime": "2024-2-06T00:47:44Z",
       "endTime": "2024-5-06T00:47:44Z"
     },
     "percentOff": 25,
     "promotionDestinations": [
       "FREE_LISTINGS"
     ],
     "itemIdInclusion": [
       "1499860100",
       "1499860101",
       "1499860102",
       "1499860103",
       "1499860104"
     ],
   }
 },
 "dataSource": "accounts/123/dataSources/1000000573361824"
}

특별 참고 사항

프로모션을 만든 후 프로모션을 만드는 데 몇 분 정도 걸릴 수 있습니다.

프로모션 관련 속성 목록은 구조화된 데이터 추가를 참조하세요. 속성을 참조하세요.

프로모션을 만들고 관리하기 전에 프로모션 권장사항 관행.

프로모션 보기

프로모션을 보려면 다음을 사용하세요. accounts.promotions.get 이 get은 읽기 전용입니다. merchantId 및 프로모션 get 메서드는 상응하는 프로모션 리소스를 반환합니다.

예를 들면 다음과 같습니다.

GET https://merchantapi.googleapis.com/promotions/v1beta/{name=accounts/*/promotions/*}

다음 샘플을 살펴보세요.

샘플 1: 오프라인 프로모션

GET https://merchantapi.googleapis.com/promotions/v1beta/accounts/123/promotions/in_store~en~US~buy_2_get_10_off

{
 "name": "accounts/123/promotions/in_store~en~US~buy_2_get_10_off",
 "promotionId": "buy_2_get_10_off",
 "contentLanguage": "en",
 "targetCountry": "US",
 "redemptionChannel": [
   "IN_STORE"
 ],
 "attributes": {
   "longTitle": "Buy 2 and get 10$ OFF purchase",
   "productApplicability": "ALL_PRODUCTS",
   "offerType": "NO_CODE",
   "couponValueType": "BUY_M_GET_MONEY_OFF",
   "promotionDisplayTimePeriod": {
     "startTime": "2024-2-06T00:47:44Z",
     "endTime": "2024-5-06T00:47:44Z"
   },
   "promotionEffectiveTimePeriod": {
     "startTime": "2024-2-06T00:47:44Z",
     "endTime": "2024-5-06T00:47:44Z"
   },
   "moneyOffAmount": {
     "amountMicros": "1000000",
     "currencyCode": "USD"
   },
   "minimum_purchase_quantity": 2,
   "storeApplicability": "ALL_STORES",
   "promotionUrl": "http://promotionnew4url.com/",
   "promotionDestinations": [
     "LOCAL_INVENTORY_ADS"
   ],
 }
 "dataSource": "accounts/123/dataSources/1000000573361824"
}

샘플 2. 온라인 프로모션

GET https://merchantapi.googleapis.com/promotions/v1beta/accounts/123/promotions/online~en~US~25_pct_off
{
 "name": "accounts/123/promotions/online~en~US~25_pct_off",
 "promotionId": "25_pct_off",
 "contentLanguage": "en",
 "targetCountry": "US",
 "redemptionChannel": [
   "ONLINE"
 ],
 "attributes": {
   "longTitle": "10% off on selected items",
   "productApplicability": "SPECIFIC_PRODUCTS",
   "offerType": "GENERIC_CODE",
   "genericRedemptionCode": "WINTERGIFT",
   "couponValueType": "PERCENT_OFF",
   "promotionDisplayTimePeriod": {
     "startTime": "2024-2-06T00:47:44Z",
     "endTime": "2024-5-06T00:47:44Z"
   },
   "promotionEffectiveTimePeriod": {
     "startTime": "2024-2-06T00:47:44Z",
     "endTime": "2024-5-06T00:47:44Z"
   },
   "percentOff": 25,
   "promotionDestinations": [
     "FREE_LISTINGS"
   ],
   "itemIdInclusion": [
     "1499860100",
     "1499860101",
     "1499860102",
     "1499860103",
     "1499860104"
   ],
 }
 "dataSource": "accounts/{account}/dataSources/{dataSource}"
}

프로모션 나열

이 promotions.list 드림 메서드를 사용하여 생성된 모든 프로모션을 볼 수 있습니다.

GET https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions

프로모션 상태

프로모션 상태를 보려면 promotionStatus 속성을 보면 됩니다. 반환: promotions.get 및 promotions.list

승인 절차에 대한 자세한 내용은 프로모션 승인을 참조하세요. 절차에 따라 다릅니다.

샘플 프로모션 상태

다음 샘플은 성공과 실패의 차이점을 보여줍니다. 요청을 처리합니다

샘플 1. 다음 응답 본문은 제품 매핑 누락으로 인해 거부되었습니다.

  "promotionStatus": {
    "destinationStatuses": [
      {
        "reportingContext": "FREE_LISTINGS",
        "status": "REJECTED"
      }
    ],
    "itemLevelIssues": [
      {
        "code": "promotion_sku_unmapped",
        "severity": "DISAPPROVED",
        "resolution": "merchant_action",
        "reportingContext": "FREE_LISTINGS",
        "description": "Unmapped",
        "detail": "This promotion couldn't be tested during review because it doesn't apply to any products that are currently in your Products feed",
        "documentation": "https://support.google.com/merchants/answer/2906014",
        "applicableCountries": [
          "US"
        ]
      },
      {
        "code": "promotion_sku_additional_requirements",
        "severity": "DISAPPROVED",
        "resolution": "merchant_action",
        "reportingContext": "FREE_LISTINGS",
        "description": "Promotion conditions not allowed",
        "detail": "This promotion has additional requirements that are not allowed such as requiring customers to verify additional details like phone number or ID before showing the promotion details",
        "documentation": "https://support.google.com/merchants/answer/2906014",
        "applicableCountries": [
          "US"
        ]
      }
    ]
  }

샘플 2. 다음 응답 본문은 승인된 프로모션을 보여줍니다.

  "promotionStatus": {
    "destinationStatuses": [
      {
        "reportingContext": "FREE_LISTINGS",
        "status": "PENDING"
      },
      {
        "destination": "SHOPPING_ADS",
        "status": "PENDING"
      }
    ],
    "itemLevelIssues": []
  }

샘플 3. 승인된 실시간 프로모션

  "promotionStatus": {
    "destinationStatuses": [
      {
        "reportingContext": "FREE_LISTINGS",
        "status": "LIVE"
      },
      {
        "destination": "SHOPPING_ADS",
        "status": "LIVE"
 }  ],
    "itemLevelIssues": []
  }

자세히 알아보기

자세한 내용은 프로모션 도움말을 참고하세요. 중앙으로 이동합니다.

Content API for Shopping에서 이전하는 방법에 대한 자세한 내용은 프로모션 이전을 참고하세요. 관리를 참조하세요.