Come monitorare lo stato degli obiettivi di Google Ads negli account MCC utilizzando Fogli Google

Questa esercitazione documenta uno script che controlla l'attività dell'obiettivo di conversione in tutti gli account del Centro clienti. Scrive i risultati su un foglio Google, codifica lo stato di salute di ogni obiettivo, codifica a colori lo stato e invia un riepilogo via e-mail solo quando c'è un problema.

Non ci sono strumenti inutili o dashboard di terze parti, solo un controllo grezzo e una visibilità completa.

Funzioni di questo script

Questo script controlla tutti gli account Google Ads del Centro clienti e valuta lo stato di ciascun obiettivo di conversione in un periodo di lookback definito. Invece di indovinare quali obiettivi sono attivi o non raggiunti, questo sistema ti fornisce un'istantanea in tempo reale in un foglio Google e ti avvisa solo quando qualcosa richiede la tua attenzione.

• Si connette al Centro clienti e scorre in loop ogni account collegato
• Ignora gli account che hai inserito nella lista bloccata (esclusi)
• Estrae il rendimento delle conversioni a livello di campagna in un determinato periodo di lookback
• Valuta lo stato di salute di ogni obiettivo di conversione
• Registra i risultati in un foglio Google, applicando i colori di sfondo allo stato
• Invia via e-mail un riepilogo solo degli account o degli obiettivi problematici

Notifiche e-mail

Ci saranno due notifiche e-mail: una per gli account che necessitano di attenzione e l'altra per tutti gli account validi.

Esempio:

Messaggi:

Capito, il tuo script ha bisogno Due uscite e-mail distinte :

1. ✅ E-mail "Tutto bene" (se Nessun problema sono stati trovati)

2. ⚠️ E-mail "Richiede attenzione" (se qualunque gli obiettivi sono inattivi, mancanti o a basso rendimento)

Ecco esattamente come dovrebbero apparire entrambe le versioni, utilizzando i dati di esempio e la logica corrente:

Messaggio #1

Tutti gli obiettivi di conversione monitorati segnalano l'attività degli ultimi 60 giorni.

Nessun problema riscontrato in nessun account.

Visualizza il report completo:
https://docs.google.com/spreadsheets/d/yoursheetid

Messaggio #2

Potrebbe essere necessario esaminare i seguenti obiettivi di conversione (ad esempio, nessuna conversione recente o inattiva):

Bright Widgets Inc (123-456-789) - Invio del modulo di contatto (richiede attenzione)
Acme Corp (987-654-321) - Pianifica chiamata (non attivo)
Acme Corp (987-654-321) - Iscrizione alla prova gratuita (richiede attenzione)
Cavi per razzi (456-789-123) - (configurato, nessuna attività) (nessuna conversione recente)
Gruppo di test beta (321-654-987) - (non impostato) (non attivo)
Zebra Analytics (999-111-222) - Download del whitepaper (richiede attenzione)

Visualizza il report completo:
https://docs.google.com/spreadsheets/d/yoursheetid

Requisiti

Prima di distribuire lo script, assicurarsi che l'ambiente sia configurato correttamente. Questo script è progettato per essere eseguito all'interno di un contesto Centro clienti di Google Ads per scrivere dati e inviare avvisi.

• Account Centro clienti di Google Ads
• Foglio di calcolo Google (deve essere creato manualmente)

La sceneggiatura originale

Questo è lo script nella sua forma completa e non modificata. Tutti i commenti, la formattazione e la logica sono esattamente come scritti originariamente. Non modificare questa impostazione se si prevede di seguire la suddivisione più avanti in questa esercitazione.

// ========== CONFIGURATION ==========

const SHEET_ID = '1PvpW3eUl5fqRwabBg0P7D8LKzW83MOTVX1KDBMB3ipA';

const LOOKBACK_DAYS = 60;

const EXCLUDED_ACCOUNT_IDS = [

'000-000-000', '000-000-000', '000-000-000'

];

const RECIPIENT_EMAILS = '[email protected]';

// ===================================

