表のマッピングを使用して、キャンペーン マネージャー 360 API の
conversions.batchinsert を Data Manager API の同等の
IngestEventsRequest にマッピングします。
リクエスト フィールド
conversions.batchinsert （キャンペーン マネージャー 360 API） |
IngestEventsRequest （Data Manager API） |
メモ |
|---|---|---|
profileId URL パスパラメータ |
同等のものはありません | |
kind |
同等のものはありません | メタデータ フィールド。Data Manager API では使用されません。 |
conversions |
events |
必須。コンバージョンまたはイベントのリスト。詳しくは、コンバージョン フィールドをご覧ください。 |
encryptionInfo |
events.adIdentifiers.encryptedUserIds に移動しました |
イベントレベルで定義されます。キャンペーン マネージャー 360 の暗号化情報は、暗号化された各ユーザー ID で指定されるようになりました。コンバージョン フィールドをご覧ください。 |
| 同等のものはありません | encryptionInfo |
リクエストレベルの encryptionInfo は、暗号化された UserData ユーザー ID の暗号化情報です。詳しくは、暗号化をご覧ください。 |
| 同等のものはありません | destinations |
必須。イベントのターゲット アカウントと Floodlight アクティビティを定義する Destination オブジェクトのリスト。詳しくは、送信先のガイドをご覧ください。コンバージョン フィールドに示されているように、個々のフィールドをマッピングします。 |
| 同等のものはありません | consent |
リクエスト内のイベントのデフォルトの同意設定（省略可）。Event の consent フィールドを設定することで、個々のイベントのこの値をオーバーライドできます。 |
| 同等のものはありません | encoding |
ユーザー ID を送信する場合は必須: UserIdentifier 値に使用される Encoding に設定します。ユーザー ID を使用しない場合、このフィールドは無視されます。 |
| 同等のものはありません | validateOnly |
true の場合、リクエストは検証されますが、実行されません。 |
コンバージョン フィールド
Conversion （キャンペーン マネージャー 360 API） |
Event （Data Manager API） |
メモ |
|---|---|---|
floodlightConfigurationId |
destinations[].operatingAccount.accountId |
リクエストレベルで定義されます。Floodlight 設定 ID に設定します。 |
| 同等のものはありません | destinations[].operatingAccount.accountType |
リクエストレベルで定義されます。FLOODLIGHT_CONFIG に設定します。 |
floodlightActivityId |
destinations[].productDestinationId |
リクエストレベルで定義されます。Floodlight アクティビティ ID に設定します。 |
kind |
同等のものはありません | メタデータ フィールド。Data Manager API では使用されません。 |
| 同等のものはありません | destinations[].reference |
リクエストレベルで定義されます。送信先のユーザー定義の識別子。1 つのリクエストで複数の送信先にイベントを送信する場合は、このフィールドを設定します。 |
adUserDataConsent |
consent.adUserData |
詳しくは、Consent をご覧ください。 |
nonPersonalizedAd |
consent.adPersonalization |
詳しくは、Consent をご覧ください。 |
| 同等のものはありません | destinationReferences |
1 つのリクエストで複数の送信先にイベントをイベントを送信する場合は、このフィールドをreferenceの対応する送信先に設定します。 |
timestampMicros |
eventTimestamp |
詳しくは、タイムスタンプの形式をご覧ください。 |
value |
conversionValue |
|
quantity |
conversionCount |
|
ordinal |
同等のものはありません |
キャンペーン マネージャー 360 API の ordinal フィールドは、Data Manager API にはありません。代わりに、Data Manager API は transactionId を使用して、同じ Floodlight アクティビティ ID に送信されたイベントの重複を排除します。
Campaign Manager 360 API では、 ordinal を 1 などの固定定数値に設定することで、イベントの重複を排除できます。Data Manager API では、transactionId をイベントごとに一意の識別子に設定する必要があります。
|
| 同等のものはありません | transactionId |
Data Manager API は、Floodlight アクティビティ ID と transactionId の組み合わせを使用して、イベントの重複を排除します。transactionId フィールドは、イベントごとに一意の識別子に設定する必要があります。このフィールドは、Floodlight オフライン コンバージョンを送信する場合は省略可です。詳しくは、データを Event オブジェクトに変換するをご覧ください。 |
customVariables |
customVariables |
CustomVariable オブジェクトのリスト。Data Manager API では、列挙型ではなく文字列がキーとして使用されます。variable フィールドには、U1、U2 などのキーを使用します。 |
limitAdTracking |
consent.adPersonalization |
詳しくは、Consent をご覧ください。 |
childDirectedTreatment |
consent.adPersonalization |
詳しくは、Consent をご覧ください。 |
treatmentForUnderage |
consent.adPersonalization |
詳しくは、Consent をご覧ください。 |
gclid |
adIdentifiers.gclid |
詳しくは、AdIdentifiers をご覧ください。 |
dclid |
adIdentifiers.dclid |
詳しくは、AdIdentifiers をご覧ください。 |
matchId |
adIdentifiers.matchId |
詳しくは、AdIdentifiers をご覧ください。 |
mobileDeviceId |
adIdentifiers.mobileId |
詳しくは、AdIdentifiers をご覧ください。 |
impressionId |
adIdentifiers.impressionId |
詳しくは、AdIdentifiers をご覧ください。 |
encryptedUserId |
adIdentifiers.encryptedUserIds |
Data Manager API は、複数の暗号化されたユーザー ID をサポートしています。詳しくは、AdIdentifiers をご覧ください。 |
encryptedUserIdCandidates |
adIdentifiers.encryptedUserIds |
候補 ID はそれぞれ、リスト内の EncryptedUserId オブジェクトにマッピングされます。 |
encryptionInfo.kind |
同等のものはありません | メタデータ フィールド。Data Manager API では使用されません。 |
encryptionInfo.encryptionEntityType |
adIdentifiers.encryptedUserIds[].entityType |
リクエストごとに 1 回暗号化情報を指定するのではなく、暗号化されたユーザー ID ごとに指定します。 |
encryptionInfo.encryptionEntityId |
adIdentifiers.encryptedUserIds[].entityId |
リクエストごとに 1 回暗号化情報を指定するのではなく、暗号化されたユーザー ID ごとに指定します。 |
encryptionInfo.encryptionSource |
adIdentifiers.encryptedUserIds[].source |
リクエストごとに 1 回暗号化情報を指定するのではなく、暗号化されたユーザー ID ごとに指定します。 |
sessionAttributesEncoded |
adIdentifiers.sessionAttributes |
詳しくは、AdIdentifiers をご覧ください。 |
cartData |
cartData |
詳しくは、カートデータのフィールドをご覧ください。 |
userIdentifiers |
userData.userIdentifiers |
詳しくは、ユーザー識別子フィールドをご覧ください。 |
ユーザー識別子フィールド
Data Manager API では、ユーザー ID は
UserData オブジェクト内に、userData フィールドの
Event の下にグループ化されます。これは、ID が Conversion オブジェクトに直接添付されるキャンペーン マネージャー 360 API とは異なります。
UserIdentifier （キャンペーン マネージャー 360 API） |
UserIdentifier （Data Manager API） |
メモ |
|---|---|---|
hashedEmail |
emailAddress |
書式設定してハッシュ化したメールアドレスに設定します。ハッシュ化したメールアドレスを暗号化することもできます。 |
hashedPhoneNumber |
phoneNumber |
書式設定してハッシュ化した電話番号に設定します。ハッシュ化した電話番号を暗号化することもできます。 |
addressInfo |
address |
AddressInfo オブジェクトに設定します。書式設定とハッシュ化のガイドラインに従ってください。ハッシュ化した住所の属性を暗号化することもできます。 |
addressInfo.hashedFirstName |
address.givenName |
|
addressInfo.hashedLastName |
address.familyName |
|
addressInfo.countryCode |
address.regionCode |
|
addressInfo.postalCode |
address.postalCode |
|
addressInfo.city |
同等のものはありません | 現在のバージョンの Data Manager API ではサポートされていません。 |
addressInfo.state |
同等のものはありません | 現在のバージョンの Data Manager API ではサポートされていません。 |
addressInfo.hashedStreetAddress |
同等のものはありません | 現在のバージョンの Data Manager API ではサポートされていません。 |
カートデータのフィールド
CartData （キャンペーン マネージャー 360 API） |
CartData （Data Manager API） |
メモ |
|---|---|---|
kind |
同等のものはありません | メタデータ フィールド。Data Manager API では使用されません。 |
merchantId |
merchantId |
|
merchantFeedLabel |
merchantFeedLabel |
|
merchantFeedLanguage |
merchantFeedLanguageCode |
|
items |
items |
Item オブジェクトのリスト。詳しくは、アイテム フィールドをご覧ください。 |
カートのデータのアイテム フィールド
Item （キャンペーン マネージャー 360 API） |
Item （Data Manager API） |
メモ |
|---|---|---|
kind |
同等のものはありません | メタデータ フィールド。Data Manager API では使用されません。 |
| 同等のものはありません | itemId |
省略可。アイテムの一意の識別子。 |
itemId |
merchantProductId |
必須。アイテムの Merchant Center 商品 ID に設定します。 |
quantity |
quantity |
必須。 |
unitPrice |
unitPrice |
必須。 |