Часто, при роботі з рекламними кампаніями по контекстній рекламі, доводиться стикатися з ситуацією включення / вимикання груп оголошень (ключових слів, оголошень) за наявністю товару на сайті. Звичайно, якщо у Вас на веденні невеликий інтернет-магазин (до 50 товарів), то цей момент можна відстежувати і вручну здійснювати зазначені дії. Але що робити, коли у Вас на сайті 1000 або 10000 товарів?     На перевірку наявності кожного з них буде витрачатися величезна кількість часу і, по-суті, вся робота ppc-шника буде зводиться до цілодобового відстеження наявності. Цей час можна витратити на виконання цікавіших, важливих і потрібних завдань.

Вихід з цієї ситуації був запропонований на сайті FreeAdWordsScripts.com (приклад скрипта, опис функцій і змін – за посиланням). Для окремих випадків можна використовувати скрипти, які включають / відключають оголошення, ставлять на паузу групи оголошень за наявністю товарів на сайті. Суть в тому, що даний скрипт парсить сторінки сайту за зазначеними посиланнями в оголошеннях на наявність зазначених Вами в скрипті кусків html які відображають наявність / відсутність товару.

          Мал.1 – товар в наявності

          Мал.2 – товару немає у наявності

А що робити в ситуаціях, коли посилання встановлені на рівні ключових слів і немає можливості відстежувати наявность товарів по кожному з них?

Для цього випадку за основу використовувався скрипт з FreeAdWordsScripts.com перероблений для перевірки посилань на рівні ключових слів і включенню / зупинці безпосередньо самих ключових по наявності / відсутності товарів на сайті.

/************************************

* Item Out Of Stock Checker

***********************************/

var URL_LEVEL = ‘Keyword’;

var ONLY_ACTIVE = false; // set to false for all ads or keywords

var CAMPAIGN_LABEL = ‘указываем_установленный_на кампании_ярлык; // set this if you want to only check campaigns with this label

var STRIP_QUERY_STRING = true; // set this to false if the stuff that comes after the question mark is important

var WRAPPED_URLS = true; // set this to true if you use a 3rd party like Marin or Kenshoo for managing you account

// This is the specific text to search for

// on the page that indicates the item

// is out of stock.

var OUT_OF_STOCK_TEXT = ‘текст_нет_в_наличииt’;

function main() {

 var alreadyCheckedUrls = {};

 var iter = buildSelector().get();

 while(iter.hasNext()) {

   var entity = iter.next();

                if(entity.urls().getFinalUrl()){

                                var url = cleanUrl(entity.urls().getFinalUrl(), entity);

                                if(alreadyCheckedUrls[url]) {

                                 if(alreadyCheckedUrls[url] === ‘out of stock’) {

                                                entity.pause();

                                 } else {

                                                entity.enable();

                                 }

                                } else {

                                 var htmlCode;

                                 try {

                                                htmlCode = UrlFetchApp.fetch(url).getContentText();

                                 } catch(e) {

                                                Logger.log(‘There was an issue checking:’+url+’, Skipping.’);

                                                continue;

                                 }

                                 if(htmlCode.indexOf(OUT_OF_STOCK_TEXT) >= 0) {

                                                alreadyCheckedUrls[url] = ‘out of stock’;

                                                entity.pause();

                                 } else {

                                                alreadyCheckedUrls[url] = ‘in stock’;

                                                entity.enable();

                                 }

                                }

                                Logger.log(‘Url: ‘+url+’ is ‘+alreadyCheckedUrls[url]);

                }

 }

}

