Zasoby

Przed utworzeniem kampanii Performance Max musisz zaimportować wszystkie komponenty, których chcesz w niej używać. Zawsze możesz wrócić i dodać komponenty później, ale aby zacząć, musisz mieć zestaw komponentów.

Podczas planowania kampanii Performance Max zapoznaj się z informacjami o komponentach i wymaganiach dotyczących komponentów.

Komponenty tekstowe i komponenty z obrazem to główne wymagane typy komponentów, dlatego w tym przewodniku pokażemy, jak przesyłać każdy z nich. Te zasady można też stosować w przypadku innych typów komponentów. Niezależnie od tego, jaki typ komponentu tworzysz, użyj AssetOperation, aby go utworzyć.

Komponenty można tworzyć za pomocą funkcji AdsApp bez użycia mutacji, ale dla zachowania spójności w tym przewodniku robimy to w taki sam sposób jak w przypadku wszystkich pozostałych operacji. Pamiętaj, że możesz i powinieneś ponownie wykorzystać istniejące komponenty, jeśli są dostępne. Aby utworzyć kampanię Performance Max, musisz mieć komponenty, ale nie jest bezwzględnie konieczne, aby tworzyć je w ramach procesu tworzenia kampanii.

Komponenty tekstowe

Komponenty tekstowe działają tak samo jak inne operacje. Jeśli przesyłasz komponenty w ramach procesu tworzenia kampanii, użyj tymczasowego identyfikatora. W przeciwnym razie zanotuj zwróconą nazwę zasobu, aby użyć jej w przyszłej operacji, gdy będziesz musiał odwołać się do zasobu, aby dodać go do grupy plików.

const textAsset = {
  "assetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/assets/${getNextTempId()}`,
      "textAsset": {
        "text": "Travel the World"
      }
    }
  }
}
operations.push(textAsset);

Zasoby graficzne

Komponenty z obrazem są przesyłane w formacie zakodowanym przy użyciu Base64. Nie możesz przesyłać obrazów bezpośrednio do skryptów Google Ads, dlatego masz do wyboru 2 różne sposoby uzyskiwania danych obrazu i kodowania ich na potrzeby przesyłania.

Aby pobrać obraz z Dysku Google, musisz najpierw uzyskać jego identyfikator, który jest najlepszym sposobem na jednoznaczne zidentyfikowanie obrazu. Jednym ze sposobów uzyskania identyfikatora jest skopiowanie linku do udostępniania z interfejsu Dysku Google i wyodrębnienie identyfikatora. Możesz też pobrać serię plików programowo i wybrać te, które chcesz przesłać. Ten kod pokazuje, jak przesłać pojedynczy obraz o znanym identyfikatorze:

const file = DriveApp.getFileById(fileId);
const imageAsset =  {
  "assetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/assets/${getNextTempId()}`,
      "name": "Marketing Logo",
      "type": "IMAGE",
      "imageAsset": {
        "data": Utilities.base64Encode(file.getBlob().getBytes())
      }
    }
  }
}

Możesz też pobrać obraz hostowany na serwerze WWW, podając jego adres URL, za pomocą tego kodu: UrlFetchApp

const file = UrlFetchApp.fetch(imageUrl);

Następnie możesz wywołać getBlob w tym pliku tak samo jak w przypadku pliku na Dysku, więc konstrukcja operacji jest identyczna z krokami dotyczącymi pliku na Dysku Google.