Mit Google Ads-Skripts können Sie Bulk-Änderungen an Ihrem Konto vornehmen, indem Sie Daten im CSV-Format hochladen. Sie können Daten aus einer CSV-Datei von Google Drive, einer Google-Tabelle oder einer Microsoft Excel-Tabelle hochladen oder in Ihrem Skript zur Laufzeit eine Bulk-Upload-Anfrage erstellen. In diesem Leitfaden wird erläutert, wie Sie diese Funktion in Ihren Skripts verwenden können.
Nutzung
Mit Bulk-Uploads können Sie bestimmte Änderungen vornehmen, die von Google Ads-Skripts sonst nicht direkt unterstützt werden würden. Dazu gehören z. B. die Verwaltung von Kampagnen oder das Hochladen von Offline-Conversions.
Bulk-Upload aus Google Drive erstellen
Die einfachste Möglichkeit, die Bulk-Upload-Funktion zu nutzen, besteht darin, eine CSV-Datei in Google Drive hochzuladen und diese Datei dann mithilfe von Google Ads-Skripts in Google Ads hochzuladen:
const file = DriveApp.getFilesByName("BulkCampaignUpload.csv")
.next();
const upload = AdsApp.bulkUploads().newFileUpload(file);
upload.forCampaignManagement();
upload.preview();
Dadurch wird in Ihrem Konto unter Tools und Einstellungen > BULK-AKTIONEN > Uploads ein Vorschaueintrag für den Bulk-Upload erstellt.
Klicken Sie auf den Link Vorschau, um die Änderungen zu sehen.
Klicken Sie auf der Detailseite auf die Schaltfläche Änderungen anwenden, wenn Sie die Änderungen in Ihr Konto übernehmen möchten. Wenn die hochgeladene Datei Fehler enthält oder Sie die Änderungen nicht vornehmen möchten, klicken Sie auf die Schaltfläche Vorschau verwerfen, um die Änderungen zu verwerfen.
Nachdem Sie sich vergewissert haben, dass Ihr Skript korrekt funktioniert, können Sie die Vorschauphase überspringen und die Änderungen direkt über Ihr Skript anwenden. Dazu kann die Methode apply() der Bulk-Upload-Instanz anstelle der Methode preview() aufgerufen werden.
Bulk-Uploads komplett neu erstellen
Sie können einen Bulk-Upload-Job wie folgt komplett neu erstellen:
// 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();
Geldeinheit festlegen
Standardmäßig werden die Geldbeträge in Bulk-Uploads als tatsächlicher Währungsbetrag interpretiert. Wenn Sie lieber Mikroeinheiten verwenden möchten, können Sie die Option moneyInMicros beim Erstellen des Uploadjobs auf true setzen (z. B. wird 2, 34 € als 2.340.000 eingegeben).
const upload = AdsApp.bulkUploads().newCsvUpload(columns,
{moneyInMicros: true});
Dateisprache festlegen
Standardmäßig wird der Inhalt der CSV-Datei in US-Englisch (en_US) interpretiert.
Mit der Option fileLocale können Sie eine andere Sprache angeben:
const upload = AdsApp.bulkUploads().newCsvUpload(columns,
{fileLocale: "fr_FR"});
Wenn Sie eine Sprache angeben, können Sie die Spaltenüberschriften entweder in der Sprache en_US oder in der Sprache angeben, die Sie in der Eigenschaft fileLocale angeben.
Zeitzone festlegen
Standardmäßig werden die Zeiteinträge in der Datei in America/Los_Angeles interpretiert. Mit der Option timeZone können Sie eine andere Zeitzone angeben. Geben Sie die Zeitzone im Format der Zeitzonendatenbank an.
const upload = AdsApp.bulkUploads().newCsvUpload(columns,
{timeZone: "America/New_York"});
Es kann besonders nützlich sein, eine Zeitzone festzulegen, wenn Sie Offline-Conversions hochladen.
Tabellenvorlagen für Bulk-Uploads
Die Google Ads-Benutzeroberfläche bietet die einfachste Möglichkeit, eine Tabellenvorlage für einen Bulk-Upload zu erhalten.
- Melden Sie sich in Ihrem Google Ads-Konto an.
- Rufen Sie Tools und Einstellungen > BULK-AKTIONEN > Uploads auf.
- Klicken Sie auf die Schaltfläche +, um einen neuen Upload zu starten.
- Daraufhin wird ein Bereich mit einer Vielzahl von Vorlagen angezeigt.
Außerdem können Sie in der Hilfe viele verschiedene Vorlagen herunterladen.