Artigos sobre automação de Google | Rotamáxima - Especialistas em resultados

Automação Google Ads: Gerencie múltiplas contas com o Google Drive.

Wed, 22 Aug 2018 19:37:52 +0000

Nessa série especial, reunimos alguns scripts úteis para você automatizar e aumentar o retorno de suas campanhas no Google Ads. Confira abaixo como automatizar o Google Ads. 1. Adicione scripts para múltiplas contas com o Google Drive – Por Russell Savage. Utilizando uma planilha do Google é possível você automatizar o trabalho de atualizar todos os scripts de suas contas. Uma das desvantagens de usar o AdWords Scripts é que você precisa fazer login em cada conta e configurar o script. Para a maioria das pessoas, isso não é um problema nas primeiras vezes. Mas quando você começa a ver o valor de alguns desses scripts, pode haver um conjunto deles que você deseja colocar em todas as suas contas. Configurá-los é bom, até encontrar um bug no seu código e ter que entrar e atualizar todas as 20 cópias do script em cada conta. Bem, neste post, criei uma maneira simples de manter uma única cópia do seu script e carregá-lo em qualquer número de contas do Google AdWords. Então, se você tiver alguma alteração, poderá atualizar uma única versão do script e todas as contas começarão a usar o novo código instantaneamente. O código para isso consiste em duas partes. O primeiro snippet de código é o código genérico que você precisa colocar em cada uma das suas contas. Esse código faz referência a uma única planilha do Google (aqui está uma amostra para você copiar: http://goo.gl/y6hPfy ) que é usada para saber quais scripts ela deve executar. A planilha tem apenas três colunas: uma descrição que é usada apenas para registro, o local do script no Google Drive e o nome do objeto no script. Não se preocupe com isso agora, vou descrevê-lo melhor na próxima seção. Finalmente, carrega o arquivo de script e executa a função principal. /************************************ * Generic Script Runner * Version 1.0 * Created By: Russ Savage * FreeAdWordsScripts.com ***********************************/ function main() { //See http://goo.gl/KvINmD for an example spreadsheet. var scriptConfigId = ‘Your Spreadsheet Id Goes Here’; var sheet = SpreadsheetApp.openById(scriptConfigId).getActiveSheet(); var data = sheet.getRange(‘A:C’).getValues(); for(var i in data) { if(i == 0) { continue; } var [description, location, classname] = data[i]; if(!location) { continue; } Logger.log(‘Running “‘+description+'” from location: ‘+location); var scriptFile = getFile(location); var scriptText = scriptFile.getBlob().getDataAsString(); eval(scriptText); var script = eval(‘new ‘+classname+'();’); script.main(); } } //This function gets the file from GDrive function getFile(loc) { var locArray = loc.split(‘/’); var folder = getFolder(loc); if(folder.getFilesByName(locArray[locArray.length-1]).hasNext()) { return folder.getFilesByName(locArray[locArray.length-1]).next(); } else { return null; } } //This function finds the folder for the file and creates folders if needed function getFolder(folderPath) { var folder = DriveApp.getRootFolder(); if(folderPath) { var pathArray = folderPath.split(‘/’); for(var i in pathArray) { if(i == pathArray.length – 1) { break; } var folderName = pathArray[i]; if(folder.getFoldersByName(folderName).hasNext()) { folder = folder.getFoldersByName(folderName).next(); } } } return folder; } Agora que temos um código genérico que lê a descrição, o local e o nome do objeto de uma planilha e executa o código, precisamos fazer algumas pequenas modificações em alguns dos nossos scripts existentes para que ele funcione. Um dos meus scripts favoritos é sobre como encontrar anomalias na sua conta . Para que o script seja executado a partir de outro script, precisamos convertê-lo em um objeto com uma única função pública. Essa mesma técnica deve funcionar em quase todos os scripts do FreeAdWordsScripts.com . Primeiro, coloque todo o script em uma chamada de função e dê a ele qualquer nome que desejar. function Anomalies() { // Copy and Paste the code from: // http://goo.gl/IT1UcV }; Em seguida, você precisa atualizar a função principal para ser um método público, para que possamos chamá-la de nosso script genérico. this.main = function() { // Don’t make any changes to the body of the main method } Uma versão completa do código atualizado pode ser encontrada aqui: Encontre anomalias na versão do objeto da sua conta . Agora você pode salvar este novo script em algum lugar em seu GDrive e atualizar o local e o nome do objeto (anomalias neste caso) em sua planilha de configuração. Agora você deveria estar bem para ir. Você pode adicionar quantos scripts desejar à planilha de configuração, mas lembre-se de que o limite de 30 minutos ainda se aplica. 2. Criando “deep links” para sua conta – Por Russell Savage. Este script cria links diretamente para a entidade que está com problemas, assim, você consegue acessar rapidamente a raiz do problema sem ter que acessar todas as páginas. Acontece que existem dois números mágicos que você precisa para que isso funcione. Quando você acessar sua conta, no URL, você verá __u = e __c =. De acordo com esta postagem do blog , esses valores são ‘effectiveUserId’ e ‘customerId’ respectivamente. Infelizmente, não há como acessar esses valores ao usar scripts, portanto, você precisará copiá-los manualmente no script abaixo. Depois disso, você pode incluir a função em todos os seus scripts e fazer um link direto para o conteúdo do seu coração. Não é a coisa mais bonita do mundo, mas é auto-contida, por isso deve ser fácil de copiar para o fundo de seus scripts. // Link to the Keyword Tab of the AdGroup Logger.log(getUrl(someAdGroupEntity,’Keywords’)); // Link to the Ads Tab of the AdGroup Logger.log(getUrl(someAdGroupEntity,’Ads’)); // Link to Location Settings Tab of the Campaign Logger.log(getUrl(comeCampaignEntity,’Settings:Locations’)); /*********************************** * Build Deep Link Urls for Entities * Version 1.0 * Created By: Russ Savage * FreeAdWordsScripts.com ***********************************/ function getUrl(entity,tab) { var customerId = ‘__c from the url’; var effectiveUserId = ‘__u from the url’; var decodedTab = getTab(tab); var base = ‘https://adwords.google.com/cm/CampaignMgmt?’; var url = base+’__c=’+customerId+’&__u=’+effectiveUserId+’#’; if(typeof entity[‘getBudget’] !== ‘undefined’) { //A Campaign return url+’c.’+entity.getId()+’.’+decodedTab+’&app=cm’; } if(typeof entity[‘createKeyword’] !== ‘undefined’) { //An AdGroup return url+’a.’+entity.getId()+’_’+entity.getCampaign().getId()+’.’+decodedTab+’&app=cm’; } if(typeof entity[‘getMatchType’] !== ‘undefined’) { //A Keyword return url+’a.’+entity.getAdGroup().getId()+’_’+entity.getCampaign().getId()+’.key&app=cm’; } if(typeof entity[‘getHeadline’] !== ‘undefined’) { //An Ad return url+’a.’+entity.getAdGroup().getId()+’_’+entity.getCampaign().getId()+’.create&app=cm’; } return url+’r.ONLINE.di&app=cm’; function getTab(tab) { var mapping = { ‘Ad groups’:’ag’,’Settings:All settings’:’st_sum’, ‘Settings:Locations’:’st_loc’,’Settings:Ad schedule’:’st_as’, ‘Settings:Devices’:’st_p’,’Ads’:’create’, ‘Keywords’:’key’,’Audiences’:’au’,’Ad extensions’:’ae’, ‘Auto targets’:’at’,’Dimensions’ : ‘di’ }; if(mapping[tab]) { return mapping[tab]; } return ‘key’; //default to keyword tab } } 3. Converta feeds RSS em JSON – Por Russel Savage. Utilize o Feed API do Google em seu script para converter feed

O post Automação Google Ads: Gerencie múltiplas contas com o Google Drive. apareceu primeiro em Rotamáxima - Especialistas em resultados.

Automação Google Ads: Campanhas de Display e Shopping

Wed, 22 Aug 2018 19:18:02 +0000

Nessa série especial, reunimos alguns scripts úteis para você automatizar e aumentar o retorno de suas campanhas no Google Ads. Confira abaixo como automatizar o Google Ads para “Trabalhar com Campanhas de Display e Shopping”. 1. Campanhas de Shopping – Por Google Ads. Gerencie suas campanhas do Google Shopping sem a necessidade de utilizar a plataforma do Google Ads. Esse grupo de scripts permitem criar anúncios de produtos, atualizar lances, etc. Recuperar todas as campanhas de compras function getAllShoppingCampaigns() { var retval = []; var campaignIterator = AdWordsApp.shoppingCampaigns().get(); while (campaignIterator.hasNext()) { var campaign = campaignIterator.next(); // Optional: Comment out if you don’t need to print details. Logger.log(‘Campaign Name: %s’, campaign.getName()); retval.push(campaign); } return retval; } Recuperar uma campanha de compras pelo nome dela function getShoppingCampaignByName(campaignName) { var campaignIterator = AdWordsApp.shoppingCampaigns() .withCondition("CampaignName = '" + campaignName + "'") .get(); while (campaignIterator.hasNext()) { var campaign = campaignIterator.next(); Logger.log('Campaign Name: %s', campaign.getName()); } } Recuperar um grupo de anúncios de compras pelo nome dele function getShoppingAdGroup() { var campaignName = ‘INSERT_CAMPAIGN_NAME_HERE’; var adGroupName = ‘INSERT_ADGROUP_NAME_HERE’; var adGroupIterator = AdWordsApp.shoppingAdGroups() .withCondition(“CampaignName = ‘” + campaignName + “‘ and AdGroupName = ‘” + adGroupName + “‘”) .get(); while (adGroupIterator.hasNext()) { var adGroup = adGroupIterator.next(); Logger.log( ‘AdGroup Name: %s, CPC = %s, Mobile Bid ‘ + ‘Modifier = %s’, adGroup.getName(), adGroup.bidding().getCpc(), adGroup.devices().getMobileBidModifier() ); } } Crie um grupo de anúncios do Shopping function createShoppingAdGroup() { var campaignName = ‘INSERT_CAMPAIGN_NAME_HERE’; var shoppingCampaign = AdWordsApp.shoppingCampaigns() .withCondition(“CampaignName = ‘” + campaignName + “‘”) .get() .next(); var adGroupOperation = shoppingCampaign.newAdGroupBuilder().build(); var adGroup = adGroupOperation.getResult(); Logger.log(adGroup); } Criar uma hierarquia de grupo de produtos de compras function createTree() { var campaignName = ‘INSERT_CAMPAIGN_NAME_HERE’; var adGroupName = ‘INSERT_ADGROUP_NAME_HERE’; var shoppingAdGroup = AdWordsApp.shoppingAdGroups() .withCondition(“CampaignName = ‘” + campaignName + “‘ and AdGroupName = ‘” + adGroupName + “‘”) .get() .next(); var root = shoppingAdGroup.rootProductGroup(); // The structure created is // – root // – cardcow brand // – New // – Refurbished // – Other conditions // – Other brands // Add a brand product group for “cardcow” under root product group. var brandNode = root.newChild() .brandBuilder() .withName(‘cardcow’) .withBid(1.2) .build() .getResult(); // Add new conditions for New and Refurbished cardcow brand items. var newItems = brandNode.newChild() .conditionBuilder() .withCondition(‘NEW’) .build() .getResult(); var refurbishedItems = brandNode.newChild() .conditionBuilder() .withCondition(‘REFURBISHED’) .withBid(0.9) .build() .getResult(); } Atravessa a hierarquia do grupo de produtos function walkProductPartitionTree() { var campaignName = ‘INSERT_CAMPAIGN_NAME_HERE’; var adGroupName = ‘INSERT_ADGROUP_NAME_HERE’; var shoppingAdGroup = AdWordsApp.shoppingAdGroups() .withCondition(“CampaignName = ‘” + campaignName + “‘ and AdGroupName = ‘” + adGroupName + “‘”) .get() .next(); var root = shoppingAdGroup.rootProductGroup(); walkHierarchy(root, 0); } function walkHierarchy(productGroup, level) { var description = ”; if (productGroup.isOtherCase()) { description = ‘Other’; } else if (productGroup.getDimension() == ‘CATEGORY’) { // Shows how to process a product group differently based on its type. description = productGroup.asCategory().getName(); } else { description = productGroup.getValue(); } var padding = new Array(level + 1).join(‘-‘); // Note: Child product groups may not have a max cpc if it has been excluded. Logger.log( ‘%s %s, %s, %s, %s, %s’, padding, description, productGroup.getDimension(), productGroup.getMaxCpc(), productGroup.isOtherCase(), productGroup.getId().toFixed() ); var childProductGroups = productGroup.children().get(); while (childProductGroups.hasNext()) { var childProductGroup = childProductGroups.next(); walkHierarchy(childProductGroup, level + 1); } } Obtém o grupo de produtos “Tudo mais” function getEverythingElseProductGroup() { var campaignName = ‘INSERT_CAMPAIGN_NAME_HERE’; var adGroupName = ‘INSERT_ADGROUP_NAME_HERE’; var shoppingAdGroup = AdWordsApp.shoppingAdGroups() .withCondition(“CampaignName = ‘” + campaignName + “‘ and AdGroupName = ‘” + adGroupName + “‘”) .get() .next(); var rootProductGroup = shoppingAdGroup.rootProductGroup(); var childProductGroups = rootProductGroup.children().get(); while (childProductGroups.hasNext()) { var childProductGroup = childProductGroups.next(); if (childProductGroup.isOtherCase()) { // Note: Child product groups may not have a max cpc if it has been // excluded. Logger.log( ‘”Everything else” product group found. Type of the product ‘ + ‘group is %s and bid is %s.’, childProductGroup.getDimension(), childProductGroup.getMaxCpc()); return; } } Logger.log(‘”Everything else” product group not found under root ‘ + ‘product group.’); } Atualizar lances para grupos de produtos function updateProductGroupBid() { var productGroups = AdWordsApp.productGroups() .withCondition(‘Clicks > 5’) .withCondition(‘Ctr > 0.01’) .forDateRange(‘LAST_MONTH’) .get(); while (productGroups.hasNext()) { var productGroup = productGroups.next(); productGroup.setMaxCpc(productGroup.getMaxCpc() + 0.01); } } Recuperar anúncios de produtos function getProductAds() { var adGroupName = ‘INSERT_ADGROUP_NAME_HERE’; var shoppingAdGroup = AdWordsApp.shoppingAdGroups() .withCondition(“AdGroupName = ‘” + adGroupName + “‘”) .get() .next(); var productAds = shoppingAdGroup.ads().get(); while (productAds.hasNext()) { var productAd = productAds.next(); Logger.log( “Ad with ID = %s was found.”, productAd.getId().toFixed(0)); } } Crie anúncios de produtos function createProductAd() { var adGroupName = ‘INSERT_ADGROUP_NAME_HERE’; var shoppingAdGroup = AdWordsApp.shoppingAdGroups() .withCondition(“AdGroupName = ‘” + adGroupName + “‘”) .get() .next(); var adOperation = shoppingAdGroup.newAdBuilder() .withMobilePreferred(true) .build(); var productAd = adOperation.getResult(); Logger.log( “Ad with ID = %s was created.”, productAd.getId().toFixed(0)); } 2. Conteúdo do Shopping – Por Google Ads. Assim como o script de Campanhas de Shopping, é possível inserir produtos, extrair informações da conta do merchant, listar todos os produtos e mais, sem a necessidade da plataforma do Google Ads. Inserir um produto function insertProduct() { var merchantId = ‘INSERT_MERCHANT_ID_HERE’; // Create a product resource. See // https://developers.google.com/shopping-content/v2/reference/v2/products // for the full list of fields supported by product resource. var productResource = { ‘offerId’: ‘book123’, ‘title’: ‘A Tale of Two Cities’, ‘description’: ‘A classic novel about the French Revolution’, ‘link’: ‘http://my-book-shop.com/tale-of-two-cities.html’, ‘imageLink’: ‘http://my-book-shop.com/tale-of-two-cities.jpg’, ‘contentLanguage’: ‘en’, ‘targetCountry’: ‘US’, ‘channel’: ‘online’, ‘availability’: ‘in stock’, ‘condition’: ‘new’, ‘googleProductCategory’: ‘Media > Books’, ‘productType’: ‘Media > Books’, ‘gtin’: ‘9780007350896’, ‘price’: { ‘value’: ‘2.50’, ‘currency’: ‘USD’ }, ‘shipping’: [{ ‘country’: ‘US’, ‘service’: ‘Standard shipping’, ‘price’: { ‘value’: ‘0.99’, ‘currency’: ‘USD’ } }], ‘shippingWeight’: { ‘value’: ‘2’, ‘unit’: ‘pounds’ } }; ShoppingContent.Products.insert(productResource, merchantId); } Listar todos os produtos function listProducts() { var merchantId = ‘INSERT_MERCHANT_ID_HERE’; // List all the products for a given merchant. var products = ShoppingContent.Products.list(merchantId); if (products.resources) { for (var i = 0; i < products.resources.length; i++) { Logger.log(products.resources[i]); } } } Inserir produtos usando a API custombatch function custombatch() { var merchantId = ‘INSERT_MERCHANT_ID_HERE’; // Create your product resources. See // https://developers.google.com/shopping-content/v2/reference/v2/products // for the full list of fields supported by product resource. See

O post Automação Google Ads: Campanhas de Display e Shopping apareceu primeiro em Rotamáxima - Especialistas em resultados.

Automação Google Ads: Palavras-chave

Wed, 22 Aug 2018 18:41:16 +0000

Nessa série especial, reunimos alguns scripts úteis para você automatizar e aumentar o retorno de suas campanhas no Google Ads. Confira abaixo como automatizar o Google Ads para “Trabalhar com Palavras-chave”. 1. Palavras-chave “exatas” – Por Brainlabs. O script faz com que suas palavras-chave sejam exatamente o que estão sendo digitadas, eliminando as variações aproximadas, como erros de digitação, plural, etc. /** * * Adds as campaign or AdGroup negatives search queries which have triggered exact keywords * Version: 1.1 * Updated: 2015-10-26 * Authors: Visar Shabi & Daniel Gilbert * brainlabsdigital.com * **/ function main() { //~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~// //Options //Choose whether to add your negative exact keywords at campaign or AdGroup level. //Set variable as “true” to add or as “false” to not add. var AddAdGroupNegative = true; // true or false var AddCampaignNegative = true; // true of false //Parameters for filtering by campaign name and AdGroup name. The filtering is case insensitive. //Leave blank, i.e. “”, if you want this script to run over all campaigns and AdGroups. var campaignNameContains = “”; var adGroupNameContains = “”; //~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~// var campaigns = {}; var adGroups = {}; var exactKeywords = []; //~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~// //Pull a list of all exact match keywords in the account var report = AdWordsApp.report( “SELECT AdGroupId, Id ” + “FROM KEYWORDS_PERFORMANCE_REPORT ” + “WHERE Impressions > 0 AND KeywordMatchType = EXACT ” + “DURING LAST_7_DAYS”); var rows = report.rows(); while (rows.hasNext()) { var row = rows.next(); var keywordId = row[‘Id’]; var adGroupId = row[‘AdGroupId’]; exactKeywords.push(adGroupId + “#” + keywordId); } //~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~// //Pull a list of all exact (close variant) search queries var report = AdWordsApp.report( “SELECT Query, AdGroupId, CampaignId, KeywordId, KeywordTextMatchingQuery, Impressions, QueryMatchTypeWithVariant ” + “FROM SEARCH_QUERY_PERFORMANCE_REPORT ” + “WHERE CampaignName CONTAINS_IGNORE_CASE ‘” + campaignNameContains + “‘ ” + “AND AdGroupName CONTAINS_IGNORE_CASE ‘” + adGroupNameContains + “‘ ” + “DURING LAST_7_DAYS”); var rows = report.rows(); while (rows.hasNext()) { var row = rows.next(); var adGroupId = parseInt(row[‘AdGroupId’]); var campaignId = parseInt(row[‘CampaignId’]); var keywordId = parseInt(row[‘KeywordId’]); var searchQuery = row[‘Query’].toLowerCase(); var keyword = row[‘KeywordTextMatchingQuery’].toLowerCase(); var matchType = row[‘QueryMatchTypeWithVariant’].toLowerCase(); if(keyword !== searchQuery && matchType.indexOf(“exact (close variant)”) !== -1){ if(!campaigns.hasOwnProperty(campaignId)){ campaigns[campaignId] = [[], []]; } campaigns[campaignId][0].push(searchQuery); campaigns[campaignId][1].push(adGroupId + “#” + keywordId); if(!adGroups.hasOwnProperty(adGroupId)){ adGroups[adGroupId] = [[], []]; } adGroups[adGroupId][0].push(searchQuery); adGroups[adGroupId][1].push(adGroupId + “#” + keywordId); } } //~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~// //Parse data correctly var adGroupIds = []; var campaignIds = []; var adGroupNegatives = []; var campaignNegatives = []; for(var x in campaigns){ campaignIds.push(parseInt(x)); campaignNegatives.push([]); for(var y = 0; y < campaigns[x][0].length; y++){ var keywordId = campaigns[x][1][y]; var keywordText = campaigns[x][0][y]; if(exactKeywords.indexOf(keywordId) !== -1){ campaignNegatives[campaignIds.indexOf(parseInt(x))].push(keywordText); } } } for(var x in adGroups){ adGroupIds.push(parseInt(x)); adGroupNegatives.push([]); for(var y = 0; y < adGroups[x][0].length; y++){ var keywordId = adGroups[x][1][y]; var keywordText = adGroups[x][0][y]; if(exactKeywords.indexOf(keywordId) !== -1){ adGroupNegatives[adGroupIds.indexOf(parseInt(x))].push(keywordText); } } } //~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~// //Create the new negative exact keywords var campaignResults = {}; var adGroupResults = {}; if(AddCampaignNegative){ var campaignIterator = AdWordsApp.campaigns() .withIds(campaignIds) .get(); while(campaignIterator.hasNext()){ var campaign = campaignIterator.next(); var campaignId = campaign.getId(); var campaignName = campaign.getName(); var campaignIndex = campaignIds.indexOf(campaignId); for(var i = 0; i < campaignNegatives[campaignIndex].length; i++){ campaign.createNegativeKeyword(“[” + campaignNegatives[campaignIndex][i] + “]”) if(!campaignResults.hasOwnProperty(campaignName)){ campaignResults[campaignName] = []; } campaignResults[campaignName].push(campaignNegatives[campaignIndex][i]); } } } if(AddAdGroupNegative){ var adGroupIterator = AdWordsApp.adGroups() .withIds(adGroupIds) .get(); while(adGroupIterator.hasNext()){ var adGroup = adGroupIterator.next(); var adGroupId = adGroup.getId(); var adGroupName = adGroup.getName(); var adGroupIndex = adGroupIds.indexOf(adGroupId); for(var i = 0; i < adGroupNegatives[adGroupIndex].length; i++){ adGroup.createNegativeKeyword(“[” + adGroupNegatives[adGroupIndex][i] + “]”); if(!adGroupResults.hasOwnProperty(adGroupName)){ adGroupResults[adGroupName] = []; } adGroupResults[adGroupName].push(adGroupNegatives[adGroupIndex][i]); } } } //~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~// //Format the results var resultsString = “The following negative keywords have been added to the following campaigns:”; for(var x in campaignResults){ resultsString += “\n\n” + x + “:\n” + campaignResults[x].join(“\n”); } resultsString += “\n\n\n\nThe following negative keywords have been added to the following AdGroups:”; for(var x in adGroupResults){ resultsString += “\n\n” + x + “:\n” + adGroupResults[x].join(“\n”); } Logger.log(resultsString); //~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~// } 2. Oportunidades de Termos de Pesquisa – Por Daniel Gilbert. Utilize esse scripts para gerar insights dos termos que são buscados e que geraram boas conversões ou apenas custos. Ele quebra as palavras nos termos de pesquisa e organiza por custo e conversão, assim você poderá ter uma ideia de que tipo palavras estão gerando conversão ou apenas custos. Excelente script para buscar termos de cauda longa e analisar seu desempenho. /** * * Search Query Mining Tool * * This script calculates the contribution of each word found in the search query report * and outputs a report into a Google Doc spreadsheet. * * Version: 1.0 * Google Apps Script maintained on brainlabsdigital.com * **/ function main() { ////////////////////////////////////////////////////////////////////////////// // Options var startDate = “2015-04-01”; var endDate = “2015-04-30”; // The start and end date of the date range for your search query data // Format is yyyy-mm-dd var currencySymbol = “£”; // The currency symbol used for formatting. For example “£”, “$” or “€”. var campaignNameContains = “”; // Use this if you only want to look at some campaigns // such as campaigns with names containing ‘Brand’ or ‘Shopping’. // Leave as “” if not wanted. var spreadsheetUrl = “https://docs.google.com/YOUR-SPREADSHEET-URL-HERE”; // The URL of the Google Doc the results will be put into. ////////////////////////////////////////////////////////////////////////////// // Thresholds var impressionThreshold = 10; var clickThreshold = 0; var costThreshold = 0; var conversionThreshold = 0; // Words will be ignored if their statistics are lower than any of these thresholds ////////////////////////////////////////////////////////////////////////////// // Find the negative keywords var negativesByGroup = []; var negativesByCampaign = []; var sharedSetData = []; var sharedSetNames = []; var sharedSetCampaigns = []; var dateRange = startDate.replace(/-/g, “”) + “,” + endDate.replace(/-/g, “”); var activeCampaignIds = []; // Gather ad group level negative keywords var keywordReport = AdWordsApp.report( “SELECT CampaignId, AdGroupId, KeywordText, KeywordMatchType ” + “FROM KEYWORDS_PERFORMANCE_REPORT ” + “WHERE CampaignStatus = ENABLED AND AdGroupStatus = ENABLED AND Status = ENABLED AND IsNegative = TRUE ” + “AND CampaignName CONTAINS_IGNORE_CASE ‘” + campaignNameContains + “‘ ” + “DURING ” + dateRange); var keywordRows = keywordReport.rows(); while (keywordRows.hasNext()) { var keywordRow = keywordRows.next(); if (negativesByGroup[keywordRow[“AdGroupId”]] == undefined) { negativesByGroup[keywordRow[“AdGroupId”]] = [[keywordRow[“KeywordText”].toLowerCase(),keywordRow[“KeywordMatchType”].toLowerCase()]]; } else { negativesByGroup[keywordRow[“AdGroupId”]].push([keywordRow[“KeywordText”].toLowerCase(),keywordRow[“KeywordMatchType”].toLowerCase()]); } if (activeCampaignIds.indexOf(keywordRow[“CampaignId”]) < 0) { activeCampaignIds.push(keywordRow[“CampaignId”]); } }//end while

O post Automação Google Ads: Palavras-chave apareceu primeiro em Rotamáxima - Especialistas em resultados.

Automação Google Ads: Texto do Anúncio

Wed, 22 Aug 2018 18:06:57 +0000

Nessa série especial, reunimos alguns scripts úteis para você automatizar e aumentar o retorno de suas campanhas no Google Ads. Confira abaixo como automatizar o Google Ads para “Trabalhar com Textos dos anúncios”. 1. Corrija os erros de letras maiúsculas em seus anúncios – por Russell Savage. Caso seus anúncios contenham muitas letras maiúsculas, o Google pode não aprová-los. Esse script substitui quaisquer sequências de 3 letras maiúsculas, criando um anúncio novo e pausando o antigo. //———————————– // Fix Ads with EXCESSIVE CAPITALIZATION // Created By: Russ Savage // FreeAdWordsScripts.com //———————————– function main() { var find_caps = /[A-Z]{3,}/g; var SEP = ‘~~@~~’; // this needs to be something you would never put in your ads. var ad_iter = AdWordsApp.ads().withCondition(“ApprovalStatus = ‘DISAPPROVED'”).get(); while(ad_iter.hasNext()) { var ad = ad_iter.next(); var old_ad_cnt = get_ad_count(ad.getAdGroup()); var old_ad_str = [ad.getHeadline(),ad.getDescription1(),ad.getDescription2(),ad.getDisplayUrl()].join(SEP); var new_ad_str = old_ad_str; Logger.log(“Before:”+old_ad_str); var m = “”; while((m = find_caps.exec(new_ad_str)) != null) { new_ad_str = replace_all(new_ad_str,m[0],init_cap(m[0]),false); } Logger.log(“After:”+new_ad_str); if(old_ad_str != new_ad_str) { var [new_headline,new_desc1,new_desc2,new_disp_url] = new_ad_str.split(SEP); ad.getAdGroup().createTextAd(new_headline, new_desc1, new_desc2, new_disp_url, ad.getDestinationUrl()); var new_ad_cnt = get_ad_count(ad.getAdGroup()); if(new_ad_cnt == (old_ad_cnt+1)) { ad.remove(); } } else { Logger.log(“Skipping because no changes were made.”); } } function init_cap(s) { return s.charAt(0).toUpperCase() + s.slice(1).toLowerCase(); } // This function was adapted from: http://dumpsite.com/forum/index.php?topic=4.msg8#msg8 function replace_all(original,str1, str2, ignore) { return original.replace(new RegExp(str1.replace(/([\/\,\!\\\^\$\{\}\[\]\.\*\+\?\|\<\>\-\&])/g,”\\$&”),(ignore?”gi”:”g”)),(typeof(str2)==”string”)?str2.replace(/\$/g,”$$$$”):str2); } function get_ad_count(ad_group) { var ad_iter = ad_group.ads().get(); var new_ad_cnt = 0; while(ad_iter.hasNext()) { ad_iter.next(); new_ad_cnt++; } return new_ad_cnt; } } 2. Automação de testes de anúncios – Por Russell Savage. O Google costuma analisar em 1 dia anúncios para aprovação, porém nem sempre este é o caso. Esse script detecta quando há uma alteração no anúncio e grava em uma planilha do Google com a data em que ele começou a rodar. /************************************ * Ad Creative Test Automation Script * Version: 1.3 * Changelog v1.3 – Data is written to the spreadsheet a little faster * Changelog v1.2 – Added additional threshold options * Changelog v1.1 – Fixed issue with dates in email * Created By: Russ Savage * FreeAdWordsScripts.com ************************************/ // You can use any of the same values here as you can for METRIC below var THRESHOLD = { metric : ‘Clicks’, value : 100 }; var TO = [‘example@example.com’]; //Try any of these values for METRIC: //AverageCpc, AverageCpm, AveragePageviews, AveragePosition, //AverageTimeOnSite, BounceRate, Clicks, ConversionRate, //Conversions, Cost, Ctr, Impressions var METRIC = ‘Ctr’; var ASC_OR_DESC = ‘ASC’; //ASC – pause ad with lowest value, DESC – pause ad with highest value function main() { //Start by finding what has changed in the account var ad_map = buildCurrentAdMap(); var prev_ad_map = readMapFromSpreadsheet(); prev_ad_map = updatePreviousAdMap(prev_ad_map,ad_map); writeMapToSpreadsheet(prev_ad_map); //Now run through the adgroups to find creative tests var ag_iter = AdWordsApp.adGroups().get(); var paused_ads = []; while(ag_iter.hasNext()) { var ag = ag_iter.next(); if(!prev_ad_map[ag.getId()]) { continue; } //Here is the date range for the test metrics var last_touched_str = _getDateString(prev_ad_map[ag.getId()].last_touched,’yyyyMMdd’); var get_today_str = _getDateString(new Date(),’yyyyMMdd’); var ag_stats = ag.getStatsFor(last_touched_str, get_today_str); if(ag_stats[‘get’+THRESHOLD.metric]() >= THRESHOLD.value) { var ad_iter = ag.ads().withCondition(‘Status = ENABLED’) .forDateRange(last_touched_str, get_today_str) .orderBy(METRIC+” “+ASC_OR_DESC).get(); var ad = ad_iter.next(); var metric = ad.getStatsFor(last_touched_str, get_today_str)[‘get’+METRIC](); ad.pause(); paused_ads.push({a : ad, m : metric}); } } sendEmailForPausedAds(paused_ads); } // A function to send an email with an attached report of ads it has paused function sendEmailForPausedAds(ads) { if(ads.length == 0) { return; } //No ads paused, no email var email_body = ‘”‘ + [‘CampaignName’,’AdGroupName’,’Headline’,’Desc1′,’Desc2′,’DisplayUrl’,METRIC].join(‘”,”‘) + ‘”\n’; for(var i in ads) { var ad = ads[i].a; var metric = ads[i].m; email_body += ‘”‘ + [ad.getCampaign().getName(), ad.getAdGroup().getName(), ad.getHeadline(), ad.getDescription1(), ad.getDescription2(), ad.getDisplayUrl(), metric ].join(‘”,”‘) + ‘”\n’; } var date_str = _getDateString(new Date(),’yyyy-MM-dd’); var options = { attachments: [Utilities.newBlob(email_body, ‘text/csv’, “FinishedTests_”+date_str+’.csv’)] }; var subject = ‘Finished Tests – ‘ + date_str; for(var i in TO) { MailApp.sendEmail(TO[i], subject, ‘See attached.’, options); } } //Given two lists of ads, this checks to make sure they are the same. function sameAds(ads1,ads2) { for(var i in ads1) { if(ads1[i] != ads2[i]) { return false; } } return true; } //This reads the stored data from the spreadsheet function readMapFromSpreadsheet() { var ad_map = {}; var sheet = SpreadsheetApp.openById(findSpreadsheetId()).getActiveSheet(); var data = sheet.getRange(‘A:C’).getValues(); for(var i in data) { if(data[i][0] == ”) { break; } var [ag_id,last_touched,ad_ids] = data[i]; ad_map[ag_id] = { ad_ids : (”+ad_ids).split(‘,’), last_touched : new Date(last_touched) }; } return ad_map; } //This will search for a label containing the spreadsheet id //If one isn’t found, it will create a new one and the label as well function findSpreadsheetId() { var spreadsheet_id = “”; var label_iter = AdWordsApp.labels().withCondition(“Name STARTS_WITH ‘history_script:'”).get(); if(label_iter.hasNext()) { var label = label_iter.next(); return label.getName().split(‘:’)[1]; } else { var sheet = SpreadsheetApp.create(‘AdGroups History’); var sheet_id = sheet.getId(); AdWordsApp.createLabel(‘history_script:’+sheet_id, ‘stores sheet id for adgroup changes script.’); return sheet_id; } } //This will store the data from the account into a spreadsheet function writeMapToSpreadsheet(ad_map) { var toWrite = []; for(var ag_id in ad_map) { var ad_ids = ad_map[ag_id].ad_ids; var last_touched = ad_map[ag_id].last_touched; toWrite.push([ag_id,last_touched,ad_ids.join(‘,’)]); } writeToSpreadsheet(toWrite); } // Write the keyword data to the spreadsheet function writeToSpreadsheet(toWrite) { var sheet = SpreadsheetApp.openById(findSpreadsheetId()).getActiveSheet(); sheet.clear(); var numRows = sheet.getMaxRows(); if(numRows < toWrite.length) { sheet.insertRows(1,toWrite.length-numRows); } var range = sheet.getRange(1,1,toWrite.length,toWrite[0].length); range.setValues(toWrite); } //This builds a map of the ads in the account so that it is easy to compare function buildCurrentAdMap() { var ad_map = {}; // { ag_id : { ad_ids : [ ad_id, … ], last_touched : date } } var ad_iter = AdWordsApp.ads().withCondition(‘Status = ENABLED’).get(); while(ad_iter.hasNext()) { var ad = ad_iter.next(); var ag_id = ad.getAdGroup().getId(); if(ad_map[ag_id]) { ad_map[ag_id].ad_ids.push(ad.getId()); ad_map[ag_id].ad_ids.sort(); } else { ad_map[ag_id] = { ad_ids : [ad.getId()], last_touched : new Date() }; } } return ad_map; } //This takes the old ad map and the current ad map and returns an //updated map with all changes. function updatePreviousAdMap(prev_ad_map,ad_map) { for(var ag_id in ad_map) { var current_ads = ad_map[ag_id].ad_ids; var previous_ads = (prev_ad_map[ag_id]) ? prev_ad_map[ag_id].ad_ids : []; if(!sameAds(current_ads,previous_ads)) { prev_ad_map[ag_id] = ad_map[ag_id]; } } return prev_ad_map; } //Helper function to format the date function _getDateString(date,format) { return Utilities.formatDate(date,AdWordsApp.currentAccount().getTimeZone(),format); } 3. Gerencie seus criativos com Excel – Por Russell Savage. Integre o Google Ads com o Drive e baixe todas

O post Automação Google Ads: Texto do Anúncio apareceu primeiro em Rotamáxima - Especialistas em resultados.

Automação Google Ads: Acompanhamento

Wed, 22 Aug 2018 17:37:55 +0000

Nessa série especial, reunimos alguns scripts úteis para você automatizar e aumentar o retorno de suas campanhas no Google Ads. Confira abaixo como automatizar o Google Ads para “Trabalhar com acompanhamento de anúncios”. 1. Acompanhamento do Índice de Qualidade – Por Martin Roettgerding. Acompanhe o Índice de Qualidade da sua conta com esse script. Além disso, o script oferece um dashboard com a média do Índice de Qualidade histórica de sua conta. Excelente para acompanhar o progresso de suas alterações nos anúncios, páginas de destino, por exemplo. Apresentando o Quality Score Tracker v3.0 postado em 11 de março de 2016 É maior, é melhor e oficial: o novo Rastreador de Índice de Qualidade está finalmente disponível! O Quality Score Tracker é um script gratuito do Google Ads que controla os Índices de qualidade de uma conta. A versão anterior ainda é incrivelmente popular, mas já tem três anos. É por isso que criamos um novo que é muito mais rápido e tem novos recursos extravagantes. A nova versão é diferente das antigas em vários aspectos. Um dos principais objetivos era escrever um roteiro que fosse o mais fácil de usar possível – ainda mais fácil do que os antigos. O novo Rastreador de Índice de qualidade pode ser usado imediatamente, sem qualquer configuração adicional. Apesar de ser fácil de usar o novo script é muito complexo e lida com muitas coisas sem incomodar o usuário. Veja o que faz: Acompanhamento do Índice de qualidade O Quality Score Tracker salva os Índices de qualidade de suas palavras-chave em uma planilha. Ao contrário das versões anteriores, você não precisa escolher quais – ele rastreia todas elas. Isso permite que você volte e pesquise o histórico de qualquer uma de suas palavras-chave posteriormente. Painel de controle Embora o rastreamento de milhares de Índices de qualidade individuais possa ser útil posteriormente, o script também fornece um painel para mostrar onde você está atualmente. O painel é fornecido em uma planilha do Google também. Essa planilha também fornece dados resumidos sobre seus Índices de qualidade. Google Drive Todos os arquivos (pontuações de qualidade do painel e da palavra-chave rastreada) são armazenados em uma pasta no seu Google Drive. Você pode acessá-los por meio do navegador ou usar todos os recursos do Google Drive, como sincronizar a pasta com o dispositivo ou compartilhar pastas com outras pessoas. Há um limite de quantas células uma planilha do Google pode conter (dois milhões). Se você atingir esse limite durante o rastreamento de Índices de qualidade, o script criará planilhas adicionais. Os arquivos da planilha são nomeados e numerados para que você possa juntar tudo mais tarde, se necessário. Como tudo está nos arquivos da planilha do Google, o espaço ocupado não conta para o limite de armazenamento do Google Drive. Customizável O script fornece várias configurações que você pode alterar (mas não é necessário). Por exemplo, você pode adicionar outros gráficos ao painel, como um Índice de qualidade ponderado por clique. FAQ integrado O painel vem com um FAQ que é atualizado toda vez que o script é executado. Mais para vir! O script já é bastante complexo, mas tenho algumas ideias para novos recursos que desejo adicionar no futuro (provavelmente uma versão da MCC será a próxima). Quando uma nova versão está disponível, um lembrete sutil é adicionado ao painel. Configuração rápida Como o script funciona imediatamente, é fácil configurá-lo. Obtenha o código (veja abaixo) e cole-o na sua conta. Agende o script para ser executado diariamente. Recomendação: 01:00 Execute o script pela primeira vez. Verifique os registros para encontrar o URL do seu painel ou encontre tudo em seu Google Drive . Configuração Detalhada No Google AdWords, navegue até ” Operações em massa” e depois ” Scripts” . Clique em + Script . Cole o script no final deste post. Nomeie-o como “Quality Score Tracker v3.0”. Clique em Salvar e, em seguida, em Autorizar agora . Volte para os Scripts e encontre o Rastreador de Índice de Qualidade no topo da lista. Clique em + Criar agendamento . Como frequência, selecione “Diariamente”, juntamente com um horário de sua conveniência. Recomendação: 01:00 Clique em Salvar . Clique em Executar e , em seguida, role para baixo para ver o script sendo executado em Logs . Com grandes contas, isso pode demorar um pouco, caso contrário, isso pode ser feito em 15 segundos. Clique em Logs no lado direito. Na próxima tela, clique no botão Logs no topo. Agora, os URLs do painel e da pasta do Google Drive são exibidos. Como alternativa, você pode encontrar tudo em seu Google Drive . /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * Quality Score Tracker v3.0.1 * Written by Martin Roettgerding. * © 2016 Martin Roettgerding, Bloofusion Germany GmbH. * www.ppc-epiphany.com/qstracker/latest */ function main(){ /* * The following preferences can be changed to customize this script. * Most of options can be set by using 1 for yes or 0 for no. * You don’t have to change anything here. The script will do fine with the defaults. */ var config = { /* * Which of the following charts should be displayed on the dashboard? * The “per QS” charts are column charts. They show the current state compared to a previous one (see next option). * “Average” and “weighted” charts are line charts, showing changes over time. */ “chartsToDisplay” : { “Keywords per QS” : 0, “Average QS” : 0, “Keywords with Impressions per QS” : 1, “Average QS for Keywords with Impressions” : 0, “Impressions per QS” : 0, “Impression weighted QS” : 1, “Clicks per QS” : 0, “Click weighted QS” : 0, “Conversions per QS” : 0, “Conversion weighted QS” : 0, “Conversion value per QS” : 0, “Conversion value weighted QS” : 0, }, /* * Column charts can show a former date for comparison. Set the number of steps you want to go back for this. * Note that the date you’re comparing this to will depend on how often you’ve run the script in the past. * Example: If the setting is 30 and you ran the script daily, your comparison will be

O post Automação Google Ads: Acompanhamento apareceu primeiro em Rotamáxima - Especialistas em resultados.

Automação Google Ads: Termos adicionados e Rótulos

Wed, 22 Aug 2018 17:09:03 +0000

Nessa série especial, reunimos alguns scripts úteis para você automatizar e aumentar o retorno de suas campanhas no Google Ads. Confira abaixo como automatizar o Google Ads para “Trabalhar com termos adicionados e Rótulos”. 1. Rótulo de contagem regressiva para termos adicionados – Por Russel Savage. Este é um excelente script para manter o controle de termos que foram recentemente adicionados, e portanto, não apresentam um histórico de estatísticas consolidados, assim, você evitar de pausá-los ou fazer alterações antes do tempo. Sempre que você adicionar novos elementos à sua conta, poderá aplicar um rótulo a ele usando o formato LABEL_PREFIX_. Portanto, se você quiser que seus scripts ignorem um novo elemento por 30 dias, aplique o rótulo “days_left_30” nesse elemento. Se você programar o script para ser executado todos os dias, o número de dias restantes no marcador será reduzido em um por dia. Quando o número de dias chegar a zero, o rótulo será removido da entidade. Nos scripts que você deseja ignorar novos elementos, inclua a seguinte função na parte inferior do script (antes da última chave): function _build_label_list() { //Build a list of labels to exclude in your .withCondition() var LABEL_PREFIX = ‘days_left_’; var label_iter = AdWordsApp.labels().withCondition(“Name STARTS_WITH ‘”+LABEL_PREFIX+”‘”).get(); var label_array = []; while(label_iter.hasNext()) { label_array.push(label_iter.next().getName()); } return “‘”+label_array.join(“‘,'”)+”‘” } E, em seguida, adicione o seguinte .withCondition (“LabelNames CONTAINS_NONE [” + _build_label_list () + “]”) para qualquer iterador que você tenha em seus outros scripts. Boa sorte, e se você tiver alguma dúvida, não hesite em perguntar. //———————————– // Label Countdown // Created By: Russ Savage // FreeAdWordsScripts.com //———————————– function main() { var LABEL_PREFIX = “days_left_”; // you can change this if you want // First lets build a list of labels to work with var label_iter = AdWordsApp.labels().withCondition(“Name STARTS_WITH ‘”+LABEL_PREFIX+”‘”).get(); var labels_array = []; while(label_iter.hasNext()) { labels_array.push(label_iter.next().getName()); } if(labels_array.length > 0) { var labels_str = “[‘” + labels_array.join(“‘,'”) + “‘]”; // grab all the keywords with the labels we want to countdown var kw_iter = AdWordsApp.keywords().withCondition(“LabelNames CONTAINS_ANY “+labels_str).get(); while(kw_iter.hasNext()) { var kw = kw_iter.next(); var l_iter = kw.labels().withCondition(“Name STARTS_WITH ‘”+LABEL_PREFIX+”‘”).get(); var label = l_iter.next(); // lazy here because we know this keyword has a label var days_left = parseInt(label.getName().substr(LABEL_PREFIX.length)) – 1; kw.removeLabel(label.getName()); if(days_left != 0) { var new_label_name = LABEL_PREFIX+days_left; // Create a new label if it doesn’t exist if(labels_array.indexOf(new_label_name) == -1) { AdWordsApp.createLabel(new_label_name); labels_array.push(new_label_name); } kw.applyLabel(new_label_name); } } } } 2. Junte Rótulos de Múltiplas Campanhas – Russel Savage. O script auxilia outro script de agrupar campanhas do autor, ele mantém todas os rótulos das palavras-chave das campanhas agrupadas.] //———————————– // Merge Labels from Multiple Campaigns // Created By: Russ Savage // FreeAdWordsScripts.com //———————————– var DESTINATION_CAMPAIGN_NAME = “Destination Campaign Name”; var ORIGIN_CAMPAIGN_NAMES = [“Origin Campaign Name 1″,”Origin Campaign Name 2”]; function main() { var label_iter = AdWordsApp.labels().get(); while(label_iter.hasNext()) { var label = label_iter.next(); //Pre-build all the iterators var iters = [ label.campaigns().withCondition(“Name IN [‘”+ORIGIN_CAMPAIGN_NAMES.join(“‘,'”)+”‘]”).get(), label.adGroups().withCondition(“CampaignName IN [‘”+ORIGIN_CAMPAIGN_NAMES.join(“‘,'”)+”‘]”).get(), label.ads().withCondition(“CampaignName IN [‘”+ORIGIN_CAMPAIGN_NAMES.join(“‘,'”)+”‘]”).get(), label.keywords().withCondition(“CampaignName IN [‘”+ORIGIN_CAMPAIGN_NAMES.join(“‘,'”)+”‘]”).get() ]; for(var i in iters) { var iter = iters[i]; while(iter.hasNext()) { _copyLabels(iter.next()); } } } } //Copies the labels from entity in Origin campaign //to entity with the same name in dest campaign function _copyLabels(entity) { var iter; if(_getEntityType(entity) == “Campaign”) { // it’s a campaign iter = AdWordsApp.campaigns() .withCondition(“Name = ‘”+DESTINATION_CAMPAIGN_NAME+”‘”) .get(); } else if(_getEntityType(entity) == “AdGroup”) { // it’s an adgroup iter = AdWordsApp.adGroups() .withCondition(“CampaignName = ‘”+DESTINATION_CAMPAIGN_NAME+”‘”) .withCondition(“Name = ‘”+entity.getName()+”‘”) .get(); } else if(_getEntityType(entity) == “Ad”) { // it’s an ad iter = AdWordsApp.ads() .withCondition(“CampaignName = ‘”+DESTINATION_CAMPAIGN_NAME+”‘”) .withCondition(“AdGroupName = ‘”+entity.getAdGroup().getName()+”‘”) .withCondition(“Headline = ‘”+entity.getHeadline()+”‘”) .withCondition(“Description1 = ‘”+entity.getDescription1()+”‘”) .withCondition(“Description2 = ‘”+entity.getDescription2()+”‘”) .withCondition(“DisplayUrl = ‘”+entity.getDisplayUrl()+”‘”) .get(); } else if(_getEntityType(entity) == “Keyword”) { // it’s a keyword iter = AdWordsApp.keywords() .withCondition(“CampaignName = ‘”+DESTINATION_CAMPAIGN_NAME+”‘”) .withCondition(“AdGroupName = ‘”+entity.getAdGroup().getName()+”‘”) .withCondition(“Text = ‘”+entity.getText()+”‘”) .withCondition(“KeywordMatchType = ‘”+entity.getMatchType()+”‘”) .get(); } while(iter.hasNext()) { _copyLabelsHelper(entity,iter.next()); } } //Copy the labels form orig entity to dest entity function _copyLabelsHelper(orig,dest) { var label_iter = orig.labels().get(); while(label_iter.hasNext()) { dest.applyLabel(label_iter.next().getName()); } } //Returns a text representation of an entity //For a better way, check: http://goo.gl/kZL3X function _getEntityType(obj) { if(typeof(obj[‘getCampaign’]) == “undefined”) { return ‘Campaign’; } if(typeof(obj[‘getAdGroup’]) == “undefined”) { return ‘AdGroup’; } if(typeof(obj[‘getHeadline’]) != “undefined”) { return “Ad”; } if(typeof(obj[‘getText’]) != “undefined”) { return “Keyword”; } return null; }//———————————– // Merge Labels from Multiple Campaigns // Created By: Russ Savage // FreeAdWordsScripts.com //———————————– var DESTINATION_CAMPAIGN_NAME = “Destination Campaign Name”; var ORIGIN_CAMPAIGN_NAMES = [“Origin Campaign Name 1″,”Origin Campaign Name 2”]; function main() { var label_iter = AdWordsApp.labels().get(); while(label_iter.hasNext()) { var label = label_iter.next(); //Pre-build all the iterators var iters = [ label.campaigns().withCondition(“Name IN [‘”+ORIGIN_CAMPAIGN_NAMES.join(“‘,'”)+”‘]”).get(), label.adGroups().withCondition(“CampaignName IN [‘”+ORIGIN_CAMPAIGN_NAMES.join(“‘,'”)+”‘]”).get(), label.ads().withCondition(“CampaignName IN [‘”+ORIGIN_CAMPAIGN_NAMES.join(“‘,'”)+”‘]”).get(), label.keywords().withCondition(“CampaignName IN [‘”+ORIGIN_CAMPAIGN_NAMES.join(“‘,'”)+”‘]”).get() ]; for(var i in iters) { var iter = iters[i]; while(iter.hasNext()) { _copyLabels(iter.next()); } } } } //Copies the labels from entity in Origin campaign //to entity with the same name in dest campaign function _copyLabels(entity) { var iter; if(_getEntityType(entity) == “Campaign”) { // it’s a campaign iter = AdWordsApp.campaigns() .withCondition(“Name = ‘”+DESTINATION_CAMPAIGN_NAME+”‘”) .get(); } else if(_getEntityType(entity) == “AdGroup”) { // it’s an adgroup iter = AdWordsApp.adGroups() .withCondition(“CampaignName = ‘”+DESTINATION_CAMPAIGN_NAME+”‘”) .withCondition(“Name = ‘”+entity.getName()+”‘”) .get(); } else if(_getEntityType(entity) == “Ad”) { // it’s an ad iter = AdWordsApp.ads() .withCondition(“CampaignName = ‘”+DESTINATION_CAMPAIGN_NAME+”‘”) .withCondition(“AdGroupName = ‘”+entity.getAdGroup().getName()+”‘”) .withCondition(“Headline = ‘”+entity.getHeadline()+”‘”) .withCondition(“Description1 = ‘”+entity.getDescription1()+”‘”) .withCondition(“Description2 = ‘”+entity.getDescription2()+”‘”) .withCondition(“DisplayUrl = ‘”+entity.getDisplayUrl()+”‘”) .get(); } else if(_getEntityType(entity) == “Keyword”) { // it’s a keyword iter = AdWordsApp.keywords() .withCondition(“CampaignName = ‘”+DESTINATION_CAMPAIGN_NAME+”‘”) .withCondition(“AdGroupName = ‘”+entity.getAdGroup().getName()+”‘”) .withCondition(“Text = ‘”+entity.getText()+”‘”) .withCondition(“KeywordMatchType = ‘”+entity.getMatchType()+”‘”) .get(); } while(iter.hasNext()) { _copyLabelsHelper(entity,iter.next()); } } //Copy the labels form orig entity to dest entity function _copyLabelsHelper(orig,dest) { var label_iter = orig.labels().get(); while(label_iter.hasNext()) { dest.applyLabel(label_iter.next().getName()); } } //Returns a text representation of an entity //For a better way, check: http://goo.gl/kZL3X function _getEntityType(obj) { if(typeof(obj[‘getCampaign’]) == “undefined”) { return ‘Campaign’; } if(typeof(obj[‘getAdGroup’]) == “undefined”) { return ‘AdGroup’; } if(typeof(obj[‘getHeadline’]) != “undefined”) { return “Ad”; } if(typeof(obj[‘getText’]) != “undefined”) { return “Keyword”; } return null; } 3. Rótulos com as datas de criação – Por Russel Savage. Rotule com a data de criação seus anúncios, grupo de anúncios, campanhas e palavras-chave com esse script. Assim, é possível ter um controle histórico de suas

O post Automação Google Ads: Termos adicionados e Rótulos apareceu primeiro em Rotamáxima - Especialistas em resultados.

Automação Google Ads: Automatizar Tarefas

Wed, 22 Aug 2018 15:06:45 +0000

Nessa série especial, reunimos alguns scripts úteis para você automatizar e aumentar o retorno de suas campanhas no Google Ads. Confira abaixo como automatizar o Google Ads para “Trabalhar com Automação de Tarefas”. 1. Reduza Lances para Palavras-chave com Custo/Conversão Alto – Por Russell Savage. Evite que suas palavras-chave consumam todo orçamento de sua campanha caso ela não esteja trazendo resultados. O script diminui automaticamente lances de palavras-chave com baixa performance em qualquer período de tempo. //———————————– // Reduce Bids on High Cost per Conversion Keywords // Created By: Russ Savage // FreeAdWordsScripts.com //———————————– function main() { //Let’s reduce keywords with a CPC greater than $15 by 35% var WAY_TOO_HIGH_COST_PER_CONV = 15; var WAY_TOO_HIGH_BID_REDUCTION_AMOUNT = .35; //And keywords with CPC between $10 and $15 by 20% var TOO_HIGH_COST_PER_CONV = 10; var TOO_HIGH_BID_REDUCTION_AMOUNT = .20; var kw_iter = AdWordsApp.keywords() .withCondition(“Status = ENABLED”) .get(); while(kw_iter.hasNext()) { var kw = kw_iter.next(); var kw_stats = kw.getStatsFor(“LAST_30_DAYS”); var cost = kw_stats.getCost(); var conversions = kw_stats.getConversions(); if(conversions > 0) { var cost_per_conversion = (cost/(conversions*1.0)); //Here is the magic. If it is way too high, reduce it by the way too high amount if(cost_per_conversion >= WAY_TOO_HIGH_COST_PER_CONV) { kw.setMaxCpc(kw.getMaxCpc() * (1-WAY_TOO_HIGH_BID_REDUCTION_AMOUNT)); } //otherwise, if it is still too high, reduce it with just the too high amount else if(cost_per_conversion >= TOO_HIGH_COST_PER_CONV) { kw.setMaxCpc(kw.getMaxCpc() * (1-TOO_HIGH_BID_REDUCTION_AMOUNT)); } }else{ //no conversions on this keyword //we will deal with that later continue; } } } 2. Aumente Lances para Palavras-chave com Custo/Conversão Baixo – Por Russell Savage. Assim como seu nome, esse script visa aumentar os lances para palavras-chave que estão custando barato. //———————————– // Increase Bids Cheap Conversion Keywords // Created By: Russ Savage // FreeAdWordsScripts.com //———————————– function main() { //For keywords with less than $5 CPC, let’s pump those bids up by 35% var AMAZING_COST_PER_CONV = 5; var AMAZING_BID_INCREASE_AMOUNT = .35; //For keywords with between $5 and $8 CPCs, we will only increase the bids by 20% var GREAT_COST_PER_CONV = 8; var GREAT_BID_INCREASE_AMOUNT = .20; var kw_iter = AdWordsApp.keywords() .withCondition(“Status = ENABLED”) .get(); while(kw_iter.hasNext()) { var kw = kw_iter.next(); var kw_stats = kw.getStatsFor(“LAST_30_DAYS”); var cost = kw_stats.getCost(); var conversions = kw_stats.getConversions(); if(conversions > 0) { var cost_per_conversion = (cost/(conversions*1.0)); if(cost_per_conversion <= AMAZING_COST_PER_CONV) { kw.setMaxCpc(kw.getMaxCpc() * (1+AMAZING_BID_INCREASE_AMOUNT)); } else if(cost_per_conversion <= GREAT_COST_PER_CONV) { kw.setMaxCpc(kw.getMaxCpc() * (1+GREAT_BID_INCREASE_AMOUNT)); } }else{ //no conversions on this keyword //we will deal with that later continue; } } } 3. Pause Palavras-chave que não performam – Por Russel Savage. Para utilizar esse script é necessário ter o valor da conversão sendo rastreado. Assim, caso o custo da palavra-chave esteja ultrapassando um valor determinado ela é automaticamente pausada. //———————————– // Pause Keywords That Are Not Performing // Created By: Russ Savage // FreeAdWordsScripts.com //———————————– function main() { var THE_VALUE_OF_ONE_CONVERSION = 10; var DECREASE_BIDS_BY_PERCENTAGE = .5; var kw_iter = AdWordsApp.keywords() .withCondition(“Status = ENABLED”) .get(); while(kw_iter.hasNext()) { var kw = kw_iter.next(); var kw_stats = kw.getStatsFor(“LAST_30_DAYS”); var cost = kw_stats.getCost(); var conversions = kw_stats.getConversions(); if(conversions == 0) { if(THE_VALUE_OF_ONE_CONVERSION * 5 > cost) { kw.pause(); } else if(THE_VALUE_OF_ONE_CONVERSION * 2 > cost) { kw.setMaxCpc(kw.getMaxCpc() * (1-DECREASE_BIDS_BY_PERCENTAGE)); } }else{ //no conversions on this keyword //we will deal with that later continue; } } }

O post Automação Google Ads: Automatizar Tarefas apareceu primeiro em Rotamáxima - Especialistas em resultados.

Automação Google Ads: Anúncios Sazonais

Wed, 22 Aug 2018 14:55:12 +0000

Nessa série especial, reunimos alguns scripts úteis para você automatizar e aumentar o retorno de suas campanhas no Google Ads. Confira abaixo como automatizar o Google Ads para “Trabalhar com anúncios sazonais”. 1. Atualize Anúncios para o Ano Novo – Por Russel Savage. Tenha seus anúncios atualizados assim que o ano novo chegar. Esse script pode auxiliar anunciantes de empresas que precisem ter o ano em seus textos. //———————————– // Update Ads for 2012 // Created By: Russ Savage // FreeAdWordsScripts.com //———————————– function main() { var OLD_YEAR = “2011”; var NEW_YEAR = “2012”; //You probably shouldn’t update destination urls unless you know what you are doing. var FIELDS_CONTAINING_YEAR = [“Headline”,”Description1″, “Description2″,”DisplayUrl” /*,”DestinationUrl”*/ ]; for(i in FIELDS_CONTAINING_YEAR) { var field_iter = AdWordsApp.ads() .withCondition(FIELDS_CONTAINING_YEAR[i] + ” CONTAINS ” + OLD_YEAR) .withCondition(“Status = ENABLED”) .get(); _iterateThroughAds(field_iter); } //————— // Private Helper Functions //————— function _iterateThroughAds(ad_iter) { while (ad_iter.hasNext()) { var ad = ad_iter.next(); var ag = ad.getAdGroup(); _createNewAdFromOldAd(ag,ad); } } function _createNewAdFromOldAd(adgroup, old_ad) { //get the updated ad texts replacing all the old years with the new years var new_headline = old_ad.getHeadline().replace(OLD_YEAR,NEW_YEAR); var new_desc1 = old_ad.getDescription1().replace(OLD_YEAR,NEW_YEAR); var new_desc2 = old_ad.getDescription2().replace(OLD_YEAR,NEW_YEAR); var new_display_url = old_ad.getDisplayUrl().replace(OLD_YEAR,NEW_YEAR); var new_dest_url = old_ad.getDestinationUrl();/*.replace(OLD_YEAR,NEW_YEAR);*/ //now create the new ad and pause the old one. adgroup.createTextAd(new_headline,new_desc1,new_desc2,new_display_url,new_dest_url); old_ad.pause(); } } 2. Atualize suas Palavras-chave em Feriados e Datas Comemorativas – Por Russel Savage. Todas as suas palavras-chave que tiverem o ano atual em seu texto será substituído com o ano atual. Assim, caso você não precisa mudar manualmente todas essas palavras-chave. /********************************************* * Update Keywords for the New Year * Version 1.1 * Changelog v1.1 * – Updated for speed and added comments * Created By: Russ Savage * FreeAdWordsScripts.com **********************************************/ function main() { var sameDayLastYear = new Date(); sameDayLastYear.setYear(sameDayLastYear.getYear()-1); var oldYearStr = sameDayLastYear.getYear().toString(); var newYearStr = new Date().getYear().toString(); Logger.log(‘Updating keywords with old year: ‘+oldYearStr+’ to new year: ‘+newYearStr); // Let’s start by getting all of the keywords var kwIter = AdWordsApp.keywords() .withCondition(“Text CONTAINS ” + oldYearStr) .withCondition(“Status = ENABLED”) .withCondition(“AdGroupStatus = ENABLED”) .withCondition(“CampaignStatus = ENABLED”) .get(); // It is always better to store and batch process afterwards var toPause = []; var toCreate = []; while (kwIter.hasNext()) { var kw = kwIter.next(); var ag = kw.getAdGroup(); var oldText = kw.getText(); var newText = oldText.replace(oldYearStr,newYearStr); // Save the info so that we can create them as a batch later toCreate.push({ ag: ag, text: newText, cpc:kw.getMaxCpc(), destUrl : kw.getDestinationUrl() }); // Same with the ones we want to pause toPause.push(kw) } // Now we create the new keywords all at once for(var i in toCreate) { var elem = toCreate[i]; elem.ag.createKeyword(elem.text, elem.cpc, elem.destUrl); } // And pause the old ones all at once for(var i in toPause) { toPause[i].pause(); //or toPause[i].remove(); to delete the old keyword } }

O post Automação Google Ads: Anúncios Sazonais apareceu primeiro em Rotamáxima - Especialistas em resultados.

Automação Google Ads: Como gerar relatórios

Wed, 22 Aug 2018 14:00:06 +0000

Nessa série especial, reunimos alguns scripts úteis para você automatizar e aumentar o retorno de suas campanhas no Google Ads. Confira abaixo como automatizar o Google Ads para Geração de Relatórios. 1. Relatório de Resumo da Conta – por Google Ads. Utilize esse script para criar relatórios em uma planilha do Google. Nesta planilha você tem uma visão do desempenho de toda a conta do Google Ads e, além disso, envia um e-mail todos os dias com estatísticas das contas atuais. // Copyright 2015, Google Inc. All Rights Reserved. // // Licensed under the Apache License, Version 2.0 (the “License”); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an “AS IS” BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. /** * @name Account Summary Report * * @overview The Account Summary Report script generates an at-a-glance report * showing the performance of an entire AdWords account. See * https://developers.google.com/adwords/scripts/docs/solutions/account-summary * for more details. * * @author AdWords Scripts Team [adwords-scripts@googlegroups.com] * * @version 1.1 * * @changelog * – version 1.1 * – Add user-updateable fields, and ensure report row ordering. * – version 1.0.4 * – Improved code readability and comments. * – version 1.0.3 * – Added validation for external spreadsheet setup. * – version 1.0.2 * – Fixes date formatting bug in certain timezones. * – version 1.0.1 * – Improvements to time zone handling. * – version 1.0 * – Released initial version. */ var SPREADSHEET_URL = ‘YOUR_SPREADSHEET_URL’; /** * Configuration to be used for running reports. */ var REPORTING_OPTIONS = { // Comment out the following line to default to the latest reporting version. apiVersion: ‘v201705’ }; /** * To add additional fields to the report, follow the instructions at the link * in the header above, and add fields to this variable, taken from the Account * Performance Report reference: * https://developers.google.com/adwords/api/docs/appendix/reports/account-performance-report */ var REPORT_FIELDS = [ {columnName: ‘Cost’, displayName: ‘Cost’}, {columnName: ‘AverageCpc’, displayName: ‘Avg. CPC’}, {columnName: ‘Ctr’, displayName: ‘CTR’}, {columnName: ‘AveragePosition’, displayName: ‘Avg. Pos.’}, {columnName: ‘Impressions’, displayName: ‘Impressions’}, {columnName: ‘Clicks’, displayName: ‘Clicks’} ]; function main() { Logger.log(‘Using spreadsheet – %s.’, SPREADSHEET_URL); var spreadsheet = validateAndGetSpreadsheet(); spreadsheet.setSpreadsheetTimeZone(AdWordsApp.currentAccount().getTimeZone()); spreadsheet.getRangeByName(‘account_id_report’).setValue( AdWordsApp.currentAccount().getCustomerId()); var yesterday = getYesterday(); var date = getFirstDayToCheck(spreadsheet, yesterday); var rows = []; var existingDates = getExistingDates(); while (date.getTime() <= yesterday.getTime()) { if (!existingDates[date]) { var row = getReportRowForDate(date); rows.push([new Date(date)].concat(REPORT_FIELDS.map(function(field) { return row[field.columnName]; }))); spreadsheet.getRangeByName(‘last_check’).setValue(date); } date.setDate(date.getDate() + 1); } if (rows.length > 0) { writeToSpreadsheet(rows); var email = spreadsheet.getRangeByName(‘email’).getValue(); if (email) { sendEmail(email); } } } /** * Retrieves a lookup of dates for which rows already exist in the spreadsheet. * * @return {!Object} A lookup of existing dates. */ function getExistingDates() { var spreadsheet = validateAndGetSpreadsheet(); var sheet = spreadsheet.getSheetByName(‘Report’); var data = sheet.getDataRange().getValues(); var existingDates = {}; data.slice(5).forEach(function(row) { existingDates[row[1]] = true; }); return existingDates; } /** * Sorts the data in the spreadsheet into ascending date order. */ function sortReportRows() { var spreadsheet = validateAndGetSpreadsheet(); var sheet = spreadsheet.getSheetByName(‘Report’); var data = sheet.getDataRange().getValues(); var reportRows = data.slice(5); if (reportRows.length) { reportRows.sort(function(rowA, rowB) { if (!rowA || !rowA.length) { return -1; } else if (!rowB || !rowB.length) { return 1; } else if (rowA[1] < rowB[1]) { return -1; } else if (rowA[1] > rowB[1]) { return 1; } return 0; }); sheet.getRange(6, 1, reportRows.length, reportRows[0].length) .setValues(reportRows); } } /** * Append the data rows to the spreadsheet. * * @param {Array<Array<string>>} rows The data rows. */ function writeToSpreadsheet(rows) { var access = new SpreadsheetAccess(SPREADSHEET_URL, ‘Report’); var emptyRow = access.findEmptyRow(6, 2); if (emptyRow < 0) { access.addRows(rows.length); emptyRow = access.findEmptyRow(6, 2); } access.writeRows(rows, emptyRow, 2); sortReportRows(); } function sendEmail(email) { var day = getYesterday(); var yesterdayRow = getReportRowForDate(day); day.setDate(day.getDate() – 1); var twoDaysAgoRow = getReportRowForDate(day); day.setDate(day.getDate() – 5); var weekAgoRow = getReportRowForDate(day); var html = []; html.push( ‘<html>’, ‘<body>’, ‘<table width=800 cellpadding=0 border=0 cellspacing=0>’, ‘<tr>’, ‘<td colspan=2 align=right>’, “<div style=’font: italic normal 10pt Times New Roman, serif; ” + “margin: 0; color: #666; padding-right: 5px;’>” + ‘Powered by AdWords Scripts</div>’, ‘</td>’, ‘</tr>’, “<tr bgcolor=’#3c78d8′>”, ‘<td width=500>’, “<div style=’font: normal 18pt verdana, sans-serif; ” + “padding: 3px 10px; color: white’>Account Summary report</div>”, ‘</td>’, ‘<td align=right>’, “<div style=’font: normal 18pt verdana, sans-serif; ” + “padding: 3px 10px; color: white’>”, AdWordsApp.currentAccount().getCustomerId(), ‘</h1>’, ‘</td>’, ‘</tr>’, ‘</table>’, ‘<table width=800 cellpadding=0 border=0 cellspacing=0>’, “<tr bgcolor=’#ddd’>”, ‘<td></td>’, “<td style=’font: 12pt verdana, sans-serif; ” + ‘padding: 5px 0px 5px 5px; background-color: #ddd; ‘ + “text-align: left’>Yesterday</td>”, “<td style=’font: 12pt verdana, sans-serif; ” + ‘padding: 5px 0px 5px 5px; background-color: #ddd; ‘ + “text-align: left’>Two Days Ago</td>”, “<td style=’font: 12pt verdana, sans-serif; ” + ‘padding: 5px 0px 5x 5px; background-color: #ddd; ‘ + “text-align: left’>A week ago</td>”, ‘</tr>’); REPORT_FIELDS.forEach(function(field) { html.push(emailRow( field.displayName, field.columnName, yesterdayRow, twoDaysAgoRow, weekAgoRow)); }); html.push(‘</table>’, ‘</body>’, ‘</html>’); MailApp.sendEmail(email, ‘AdWords Account ‘ + AdWordsApp.currentAccount().getCustomerId() + ‘ Summary Report’, ”, {htmlBody: html.join(‘\n’)}); } function emailRow(title, column, yesterdayRow, twoDaysAgoRow, weekAgoRow) { var html = []; html.push(‘<tr>’, “<td style=’padding: 5px 10px’>” + title + ‘</td>’, “<td style=’padding: 0px 10px’>” + yesterdayRow[column] + ‘</td>’, “<td style=’padding: 0px 10px’>” + twoDaysAgoRow[column] + formatChangeString(yesterdayRow[column], twoDaysAgoRow[column]) + ‘</td>’, “<td style=’padding: 0px 10px’>” + weekAgoRow[column] + formatChangeString(yesterdayRow[column], weekAgoRow[column]) + ‘</td>’, ‘</tr>’); return html.join(‘\n’); } function getReportRowForDate(date) { var timeZone = AdWordsApp.currentAccount().getTimeZone(); var dateString = Utilities.formatDate(date, timeZone, ‘yyyyMMdd’); return getReportRowForDuring(dateString + ‘,’ + dateString); } function getReportRowForDuring(during) { var report = AdWordsApp.report( ‘SELECT ‘ + REPORT_FIELDS .map(function(field) { return field.columnName; }) .join(‘,’) + ‘ FROM ACCOUNT_PERFORMANCE_REPORT ‘ + ‘DURING ‘ + during, REPORTING_OPTIONS); return report.rows().next(); } function formatChangeString(newValue, oldValue) { var x = newValue.indexOf(‘%’); if (x != -1) { newValue = newValue.substring(0, x); var y = oldValue.indexOf(‘%’); oldValue = oldValue.substring(0, y); } var change = parseFloat(newValue – oldValue).toFixed(2); var changeString = change; if (x

O post Automação Google Ads: Como gerar relatórios apareceu primeiro em Rotamáxima - Especialistas em resultados.

Automação Google Ads: Como programar alertas

Tue, 21 Aug 2018 20:49:37 +0000

Nessa série especial, reunimos alguns scripts úteis para você automatizar e aumentar o retorno de suas campanhas no Google Ads. Confira abaixo como automatizar o Google Ads para “Programação de alertas especiais”. 1. Detector de Anomalias da Conta – Por Google Ads. O script do Google alerta por e-mail quando sua conta apresenta um comportamento muito diferente de seu histórico. Ele faz uma comparação com as estatísticas obtidas até o dia atual com o histórico das estatísticas em relação ao mesmo dia da semana. // Copyright 2017, Google Inc. All Rights Reserved. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. /** * @name Account Anomaly Detector * * @fileoverview The Account Anomaly Detector alerts the advertiser whenever an * advertiser account is suddenly behaving too differently from what's * historically observed. See * https://developers.google.com/adwords/scripts/docs/solutions/account-anomaly-detector * for more details. * * @author AdWords Scripts Team [adwords-scripts@googlegroups.com] * * @version 1.1 * * @changelog * - version 1.1.1 * - Fixed bug in handling of reports with 0 rows. * - version 1.1 * - Added conversions to tracked statistics. * - version 1.0.3 * - Improved code readability and comments. * - version 1.0.2 * - Added validation for external spreadsheet setup. * - Updated to use report version v201609. * - version 1.0.1 * - Improvements to time zone handling. * - version 1.0 * - Released initial version. */ var SPREADSHEET_URL = 'YOUR_SPREADSHEET_URL'; var DAYS = ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday', 'Sunday']; /** * Configuration to be used for running reports. */ var REPORTING_OPTIONS = { // Comment out the following line to default to the latest reporting version. apiVersion: 'v201705' }; function main() { Logger.log('Using spreadsheet - %s.', SPREADSHEET_URL); var spreadsheet = validateAndGetSpreadsheet(SPREADSHEET_URL); spreadsheet.setSpreadsheetTimeZone(AdWordsApp.currentAccount().getTimeZone()); var impressionsThreshold = parseField(spreadsheet. getRangeByName('impressions').getValue()); var clicksThreshold = parseField(spreadsheet.getRangeByName('clicks'). getValue()); var conversionsThreshold = parseField(spreadsheet.getRangeByName('conversions').getValue()); var costThreshold = parseField(spreadsheet.getRangeByName('cost').getValue()); var weeksStr = spreadsheet.getRangeByName('weeks').getValue(); var weeks = parseInt(weeksStr.substring(0, weeksStr.indexOf(' '))); var email = spreadsheet.getRangeByName('email').getValue(); var now = new Date(); // Basic reporting statistics are usually available with no more than a 3-hour // delay. var upTo = new Date(now.getTime() - 3 * 3600 * 1000); var upToHour = parseInt(getDateStringInTimeZone('h', upTo)); if (upToHour == 1) { // first run for the day, kill existing alerts spreadsheet.getRangeByName('clicks_alert').clearContent(); spreadsheet.getRangeByName('impressions_alert').clearContent(); spreadsheet.getRangeByName('conversions_alert').clearContent(); spreadsheet.getRangeByName('cost_alert').clearContent(); } var dateRangeToCheck = getDateStringInPast(0, upTo); var dateRangeToEnd = getDateStringInPast(1, upTo); var dateRangeToStart = getDateStringInPast(1 + weeks * 7, upTo); var fields = 'HourOfDay,DayOfWeek,Clicks,Impressions,Conversions,Cost'; var todayQuery = 'SELECT ' + fields + ' FROM ACCOUNT_PERFORMANCE_REPORT DURING ' + dateRangeToCheck + ',' + dateRangeToCheck; var pastQuery = 'SELECT ' + fields + ' FROM ACCOUNT_PERFORMANCE_REPORT WHERE DayOfWeek=' + DAYS[getDateStringInTimeZone('u', now)].toUpperCase() + ' DURING ' + dateRangeToStart + ',' + dateRangeToEnd; var todayStats = getReportStats(todayQuery, upToHour, 1); var pastStats = getReportStats(pastQuery, upToHour, weeks); var statsExist = true; if (typeof todayStats === 'undefined' || typeof pastStats === 'undefined') { statsExist = false; } var alertText = []; if (statsExist && impressionsThreshold && todayStats.impressions < pastStats.impressions * impressionsThreshold) { var ImpressionsAlert = ' Impressions are too low: ' + todayStats.impressions + ' impressions by ' + upToHour + ':00, expecting at least ' + parseInt(pastStats.impressions * impressionsThreshold); writeAlert(spreadsheet, 'impressions_alert', alertText, ImpressionsAlert, upToHour); } if (statsExist && clicksThreshold && todayStats.clicks < pastStats.clicks * clicksThreshold) { var clickAlert = ' Clicks are too low: ' + todayStats.clicks + ' clicks by ' + upToHour + ':00, expecting at least ' + (pastStats.clicks * clicksThreshold).toFixed(1); writeAlert(spreadsheet, 'clicks_alert', alertText, clickAlert, upToHour); } if (statsExist && conversionsThreshold && todayStats.conversions < pastStats.conversions * conversionsThreshold) { var conversionsAlert = ' Conversions are too low: ' + todayStats.conversions + ' conversions by ' + upToHour + ':00, expecting at least ' + (pastStats.conversions * conversionsThreshold).toFixed(1); writeAlert( spreadsheet, 'conversions_alert', alertText, conversionsAlert, upToHour); } if (statsExist && costThreshold && todayStats.cost > pastStats.cost * costThreshold) { var costAlert = ' Cost is too high: ' + todayStats.cost + ' ' + AdWordsApp.currentAccount().getCurrencyCode() + ' by ' + upToHour + ':00, expecting at most ' + (pastStats.cost * costThreshold).toFixed(2); writeAlert(spreadsheet, 'cost_alert', alertText, costAlert, upToHour); } if (alertText.length > 0 && email && email.length > 0) { MailApp.sendEmail(email, 'AdWords Account ' + AdWordsApp.currentAccount().getCustomerId() + ' misbehaved.', 'Your account ' + AdWordsApp.currentAccount().getCustomerId() + ' is not performing as expected today: \n\n' + alertText.join('\n') + '\n\nLog into AdWords and take a look.\n\nAlerts dashboard: ' + SPREADSHEET_URL); } writeDataToSpreadsheet(spreadsheet, now, statsExist, todayStats, pastStats, AdWordsApp.currentAccount().getCustomerId()); } function toFloat(value) { value = value.toString().replace(/,/g, ''); return parseFloat(value); } function parseField(value) { if (value == 'No alert') { return null; } else { return toFloat(value); } } /** * Runs an AdWords report query for a number of weeks and return the average * values for the stats. * * @param {string} query The formatted report query. * @param {int} hours The limit hour of day for considering the report rows. * @param {int} weeks The number of weeks for the past stats. * @return {Object} An object containing the average values for the stats. */ function getReportStats(query, hours, weeks) { var reportRows = []; var report = AdWordsApp.report(query, REPORTING_OPTIONS); var rows = report.rows(); while (rows.hasNext()) { reportRows.push(rows.next()); } return accumulateRows(reportRows, hours, weeks); } function accumulateRows(rows, hours, weeks) { var result = {clicks: 0, impressions: 0, conversions: 0, cost: 0}; for (var i = 0; i < rows.length; i++) { var row = rows[i]; var hour = row['HourOfDay']; if (hour < hours) { result = addRow(row, result, 1 / weeks); } } return result; } function addRow(row, previous, coefficient) { if (!coefficient) { coefficient = 1; } if (row == null) { row = {Clicks: 0,

O post Automação Google Ads: Como programar alertas apareceu primeiro em Rotamáxima - Especialistas em resultados.