Mit Google Ads-Scripts können Sie Bulk-Änderungen an Ihrem Konto vornehmen, indem Sie Daten im CSV-Format hochladen. Sie können Daten aus einer CSV-Datei aus Google Drive, einer Google-Tabelle oder einer Microsoft Excel-Tabelle hochladen oder bei der Laufzeit einen Bulk-Upload-Antrag in Ihrem Script erstellen. In diesem Leitfaden wird erläutert, wie Sie diese Funktion in Ihren Skripts verwenden.
Nutzung
Mit Bulk-Uploads können Sie bestimmte Änderungen vornehmen, die sonst nicht direkt von Google Ads-Scripts unterstützt werden, z. B. Kampagnen verwalten oder Offline-Conversions hochladen.
Bulk-Upload aus Google Drive erstellen
Die Funktion „Bulk-Upload“ lässt sich am einfachsten verwenden, indem Sie eine CSV-Datei in Google Drive und dann mithilfe von Google Ads-Scripts in Google Ads hochladen:
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 anzusehen.
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.
Wenn Sie sich sicher sind, dass Ihr Skript ordnungsgemäß funktioniert, können Sie die Vorschau überspringen und die Änderungen direkt über Ihr Skript anwenden. Dazu kann die Methode apply() der Instanz für den Bulk-Upload 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 Mikros verwenden möchten, können Sie die Option moneyInMicros beim Erstellen des Uploadjobs auf true setzen (z. B. 2, 34 € als 2340000 eingeben).
const upload = AdsApp.bulkUploads().newCsvUpload(columns,
{moneyInMicros: true});
Dateisprache festlegen
Standardmäßig wird der Inhalt der CSV-Datei in der Sprache „US-Englisch“ (en_US) interpretiert.
Mit der Option fileLocale können Sie ein anderes Gebietsschema angeben, wie unten gezeigt:
const upload = AdsApp.bulkUploads().newCsvUpload(columns,
{fileLocale: "fr_FR"});
Wenn Sie ein Gebietsschema angeben, können Sie die Spaltenüberschriften entweder im en_US-Gebietsschema oder im Gebietsschema angeben, das Sie in der fileLocale-Eigenschaft angeben.
Zeitzone festlegen
Standardmäßig werden die Zeitangaben in der Datei in der Zeitzone „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.
- Gehen Sie zu Tools und Einstellungen > BULK-AKTIONEN > Uploads.
- Klicken Sie auf die Schaltfläche +, um einen neuen Upload zu starten.
- Daraufhin wird ein Abschnitt mit einer Vielzahl von Vorlagen zur Auswahl angezeigt.
Sie können auch viele verschiedene Vorlagen in der Hilfe herunterladen.