function main() {

const sheet = SpreadsheetApp.openById(SHEET_ID).getSheets()[0];

sheet.clear();

sheet.appendRow(['Account Name', 'Account ID', 'Goal Name', 'Conversions', 'Status', 'Date Range']);

const startDate = getDateXDaysAgo(LOOKBACK_DAYS);

const endDate = getTodayDate();

const dateRangeLabel = `Last ${LOOKBACK_DAYS} days (${startDate} to ${endDate})`;

const accounts = MccApp.accounts().get();

const flagged = [];

let rowIndex = 2;

while (accounts.hasNext()) {

const account = accounts.next();

const accountId = account.getCustomerId();

const accountName = account.getName();

Logger.log(`⏳ Checking account: ${accountName} (${accountId})`);

if (EXCLUDED_ACCOUNT_IDS.includes(accountId)) {

Logger.log(`🚫 Skipping excluded account: ${accountName} (${accountId})`);

continue;

}

try {

MccApp.select(account);

const query = `

SELECT ConversionTypeName, Conversions

FROM CAMPAIGN_PERFORMANCE_REPORT

DURING ${startDate},${endDate}

`;

const report = AdsApp.report(query);

const rows = report.rows();

const goalMap = {};

while (rows.hasNext()) {

const row = rows.next();

const goalName = row['ConversionTypeName'] || '(not set)';

const conversions = parseFloat(row['Conversions']) || 0;

if (!goalMap[goalName]) {

goalMap[goalName] = 0;

}

goalMap[goalName] += conversions;

}

if (Object.keys(goalMap).length === 0) {

Logger.log(`⚠️ No conversion data returned for account: ${accountName} (${accountId})`);

const status = 'No Recent Conversions';

sheet.appendRow([

accountName,

accountId,

'(configured, no activity)',

0,

status,

dateRangeLabel

]);

setStatusColumnColor(sheet, rowIndex, status);

flagged.push(`${accountName} (${accountId}) - no conversion goals triggered`);

rowIndex++;

continue;

}

for (const [goalName, totalConversions] of Object.entries(goalMap)) {

let status;

if (totalConversions > 0) {

status = 'Active';

} else if (goalName.toLowerCase().includes('test') || goalName === '(not set)') {

status = 'Inactive';

} else {

status = 'Needs Attention';

}

sheet.appendRow([

accountName,

accountId,

goalName,

totalConversions,

status,

dateRangeLabel

]);

setStatusColumnColor(sheet, rowIndex, status);

if (status !== 'Active') {

flagged.push(`${accountName} (${accountId}) - ${goalName} (${status})`);

}

rowIndex++;

}

} catch (e) {

Logger.log(`❌ Error processing account: ${accountName} (${accountId}) - ${e.message}`);

}

}

if (flagged.length > 0) {

const subject = '⚠️ Conversion Goals Needing Attention';

const body = `The following conversion goals may need review (e.g., no recent conversions or inactive):\n\n`

+ flagged.join('\n')

+ `\n\nView the full report:\nhttps://docs.google.com/spreadsheets/d/${SHEET_ID}`;

MailApp.sendEmail(RECIPIENT_EMAILS, subject, body);

} else {

Logger.log('✅ All goals are reporting conversions.');

}

}

// 🎨 Apply color to only the "Status" column (Column E)

function setStatusColumnColor(sheet, row, status) {

const range = sheet.getRange(row, 5); // Column E

switch (status) {

case 'Active':

range.setBackground('#d9ead3'); // Light green

break;

case 'Inactive':

range.setBackground('#f4cccc'); // Light red

break;

case 'Needs Attention':

range.setBackground('#fff2cc'); // Light yellow

break;

case 'No Recent Conversions':

range.setBackground('#e6e6fa'); // Light purple

break;

default:

range.setBackground(null);

}

}

// 🕒 Helpers

function getTodayDate() {

const date = new Date();

return Utilities.formatDate(date, AdsApp.currentAccount().getTimeZone(), 'yyyyMMdd');

}

function getDateXDaysAgo(days) {

const date = new Date();

date.setDate(date.getDate() - days);

return Utilities.formatDate(date, AdsApp.currentAccount().getTimeZone(), 'yyyyMMdd');

}

Suddivisione degli script per sezione

CONFIGURAZIONE

• SHEET_ID: destinazione di Fogli Google per tutti gli output
• LOOKBACK_DAYS: Finestra di reporting in giorni
• EXCLUDED_ACCOUNT_IDS: Conti cliente da saltare
• RECIPIENT_EMAILS: Chi riceve un'email quando c'è un problema

Funzione main()

• Apre il foglio, lo cancella e imposta le intestazioni
• Calcola l'intervallo di date
• Passa in loop a tutti i sottoconti MCC
• Ignora quelli che sono stati bloccati
• Utilizza CAMPAIGN_PERFORMANCE_REPORT per estrarre tutti i dati degli obiettivi
• Per ogni obiettivo:
  • Aggrega le conversioni totali
  • Assegna uno stato:
    • Attivo: conversioni > 0
    • Inattivo: obiettivo di test o non impostato
    • Richiede attenzione: zero conversioni, non un test
    • Nessuna conversione recente: non sono stati restituiti dati sull'obiettivo
• Aggiunge dati al foglio
• Chiama setStatusColumnColor() per contrassegnare ogni riga
• Crea un elenco segnalato ed e-mail se viene rilevato un problema

setStatusColumnColor(foglio, riga, stato)

• Applica un colore di sfondo alla colonna E a seconda dello stato dell'obiettivo:
  • Verde per l'attività attiva
  • Rosso per inattivo
  • Giallo per ha bisogno di attenzione
  • Viola per assenza di attività

Aiutanti per la data

