Zasoby

Zanim utworzysz kampanię Performance Max, musisz zaimportować wszystkie komponenty, których zamierzasz używać w kampanii. Zawsze możesz wrócić i dodać komponenty później, ale na początek potrzebujesz ich zestawu.

Podczas planowania kampanii zapoznaj się z komponentami i wymaganiami dotyczącymi komponentów w kampaniach Performance Max.

Komponenty tekstowe i komponenty z obrazem są głównymi wymaganymi typami komponentów, dlatego w tym przewodniku pokażemy, jak je przesyłać. Te zasady można też stosować do innych typów komponentów. Niezależnie od typu tworzonego komponentu użyj AssetOperation, aby go utworzyć.

Komponenty można tworzyć za pomocą AdsApp bez użycia mutate, ale dla zachowania spójności w tym przewodniku używamy tej samej metody co w przypadku wszystkich innych operacji. Pamiętaj, że jeśli masz już dostępne komponenty, możesz i powinnaś ich używać ponownie. Aby utworzyć kampanię Performance Max, musisz mieć komponenty, ale nie jest 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 komponentu, aby dodać go do grupy plików.

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

Komponenty z obrazem

Komponenty z obrazem są przesyłane w formacie zakodowanym przy użyciu Base64. Ponieważ nie możesz przesyłać obrazów bezpośrednio do skryptów Google Ads, 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ż programowo pobrać serię plików 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())
      }
    }
  }
}
operations.push(imageAsset);

Możesz też pobrać obraz hostowany na serwerze WWW za pomocą jego adresu URL, używając 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.