Коригування ставок рекламних кампаній за часом доби в Google AdWords

Багато рекламодавців стикаються з тим, що рекламні кампанії працюють на протязі доби, і, відповідно, витрачають бюджет цілодобово, при цьому конверсії (продажі, дзвінки) зазвичай припадають на певні години, тоді як в інший час доби спостерігається повна їх відсутність. Можна використовувати вбудований  розклад AdWords, але існує обмеження, на кількість тимчасових інтервалів в розкладі (не більше 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. }

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

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

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

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

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

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

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

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

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

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