Skrypty Google Ads umożliwiają zbiorcze wprowadzanie zmian na koncie przez przesłanie danych w formacie CSV. Dane możesz przesłać z pliku CSV z Dysku Google, arkusza kalkulacyjnego Google lub arkusza kalkulacyjnego programu Microsoft Excel albo utworzyć w skrypcie zbiorcze żądanie przesłania w czasie działania. Ten przewodnik wyjaśnia, jak używać tej funkcji w skryptach.
Wykorzystanie
Korzystając z przesyłania zbiorczego, możesz wprowadzać określone rodzaje zmian, które w przeciwnym razie nie byłyby obsługiwane bezpośrednio przez skrypty Google Ads, np. zarządzanie kampaniami lub 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 go 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 pozycji podglądu przesyłania zbiorczego w sekcji Narzędzia i ustawienia > ZBIORCZE DZIAŁANIA > Przesłane pliki.
Kliknij link Podgląd, aby wyświetlić zmiany.
Aby zastosować zmiany na koncie, na stronie szczegółów kliknij przycisk Zastosuj zmiany. Jeśli przesłany plik zawiera błędy lub jeśli nie chcesz wprowadzać zmian, kliknij przycisk Odrzuć podgląd, aby odrzucić zmiany.
Po sprawdzeniu, czy skrypt działa prawidłowo, możesz pominąć etap podglądu i zastosować zmiany bezpośrednio z poziomu skryptu. Można to zrobić, wywołując metodę apply() w instancji przesyłania zbiorczego zamiast metody preview().
Tworzenie przesyłania zbiorczego od podstaw
Zadanie przesyłania zbiorczego możesz utworzyć od podstaw w następujący sposób:
// 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 jednostkę pieniężną
Domyślnie kwoty przesyłane zbiorczo są interpretowane jako rzeczywista kwota w walucie. Jeśli wolisz używać wartości mikro, podczas tworzenia zadania przesyłania możesz ustawić opcję moneyInMicros na true (np.2, 34 EUR zostanie wpisane jako 2340 000).
const upload = AdsApp.bulkUploads().newCsvUpload(columns,
{moneyInMicros: true});
Ustaw język pliku
Domyślnie zawartość pliku CSV jest interpretowana w języku angielskim (USA).
Możesz określić inny język za pomocą opcji fileLocale, jak pokazano poniżej:
const upload = AdsApp.bulkUploads().newCsvUpload(columns,
{fileLocale: "fr_FR"});
Po określeniu języka możesz podać nagłówki kolumn w języku en_US lub w języku określonym we właściwości fileLocale.
Ustaw strefę czasową
Domyślnie wpisy czasu w pliku są interpretowane w atrybutach America/Los_Angeles. Inną strefę czasową możesz określić za pomocą opcji timeZone. Podaj 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
Najłatwiejszym sposobem pobrania szablonu arkusza kalkulacyjnego do przesyłania zbiorczego jest użycie interfejsu Google Ads.
- Zaloguj się na konto Google Ads.
- Kliknij Narzędzia i ustawienia > ZBIORCZE DZIAŁANIA > 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.