Winkelverkoopgegevens moeten correct zijn opgemaakt en voldoen aan ons beleid voor klantgegevens. Dit artikel geeft richtlijnen voor de opmaak van uw gegevensbestand voor de winkelverkoop.
In dit artikel
- Uw winkelverkoopgegevens toevoegen
- Uw bestand met winkelverkoopgegevens opmaken
- Uw kolomkoppen aanpassen
- Informatie over de richtlijnen voor opmaak van transactiegegevens van klanten
Voordat u begint
Zet uw gegevens in een Excel-, csv- of Google Spreadsheets-bestand. Gebruik deze templates als u hulp nodig heeft bij de instelling van uw gegevens:
Algemene opmaakrichtlijnen
- Hash de namen, e-mailadressen en telefoonnummers van uw klanten in uw winkelverkoopgegevens om de transactiegegevens van uw klanten veilig te houden. U kunt de informatie zelf hashen of Google Ads uw winkelverkoopgegevens laten hashen met het SHA-256-algoritme (de branchenorm voor eenrichtingshashing).
- Houd er rekening mee dat er limieten gelden voor de bestandsgrootte en dat die ertoe kunnen leiden dat uw bestand niet wordt geüpload.
- Eenmalige upload rechtstreeks naar uw Google Ads-account:
- 150 MB: Alleen voor handmatig naar Google Ads geüploade csv-bestanden, met naar schatting 300.000 rijen met transacties.
- 50 MB: Voor alle andere indelingen, waaronder csv-bestanden die op basis van een planning worden geüpload, met naar schatting 100.000 rijen met transacties.
- Als u uploadt met de Google Ads API: 1.000.000 rijen transacties per uploadtaak. Gebruik OfflineUserDataJob om de taak te maken en voeg transacties toe met de methode AddOfflineUserDataJobs. Voor optimale verwerking doet u dit in batches van 10.000 rijen per keer. U kunt meerdere uploadtaken tegelijk maken om sneller rijen in te dienen voor verwerking.
Opmerking: Als u een partner voor uw winkelverkoopgegevens gebruikt, kunt u contact opnemen met die partner om te informeren naar hun limieten voor het uploaden van deze gegevens.
- Eenmalige upload rechtstreeks naar uw Google Ads-account:
Als u technische vragen over de Google Ads API heeft (bijvoorbeeld vragen over het gebruik van de API of SDK, of fouten die u krijgt via de API of SDK), volgt u de stappen voor probleemoplossing op de pagina Technische support voor API's.
Als u vragen over de Google Ads API heeft die over de UI van Google Ads gaan, klikt u onderaan de pagina op Contact.
Richtlijnen voor de opmaak van kolomkoppen
U heeft verplicht 2 koprijen nodig in uw gegevensbestand voor de winkelverkoop: een rij om metadata te uploaden en een rij met kolomnamen voor klanttransacties.
Metadata uploaden
De eerste rij bevat de metadata van de upload.
Opmerking: Als u de functie voor vrije variabelen gebruikt, maakt u de kolomkop in deze rij zo op:
Parameters:TimeZone=<insert_TZ>;LoyaltyRate=<insert_rate>;TransactionUploadRate=<insert_rate>;CustomVariable=<insert_name>
De vrije variabele moet actief zijn om deze te gebruiken.
Tussen de haakjes voegt u de gevraagde informatie voor elke parameter toe:
- De waarden voor LoyaltyRate en TransactionUploadRate moeten zijn ingesteld op 1.
Metadata van klanttransacties
In de 2e rij staat informatie over de klanttransacties die u wilt uploaden, zoals e-mailadressen, telefoonnummers en namen. Dit zijn de kolomkoppen die u kunt toevoegen aan de tweede rij voor informatie over klanttransacties:
- First Name
- Last Name
- City
- State
- Zip
- Country
- Phone Number
- Conversion Name (vereist)
- Conversion Time (vereist)
- Conversion Value (vereist)
- Conversion Currency (vereist)
- Ad User Data (als u gegevens over winkelverkopen gebruikt met Klantenmatch voor gebruikers in de EER)
- Ad Personalization (als u gegevens over winkelverkopen gebruikt met Klantenmatch voor gebruikers in de EER)
In het volgende gedeelte staat hoe u uw winkelverkoopgegevens opmaakt.
Richtlijnen voor gegevensopmaak
De transactiegegevens van de klant die u opgeeft, moeten correct zijn opgemaakt, zodat Google Ads de gegevens kan uploaden. Bepaalde klanttransactiegegevens moeten worden gehasht met het SHA-256-algoritme, waaronder:
- E-mailadressen van klanten
- Telefoonnummers van klanten
- De voor- en achternaam van klanten
Andere transactiegegevens van de klant, zoals het land waar de klant woont, postcodes en kenmerkgegevens, hoeven niet te worden gehasht.
Download om te beginnen de Excel-, csv- of Google Spreadsheets-template en geef de transactiegegevens van de klant op. Als u bepaalde klanttransactiegegevens niet kunt hashen, gebruikt u de csv-template. Google Ads hasht automatisch alle gegevens die moeten worden gehasht als u de ingevulde csv-template uploadt.
Vouw het gedeelte hieronder uit om de richtlijnen voor elke kolom in de template te bekijken. De kolomnamen moeten exact overeenkomen met de namen in de template.
Time zone (tijdzone)- Neem deze op in de 1e rij als alle tijden van conversie in dezelfde tijdzone vallen.
- Als de tijden van conversies in verschillende tijdzones vallen, voegt u de tijdzone voor elke tijd van een conversie toe in de kolom Conversion Time. Neem de instructies en de tabel in het gedeelte Conversion Time in dit artikel door.
- Als u in de eerste rij en de kolom Conversion Time een tijdzone opgeeft, wordt er bij de upload eerst gekeken naar de kolom Conversion Time en daarna naar de tijdzone in de eerste rij als een conversie geen tijdzone heeft.
- Geef uw tijdzone-ID op volgens deze lijst om fouten te vermijden tijdens de zomertijd.
- Geef de afwijking van de Greenwich Mean Time (GMT) op met + of -, gevolgd door het tijdsverschil in 4 cijfers (voor GMT geeft u +0000 op).
Voorbeeld:
- America/New_York-0500
- Europe/Berlin+0100
- Het percentage van de totale verkoop in uw gegevensbestand dat u aan een klant kunt koppelen.
- We raden u aan deze waarde op 1 te laten staan.
- Op dit moment heeft de waarde van uw percentage geüploade transacties geen invloed op de rapportage over winkelverkopen. We raden u aan alle klantgerelateerde verkopen te uploaden en het percentage geüploade transacties in te stellen op 1.
Voorbeeld:
- 0,5
- 0,2
- 0,8
- Geef voor alle e-mailadressen een domeinnaam op, zoals gmail.com of hotmail.co.jp.
- Verwijder eventuele spaties tussen de e-mailadressen.
- Gebruik alleen kleine letters.
- U kunt maximaal 3 e-mailadressen per klant opgeven, in 3 aparte Email-kolommen.
Voorbeeld:
- user1@gmail.com
- user2@yahoo.com
- Gebruik alleen kleine letters.
- Accenten zijn toegestaan.
- Verwijder overbodige spaties voor, na en tussen de namen.
Voorbeeld:
- tom
- renée
- marie-astrid
- Gebruik alleen kleine letters.
- Accenten zijn toegestaan.
- Verwijder overbodige spaties voor, na en tussen de namen.
Voorbeeld:
- gupta
- o'calloway
- cox-cohen
- mcdonnell
- Gebruik alleen kleine letters.
- Accenten zijn toegestaan.
Voorbeeld:
- san francisco
- new york city
- parijs
- münchen
- Gebruik alleen kleine letters.
- Uitzondering: de 2-letterige afgekorte namen voor Amerikaanse staten.
Voorbeeld:
- CA
- californië
- new york
- maharashtra
- Amerikaanse postcodes en internationale postcodes zijn toegestaan.
- Voor de VS:
- Postcodes van 5 cijfers zijn toegestaan.
- Ook postcodes van 5 cijfers gevolgd door een 4-cijferige toevoeging zijn toegestaan. Gebruik van deze codes kan uw overeenkomstpercentage verhogen.
- Voor alle andere landen:
- Gebruik geen toevoegingen voor postcodes.
Voorbeeld:
- 94109
- 94109-1234
- W1J 0BH
- Gebruik een 2-letterige landcode in overeenstemming met de ISO-norm.
- Neem altijd een landcode op, zelfs als al uw klantgegevens betrekking hebben op hetzelfde land.
Voorbeeld:
- US
- DE
- FR
- AU
- JP
- Telefoonnummers moeten worden genoteerd volgens de E.164-norm. Ze moeten het volgende bevatten: het voorvoegsel +, vervolgens de landcode en daarna het abonneenummer. Dit kan eventueel een nationale bestemmingscode of een netnummer bevatten.
- U kunt maximaal 3 telefoonnummers per klant opgeven, in 3 aparte Phone Number-kolommen.
Voorbeeld:
- +12038271234
- +442071838750
- De naam van de conversieactie die u wilt importeren.
- Deze moet qua spelling en hoofdlettergebruik overeenkomen met de conversieactie in uw Google Ads-account.
Voorbeeld:
- SS_customer_signups
- SS_customer_purchases
- Gebruik een geaccepteerde datumnotatie. Zie de tabel hieronder.
- Als u een tijdzone aan de tijd van conversie wilt toevoegen, gebruikt u een van de laatste 4 notaties in de onderstaande tabel.
- Vervang hierbij +z door het aantal uren verschil met GMT. U geeft dit aan met + of - en het tijdsverschil in 4 cijfers.
- U kunt ook zzzz vervangen door de tijdzone-ID.
Indeling | Voorbeelden |
MM/dd/jjjj uu:mm:ss aa | "08/14/2020 5:01:54 PM" |
MMM dd,jjjj uu:mm:ss aa | "Aug 14, 2020 5:01:54 PM" |
MM/dd/jjjj UU:mm:ss | "08/14/2020 17:01:54" |
jjjj-MM-dd UU:mm:ss | "2020-08-14 13:00:00" |
jjjj-MM-ddTUU:mm:ss | "2020-08-14T13:00:00" |
jjjj-MM-dd UU:mm:ss+z | "2020-08-14 13:00:00+0500" |
jjjj-MM-ddTUU:mm:ss+z | "2020-08-14T13:00:00-0100" |
jjjj-MM-dd UU:mm:ss zzzz | "2020-08-14 13:00:00 America/Los_Angeles" |
jjjj-MM-ddTUU:mm:ss zzzz | "2020-08-14T13:00:00 America/Los_Angeles" |
- Een getal voor de waarde die u aan de conversie toekent.
- Alleen positieve getallen worden geaccepteerd.
- De valuta waarin uw conversiewaarde wordt opgegeven.
- Gebruik deze kolom als u conversiewaarden rapporteert in meerdere valuta of als u meerdere klantaccounts heeft die in verschillende valuta's worden gefactureerd.
- Gebruik ISO 4217-valutacodes van 3 tekens.
Voorbeeld:
- USD
- JPY
- EUR
- De variabelewaarden die aan de vrije variabele zijn gekoppeld, worden in de parameterrij vermeld.
- De variabelewaarden die zijn opgegeven in het uploadbestand, moeten overeenkomen met de variabelewaarden die zijn gedefinieerd in uw Google Ads-account.
- Gebruik deze kolom als u vrije variabelen gebruikt en een vrije variabele heeft vermeld in de parameters.
- Gebruik deze kolom om variabelewaarden op te geven voor elke transactie.
- Als er transacties worden geüpload met een variabelewaarde die niet overeenkomt met de gedefinieerde waarde in het Google Ads-account, worden conversies van de winkelverkoop voor deze transacties gerapporteerd met 'uncategorized' als variabelewaarde.
Voorbeeld:
- Vrije variabele: Klanttype
- Variabelewaarden: Nieuw of Terugkerend
- Vrije variabele: Productcategorie
- Variabelewaarden: Jassen, Schoenen, Sportkleding of Overig
- Toestemmingssignalen doorgeven voor gebruikers in de EER voor advertentiemetingsdoeleinden.
- Vereist als u Klantenmatch gebruikt met gegevens over winkelverkopen.
Mogelijke waarden:
- Granted (Verleend): Er is toestemming verleend om gegevens te gebruiken.
- Denied (Geweigerd): Er is geen toestemming gegeven om de gegevens te gebruiken.
- Unspecified (Niet gespecificeerd): De toestemming is niet aangegeven.
Voorbeeld:
- Granted (Toegewezen)
- Denied (Geweigerd)
- Toestemmingssignalen doorgeven voor gebruikers in de EER voor advertentiepersonalisatie.
- Vereist als u Klantenmatch gebruikt met gegevens over winkelverkopen.
Mogelijke waarden:
- Granted (Verleend): Er is toestemming verleend om gegevens te gebruiken.
- Denied (Geweigerd): Er is geen toestemming gegeven om de gegevens te gebruiken.
- Unspecified (Niet gespecificeerd): De toestemming is niet aangegeven.
Voorbeeld:
- Granted (Toegewezen)
- Denied (Geweigerd)