Nové možnosti reportingu v rámci Adwords skriptů Adwords API v201601

Na konci ledna přišla pravidelná aktualizace Adwords API, která přináší velmi pozitivní novinky i do našich oblíbených Adwords skriptů.

Hlavní novinkou pro nás skriptaře jsou nové sloupce a reporty, které si můžeme pomocí AWQL stáhnout.

Jaké sloupce navíc nám tedy Google nadělil:

FirstPositionCpc – simulace potřebné nabídky pro 1. pozici daného klíčového slova.
EstimatedAddClicksAtFirstPositionCpc – kolik prokliků získám navíc na 1. pozici.
EstimatedAddCostAtFirstPositionCpc – o kolik víc zaplatím za prokliky na 1. pozici.
CreativeQualityScore – jak hodnotí Adwords relevanci reklamy daného klíčového slova.
1. Not applicable – neví.
2. Below average – podprůměrná.
3. Average – průměrná.
4. Above average – nadprůměrná.
PostClickQualityScore – relevance vstupní stránky k Vašemu klíčovému slovu.
1. Not applicable – neví.
2. Below average – podprůměrná.
3. Average – průměrná.
4. Above average – nadprůměrná.
SearchPredictedCtr – jak hodnotí Adwords Ctr Vašeho klíčového slova na dané pozici.
1. Not applicable – neví.
2. Below average – podprůměrná.
3. Average – průměrná.
4. Above average – nadprůměrná.

Co s tím tedy můžeme dělat

Mohu automaticky reportovat klíčová slova, která mají malé CTR vzhledem k pozici.
Mohu odhalit, která klíčová slova nesměřuji na ideální vstupní stránku.
Mohu reportovat klíčová slova, která nemají relevantní reklamu.
Díky metrice EstimatedAddClicksAtFirstPositionCpc a EstimatedAddCostAtFirstPositionCpc mohu zjistit, kolik prokliků a za jakou cenu získám navíc v případě nabídky na 1. pozici.

Zdrojový kód skriptu

//SETTINGS - Vložte URL nového sešitu//
var spreadsheet = SpreadsheetApp.openByUrl('');

function main(){

spreadsheet.setSpreadsheetLocale('en');
var sheetSettings = createOrGetSheet(spreadsheet, 'Nastavení', 0);
var settingRange = sheetSettings.getRange(1,1,1,2);
if(sheetSettings.getRange(1,2).isBlank()) {
  settingRange.setValues([['Počet dnů pro report',90]]);
}
var daysBack = sheetSettings.getRange(1,2).getValue();
var sheet = createOrGetSheet(spreadsheet, 'KW report', 1);

var to = lynt_get_date(1);
var from = lynt_get_date(daysBack);
var dateRange = from + ',' + to;


var report = AdWordsApp.report(
  " SELECT Criteria,AdGroupName, CampaignName, KeywordMatchType, Impressions, Clicks, Cost,AveragePosition, QualityScore, AverageCpc, AllConversionValue, CostPerAllConversion, AllConversions, AveragePosition, SearchImpressionShare, FirstPageCpc, TopOfPageCpc, CreativeQualityScore, SearchPredictedCtr, PostClickQualityScore, EstimatedAddCostAtFirstPositionCpc, EstimatedAddClicksAtFirstPositionCpc, FirstPositionCpc, CpcBid " + 
  " FROM KEYWORDS_PERFORMANCE_REPORT"+
  " WHERE Impressions > 10"+
  " AND AdGroupStatus = ENABLED" + 
  " AND CampaignStatus = ENABLED" + 
  " AND Status = ENABLED" +
  " DURING " + dateRange);
  
report.exportToSheet(sheet);
}


function lynt_DST(datum, offset){
  var yr = datum.getFullYear();
  var dst_start = new Date("March 14, " + yr +" 02:00:00");
  var dst_end = new Date("November 07, " + yr +" 02:00:00");
  var day = dst_start.getDay();
  dst_start.setDate(14-day);
  day = dst_end.getDay();
  dst_end.setDate(7-day);
  if (datum >= dst_start && datum < dst_end){
    return offset+1;
  } else {
  return offset;
  }
}
 
//Creating or returning selected sheet 
function createOrGetSheet(reportSpreadsheet, name, position) {
  var sheet = reportSpreadsheet.getSheetByName(name);
  if(sheet == null) {
    return reportSpreadsheet.insertSheet(name,position);
  } else {
    return sheet;
  }
}
 
