Najlepszym sposobem zarządzania kampaniami Performance Max za pomocą skryptów Google Ads jest użycie strategii mutacji, która umożliwia bezpośrednie zarządzanie kampaniami Performance Max. Kampanie Performance Max można tworzyć tylko za pomocą funkcji mutate. Możesz jednak też używać innych obiektów AdsApp do pobierania kampanii Performance Max, zarządzania grupami plików i generowania raportów.
Pobieranie kampanii Performance Max
Kampanie Performance Max są dostępne w kolekcji performanceMaxCampaigns obiektu AdsApp. Możesz je pobrać w zwykły sposób:
const campaignName = "My Performance Max campaign";
const campaignIterator = AdsApp.performanceMaxCampaigns()
.withCondition(`campaign.name = "${campaignName}"`)
.get();
for (const campaign of campaignIterator) {
...
}
W przeciwieństwie do niektórych innych typów kampanii kampanie Performance Max nie mają grup reklam ani obiektów reklam, które można zobaczyć. Wszystko, co jest związane z tymi pojęciami w przypadku innych kampanii, jest obsługiwane automatycznie na podstawie ustawionych grup komponentów.
Komponenty i grupy plików
Reklamy z kampanii Performance Max wyświetlają się na podstawie komponentów, takich jak filmy, obrazy, nagłówki i teksty reklamy, które zostały przesłane przez Ciebie lub wygenerowane automatycznie. Pełne omówienie wymaganych rodzajów komponentów znajdziesz w przewodniku po komponentach w kampaniach Performance Max w interfejsie Google Ads API.
Komponenty w kampaniach Performance Max są łączone w grupy plików, a każda kampania Performance Max musi mieć co najmniej 1 grupę plików. Nie możesz tworzyć tych grup plików bezpośrednio w skryptach, ale możesz dodawać komponenty do dotychczasowej grupy plików i je z niej usuwać.
Dodaj komponent do grupy plików
Najpierw utwórz komponent:
const imageUrl = "http://www.example.com/example.png";
const imageBlob = UrlFetchApp.fetch(imageUrl).getBlob();
const assetOperation = AdsApp.adAssets().newImageAssetBuilder()
.withName("new asset name")
.withData(imageBlob)
.build();
const imageAsset = assetOperation.getResult();
Następnie dodaj utworzony komponent do istniejącej grupy plików:
// First, fetch the Performance Max campaign we want to operate on.
const campaignIterator = AdsApp.performanceMaxCampaigns()
.withCondition(`campaign.name = '${campaignName}'`)
.get();
let campaign;
if (campaignIterator.hasNext()) {
campaign = campaignIterator.next();
} else {
throw `No campaign found with name ${campaignName}.`
}
// Then, get that campaign's asset groups.
const assetGroupIterator = campaign.assetGroups().get();
// The campaign must have at least one asset group, so we can just assume so here.
const assetGroup = assetGroupIterator.next();
// Add the asset from the previous step.
assetGroup.addAsset(imageAsset, 'MARKETING_IMAGE');
Zwróć uwagę, że w ostatnim kroku musisz określić typ komponentu. Pełną listę typów komponentów znajdziesz w dokumentacji interfejsu Google Ads API.
Aby użyć istniejącego zasobu, najpierw utwórz selektor zasobów:
const assetSelector = AdsApp.adAssets().assets();
Następnie użyj filtra withCondition, aby zawęzić listę do zasobów, na których chcesz wykonać działanie. Pełną listę opcji filtrowania znajdziesz w AssetSelector.
Na koniec pobierz iterator i wykonaj iterację tak samo jak w przypadku innych elementów:
const assetIterator = assetSelector.get();
for (const asset of assetIterator) {
...
}
Komponenty tekstowe
Komponenty tekstowe działają nieco inaczej, ponieważ nie musisz ich tworzyć z wyprzedzeniem. Wystarczy, że zamiast komponentu podasz tekst, a system automatycznie utworzy komponent. Jeśli tekst jest dokładną kopią istniejącego komponentu tekstowego, zostanie użyty ten komponent.
Oto przykład tworzenia komponentu z nagłówkiem:
assetGroup.addAsset('asset text here', 'HEADLINE');
Usuwanie komponentu z grupy plików
Możesz też usunąć komponent z grupy plików, ale pamiętaj, że aby kampania była prawidłowa, każda grupa plików musi zawierać minimalną liczbę komponentów określonego rodzaju.
Oto jak usunąć komponent dodany w poprzednim przykładzie:
assetGroup.removeAsset(imageAsset, 'MARKETING_IMAGE');
Możesz też uzyskać listę komponentów w danej grupie komponentów za pomocą funkcji search:
// The resource name is a unique identifier for this asset group.
const assetGroupName = assetGroup.getResourceName();
results = AdsApp.search(
`SELECT asset.resource_name, asset_group_asset.field_type
FROM asset_group_asset
WHERE asset_group.resource_name = '${assetGroupName}'`
);
Spowoduje to wybranie nazwy zasobu jako jego unikalnego identyfikatora. Możesz też wybrać inne pola, takie jak asset.type lub asset.text_asset.text, aby jeszcze bardziej zawęzić wyniki. Aby utworzyć własne zapytanie, użyj kreatora zapytań dla tego typu raportu.
Gdy masz już docelowy komponent, wywołaj remove w grupie plików, aby usunąć z niej komponent:
// This example assumes at least one asset is returned. We'll remove the first
// asset, whatever it is. In your code, customize this to choose the right
// asset to be removed.
const row_info = results.next().asset;
assetGroup.remove(row_info.asset.resource_name, row_info.asset_group_asset.field_type);