Ringkasan Merchant Promotion API

Gunakan promosi untuk menampilkan penawaran spesial produk yang Anda jual di Google. Promosi ditampilkan di berbagai properti Google, termasuk Google Penelusuran, Shopping, dan Chrome.

Saat Anda menambahkan Promosi ke produk Anda, pembeli akan melihat link penawaran spesial untuk contoh "diskon 15%" atau "Gratis ongkos kirim". Link penawaran dapat meningkatkan daya tarik produk Anda dan mendorong pembeli untuk melakukan pembelian.

Untuk informasi selengkapnya, lihat Promosi dasar-dasar.

Prasyarat

Google meminta Anda memberikan informasi spesifik tentang bisnis Anda dan sebelum menampilkan promosi Anda. Anda harus memiliki hal berikut:

Selain itu, Anda harus mendaftarkan akun penjual Anda dalam program Promosi. Jika jika tidak yakin apakah Anda sudah terdaftar, periksa Google.

Jika Anda tidak terdaftar, lengkapi permintaan formulir ini. Tujuan tim promosi akan memberi tahu kapan Anda siap untuk memulai implementasi.

Untuk informasi selengkapnya, lihat Kriteria partisipasi dan kebijakan yang relevan.

Membuat sumber data

Gunakan API datasource.create untuk membuat feed promo. Jika pelanggan Feed promo tersedia, gunakan datasource.get untuk mengambil datasource.name

Bentuk permintaannya adalah sebagai berikut:

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

Contoh

Contoh ini menunjukkan permintaan dan respons yang umum.

Permintaan:

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

Respons:

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

Buat promosi

Anda dapat menggunakan accounts.promotions.insert untuk membuat atau memperbarui promosi. Metode accounts.promotions.insert menggunakan resource promotions dan nama sumber data sebagai input. Metode ini mengembalikan promosi baru atau yang diperbarui jika berhasil.

Membuat promosi memerlukan datasource.name.

Google meninjau dan menyetujui promosi Anda sebelum mendistribusikannya. Untuk selengkapnya informasi, lihat Persetujuan promosi {i>checkout<i}.

Bentuk permintaan:

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

Pelajari contoh promosi berikut sebagai referensi.

Contoh 1: Lokal promosi berlaku untuk semua produk dan semua toko

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"
}

Contoh 2: Promosi online yang diterapkan untuk produk yang dipilih dengan penukaran kode

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"
}

Catatan khusus

Setelah pembuatan promosi, mungkin perlu waktu beberapa menit untuk membuat promosi.

Untuk mengetahui daftar atribut terkait promosi, lihat Menambahkan data terstruktur atribut.

Sebelum membuat dan mengelola promosi, lihat Promosi Terbaik Praktik.

Lihat promosi

Untuk melihat promosi, gunakan accounts.promotions.get Get ini bersifat hanya baca. Proses ini memerlukan merchantId Anda dan ID promosi. Metode get akan menampilkan resource promosi yang sesuai.

Contoh:

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

Pelajari contoh-contoh ini.

Contoh 1: Promosi lokal

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"
}

Contoh 2. Promosi online

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}"
}

Menampilkan daftar promosi

Anda dapat menggunakan promotions.list untuk melihat semua promosi yang dibuat.

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

Status promosi

Untuk melihat status promosi, Anda dapat melihat atribut promotionStatus dikembalikan oleh promotions.get dan promotions.list

Untuk memahami proses persetujuan, lihat Persetujuan promosi {i>checkout<i}.

Contoh status promosi

Contoh berikut menunjukkan perbedaan antara keberhasilan dan kegagalan permintaan.

Contoh 1. Isi respons berikut menunjukkan promosi online yang ditolak karena pemetaan produk tidak ada.

  "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"
        ]
      }
    ]
  }

Contoh 2. Isi respons berikut menunjukkan promosi yang disetujui.

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

Contoh 3. Promosi aktif yang disetujui

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

Pelajari lebih lanjut

Untuk mengetahui detail selengkapnya, lihat Bantuan Promosi Google.

Untuk mempelajari cara bermigrasi dari Content API for Shopping, lihat Memigrasikan promosi Google Workspace.