//Getting data for x days back in right format for AWQL query
function lynt_get_date(pocet_dni) {
  var minule = new Date(); 
  //kdyz je letni cas, tak o hodinu dele (GMT+1)
  var offset = lynt_DST(minule,1);
  minule.setTime(minule.getTime() - (1000 * 60 * 60 * (24) * pocet_dni) + offset);
  return lynt_format_awql_date(minule);
}
 
//Getting always last sunday with right formats for AWQL
function lynt_get_sunday() {
  var minule = new Date();
  //kdyz je letni cas, tak o hodinu dele (GMT+1)
  var offset = lynt_DST(minule,1);
  minule.setTime(minule.getTime() - (1000 * 60 * 60 * (24) * (minule.getDay())) + offset);
  return lynt_format_awql_date(minule);
}
 
//Getting x days from last sunday right formated for AWQL
function lynt_get_xdays_back_from_sunday(pocet_dni) {
  var minule = new Date();
  //kdyz je letni cas, tak o hodinu dele (GMT+1)
  var offset = lynt_DST(minule,1);
  minule.setTime(minule.getTime() - (1000 * 60 * 60 * (24) * pocet_dni) - (1000 * 60 * 60 * 24 * (minule.getDay()))+ offset);
  return lynt_format_awql_date(minule);
}
 
//Format date for AWQL
function lynt_format_awql_date(datum){
  return datum.getUTCFullYear()+("0"+(datum.getUTCMonth()+1)).slice(-2)+("0"+datum.getUTCDate()).slice(-2);
}

//SETTINGS - Vložte URL nového sešitu//

var spreadsheet = SpreadsheetApp.openByUrl('');

function main(){

spreadsheet.setSpreadsheetLocale('en');

var sheetSettings = createOrGetSheet(spreadsheet, 'Nastavení', 0);

var settingRange = sheetSettings.getRange(1,1,1,2);

if(sheetSettings.getRange(1,2).isBlank()) {

settingRange.setValues([['Počet dnů pro report',90]]);

}

var daysBack = sheetSettings.getRange(1,2).getValue();

var sheet = createOrGetSheet(spreadsheet, 'KW report', 1);

var to = lynt_get_date(1);

var from = lynt_get_date(daysBack);

var dateRange = from + ',' + to;

var report = AdWordsApp.report(

" SELECT Criteria,AdGroupName, CampaignName, KeywordMatchType, Impressions, Clicks, Cost,AveragePosition, QualityScore, AverageCpc, AllConversionValue, CostPerAllConversion, AllConversions, AveragePosition, SearchImpressionShare, FirstPageCpc, TopOfPageCpc, CreativeQualityScore, SearchPredictedCtr, PostClickQualityScore, EstimatedAddCostAtFirstPositionCpc, EstimatedAddClicksAtFirstPositionCpc, FirstPositionCpc, CpcBid " +

" FROM KEYWORDS_PERFORMANCE_REPORT"+

" WHERE Impressions > 10"+

" AND AdGroupStatus = ENABLED" +

" AND CampaignStatus = ENABLED" +

" AND Status = ENABLED" +

" DURING " + dateRange);

report.exportToSheet(sheet);

}

