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 Conversion-Felder. |
encryptionInfo |
Verschoben nach events.adIdentifiers.encryptedUserIds |
Auf Ereignisebene definiert. Die Campaign Manager 360-Verschlüsselungsinformationen werden jetzt in jeder verschlüsselten Nutzer-ID angegeben. Weitere Informationen finden Sie im Abschnitt Conversion-Felder. |
| Kein Äquivalent | encryptionInfo |
`encryptionInfo` auf Anfrageebene sind die Verschlüsselungsinformationen für verschlüsselte UserData-Nutzerkennungen.encryptionInfo 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 finden Sie im Leitfaden zu Zielen. Ordnen Sie einzelne Felder wie im Abschnitt Conversion-Felder gezeigt zu. |
| 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 Nutzerkennungen gesendet werden: Legen Sie die Encoding fest, die für UserIdentifier Werte verwendet wird. Wenn Sie keine Nutzerkennungen 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. Legen Sie die Floodlight-Konfigurations-ID fest. |
| Kein Äquivalent | destinations[].operatingAccount.accountType |
Auf Anfrageebene definiert. Legen Sie FLOODLIGHT_CONFIG fest. |
floodlightActivityId |
destinations[].productDestinationId |
Auf Anfrageebene definiert. Legen Sie die Floodlight-Aktivitäts-ID fest (früher als Floodlight-Aktivitäts-ID bekannt). |
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 den entsprechenden reference der Ziele 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 kann transactionId verwendet werden, um zu steuern, wie Conversions desselben Nutzers und vom selben Tag dedupliziert 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 festlegten. In der Data Manager API muss transactionId für jedes Ereignis auf eine eindeutige Kennung festgelegt werden.
|
| Kein Äquivalent | transactionId |
In der Data Manager API wird transactionId verwendet, um zu steuern, wie Conversions desselben Nutzers und vom selben Tag dedupliziert werden. Dieses Feld 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 umwandeln.
|
customVariables |
customVariables |
Eine Liste von CustomVariable-Objekten. In der Data Manager API werden Strings anstelle von Enums als Schlüssel verwendet. Verwenden Sie Schlüssel wie U1 und U2 für das Feld variable. |
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 Nutzer-ID angegeben. |
encryptionInfo.encryptionEntityId |
adIdentifiers.encryptedUserIds[].entityId |
Anstatt die Verschlüsselungsinformationen einmal pro Anfrage anzugeben, werden sie pro verschlüsselter Nutzer-ID angegeben. |
encryptionInfo.encryptionSource |
adIdentifiers.encryptedUserIds[].source |
Anstatt die Verschlüsselungsinformationen einmal pro Anfrage anzugeben, werden sie pro verschlüsselter Nutzer-ID angegeben. |
sessionAttributesEncoded |
adIdentifiers.sessionAttributes |
Weitere Informationen finden Sie unter AdIdentifiers. |
cartData |
cartData |
Weitere Informationen finden Sie unter Felder für Warenkorbdaten. |
userIdentifiers |
userData.userIdentifiers |
Weitere Informationen finden Sie unter Felder für Nutzerkennungen. |
Felder für Nutzerkennungen
In der Data Manager API werden Nutzerkennungen in einem
UserData Objekt unter dem userData Feld des
Event gruppiert. Dies unterscheidet sich von der Campaign Manager 360 API, bei der Kennungen direkt an das Conversion-Objekt angehängt werden.
UserIdentifier (Campaign Manager 360 API) |
UserIdentifier (Data Manager API) |
Hinweise |
|---|---|---|
hashedEmail |
emailAddress |
Legen Sie die formatierte und gehashte E-Mail-Adresse fest. Sie können die gehashte E-Mail-Adresse auch verschlüsseln. |
hashedPhoneNumber |
phoneNumber |
Legen Sie die formatierte und gehashte Telefonnummer fest. Sie können die gehashte Telefonnummer auch verschlüsseln. |
addressInfo |
address |
Legen Sie ein AddressInfo-Objekt fest. Beachten Sie 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 Artikel-Fel1der. |
Artikel-Felder 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. Eindeutige Kennung für das Objekt |
itemId |
merchantProductId |
Erforderlich. Legen Sie die Merchant Center-Produkt-ID für den Artikel fest. |
quantity |
quantity |
Erforderlich. |
unitPrice |
unitPrice |
Erforderlich. |