Kampanie Performance Max korzystające z AdsApp

Scenariusze Google Ads umożliwiają częściowe zarządzanie kampaniami Performance Max. Za pomocą skryptów możesz pobierać kampanie Performance Max, zarządzać grupami komponentów i uruchamiać raporty. Nie możesz jednak używać skryptów do tworzenia kampanii Performance Max. Aby dowiedzieć się więcej o zaawansowanych operacjach, przeczytaj dalszą część tego przewodnika, w której omawiamy bardziej ogólne podejście z użyciem funkcji mutate.

Pobieranie kampanii Performance Max

Kampanie Performance Max są dostępne w kolekcjach 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ą widocznych grup reklam ani obiektów reklamy. W przypadku innych kampanii wszystkie kwestie związane z tymi elementami są obsługiwane automatycznie na podstawie ustawionych przez Ciebie grup komponentów.

Komponenty i grupy komponentów

Reklamy z kampanii Performance Max korzystają z komponentów takich jak filmy, obrazy, nagłówki i teksty reklamy – przesłane przez Ciebie lub wygenerowane automatycznie. Pełny przegląd wymaganych komponentów znajdziesz w przewodniku po komponentach Performance Max w interfejsie Google Ads API.

Komponenty w kampaniach Performance Max są grupowane w grupy komponentów, a każda kampania Performance Max musi mieć co najmniej 1 grupę komponentów. Nie możesz tworzyć tych grup komponentów bezpośrednio w skryptach, ale możesz dodawać i usuwać komponenty z dotychczasowej grupy komponentów.

Dodawanie komponentu 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 komponentó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');

Pamiętaj, że w ostatnim kroku musisz określić typ zasobu. Pełną listę typów komponentów znajdziesz w dokumentacji interfejsu Google Ads API.

Aby użyć istniejącego komponentu, najpierw utwórz selektor komponentu:

const assetSelector = AdsApp.adAssets().assets();

Następnie użyj filtra withCondition, aby zawęzić listę do zasobów, z którymi chcesz pracować. Pełną listę opcji filtrowania znajdziesz w dokumentacji AssetSelector.

Na koniec pobierz iterator i wykonaj iterację jak w przypadku innych jednostek:

const assetIterator = assetSelector.get();

for (const asset of assetIterator) {
   ...
}

Komponenty tekstowe

Zasoby tekstowe działają nieco inaczej, ponieważ nie musisz ich tworzyć z wyprzedzeniem. Wystarczy, że zamiast zasobu podasz tekst, a system automatycznie go utworzy. Jeśli tekst jest identyczny z tekstem istniejącego komponentu tekstowego, zostanie on ponownie użyty.

Oto przykład tworzenia komponentu nagłówka:

assetGroup.addAsset('asset text here', 'HEADLINE');

Usuwanie komponentu z grupy komponentów

Możesz też usunąć komponent z grupy komponentów, ale pamiętaj, że aby kampania była prawidłowa, musisz mieć minimalną liczbę komponentów określonych typów.

Aby usunąć zasób dodany w poprzednim przykładzie:

assetGroup.removeAsset(imageAsset, 'MARKETING_IMAGE');

Listę komponentów w danej grupie komponentów możesz też uzyskać 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, np. asset.type lub asset.text_asset.text, aby jeszcze bardziej doprecyzować wyniki. Aby utworzyć własne zapytanie, użyj Kreatora zapytań do tego typu raportu.

Gdy masz już zasób docelowy, wywołaj funkcję remove w grupie komponentów, aby usunąć z niej komponent:

// Let's assume at least one asset is returned. We'll just remove the first
// asset, whatever it is. In your code, customize this to choose the right asset.
const row_info = results.next().asset;
assetGroup.remove(row_info.asset.resource_name, row_info.asset_group_asset.field_type);