function lynt_DST(datum, offset){

var yr = datum.getFullYear();

var dst_start = new Date("March 14, " + yr +" 02:00:00");

var dst_end = new Date("November 07, " + yr +" 02:00:00");

var day = dst_start.getDay();

dst_start.setDate(14-day);

day = dst_end.getDay();

dst_end.setDate(7-day);

if (datum >= dst_start && datum < dst_end){

return offset+1;

} else {

return offset;

}

//Creating or returning selected sheet

function createOrGetSheet(reportSpreadsheet, name, position) {

var sheet = reportSpreadsheet.getSheetByName(name);

if(sheet == null) {

return reportSpreadsheet.insertSheet(name,position);

} else {

return sheet;

}

//Getting data for x days back in right format for AWQL query

function lynt_get_date(pocet_dni) {

var minule = new Date();

//kdyz je letni cas, tak o hodinu dele (GMT+1)

var offset = lynt_DST(minule,1);

minule.setTime(minule.getTime() - (1000 * 60 * 60 * (24) * pocet_dni) + offset);

return lynt_format_awql_date(minule);

}

//Getting always last sunday with right formats for AWQL

function lynt_get_sunday() {

var minule = new Date();

//kdyz je letni cas, tak o hodinu dele (GMT+1)

var offset = lynt_DST(minule,1);

minule.setTime(minule.getTime() - (1000 * 60 * 60 * (24) * (minule.getDay())) + offset);

return lynt_format_awql_date(minule);

}

//Getting x days from last sunday right formated for AWQL

function lynt_get_xdays_back_from_sunday(pocet_dni) {

var minule = new Date();

//kdyz je letni cas, tak o hodinu dele (GMT+1)

var offset = lynt_DST(minule,1);

minule.setTime(minule.getTime() - (1000 * 60 * 60 * (24) * pocet_dni) - (1000 * 60 * 60 * 24 * (minule.getDay()))+ offset);

return lynt_format_awql_date(minule);

}

//Format date for AWQL

function lynt_format_awql_date(datum){

return datum.getUTCFullYear()+("0"+(datum.getUTCMonth()+1)).slice(-2)+("0"+datum.getUTCDate()).slice(-2);

}

Comments

Martin Tomanek says

14 června, 2016 at 7:25 pm

Perfektní skript! Díky

Odpovědět
Petr Slavík says

13 července, 2016 at 8:20 pm

Děkuji za skript, hodně mi pomohl! A pomůže 😉

Odpovědět
Lukáš Kolovrat says

18 července, 2016 at 10:43 am

Také moc děkuji.
Skvělá práce.

Odpovědět
David says

8 února, 2017 at 8:16 pm

Zdravím, vyhodilo mi to chybu…niečo som zle nastavil? Dakujem
Invalid reporting query: KEYWORDS_PERFORMANCE_REPORT. (line 20)

Odpovědět
- Jakub says
  
  8 února, 2017 at 8:37 pm
  
  Tak je někde problém ve zkopírování skriptu, je nutné vložit na začátek URL adresu sešitu do řádky 2 do uvozovek, ale jinak to jede, teď jsem to schválně otestoval. Zkusit znovu skript zkopírovat z kódu.
  
  Odpovědět
  - Jan says
    
    19 července, 2018 at 4:58 pm
    
    Absolutne stejny problem. Fixnul to nekdo? Prekopirovaval jsem to snad 10x, stejna chybova hlaska.
    
    Odpovědět
Honza says

20 dubna, 2017 at 9:32 am

Jakube díky, funguje skvěle. Ve videu ukazuješ další listy – není tento někde ke stažení?

Odpovědět
Loopka says

16 května, 2017 at 12:32 pm

Ahoj, diki moc za super skript! Tiez by ma zaujimali tie zvysne sheets, ktore si prezentoval vo videu, ci to je iba workshopy?

Diki moc za odpoved

Odpovědět
CRITICAL says

5 června, 2017 at 12:43 pm

Tenhle skript nám moc pomohl. Díky!

Odpovědět
Matěj Konečný says

26 dubna, 2018 at 1:23 pm

Ahoj,

je možné dostat zápis QUERY pro „Špatná reklama“, „Špatná landing page“ a Špatné CTR u volné shody“ ?
Bohužel z nějakého důvodu mi nefungují početní funkce.

Děkuji moc

Odpovědět
Ľuboš Dubovec says

20 června, 2018 at 5:09 pm

Mne to tiež vypisuje danú chybu
Invalid reporting query: KEYWORDS_PERFORMANCE_REPORT. (line 20)
dal som 2 riadok do úvodzoviek a niekoľko krát som to skúsil prekopírovať a stále mi to nefunguje. Viete mi niekto poradiť ?

Odpovědět
webdesign studio designcrew says

4 července, 2018 at 11:57 pm

Díky za inspiraci a návod. Určitě využijeme pro naše klienty.

Odpovědět
Lukáš Kolovrat says

22 října, 2022 at 8:16 pm

Dobrý den,
Chystá aktualizace scriptu – zasazení do Nového prostředí Google Ads?
Neradi bychom v listopadu přestali script používat 🙁 Zkoušel jsem sám převést do nové syntaxe, ale bohužel se mi nedaří a script hlásí chyby.
Děkuji.

Odpovědět

Co s tím tedy můžeme dělat

Zdrojový kód skriptu

Reader Interactions

Comments

Napsat komentář Zrušit odpověď na komentář