Skrypt Google Ads: PMax Search Terms Alert

Skrypt Google Ads PMax Search Terms Alert umożliwia analizowanie kampanii Performance Max pod kątem konkretnych wyszukiwanych haseł, takich jak te związane z marką lub konkurencją.

Skrypt automatycznie wysyła wiadomość e-mail, gdy znajdzie kampanie wyświetlające reklamy PMax dla określonych słów kluczowych. Wiadomość zawiera wszystkie dostępne obecnie metryki związane z wyszukiwanymi frazami w tym typie kampanii: liczba kliknięć, liczba wyświetleń, liczba konwersji oraz wartość tych konwersji.

To narzędzie pozwala podejmować działania optymalizacyjne. Przykładowym podejściem może być dodanie nazwy marki jako słowa wykluczającego lub utworzenie kilku kampanii PMax (z różnymi wykluczeniami lub bez nich) w celu dalszej analizy wyników dla każdej z tych konfiguracji.

Rozwiązanie wykorzystuje najnowszą wersję API (08.2023) oraz dostępne dane w zakładce „Statystyki wyszukiwanych haseł” w interfejsie kampanii Performance Max.

Konfiguracja:
1. Wstaw szukane słowo kluczowe do zmiennej UNWANTED_SEARCH_TERMS
Możemy dodać nieskończoną ilość wyrazów.
Każdy powinien być w cudzysłowie i oddzielony przecinkiem.

2. Nazwę etykiety wstaw do zmiennej: CAMPAIGN_LABEL
3. Oznacz etykietą wybrane kampanie Performance Max

Harmonogram: raz dziennie

---

Po więcej na temat Skryptów zapraszam na grupę FB:
https://www.facebook.com/groups/zaawansowane.google.ads

---

/*

Copyright 2023 Krzysztof Bycina, www.LiveAds.pl
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.

*/


// --------------------------------------- Configuration:
const UNWANTED_SEARCH_TERMS = ["ENTER YOUR KEYWORD HERE e.g. BRAND NAME"];
const CAMPAIGN_LABEL = "ENTER YOUR LABEL HERE";
const EMAIL = "ENTER YOUR E-MAIL HERE";
// --------------------------------------- End of the configuration

function main() {
  const campaigns = fetchCampaigns();
  const matches = [];
  
  campaigns.forEach(campaign => {
    const id = campaign.id;
    const name = campaign.name;
    
    const queries = retrieveQueries(id);
    const matchingRows = inspectCampaign(queries, name);
    
    if (matchingRows.length > 0) {
      matches.push({
        campaignName: name,
        matchingRows: matchingRows
      });
    }
  });
  
  if (matches.length > 0) {
    notifyByEmail(matches);
  }
}

function retrieveQueries(id) { 
  const query = AdsApp.report(`
    SELECT 
    campaign_search_term_insight.category_label,
    metrics.clicks, 
    metrics.impressions, 
    metrics.conversions,
    metrics.conversions_value
    FROM campaign_search_term_insight 
    WHERE 
    segments.date DURING LAST_30_DAYS 
    AND campaign_search_term_insight.campaign_id = '${id}'
    ORDER BY metrics.conversions
    `);
    
  return query;
}

function inspectCampaign(query, campaignName) {
  const data = [];
  const rows = query.rows();
  
  while (rows.hasNext()) {
    const row = rows.next();
    const rowData = {
      campaign_name: campaignName,
      category_label: row['campaign_search_term_insight.category_label'],
      clicks: row['metrics.clicks'],
      impressions: row['metrics.impressions'],
      conversions: row['metrics.conversions'],
      conversions_value: row['metrics.conversions_value']
    };
    
    data.push(rowData);
  }
  
  const matchingRows = data.filter(row => {
    return UNWANTED_SEARCH_TERMS.some(term => row.category_label.includes(term));
  });
  
  console.log("PMax campaigns with unwanted search terms: '" + campaignName + "':", matchingRows);
  return matchingRows;
}

function notifyByEmail(matches) {
  const subject = "PMax search terms alert summary.";
  let message = "PMax campaigns with unwanted search terms:\n\n";

  let totalClicks = 0;
  let totalImpressions = 0;
  let totalConversions = 0;
  let totalConversionsValue = 0;

  matches.forEach(match => {
    const campaignName = match.campaignName;
    const matchingRows = match.matchingRows;

    matchingRows.forEach(row => {
      const clicks = parseInt(row.clicks);
      const impressions = parseInt(row.impressions);

      totalClicks += clicks;
      totalImpressions += impressions;
      totalConversions += parseFloat(row.conversions);
      totalConversionsValue += parseFloat(row.conversions_value);

      message += "Campaign: " + campaignName + "\n\n";
      message += "Category Label: " + row.category_label + "\n";
      message += "Clicks: " + clicks + "\n";
      message += "Impressions: " + impressions + "\n";
      message += "Conversions: " + parseFloat(row.conversions).toFixed(2) + "\n";
      message += "Conversions Value: " + parseFloat(row.conversions_value).toFixed(2) + "\n\n";
    });

    message += "---------------------------------------------------\n\n";
  });

  totalConversions = totalConversions.toFixed(2);
  totalConversionsValue = totalConversionsValue.toFixed(2);

  message = `Total Clicks: ${totalClicks}\n`
           + `Total Impressions: ${totalImpressions}\n`
           + `Total Conversions: ${totalConversions}\n`
           + `Total Conversions Value: ${totalConversionsValue}\n\n` + message;

  MailApp.sendEmail(EMAIL, subject, message);
}

function fetchCampaigns() {
  const campaigns = [];
  const selector = AdsApp.performanceMaxCampaigns()
    .withCondition("LabelNames CONTAINS_ANY ['" + CAMPAIGN_LABEL + "']")
    .withCondition("Status = ENABLED")
    .forDateRange("TODAY");
    
  const iterator = selector.get();
  
  while (iterator.hasNext()) {
    const campaign = iterator.next();
    campaigns.push({ id: campaign.getId(), name: campaign.getName() });
  }
  
  return campaigns;
}