表のマッピングを使用して、キャンペーン マネージャー 360 API の conversions.batchinsert をデータ マネージャー 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（以前は 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 に存在しません。代わりに、transactionId を使用して、同一日に同一ユーザーによる複数コンバージョンが発生している場合の処理方法を指定できます。キャンペーン マネージャー 360 API では、 ordinal を 1 などの固定の定数値に設定することで、イベントの重複除去を確実に行うことができます。Data Manager API では、transactionId はイベントごとに一意の識別子に設定する必要があります。 |
| 同等のものはありません | transactionId |
Data Manager API では、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 は Event の userData フィールドにある UserData オブジェクト内にグループ化されます。キャンペーン マネージャー 360 API では、識別子が Conversion オブジェクトに直接関連付けられます。
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 |
必須。 |