Use as promoções para mostrar ofertas especiais de produtos que você vende no Google. As promoções aparecem em diferentes Serviços do Google, incluindo a Pesquisa Google, Shopping e Chrome.
Quando você adiciona promoções aos seus produtos, os compradores veem um link de oferta especial, para exemplo "15% de desconto" ou "Frete grátis". Links de ofertas podem aumentar o apelo seus produtos e incentivar os compradores a comprar.
Para mais informações, consulte Promoção e os conceitos básicos.
Pré-requisitos
O Google precisa que você forneça informações específicas sobre sua empresa e produtos antes de exibir suas promoções. Você precisa ter o seguinte:
- Um produto ativo feed na plataforma Merchant Center.
- Uma promoção ativa feed na plataforma Merchant Center.
- Uma conta do Google Ads. para Google Shopping campanhas.
Além disso, é preciso registrar sua conta de comerciante no Programa de Promoções. Se você não tiver certeza se já fez a inscrição, consulte a página de Ajuda.
Se você não estiver inscrito, preencha a solicitação formulário. A a equipe de promoções vai avisar você quando estiver tudo pronto para começar a implementação.
Para mais informações, consulte Critérios de participação e políticas do IAM.
Criar uma fonte de dados
Use a API datasource.create para criar um feed de promoção. Se um modelo O feed de promoções está disponível. Use datasource.get para buscar o datasource.name
O formato da solicitação é o seguinte:
POST https://merchantapi.googleapis.com/promotions/v1beta/accounts/{account}/dataSources/{datasource}
Exemplo
O exemplo mostra uma solicitação e uma resposta típicas.
Solicitação:
POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/123/dataSources {"displayName": "test api feed", "promotionDataSource":{"targetCountry":"US", "contentLanguage":"en"}}
Resposta:
{
"name": "accounts/123/dataSources/1000000573361824",
"dataSourceId": "1000000573361824",
"displayName": "test api feed",
"promotionDataSource": {
"targetCountry": "US",
"contentLanguage": "en"
},
"input": "API"
}
Crie promoções
Você pode usar o
accounts.promotions.insert
para criar ou atualizar uma promoção. Método accounts.promotions.insert
usa um recurso promotions e um nome de fonte de dados como entrada. Ela retorna
promoção nova ou atualizada se for bem-sucedida.
A criação de uma promoção exige datasource.name (em inglês).
O Google analisa e aprova suas promoções antes de distribuí-las. Para mais informações, consulte Aprovação da promoção de análise de dados.
O formato da solicitação:
POST https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*/}promotions:insert
Estude os seguintes exemplos de promoções para referência.
Exemplo 1: um Local promoção aplicável para todos os produtos e todas as lojas
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"
}
Exemplo 2: uma promoção on-line aplicada a produtos selecionados com um resgate código
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"
}
Observações especiais
Pode levar alguns minutos depois que a promoção for criada.
Para uma lista de atributos relacionados a promoções, consulte Adicionar dados estruturados atributos.
Antes de criar e gerenciar promoções, consulte Melhores promoções práticas.
Ver promoções
Para acessar uma promoção, use
accounts.promotions.get
Este get é somente leitura. São necessários seu merchantId e o ID do
promoção. O método get retorna o recurso de promoções correspondente.
Exemplo:
GET https://merchantapi.googleapis.com/promotions/v1beta/{name=accounts/*/promotions/*}
Estude essas amostras.
Exemplo 1: uma promoção local
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"
}
Amostra 2. Uma promoção on-line
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}"
}
Listar promoções
Você pode usar o
promotions.list
para visualizar todas as promoções criadas.
GET https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions
Status da promoção
Para ver o status de uma promoção, consulte o atributo promotionStatus.
retornado por
promotions.get
e
promotions.list.
Para entender o processo de aprovação, consulte Aprovação de promoções de análise de dados.
Exemplo de status de promoção
Os exemplos a seguir demonstram a diferença entre sucesso e falha solicitações.
Exemplo 1. O corpo da resposta a seguir mostra uma promoção on-line que seria recusado devido à ausência de mapeamento de produtos.
"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"
]
}
]
}
Amostra 2. O corpo da resposta a seguir mostra uma promoção aprovada.
"promotionStatus": {
"destinationStatuses": [
{
"reportingContext": "FREE_LISTINGS",
"status": "PENDING"
},
{
"destination": "SHOPPING_ADS",
"status": "PENDING"
}
],
"itemLevelIssues": []
}
Amostra 3. Uma promoção aprovada e ativa
"promotionStatus": {
"destinationStatuses": [
{
"reportingContext": "FREE_LISTINGS",
"status": "LIVE"
},
{
"destination": "SHOPPING_ADS",
"status": "LIVE"
} ],
"itemLevelIssues": []
}
Saiba mais
Para mais detalhes, consulte a Ajuda das promoções de Ajuda.
Para saber mais sobre a migração da API Content for Shopping, consulte Migrar promoções de configuração.