function cleanUrl(url, entity) {

 if (url) {

                 if(WRAPPED_URLS) {

                                url = url.substr(url.lastIndexOf(‘http’));

                                if(decodeURIComponent(url) !== url) {

                                 url = decodeURIComponent(url);

                                }

                 }

                 if(STRIP_QUERY_STRING) {

                                if(url.indexOf(‘?’)>=0) {

                                 url = url.split(‘?’)[0];

                                }

                 }

                 if(url.indexOf(‘{‘) >= 0) {

                                //Let’s remove the value track parameters

                                url = url.replace(/\{[0-9a-zA-Z]+\}/g,”);

                 }

                }

                else Logger.log(‘Что-то пошло не так, в урле нулл: ‘+url+’ ‘+ entity.getCampaign.getName+ ‘ -> ‘ +entity.getAdGroup.getName);

 return url;

}

function buildSelector() {

 //var selector = (URL_LEVEL === ‘Keyword’) ? AdWordsApp.ads() : AdWordsApp.keywords();

 var selector = (URL_LEVEL === ‘Keyword’) ? AdWordsApp.keywords() : AdWordsApp.ads();

 selector = selector.withCondition(‘CampaignStatus != DELETED’).withCondition(‘AdGroupStatus != DELETED’);

 if(ONLY_ACTIVE) {

   selector = selector.withCondition(‘CampaignStatus = ENABLED’).withCondition(‘Status = ENABLED’);

   if(URL_LEVEL !== ‘Keyword’) {

     selector = selector.withCondition(‘AdGroupStatus = ENABLED’);

   }

 }

 if(CAMPAIGN_LABEL) {

   var label = AdWordsApp.labels().withCondition(“Name = ‘”+CAMPAIGN_LABEL+”‘”).get().next();

   var campIter = label.campaigns().get();

   var campaignNames = [];

   while(campIter.hasNext()) {

     campaignNames.push(campIter.next().getName());

   }

   selector = selector.withCondition(“CampaignName IN [‘”+campaignNames.join(“‘,'”)+”‘]”);

 }

 return selector;

}

Важливо для роботи скрипта:

1. Обов’язково ставимо ярлик на кампанію і прописуємо його в скрипті, щоб вказати, яку саме кампанію скрипт повинен перевіряти.
2. Обов’язково прописуємо html-параметр наявності товару, а не текст «немає в наявності».
3. Кількість ключових слів, що містять посилання, необхідно обмежувати досвідченим шляхом, тому що час роботи скрипта, встановлене AdWords, не повинен перевищувати 30 хвилин (на практиці вдалося отримати трохи більше 3500 ключових слів з посиланнями).
4. Всі номери повинні бути робочими. Наявність битих посилань в рази підвищує час роботи скрипта, і Ви можете не вкластися у відведений час.
5. Обов’язково задаємо розклад роботи скрипта, щоб нам не довелося кожен раз запускати його вручну.

Багато рекламодавців стикаються з тим, що рекламні кампанії працюють на протязі доби, і, відповідно, витрачають бюджет цілодобово, при цьому конверсії (продажі, дзвінки) зазвичай припадають на певні години, тоді як в інший час доби спостерігається повна їх відсутність. Можна використовувати вбудований  розклад Google Ads, але існує обмеження, на кількість тимчасових інтервалів в розкладі (не більше 6 інтервалів в день).

Вирішення цього питання розробила команда BrainLabs.
Все що потрібно – це скрипт, таблиця в Google Sheets і дані з Вашої системи аналітики.

Етап перший – підготовка даних з Google Analytics.

Для прикладу використовуємо дані з по eCommerce проекту, конкретно – кількість транзакцій, з прив’язкою до днів тижня (вибірка для прикладу бралася за 3 місяці).
Створюємо користувальницький звіт, де в метриках вибираємо коефіцієнт транзакцій (Ecommerce Conversion Rate) сесії (щоб уникнути порожніх рядків і пропущених значень в подальшому), в параметрах – дні тижня. Додаємо фільтр по каналу AdWords.

В отриманому звіті, як вторинний параметр вибираємо «Годинник» і експортуємо в Excel. З даних в вивантаженні, створюємо зведену таблицю, в якій рядки – це годинник, стовпці – дні тижня, значення – коефіцієнт транзакцій. Для візуальної наочності можна використовувати умовне форматування.

При такому поданні стає видно, коли рекламні кампанії контекстної реклами ефективні, а коли – ні.
Наступний крок – перетворимо дані в таблиці. Для цього – копіюємо зведену таблицю на новий лист і дублюємо там-же. В клітинках значень однієї з таблиць, на Ваш розсуд, вираховуємо відхилення коефіцієнта конверсії в заданий час щодо середнього значення для цього часу доби (вираховується при створенні зведеної таблиці). Для наочності використовуємо умовне форматування.

Наступний крок – використання скрипта і розкладу від BrainLabs.
Суть роботи скрипта полягає в наступному:

1. В Google таблицях створюється розклад аналогічний вивантаженню наведеному вище.
2. Для завдання коригувань можемо використовувати отриману вище таблицю. Варто враховувати, що максимально допустимий коефіцієнт коригування для AdWords: 900% на підвищення (+ 300% для мобільних) і -100% на зниження, тобто якщо ми вкажемо коригування -100% – реклама буде зупинена. При вказівці коригування 300%, при обраної нами ставки за клік в 1 $, після застосування розкладу, максимальна ставка за клік буде 3 $.

3. Коефіцієнти, звичайно, варто підправити під свою РК. Підсумкова таблиця буде мати такий вигляд:

4. Додаємо сам скрипт, наведений нижче, до облікового запису AdWords.

1. /*
2. *
3. * Advanced ad scheduling
4. *
5. * This script will apply ad schedules to campaigns or shopping campaigns and set the
6. * ad schedule bid modifier and mobile bid modifier at each hour according to
7. * multiplier timetables in a Google sheet.
8. *
9. * Version: 2.0
10. * brainlabsdigital.com
11. *
12. */
14. function main() {
15. //~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~//
16. //~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~//
17. //Options
19. //The Google sheet to use
20. //The default value is the example sheet linked to in the article
21. var spreadsheetUrl = “https://docs.google.com/a/brainlabsdigital.com/spreadsheets/d/1JDGBPs2qyGdHd94BRZw9lE9JFtoTaB2AmlL7xcmLx2g/edit#gid=0”;
23. //Shopping or regular campaigns
24. //Use true if you want to run script on shopping campaigns (not regular campaigns).
25. //Use false for regular campaigns.
26. var shoppingCampaigns = false;
28. //Use true if you want to set mobile bid adjustments as well as ad schedules.
29. //Use false to just set ad schedules.
30. var runMobileBids = true;
32. //Optional parameters for filtering campaign names. The matching is case insensitive.
33. //Select which campaigns to exclude e.g [“foo”, “bar”] will ignore all campaigns
34. //whose name contains ‘foo’ or ‘bar’. Leave blank [] to not exclude any campaigns.
35. var excludeCampaignNameContains = [];
37. //Select which campaigns to include e.g [“foo”, “bar”] will include only campaigns
38. //whose name contains ‘foo’ or ‘bar’. Leave blank [] to include all campaigns.
39. var includeCampaignNameContains = [];
41. //When you want to stop running the ad scheduling for good, set the lastRun
42. //variable to true to remove all ad schedules and mobile bid modifiers.
43. var lastRun = false;
45. //~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~//
46. //~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~//
48. //Initialise for use later.
49. var weekDays = [“MONDAY”, “TUESDAY”, “WEDNESDAY”, “THURSDAY”, “FRIDAY”, “SATURDAY”, “SUNDAY”];
50. var adScheduleCodes = [];
51. var campaignIds = [];
53. //Retrieving up hourly data
54. var scheduleRange = “B2:H25”;
55. var accountName = AdWordsApp.currentAccount().getName();
56. var spreadsheet = SpreadsheetApp.openByUrl(spreadsheetUrl);
57. var sheets = spreadsheet.getSheets();
59. var timeZone = AdWordsApp.currentAccount().getTimeZone();
60. var date = new Date();
61. var dayOfWeek = parseInt(Utilities.formatDate(date, timeZone, “uu”), 10) – 1;
62. var hour = parseInt(Utilities.formatDate(date, timeZone, “HH”), 10);
64. var sheet = sheets[0];
65. var data = sheet.getRange(scheduleRange).getValues();
67. //This hour’s bid multiplier.
68. var thisHourMultiplier = data[hour][dayOfWeek];
69. var lastHourCell = “I2”;
70. getRange(lastHourCell).setValue(thisHourMultiplier);
72. //The next few hours’ multipliers
73. var timesAndModifiers = [];
74. for (var h=0; h<4; h++) {
75. var newHour = (hour + h)%24;
76. if (hour + h > 23) {
77. var newDay = (dayOfWeek + 1)%7;
78. } else {
79. var newDay = dayOfWeek;
80. }
81. var bidModifier = data[newHour][newDay];
82. if (isNaN(bidModifier) || (bidModifier < -0.9 && bidModifier > -1) || bidModifier > 9) {
83. log(“Bid modifier ‘” + bidModifier + “‘ for ” + weekDays[newDay] + ” ” + newHour + ” is not valid.”);
84. push([newHour, weekDays[newDay], 0]);
85. } else if (bidModifier != -1 && bidModifier.length != 0) {
86. push([newHour, weekDays[newDay], bidModifier]);
87. }
88. }
90. if (timesAndModifiers.length === 0){
91. // If there are no modifiers then the campaigns should not be running for the next few hours.
92. // If we just removed all schedules, then ads would start running (with no modifier)
93. // so an arbitrary ad schedule is created (scheduled for yesterday so it does not affect anything).
94. push([0,weekDays[(dayOfWeek+6)%7],0.0]);
95. }
98. //Pull a list of all relevant campaign IDs in the account.
99. var campaignSelector = ConstructIterator(shoppingCampaigns)
100. for(var i = 0; i < excludeCampaignNameContains.length; i++){
101. campaignSelector = campaignSelector.withCondition(‘Name DOES_NOT_CONTAIN_IGNORE_CASE “‘ + excludeCampaignNameContains[i] + ‘”‘);
102. }
103. var campaignIterator = campaignSelector.get();
104. while(campaignIterator.hasNext()){
105. var campaign = campaignIterator.next();
106. var campaignName = campaign.getName();
107. var includeCampaign = false;
108. if(includeCampaignNameContains.length === 0){
109. includeCampaign = true;
110. }
111. for(var i = 0; i < includeCampaignNameContains.length; i++){
112. var index = campaignName.toLowerCase().indexOf(includeCampaignNameContains[i].toLowerCase());
113. if(index !== -1){
114. includeCampaign = true;
115. break;
116. }
117. }
118. if(includeCampaign){
119. var campaignId = campaign.getId();
120. push(campaignId);
121. }
122. }
124. //Return if there are no campaigns.
125. if(campaignIds.length === 0){
126. log(“There are no campaigns matching your criteria.”);
127. return;
128. }
130. //Remove all ad scheduling and mobile bid adjustments for the last run.
131. if(lastRun){
132. checkAndRemoveAdSchedules(campaignIds, []);
133. ModifyMobileBidAdjustment(campaignIds, 0);
134. return;
135. }
137. // Change the mobile bid adjustment
138. if(runMobileBids){
139. if (sheets.length < 2) {
140. log(“Mobile ad schedule sheet was not found in the Google spreadsheet.”);
141. } else {
142. var sheet = sheets[1];
143. var data = sheet.getRange(scheduleRange).getValues();
144. var thisHourMultiplier_Mobile = data[hour][dayOfWeek];
146. if (thisHourMultiplier_Mobile.length === 0) {
147. thisHourMultiplier_Mobile = -1;
148. }
150. if (isNaN(thisHourMultiplier_Mobile) || (thisHourMultiplier_Mobile < -0.9 && thisHourMultiplier_Mobile > -1) || thisHourMultiplier_Mobile > 3) {
151. log(“Mobile bid modifier ‘” + thisHourMultiplier_Mobile + “‘ for ” + weekDays[dayOfWeek] + ” ” + hour + ” is not valid.”);
152. thisHourMultiplier_Mobile = 0;
153. }
155. if(thisHourMultiplier === “”){
156. var totalMultiplier = “”;
157. }
158. else if(thisHourMultiplier == -1 || thisHourMultiplier_Mobile == -1){
159. var totalMultiplier = -1;
160. }
161. else{
162. var totalMultiplier = (1+thisHourMultiplier_Mobile)*(1+thisHourMultiplier) -1;
163. }
164. getRange(“I2”).setValue(thisHourMultiplier_Mobile);
165. getRange(“T2”).setValue(totalMultiplier);
166. ModifyMobileBidAdjustment(campaignIds, thisHourMultiplier_Mobile);
167. }
168. }
170. // Check the existing ad schedules, removing those no longer necessary
171. var existingSchedules = checkAndRemoveAdSchedules(campaignIds, timesAndModifiers);
173. // Add in the new ad schedules
174. AddHourlyAdSchedules(campaignIds, timesAndModifiers, existingSchedules, shoppingCampaigns);
176. }
179. /**
180. * Function to add ad schedules for the campaigns with the given IDs, unless the schedules are
181. * referenced in the existingSchedules array. The scheduling will be added as a hour long periods
182. * as specified in the passed parameter array and will be given the specified bid modifier.
183. *
184. * @param array campaignIds array of campaign IDs to add ad schedules to
185. * @param array timesAndModifiers the array of [hour, day, bid modifier] for which to add ad scheduling
186. * @param array existingSchedules array of strings identifying already existing schedules.
187. * @param bool shoppingCampaigns using shopping campaigns?
188. * @return void
189. */
190. function AddHourlyAdSchedules(campaignIds, timesAndModifiers, existingSchedules, shoppingCampaigns){
191. // times = [[hour,day],[hour,day]]
192. var campaignIterator = ConstructIterator(shoppingCampaigns)
193. .withIds(campaignIds)
194. .get();
195. while(campaignIterator.hasNext()){
196. var campaign = campaignIterator.next();
197. for(var i = 0; i < timesAndModifiers.length; i++){
198. if (existingSchedules.indexOf(
199. timesAndModifiers[i][0] + “|” + (timesAndModifiers[i][0]+1) + “|” + timesAndModifiers[i][1]
200. + “|” + Utilities.formatString(“%.2f”,(timesAndModifiers[i][2]+1)) + “|” + campaign.getId())
201. > -1) {
203. continue;
204. }
206. addAdSchedule({
207. dayOfWeek: timesAndModifiers[i][1],
208. startHour: timesAndModifiers[i][0],
209. startMinute: 0,
210. endHour: timesAndModifiers[i][0]+1,
211. endMinute: 0,
212. bidModifier: 1+timesAndModifiers[i][2]
213. });
214. }
215. }
216. }
219. /**
220. * Function to remove ad schedules from all campaigns referenced in the passed array
221. * which do not correspond to schedules specified in the passed timesAndModifiers array.
222. *
223. * @param array campaignIds array of campaign IDs to remove ad scheduling from
224. * @param array timesAndModifiers array of [hour, day, bid modifier] of the wanted schedules
225. * @return array existingWantedSchedules array of strings identifying the existing undeleted schedules
226. */
227. function checkAndRemoveAdSchedules(campaignIds, timesAndModifiers) {
229. var adScheduleIds = [];
231. var report = AdWordsApp.report(
232. ‘SELECT CampaignId, Id ‘ +
233. ‘FROM CAMPAIGN_AD_SCHEDULE_TARGET_REPORT ‘ +
234. ‘WHERE CampaignId IN [“‘ + campaignIds.join(‘”,”‘) + ‘”]’
235. );
237. var rows = report.rows();
238. while(rows.hasNext()){
239. var row = rows.next();
240. var adScheduleId = row[‘Id’];
241. var campaignId = row[‘CampaignId’];
242. push([campaignId,adScheduleId]);
243. }
245. var chunkedArray = [];
246. var chunkSize = 10000;
248. for(var i = 0; i < adScheduleIds.length; i += chunkSize){
249. push(adScheduleIds.slice(i, i + chunkSize));
250. }
252. var wantedSchedules = [];
253. var existingWantedSchedules = [];
255. for (var j=0; j<timesAndModifiers.length; j++) {
256. push(timesAndModifiers[j][0] + “|” + (timesAndModifiers[j][0]+1) + “|” + timesAndModifiers[j][1] + “|” + Utilities.formatString(“%.2f”,timesAndModifiers[j][2]+1));
257. }
259. for(var i = 0; i < chunkedArray.length; i++){
260. var unwantedSchedules = [];
262. var adScheduleIterator = AdWordsApp.targeting()
263. .adSchedules()
264. .withIds(chunkedArray[i])
265. .get();
266. while (adScheduleIterator.hasNext()) {
267. var adSchedule = adScheduleIterator.next();
268. var key = adSchedule.getStartHour() + “|” + adSchedule.getEndHour() + “|” + adSchedule.getDayOfWeek() + “|” + Utilities.formatString(“%.2f”,adSchedule.getBidModifier());
270. if (wantedSchedules.indexOf(key) > -1) {
271. push(key + “|” + adSchedule.getCampaign().getId());
272. } else {
273. push(adSchedule);
274. }
275. }
277. for(var j = 0; j < unwantedSchedules.length; j++){
278. unwantedSchedules[j].remove();
279. }
280. }
282. return existingWantedSchedules;
283. }
286. /**
287. * Function to construct an iterator for shopping campaigns or regular campaigns.
288. *
289. * @param bool shoppingCampaigns Using shopping campaigns?
290. * @return AdWords iterator Returns the corresponding AdWords iterator
291. */
292. function ConstructIterator(shoppingCampaigns){
293. if(shoppingCampaigns === true){
294. return AdWordsApp.shoppingCampaigns();
295. }
296. else{
297. return AdWordsApp.campaigns();
298. }
299. }
302. /**
303. * Function to set a mobile bid modifier for a set of campaigns
304. *
305. * @param array campaignIds An array of the campaign IDs to be affected
306. * @param Float bidModifier The multiplicative mobile bid modifier
307. * @return void
308. */
309. function ModifyMobileBidAdjustment(campaignIds, bidModifier){
311. var platformIds = [];
313. for(var i = 0; i < campaignIds.length; i++){
314. push([campaignIds[i],30001]);
315. }
317. var platformIterator = AdWordsApp.targeting()
318. .platforms()
319. .withIds(platformIds)
320. .get();
321. while (platformIterator.hasNext()) {
322. var platform = platformIterator.next();
323. setBidModifier(1+bidModifier);
324. }
325. }

Що потрібно знати користувачеві про скрипт Google Ads?

Рядок 21 – вказуємо посилання на нашу Google таблицю з розкладом.

Рядок 26 – вказуємо, чи буде розклад працювати для товарних кампаній або ж для пошукових.

Рядок 30 – використовуємо додатковий розклад для мобільних пристроїв (другий лист в прикладі).

Рядок 35 – вказуємо кампанії для яких не плануємо використовувати скрипт.

Рядок 39 – вказуємо кампанії для яких плануємо використовувати розклад.

Рядок 43 – коли слід зупинити роботу скрипта розкладу.

Важливо: Для всіх кампаній, в яких буде використовуватися скрипт – будуть видалені всі розклади показу.

• Якщо у нас в розкладі задана є порожня клітинка – це сприймається, як коригування -100%.
• Скрипт використовує часовий пояс вашого облікового запису AdWords.
• Максимальне коригування ставки + 900% (для мобільних обмеження на + 300%), мінімальне – -100%.

У статті використані матеріали з ресурсів searchengineland.com і liraltd.com.