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 nicht direkt von Google Ads-Scripts unterstützt werden, z. B. Kampagnen verwalten oder Offline-Conversions hochladen.
Bulk-Upload aus Google Drive erstellen
Am einfachsten verwenden Sie die Bulk-Upload-Funktion, indem Sie eine CSV-Datei in Google Drive hochladen und diese Datei dann mit 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 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.
Wenn Sie überprüft haben, dass Ihr Script richtig funktioniert, können Sie die Vorschauphase überspringen und die Änderungen direkt über das Script übernehmen. Dazu rufen Sie die Methode apply() der Bulk-Upload-Instanz anstelle der Methode preview() 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 beim Erstellen des Upload-Jobs die Option moneyInMicros auf true festlegen.Beispiel: 2, 34 € würden 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 ein anderes Gebietsschema angeben:
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 Zeiteinträge 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"});
Das Festlegen einer Zeitzone kann beim Hochladen von Offline-Conversions hilfreich sein.
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 Bereich mit verschiedenen Vorlagen angezeigt, aus denen Sie auswählen können.
Viele verschiedene Vorlagen können Sie auch in der Hilfe herunterladen.