Verwenden Sie die Zuordnungen in den Tabellen, um ein conversions.batchinsert in der Campaign Manager 360 API dem entsprechenden IngestEventsRequest in der Data Manager API zuzuordnen.
Anfragefelder
conversions.batchinsert (Campaign Manager 360 API) |
IngestEventsRequest (Data Manager API) |
Hinweise |
|---|---|---|
profileId URL-Pfadparameter |
Kein Äquivalent | |
kind |
Kein Äquivalent | Metadatenfeld, das von der Data Manager API nicht verwendet wird. |
conversions |
events |
Erforderlich. Die Liste der Conversions oder Ereignisse. Weitere Informationen finden Sie im Abschnitt zu Conversion-Feldern. |
encryptionInfo |
Verschoben nach events.adIdentifiers.encryptedUserIds |
Auf Ereignisebene definiert. Die Verschlüsselungsinformationen für Campaign Manager 360 sind jetzt in jeder verschlüsselten Nutzer-ID angegeben. Weitere Informationen finden Sie im Abschnitt zu Conversion-Feldern. |
| Kein Äquivalent | encryptionInfo |
Die Verschlüsselungsinformationen auf Anfrageebene encryptionInfo beziehen sich auf verschlüsselte UserData-Nutzer-IDs. Weitere Informationen finden Sie unter Verschlüsselung. |
| Kein Äquivalent | destinations |
Erforderlich. Eine Liste von Destination-Objekten, die das Zielkonto und die Floodlight-Aktivität für die Ereignisse definieren. Weitere Informationen Ordnen Sie einzelne Felder zu, wie im Abschnitt „Conversion-Felder“ beschrieben. |
| Kein Äquivalent | consent |
Optionale Standardeinstellungen für die Einwilligung für Ereignisse in der Anfrage. Sie können diesen Wert für ein einzelnes Ereignis überschreiben, indem Sie das Feld consent von Event festlegen. |
| Kein Äquivalent | encoding |
Erforderlich, wenn Nutzer-IDs gesendet werden:Auf die Encoding für UserIdentifier-Werte festlegen. Wenn Sie keine Nutzer-IDs verwenden, wird dieses Feld ignoriert. |
| Kein Äquivalent | validateOnly |
Wenn „true“, wird die Anfrage validiert, aber nicht ausgeführt. |
Conversion-Felder
Conversion (Campaign Manager 360 API) |
Event (Data Manager API) |
Hinweise |
|---|---|---|
floodlightConfigurationId |
destinations[].operatingAccount.accountId |
Auf Anfrageebene definiert. Auf die Floodlight-Konfigurations-ID festgelegt. |
| Kein Äquivalent | destinations[].operatingAccount.accountType |
Auf Anfrageebene definiert. Setze dies auf FLOODLIGHT_CONFIG. |
floodlightActivityId |
destinations[].productDestinationId |
Auf Anfrageebene definiert. Auf die ID der Floodlight-Aktivität festgelegt. |
kind |
Kein Äquivalent | Metadatenfeld, das von der Data Manager API nicht verwendet wird. |
| Kein Äquivalent | destinations[].reference |
Auf Anfrageebene definiert. Eine benutzerdefinierte Kennung für das Ziel. Legen Sie dieses Feld fest, wenn Sie Ereignisse in einer einzelnen Anfrage an mehrere Ziele senden. |
adUserDataConsent |
consent.adUserData |
Weitere Informationen finden Sie unter Consent. |
nonPersonalizedAd |
consent.adPersonalization |
Weitere Informationen finden Sie unter Consent. |
| Kein Äquivalent | destinationReferences |
Wenn Sie Ereignisse in einer einzelnen Anfrage an mehrere Ziele senden, legen Sie dieses Feld auf die entsprechende reference des Ziels fest. |
timestampMicros |
eventTimestamp |
Weitere Informationen finden Sie unter Zeitstempelformat. |
value |
conversionValue |
|
quantity |
conversionCount |
|
ordinal |
Kein Äquivalent |
Das Feld ordinal aus der Campaign Manager 360 API ist in der Data Manager API nicht vorhanden.
Stattdessen werden in der Data Manager API transactionId verwendet, um Ereignisse zu deduplizieren, die an dieselbe Floodlight-Aktivitäts-ID gesendet werden.
In der Campaign Manager 360 API konnten Sie dafür sorgen, dass Ereignisse dedupliziert werden, indem Sie ordinal auf einen festen, konstanten Wert wie 1 festlegen. In der Data Manager API muss transactionId für jedes Ereignis auf einen eindeutigen Bezeichner festgelegt werden.
|
| Kein Äquivalent | transactionId |
In der Data Manager API wird eine Kombination aus Floodlight-Aktivitäts-ID und transactionId verwendet, um das Ereignis zu deduplizieren. Das Feld transactionId muss für jedes Ereignis auf eine eindeutige Kennung festgelegt werden.
Dieses Feld ist optional, wenn Sie Floodlight-Offline-Conversions senden. Weitere Informationen finden Sie unter Daten in Event-Objekte konvertieren.
|
customVariables |
customVariables |
Eine Liste von CustomVariable-Objekten. In der Data Manager API werden Strings als Schlüssel anstelle von Enums verwendet. Verwenden Sie für das Feld variable Schlüssel wie U1 und U2. |
limitAdTracking |
consent.adPersonalization |
Weitere Informationen finden Sie unter Consent. |
childDirectedTreatment |
consent.adPersonalization |
Weitere Informationen finden Sie unter Consent. |
treatmentForUnderage |
consent.adPersonalization |
Weitere Informationen finden Sie unter Consent. |
gclid |
adIdentifiers.gclid |
Weitere Informationen finden Sie unter AdIdentifiers. |
dclid |
adIdentifiers.dclid |
Weitere Informationen finden Sie unter AdIdentifiers. |
matchId |
adIdentifiers.matchId |
Weitere Informationen finden Sie unter AdIdentifiers. |
mobileDeviceId |
adIdentifiers.mobileId |
Weitere Informationen finden Sie unter AdIdentifiers. |
impressionId |
adIdentifiers.impressionId |
Weitere Informationen finden Sie unter AdIdentifiers. |
encryptedUserId |
adIdentifiers.encryptedUserIds |
Die Data Manager API unterstützt mehrere verschlüsselte Nutzer-IDs. Weitere Informationen finden Sie unter AdIdentifiers. |
encryptedUserIdCandidates |
adIdentifiers.encryptedUserIds |
Jede Kandidaten-ID wird einem EncryptedUserId-Objekt in der Liste zugeordnet. |
encryptionInfo.kind |
Kein Äquivalent | Metadatenfeld, das von der Data Manager API nicht verwendet wird. |
encryptionInfo.encryptionEntityType |
adIdentifiers.encryptedUserIds[].entityType |
Anstatt die Verschlüsselungsinformationen einmal pro Anfrage anzugeben, werden sie pro verschlüsselter User-ID angegeben. |
encryptionInfo.encryptionEntityId |
adIdentifiers.encryptedUserIds[].entityId |
Anstatt die Verschlüsselungsinformationen einmal pro Anfrage anzugeben, werden sie pro verschlüsselter User-ID angegeben. |
encryptionInfo.encryptionSource |
adIdentifiers.encryptedUserIds[].source |
Anstatt die Verschlüsselungsinformationen einmal pro Anfrage anzugeben, werden sie pro verschlüsselter User-ID angegeben. |
sessionAttributesEncoded |
adIdentifiers.sessionAttributes |
Weitere Informationen finden Sie unter AdIdentifiers. |
cartData |
cartData |
Weitere Informationen finden Sie unter Warenkorbdatenfelder. |
userIdentifiers |
userData.userIdentifiers |
Weitere Informationen finden Sie unter Felder für Nutzer-IDs. |
Felder für Nutzerkennungen
In der Data Manager API werden Nutzer-IDs in einem UserData-Objekt unter dem Feld userData des Event gruppiert. Das unterscheidet sich von der Campaign Manager 360 API, in der Kennungen direkt an das Conversion-Objekt angehängt werden.
UserIdentifier (Campaign Manager 360 API) |
UserIdentifier (Data Manager API) |
Hinweise |
|---|---|---|
hashedEmail |
emailAddress |
Auf die formatierte und gehashte E-Mail-Adresse festgelegt. Sie können die gehashte E‑Mail-Adresse auch verschlüsseln. |
hashedPhoneNumber |
phoneNumber |
Auf die formatierte und gehashte Telefonnummer festgelegt. Sie können die gehashte Telefonnummer auch verschlüsseln. |
addressInfo |
address |
Auf ein AddressInfo-Objekt festgelegt. Halten Sie sich an die Formatierungs- und Hashing-Richtlinien. Sie können auch die gehashten Attribute einer Adresse verschlüsseln. |
addressInfo.hashedFirstName |
address.givenName |
|
addressInfo.hashedLastName |
address.familyName |
|
addressInfo.countryCode |
address.regionCode |
|
addressInfo.postalCode |
address.postalCode |
|
addressInfo.city |
Kein Äquivalent | Wird in der aktuellen Version der Data Manager API nicht unterstützt. |
addressInfo.state |
Kein Äquivalent | Wird in der aktuellen Version der Data Manager API nicht unterstützt. |
addressInfo.hashedStreetAddress |
Kein Äquivalent | Wird in der aktuellen Version der Data Manager API nicht unterstützt. |
Felder für Warenkorbdaten
CartData (Campaign Manager 360 API) |
CartData (Data Manager API) |
Hinweise |
|---|---|---|
kind |
Kein Äquivalent | Metadatenfeld, das von der Data Manager API nicht verwendet wird. |
merchantId |
merchantId |
|
merchantFeedLabel |
merchantFeedLabel |
|
merchantFeedLanguage |
merchantFeedLanguageCode |
|
items |
items |
Eine Liste von Item-Objekten. Weitere Informationen finden Sie unter Artikelfelder. |
Artikelfelder für Warenkorbdaten
Item (Campaign Manager 360 API) |
Item (Data Manager API) |
Hinweise |
|---|---|---|
kind |
Kein Äquivalent | Metadatenfeld, das von der Data Manager API nicht verwendet wird. |
| Kein Äquivalent | itemId |
Optional. Eine eindeutige Kennung für das Element. |
itemId |
merchantProductId |
Erforderlich. Wird auf die Produkt-ID im Merchant Center für den Artikel festgelegt. |
quantity |
quantity |
Erforderlich. |
unitPrice |
unitPrice |
Erforderlich. |