First-Party-Daten in AMC hochladen: Ablauf, Hashing und Consent-Signale

Was ADU ist

Der Advertiser Data Upload (ADU, auf der Amazon Ads API auch ADU 2.0 genannt) lädt frei definierbare Datensätze in eine AMC-Instanz. Beispiele von Amazon: Off-Amazon-Conversions, Filialbesuche und Käufe im Geschäft, zusätzliche Produktmetadaten, CRM-Zielgruppensegmente und Mapping-Tabellen. Datensätze mit unterstützten Kennungen lassen sich mit AMC-Daten verknüpfen, um Off-Amazon-Ereignisse Impressionen und Klicks zuzurechnen.

Daten, die mit ADU 1.0 hochgeladen wurden, lassen sich nicht mehr abfragen. Um sie weiter zu nutzen, löschen Sie die alten Daten und laden sie mit ADU 2.0 neu hoch.

Voraussetzungen

• Die AMC-Nutzungsbedingungen müssen in der Oberfläche akzeptiert sein, sonst antworten alle API-Aufrufe mit Fehler 401.
• Zugang zur AMC-API auf der Amazon Ads API. ADU gibt es nur über die API. Ihre Zugangsdaten brauchen die Scopes Campaign Management und Data Provider.
• Ein AWS-Konto mit der Berechtigung, einen S3-Bucket für die Upload-Dateien anzulegen.

Daten vorbereiten

• Formate: CSV (UTF-8, beliebiges Trennzeichen), JSON (ein Objekt je Zeile, kein umschließendes Objekt oder Array) und Parquet.
• Kompression: BZIP, GZIP, ZIP, SNAPPY oder keine (NONE). Dateien über 1 GB sollten Sie aufteilen, weil das Lesen sonst scheitern kann.
• Fact-Datensätze speichern Zeitreihen (Ereignisse) und brauchen eine TIMESTAMP- oder DATE-Spalte; Dimension-Datensätze speichern statische Tabellen wie eine Kundenliste. Ist eine Spalte als mainEventTime markiert, ist der Datensatz ein Fact-Datensatz.
• Zeitstempel müssen in UTC im Format yyyy-MM-ddThh:mm:ssZ vorliegen, Datumswerte als yyyy-MM-dd.
• Die Partitionierung (period) steuert, wie fein Sie abfragen können: PT1H stündlich, P1D täglich (Standard), P1M monatlich.

Persönliche Kennungen: standardisieren und hashen

Dateien mit personenbezogenen Daten wie E-Mail-Adressen oder Telefonnummern müssen vor dem Upload standardisiert und mit SHA-256 gehasht werden. Standardisieren heißt, Rohwerte in ein einheitliches Format zu bringen, etwa alles in Kleinbuchstaben; bei Telefonnummern und Adressen gelten weitere Regeln, die Amazon nur Nutzern der Ads Console zeigt.

Für Spalten mit MAID, Experian, Kantar, LiveRamp, Merkle, Neustar, RealId (Acxiom) oder SambaTV führen Sie weder Standardisierung noch Hashing durch. Enthält ein Datensatz Roh-Kennungen, wird der Upload abgelehnt.

Consent für UK und EWR

• Wer personenbezogene Daten für Amazon-Werbung im Vereinigten Königreich und im EWR übermittelt, muss ein gültiges Consent-Signal und den Ländercode der Einwilligung mitliefern.
• Zulässig sind das IAB Transparency & Consent Framework (TCF), das Global Privacy Protocol (GPP) oder das Amazon Consent Signal (ACS). Senden Sie nicht mehrere: Bei mehreren nutzt Amazon TCF und ignoriert ACS.
• Der Ländercode ist ein zweistelliger Code nach ISO 3166 (zum Beispiel DE). Daten ohne Ländercode werden abgelehnt.
• Beim ACS gibt amzn_user_data den Wert GRANTED oder DENIED an. AMC respektiert die Einwilligung und weist Datensätze bei verweigerter Einwilligung zurück.

Das ist Amazons technische Vorgabe und keine Rechtsberatung. Ob Ihre Einwilligungen für den Zweck tragen, klären Sie mit Datenschutzbeauftragten oder Rechtsberatung.

Schritt für Schritt

1. Daten vorbereiten. Format, Kompression, Fact oder Dimension, Datentypen und Hashing der Kennungen festlegen.
2. S3-Bucket einrichten. Einen S3-Bucket für die Upload-Dateien anlegen und konfigurieren.
3. Datensatz anlegen. Mit der Dataset-API einen neuen Datensatz definieren.
4. Daten hochladen. Mit der Upload-API Daten in den Datensatz laden.
5. Spalten ändern. Bei Bedarf Spalten über die Data-Set-Column-API anpassen.

Häufige Fragen