Gli script Google Ads consentono di gestire in qualche modo le attività di Shopping campagne. Puoi utilizzare script da utilizzare con le campagne Shopping esistenti, nonché per creare e gestire i prodotti gerarchie di gruppo ed eseguire report sugli acquisti. Tuttavia, non puoi utilizzare gli script per creare campagne Shopping, imposta le proprietà Shopping a livello di campagna (ad esempio: priorità della campagna, filtri inventario ecc.) o collega Merchant Center .
Recupero di campagne e gruppi di annunci Shopping
Le campagne Shopping sono disponibili tramite
shoppingCampaigns
raccolta di
AdsApp
. Tu
recuperarli come di consueto tramite gli script:
const campaignName = "My first shopping campaign";
const campaignIterator = AdsApp.shoppingCampaigns()
.withCondition(`campaign.name = "${campaignName}"`)
.get();
for (const campaign of campaignIterator) {
...
}
Dopo aver recuperato una campagna, puoi visualizzare i relativi gruppi di annunci in modo in modo adeguato. Questa opzione è preferibile solo se devi intervenire sia sulla campagna che sui suoi gruppi di annunci.
const adGroupIterator = campaign.adGroups()
.withCondition(`ad_group.name = "${adGroupName}"`)
.get();
for (const adGroup of adGroupIterator) {
...
}
Se prevedi di agire solo su specifici gruppi di annunci, puoi utilizzare la
AdsApp.shoppingAdGroups()
metodo per recuperare i gruppi di annunci senza recuperare il
per prima cosa:
const adGroupIterator = AdsApp.shoppingAdGroups()
.withCondition(`campaign.name = "${campaignName}"`)
.withCondition(`ad_group.name = "${adGroupName}"`)
.get();
for (const adGroup of adGroupIterator) {
...
}
Annunci di prodotti
Gli script Google Ads consentono di
recupera
gli annunci di prodotto utilizzando
il
ads()
del metodo
ShoppingAdGroup
Puoi
creazione
i nuovi annunci di prodotto che utilizzano
newAdBuilder()
:
metodo di
ShoppingAdGroup
.
Eseguire l'iterazione della gerarchia dei gruppi di prodotti
Puoi accedere alla directory principale della gerarchia di gruppi di prodotti utilizzando il
rootProductGroup
del metodo
ShoppingAdGroup
.
Puoi quindi utilizzare
children
per iterare i gruppi di prodotti secondari e attraversare il gruppo di prodotti
nella gerarchia. Ogni nodo è
ProductGroup
e puoi utilizzare
getDimension
per determinare il tipo effettivo di gruppo di prodotti. Puoi anche trasmettere
a un tipo più specifico (ad esempio,
ProductBrand
)
utilizzando il metodo di trasmissione corrispondente (ad esempio,
asBrand
).
Il seguente snippet di codice mostra come attraversare in modo ricorsivo il gruppo di prodotti
nella gerarchia.
walkTree(shoppingAdGroup.rootProductGroup(), 1);
function walkTree(root, level) {
// Logger.log(root.getDimension());
let description = "";
switch (root.getDimension()) {
case "ROOT":
description = "Root";
break;
case "CATEGORY":
description = root.asCategory().getName();
break;
case "BRAND":
description = root.asBrand().getName();
break;
// Handle more types here.
...
}
if (root.isOtherCase()) {
description = "Other";
}
const padding = new Array(level + 1).join('-');
console.log("%s, %s, %s, %s, %s, %s",
padding,
description,
root.getDimension(),
root.getMaxCpc(),
root.isOtherCase(),
root.getId().toFixed());
const children = root.children().get();
for (const child of children) {
walkTree(child, level + 1);
}
}
Seleziona un gruppo di prodotti specifico
Puoi selezionare gruppi di prodotti specifici in una gerarchia di gruppi di prodotti con i
productGroups
di un
AdsApp
,
ShoppingCampaign
,
o
ShoppingAdGroup
in esecuzione in un'istanza Compute Engine. Questo approccio è più semplice rispetto all'uso dell'intero gruppo di prodotti
gerarchia durante la selezione di specifici gruppi di prodotti per la gestione delle offerte
scopi. Il seguente snippet di codice mostra come selezionare tutti i gruppi di prodotti
con più di cinque clic e una percentuale di clic superiore a 0.01
durante
nell'ultimo mese e aumenta la propria offerta di 0.01
.
function main() {
const productGroups = AdsApp.productGroups()
.withCondition("metrics.clicks > 5")
.withCondition("metrics.ctr > 0.01")
.forDateRange("LAST_MONTH")
.get();
for (const productGroup of productGroups) {
productGroup.setMaxCpc(productGroup.getMaxCpc() + 0.01);
}
}
Aggiornare la gerarchia di un gruppo di prodotti
Puoi aggiungere un gruppo di prodotti secondario a un gruppo di prodotti esistente utilizzando il relativo
newChild
. Questo ti offre
ProductGroupBuilderSpace
che potrai utilizzare per creare un gruppo di prodotti appropriato. La
lo snippet di codice riportato di seguito aggiunge una suddivisione per "cardcow" brand alla base
e poi la suddivide ulteriormente per i prodotti nuovi e ricondizionati.
const root = shoppingAdGroup.rootProductGroup();
// Add a brand product group for a "cardcow" under root.
const brandProductGroup = root.newChild()
.brandBuilder()
.withName("cardcow")
.withBid(1.2)
.build()
.getResult();
// Add new conditions for New and Refurbished cardcow brand items.
const newItems = brandProductGroup.newChild()
.conditionBuilder()
.withCondition("New")
.withBid(1.5)
.build()
.getResult();
// Refurbished items will use the bid from "cardcow" product group.
const refurbishedItems = brandProductGroup.newChild()
.conditionBuilder()
.withCondition("Refurbished")
.build()
.getResult();
Analogamente, puoi rimuovere una suddivisione utilizzando
remove
metodo di
ProductGroup
.
In questo modo viene eliminata anche l'intera gerarchia dei gruppi di prodotti sotto il prodotto
che viene rimosso.
Gli script assicureranno che la gerarchia dei gruppi di prodotti sia in uno stato coerente dopo aver creato ciascun gruppo di prodotti, pertanto non devi creare o eliminare gruppo di prodotti corrispondente a "Tutto il resto" quando aggiorni il prodotto struttura gerarchica di gruppo.
La scheda "Tutto il resto" gruppo di prodotti
Le gerarchie dei gruppi di prodotti Shopping contengono il pulsante "Tutto il resto" ("Altro")
gruppo di prodotti a ogni livello per gestire prodotti che non corrispondono
condizione personalizzata che hai creato nella gerarchia dei gruppi di prodotti. Puoi utilizzare lo
isOtherCase
per distinguere tra un normale gruppo di prodotti che hai aggiunto e il
"Altro" gruppo di prodotti.
Il seguente snippet di codice recupera l'elemento "Altro" gruppo di prodotti nella directory principale gerarchia dei gruppi di prodotti e stampa la relativa offerta.
const root = shoppingAdGroup.rootProductGroup();
const childProductGroups = root.children().get();
let everythingElseProductGroupFound = false;
for (const childProductGroup of childProductGroups) {
if (childProductGroup.isOtherCase()) {
console.log("'Everything else' product group found. Type of the " +
"product group is %s and bid is %s.",
childProductGroup.getDimension(),
childProductGroup.getMaxCpc());
everythingElseProductGroupFound = true;
break;
}
}
if (!everythingElseProductGroupFound) {
console.log("No 'Everything else' product group found under root " +
"product group.");
}
Quando suddividi un gruppo di prodotti foglia, gli script creano automaticamente "Altro" gruppo di prodotti per garantire che la gerarchia dei gruppi di prodotti rimanga valida. L'opzione "Altro" Il gruppo di prodotti eredita l'offerta del prodotto principale gruppo.
Crea un nuovo gruppo di annunci Shopping
Gli script Google Ads ti consentono di creare un nuovo gruppo di annunci Shopping utilizzando
newAdGroupBuilder
metodo di
ShoppingCampaign
.
Dopo aver creato
ShoppingAdGroup
,
puoi usare i suoi
createRootProductGroup
per creare una nuova gerarchia dei gruppi di prodotti.
Report
Gli script Google Ads supportano
product_group_view
e
shopping_performance_view
per monitorare il rendimento delle campagne Shopping. Puoi
scopri di più sui report nel nostro
guida ai report.