• getTodayDate() restituisce la data odierna nel fuso orario corretto
• getDateXDaysAgo() restituisce la data X giorni fa

Questa procedura dettagliata mostra come impostare lo strumento di verifica dello stato dell'obiettivo di conversione per l'account Centro clienti Google Ads. Segui ogni passaggio per far funzionare il sistema, scrivi su Fogli Google e invia avvisi quando qualcosa si rompe.

Passaggio 1: crea il foglio Google

Inizia impostando la destinazione di output.

1. Vai a Fogli Google
2. Fai clic su "Vuoto" per creare un nuovo foglio di calcolo
3. Per favore, dagli un nome come Goal Monitor
4. La parte al centro è l'ID del foglio
5. Incolla l'ID nel tuo script dove dice const SHEET_ID = '...'

Passaggio 2: apri il pannello Script di Google Ads

Distribuirai questo script all'interno del tuo account Centro clienti.

1. Accedi al tuo account Centro clienti Google Ads
2. Fai clic su "Strumenti e impostazioni" nella barra di navigazione in alto
3. Nella sezione "Azioni collettive", seleziona "Script".
4. Fare clic sul pulsante più (+) per aggiungere un nuovo script
5. Incollare l'intero script esattamente come scritto nell'editor di codice

Passaggio 3: autorizza lo script

La prima volta che si utilizza lo script, è necessario autorizzarlo.

1. Fai clic su "Autorizza" in alto a destra
2. Seleziona il tuo account Google
3. Approva tutte le autorizzazioni richieste

È necessario completare questo passaggio o lo script non verrà eseguito.

Passaggio 4: Impostare la configurazione dello script

All'interno dello script, rivedere e modificare quanto segue:

• SHEET_ID: Incolla l'ID foglio copiato
• LOOKBACK_DAYS: Cambia se necessario (il valore predefinito è 60)
• EXCLUDED_ACCOUNT_IDS: aggiungi tutti gli account che non desideri scansionare
• RECIPIENT_EMAILS: aggiungere l'e-mail o le e-mail per ricevere i rapporti di avviso

È possibile lasciare il resto dello script esattamente così com'è.

Passaggio 5: Eseguire un test manuale

Eseguilo una volta manualmente per assicurarti che tutto funzioni.

1. Fai clic su "Esegui" nella parte superiore della navigazione.
2. Attendere il completamento dell'esecuzione.
3. Apri il foglio Google collegato.
4. Verificare che:
   • Le intestazioni sono state create
   • I dati sono stati scritti per ogni account attivo.
   • Gli stati e i colori vengono applicati correttamente nella colonna E.

Passaggio 6: Pianificare lo script (facoltativo)

Per renderlo automatico, impostarlo in modo che venga eseguito in base a una pianificazione ricorrente.

1. Dall'editor di script, fai clic su "Crea pianificazione".
2. Scegli una frequenza (si consiglia una frequenza giornaliera)
3. Imposta il tempo di esecuzione (la mattina presto è l'ideale)
4. Salva e chiudi

Lo script verrà eseguito automaticamente e ti avviserà solo quando qualcosa non va.

Passaggio 7: Esaminare gli avvisi

Quando lo script viene eseguito, controlla tutti gli obiettivi di conversione. Se qualcuno è inattivo o non si attiva, ricevi un'e-mail.

Riepilogo

Questo script non è solo un dump di dati. È un controllo per ogni obiettivo di conversione nell'intero Centro clienti Google Ads. Ricevi un avviso quando qualcosa si rompe, si blocca o interrompe silenziosamente il tracciamento. Quando tutto va bene, c'è silenzio.

Controlla tutti gli account che gestisci, segnala gli obiettivi inattivi o con prestazioni insufficienti e invia un report filtrato e senza rumore direttamente nella tua casella di posta. Il foglio Google ti offre una visualizzazione in tempo reale dello stato dell'obiettivo in base all'account, al nome dell'obiettivo e al volume di conversione, con segnali visivi incorporati.

Non stai scavando attraverso le interfacce. Non stai aspettando fino alla fine del mese per renderti conto di essere stato cieco. Hai il controllo prima che diventi un problema.

Dai un'occhiata a post simili:

Dai un'occhiata a post simili:

Se gestisci più account, non perderti la nostra guida su monitoraggio dei problemi di GA4 da numerose proprietà O esportatore Termini di ricerca effettivi più performanti con uno script leggero per perfezionare il targeting.

Contattaci

Stanco di indovinare se il tuo tracciamento funziona? Vuoi un team che crei sistemi invece di semplici report?

Bright Vessel non si limita a gestire Google Ads; Progettiamo la visibilità delle prestazioni su larga scala. Che tu abbia bisogno di aiuto per implementare questo script, integrarlo in uno stack di automazione più ampio o creare un livello di analisi personalizzato che ti dica qualcosa, siamo pronti.

Parla con il team che costruisce ciò che altre agenzie falsificano.

Contatta Bright Vessel