Mit Google Ads-Skripts können Sie Bulk-Änderungen an Ihrem Konto vornehmen, indem Sie Daten im CSV-Format hochladen. Die CSV-Daten können aus Google Drive, einer Google-Tabelle oder einer Microsoft Excel-Tabelle stammen. Sie können aber auch in Ihrem Skript zur Laufzeit eine Bulk-Upload-Anforderung erstellen. In dieser Anleitung wird gezeigt, wie Sie dies in Ihren Skripts realisieren.
Nutzung
Mit Bulk-Uploads können Sie bestimmte Arten von Änderungen vornehmen, die sonst von Google Ads-Skripts nicht direkt unterstützt werden, z. B. Kampagnen verwalten oder Offline-Conversions hochladen.
Bulk-Upload aus Google Drive erstellen
Am einfachsten verwenden Sie die Funktion für Bulk-Uploads, indem Sie eine CSV-Datei in Google Drive hochladen und diese Datei mit Google Ads-Skripts 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 Eintrag für die Vorschau des Bulk-Uploads 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.
Sobald Sie überprüft haben, dass Ihr Skript ordnungsgemäß funktioniert, können Sie die Vorschauphase überspringen und die Änderungen direkt über Ihr Skript anwenden. Dazu rufen Sie die
Methode
apply()
der Bulk-Upload-Instanz anstelle der
preview()
Methode auf.
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 Mikros verwenden möchten, können Sie die Option moneyInMicros beim Erstellen des Upload-Jobs auf true setzen.So werden beispielsweise 2, 34 € als 2340000 eingegeben.
const upload = AdsApp.bulkUploads().newCsvUpload(columns,
{moneyInMicros: true});
Dateisprache festlegen
Standardmäßig werden die Inhalte 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 en_US oder in der Sprache angeben, die Sie in der Eigenschaft fileLocale festlegen.
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
Am einfachsten erhalten Sie eine Tabellenvorlage für einen Bulk-Upload über die Google Ads-Benutzeroberfläche.
- Melden Sie sich an in Ihrem Google Ads-Konto.
- Gehen Sie zu Tools und Einstellungen > BULK-AKTIONEN > Uploads.
- Klicken Sie auf die Schaltfläche + , um einen neuen Upload zu starten.
- Daraufhin wird ein Bereich mit verschiedenen Vorlagen angezeigt.
Viele weitere Vorlagen können Sie auch in der Google Ads-Hilfe herunterladen.