Przesyłanie zbiorcze

Skrypty Google Ads umożliwiają wprowadzanie zmian zbiorczych na koncie przez przesyłanie danych w formacie CSV. Możesz przesyłać dane z pliku CSV na Dysku Google, z arkusza kalkulacyjnego Google, z arkusza kalkulacyjnego Microsoft Excel lub tworzyć żądanie przesyłania zbiorczego w skrypcie w czasie działania. Z tego przewodnika dowiesz się, jak korzystać z tej funkcji w skryptach.

Wykorzystanie

Dzięki przesyłaniu zbiorczemu możesz wprowadzać pewne rodzaje zmian, które w inny sposób nie byłyby bezpośrednio obsługiwane przez skrypty Google Ads, np. zarządzać kampaniami lub przesyłać konwersje 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 szczegółów 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ężne w przesyłaniu zbiorczym są interpretowane jako rzeczywista kwota w danej walucie. Jeśli wolisz używać mikropieniędzy, 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 America/Los_Angeles. Możesz określić inną strefę czasową za pomocą opcji timeZone. Określ strefę czasową 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 pobranie go 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.

Wiele różnych szablonów możesz też pobrać z Centrum pomocy.