Przesyłanie zbiorcze

Skrypty Google Ads umożliwiają zbiorcze wprowadzanie zmian na koncie przez przesłanie danych w formacie CSV. Możesz przesłać dane z pliku CSV z Dysku Google, arkusza kalkulacyjnego Google lub arkusza programu Microsoft Excel albo utworzyć prośbę o przesyłanie zbiorcze w skrypcie w czasie wykonywania. Z tego przewodnika dowiesz się, jak używać tej funkcji w skryptach.

Wykorzystanie

Za pomocą przesyłania zbiorczego możesz wprowadzać pewne zmiany, które nie są obsługiwane bezpośrednio przez skrypty Google Ads, np. zarządzać kampaniami lub przesyłać konwersje offline.

Tworzenie zbiorczego przesyłania z Dysku Google

Najprostszym sposobem korzystania z funkcji przesyłania zbiorczego jest przesłanie pliku CSV na Dysk Google, a potem 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 zbiorczego przesyłania 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, aby odrzucić zmiany.

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

Tworzenie przesyłania zbiorczego od podstaw

Aby utworzyć zadanie przesyłania zbiorczego od podstaw:

// 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();

Ustaw walutę

Domyślnie kwoty w pliku zbiorczym są interpretowane jako rzeczywiste kwoty w walucie. Jeśli wolisz używać mikrosów, podczas tworzenia zadania przesyłania możesz ustawić opcję moneyInMicros na true (np.2, 34 zł będzie wpisane 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 (en_US). Możesz określić inny region za pomocą opcji fileLocale, jak pokazano poniżej:

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

Po określeniu ustawień regionalnych nagłówki kolumn możesz podać w ustawieniach regionalnych en_US lub w ustawieniach regionalnych określonych w przypadku właściwości fileLocale.

Ustaw strefę czasową

Domyślnie wpisy czasu w pliku są interpretowane jako strefa America/Los_Angeles. Możesz użyć opcji timeZone, aby określić inną strefę czasową. 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ąć przesyłanie, kliknij przycisk +.
• Następnie pojawi się sekcja z różnymi szablonami do wyboru.

Możesz też pobrać wiele różnych szablonów z Centrum pomocy.