Verwenden Sie die Zuordnungen in den Tabellen, um einen conversions.batchinsert in der Campaign Manager 360 API dem entsprechenden IngestEventsRequest in der Data Manager API zuzuordnen.
Authentifizierung
Für die Data Manager API sind Anmeldedaten mit einem anderen Bereich als für die Campaign Manager 360 API erforderlich. Folgen Sie der Anleitung unter API-Zugriff einrichten, um neue Anmeldedaten zu generieren, die den Bereich der Data Manager API enthalten.
Anfragefelder
conversions.batchinsert (Campaign Manager 360 API) |
IngestEventsRequest (Data Manager API) |
Hinweise |
|---|---|---|
profileId URL-Pfadparameter |
Kein Äquivalent | |
kind |
Kein Äquivalent | Metadatenfeld; wird von der Data Manager API nicht verwendet. |
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 Verschlüsselungsinformationen von Campaign Manager 360 werden jetzt in jeder verschlüsselten Nutzer-ID angegeben. Weitere Informationen finden Sie im Abschnitt Conversion-Felder. |
| Kein Äquivalent | encryptionInfo |
Die encryptionInfo auf Anfrageebene enthält die Verschlüsselungsinformationen für 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 finden Sie im Leitfaden zu Zielen. 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:Legen Sie den Encoding fest, der für UserIdentifier-Werte verwendet wird. Wenn keine Nutzer-IDs verwendet werden, 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. Setze dies auf FLOODLIGHT_CONFIG. |
floodlightActivityId |
destinations[].productDestinationId |
Auf Anfrageebene definiert. Legen Sie die ID der Floodlight-Aktivität fest. |
kind |
Kein Äquivalent | Metadatenfeld; wird von der Data Manager API nicht verwendet. |
| 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 für dieses Feld 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 gesetzt haben. In der Data Manager API muss transactionId auf eine eindeutige Kennung für jedes Ereignis festgelegt werden.
|
| Kein Äquivalent | transactionId |
Die Data Manager API verwendet eine Kombination aus der Floodlight-Aktivitäts-ID und transactionId, um das Ereignis zu deduplizieren. Das Feld transactionId muss für jedes Ereignis auf eine eindeutige Kennung festgelegt werden.
Erforderlich, wenn Ereignisse für Conversions mit mehreren Quellen gesendet werden. Weitere Informationen finden Sie unter Daten in Event-Objekte konvertieren.
|
customVariables |
customVariables |
Eine Liste von CustomVariable-Objekten. Die Data Manager API verwendet Strings als Schlüssel anstelle von Enums. Verwenden Sie Schlüssel wie U1, 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 ist einem EncryptedUserId-Objekt in der Liste zugeordnet. |
encryptionInfo.kind |
Kein Äquivalent | Metadatenfeld; wird von der Data Manager API nicht verwendet. |
encryptionInfo.encryptionEntityType |
adIdentifiers.encryptedUserIds[].entityType |
Die Verschlüsselungsinformationen werden nicht einmal pro Anfrage, sondern pro verschlüsselter Nutzer-ID angegeben. |
encryptionInfo.encryptionEntityId |
adIdentifiers.encryptedUserIds[].entityId |
Die Verschlüsselungsinformationen werden nicht einmal pro Anfrage, sondern 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 Warenkorbdatenfelder. |
userIdentifiers |
userData.userIdentifiers |
Weitere Informationen finden Sie unter Felder für Nutzer-IDs. |
Felder für Nutzer-IDs
In der Data Manager API werden Nutzer-IDs in einem UserData-Objekt im Feld userData 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 |
Wird auf ein AddressInfo-Objekt festgelegt. Folgen Sie den Formatierungs- und Hash-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 für Campaign Manager 360-Ziele nicht unterstützt. |
addressInfo.state |
Kein Äquivalent | Wird für Campaign Manager 360-Ziele nicht unterstützt. |
addressInfo.hashedStreetAddress |
Kein Äquivalent | Wird für Campaign Manager 360-Ziele nicht unterstützt. |
Felder für Warenkorbdaten
CartData (Campaign Manager 360 API) |
CartData (Data Manager API) |
Hinweise |
|---|---|---|
kind |
Kein Äquivalent | Metadatenfeld; wird von der Data Manager API nicht verwendet. |
merchantId |
merchantId |
|
merchantFeedLabel |
merchantFeedLabel |
|
merchantFeedLanguage |
merchantFeedLanguageCode |
|
items |
items |
Eine Liste von Item-Objekten. Weitere Informationen finden Sie unter Elementfelder. |
Artikelfelder für Warenkorbdaten
Item (Campaign Manager 360 API) |
Item (Data Manager API) |
Hinweise |
|---|---|---|
kind |
Kein Äquivalent | Metadatenfeld; wird von der Data Manager API nicht verwendet. |
| Kein Äquivalent | itemId |
Optional. Eine eindeutige Kennung für den Artikel. |
itemId |
merchantProductId |
Erforderlich. Legen Sie die Merchant Center-Produkt-ID für den Artikel fest. |
quantity |
quantity |
Erforderlich. |
unitPrice |
unitPrice |
Erforderlich. |