Przesyłanie zbiorcze

Skrypty Google Ads pozwalają zbiorczo wprowadzać zmiany na koncie, przesyłając dane w formacie CSV. Możesz przesłać dane z pliku CSV z Dysku Google, arkusza kalkulacyjnego Google, arkusza kalkulacyjnego Microsoft Excel lub utworzyć żądanie przesyłania zbiorczego w skrypcie w czasie działania. Z tego przewodnika dowiesz się, jak korzystać z tej funkcji w skryptach.

Wykorzystanie

Przesyłanie zbiorcze umożliwia wprowadzanie niektórych rodzajów zmian, które w inny sposób nie byłyby bezpośrednio obsługiwane przez skrypty Google Ads, np. zarządzanie kampaniami czy przesyłanie konwersji offline.

Tworzenie przesyłania zbiorczego z Dysku Google

Najprostszym sposobem korzystania z funkcji przesyłania zbiorczego jest przesłanie pliku CSV na Dysk Google, a następnie przesłanie tego pliku do Google Ads za pomocą skryptów Google Ads:

const file = DriveApp.getFilesByName("BulkCampaignUpload.csv")
    .next();
const upload = AdsApp.bulkUploads().newFileUpload(file);
upload.forCampaignManagement();
upload.preview();

Spowoduje to utworzenie na koncie wpisu podglądu przesyłania zbiorczego w sekcji Narzędzia i ustawienia > DZIAŁANIA ZBIORCZE > Przesłane pliki.

Aby wyświetlić zmiany, kliknij link Podgląd.

Aby zastosować zmiany na koncie, na stronie z informacjami kliknij przycisk Zastosuj zmiany. Jeśli przesłany plik zawiera błędy lub nie chcesz wprowadzać zmian, kliknij przycisk Odrzuć podgląd.

Gdy sprawdzisz, że skrypt działa prawidłowo, możesz pominąć etap podglądu i zastosować zmiany bezpośrednio ze skryptu. Możesz to zrobić, wywołując metodę apply() instancji przesyłania zbiorczego zamiast metody preview().

Tworzenie przesyłania zbiorczego od zera

Aby utworzyć zadanie przesyłania zbiorczego od zera:

// The best way to find column names is to consult a template
// as described in the last section of this guide.
const columns = [
   "Campaign", "Budget", "Bid Strategy type", "Campaign type"
];

const upload = AdsApp.bulkUploads().newCsvUpload(columns);

// Call append once for each row you'd like to upload
upload.append({
   "Campaign": "Test Campaign 1",
   "Budget": 2.34,
   "Bid Strategy type": "cpc",
   "Campaign type": "Search Only"
});
upload.forCampaignManagement();
upload.preview();

Ustawianie jednostki pieniężnej

Domyślnie kwoty pieniędzy w przesyłaniu zbiorczym są interpretowane jako rzeczywista kwota w danej walucie. Jeśli wolisz używać mikrojednostek, podczas tworzenia zadania przesyłania możesz ustawić opcję moneyInMicros na true (np.kwota 2, 34 EUR zostanie wpisana jako 2340000).

const upload = AdsApp.bulkUploads().newCsvUpload(columns,
    {moneyInMicros: true});

Ustawianie języka pliku

Domyślnie zawartość pliku CSV jest interpretowana w języku angielskim (Stany Zjednoczone) (en_US). Możesz określić inny język za pomocą opcji fileLocale:

const upload = AdsApp.bulkUploads().newCsvUpload(columns,
    {fileLocale: "fr_FR"});

Gdy określisz język, możesz podać nagłówki kolumn w języku en_US lub w języku określonym we właściwości fileLocale.

Ustawianie strefy czasowej

Domyślnie wpisy czasu w pliku są interpretowane w strefie czasowej America/Los_Angeles. Możesz określić inną strefę czasową za pomocą opcji timeZone. Strefę czasową należy podać w formacie bazy danych TZ.

const upload = AdsApp.bulkUploads().newCsvUpload(columns,
    {timeZone: "America/New_York"});

Ustawienie strefy czasowej może być przydatne podczas przesyłania konwersji offline.

Szablony arkuszy kalkulacyjnych do przesyłania zbiorczego

Najprostszym sposobem uzyskania szablonu arkusza kalkulacyjnego do przesyłania zbiorczego jest skorzystanie z interfejsu Google Ads.

  • Zaloguj się na konto Google Ads.
  • Kliknij Narzędzia i ustawienia > DZIAŁANIA ZBIORCZE > Przesłane pliki.
  • Aby rozpocząć nowe przesyłanie, kliknij przycisk +.
  • Pojawi się sekcja z różnymi szablonami do wyboru.

W Centrum pomocy możesz też pobrać wiele różnych szablonów z centrum pomocy.