표의 매핑을 사용하여 Campaign Manager 360 API의
conversions.batchinsert를 Data Manager API의
IngestEventsRequest에 매핑합니다.
요청 필드
conversions.batchinsert (Campaign Manager 360 API) |
IngestEventsRequest (Data Manager API) |
참고 |
|---|---|---|
profileId URL 경로 매개변수 |
- 동등한 보고서 없음 | |
kind |
- 동등한 보고서 없음 | 메타데이터 필드이며 Data Manager API에서 사용되지 않습니다. |
conversions |
events |
필수사항. 전환 또는 이벤트 목록입니다. 자세한 내용은 전환 필드 섹션을 참고하세요. |
encryptionInfo |
events.adIdentifiers.encryptedUserIds로 이동했습니다. |
이벤트 수준에서 정의됩니다. 이제 Campaign Manager 360 암호화 정보가 각 암호화된 사용자 ID에 지정됩니다. 전환 필드 섹션을 참고하세요. |
| - 동등한 보고서 없음 | encryptionInfo |
요청 수준 encryptionInfo은 암호화된 UserData 사용자 식별자의 암호화 정보입니다. 자세한 내용은 암호화를 참고하세요. |
| - 동등한 보고서 없음 | destinations |
필수사항. 이벤트의 타겟 계정 및 플러드라이트 활동을 정의하는 Destination 객체 목록입니다. 자세한 내용은 대상 가이드를 참고하세요. 전환 필드 섹션에 표시된 대로 개별 필드를 매핑합니다. |
| - 동등한 보고서 없음 | consent |
요청의 이벤트에 대한 선택적 기본 동의 설정입니다. Event의 consent 필드를 설정하여 개별 이벤트의 이 값을 재정의할 수 있습니다. |
| - 동등한 보고서 없음 | encoding |
사용자 식별자를 전송하는 경우 필수사항: UserIdentifier 값에 사용되는 Encoding으로 설정합니다. 사용자 식별자를 사용하지 않는 경우 이 필드는 무시됩니다. |
| - 동등한 보고서 없음 | validateOnly |
true인 경우 요청이 검증되지만 실행되지는 않습니다. |
전환 필드
Conversion (Campaign Manager 360 API) |
Event (Data Manager API) |
참고 |
|---|---|---|
floodlightConfigurationId |
destinations[].operatingAccount.accountId |
요청 수준에서 정의됩니다. 플러드라이트 구성 ID로 설정합니다. |
| - 동등한 보고서 없음 | destinations[].operatingAccount.accountType |
요청 수준에서 정의됩니다. FLOODLIGHT_CONFIG로 설정합니다. |
floodlightActivityId |
destinations[].productDestinationId |
요청 수준에서 정의됩니다. 플러드라이트 활동 ID (이전에는 플러드라이트 활동 ID라고 함)로 설정합니다. |
kind |
- 동등한 보고서 없음 | 메타데이터 필드이며 Data Manager API에서 사용되지 않습니다. |
| - 동등한 보고서 없음 | destinations[].reference |
요청 수준에서 정의됩니다. 대상에 대한 사용자 정의 식별자입니다. 단일 요청에서 여러 대상으로 이벤트를 전송하는 경우 이 필드를 설정합니다. |
adUserDataConsent |
consent.adUserData |
자세한 내용은 Consent를 참고하세요. |
nonPersonalizedAd |
consent.adPersonalization |
자세한 내용은 Consent를 참고하세요. |
| - 동등한 보고서 없음 | destinationReferences |
단일 요청에서 여러 대상으로 이벤트를 전송하는 경우 이 필드를 대상의 해당 reference로 설정합니다. |
timestampMicros |
eventTimestamp |
자세한 내용은 타임스탬프 형식을 참고하세요. |
value |
conversionValue |
|
quantity |
conversionCount |
|
ordinal |
- 동등한 보고서 없음 |
Campaign Manager 360 API의 ordinal 필드는 Data Manager API에 없습니다.
대신 transactionId를 사용하여 동일한 사용자와 날짜의 전환 중복을 제거하는 방식을 제어할 수 있습니다.
Campaign Manager 360 API에서는 ordinal을 1과 같은 고정된 상수 값으로 설정하여 이벤트의 중복을 제거할 수 있습니다. Data Manager API에서는 transactionId를 각 이벤트의 고유 식별자로 설정해야 합니다.
|
| - 동등한 보고서 없음 | transactionId |
Data Manager API에서는 transactionId를 사용하여 동일한 사용자와 날짜의 전환 중복을 제거하는 방식을 제어합니다. 이 필드는 각 이벤트의 고유 식별자로 설정해야 합니다.
플러드라이트 오프라인 전환을 전송할 때 이 필드는 선택사항입니다. 자세한 내용은 데이터를 Event 객체로 변환을 참고하세요.
|
customVariables |
customVariables |
CustomVariable 객체 목록입니다. Data Manager API는 enum 대신 문자열을 키로 사용합니다. 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 |
요청당 한 번 암호화 정보를 지정하는 대신 암호화된 사용자 ID별로 지정됩니다. |
encryptionInfo.encryptionEntityId |
adIdentifiers.encryptedUserIds[].entityId |
요청당 한 번 암호화 정보를 지정하는 대신 암호화된 사용자 ID별로 지정됩니다. |
encryptionInfo.encryptionSource |
adIdentifiers.encryptedUserIds[].source |
요청당 한 번 암호화 정보를 지정하는 대신 암호화된 사용자 ID별로 지정됩니다. |
sessionAttributesEncoded |
adIdentifiers.sessionAttributes |
자세한 내용은 AdIdentifiers를 참고하세요. |
cartData |
cartData |
자세한 내용은 장바구니 데이터 필드를 참고하세요. |
userIdentifiers |
userData.userIdentifiers |
자세한 내용은 사용자 식별자 필드를 참고하세요. |
사용자 식별자 필드
Data Manager API에서 사용자 식별자는
UserData 객체 내에 그룹화됩니다. userData 필드 아래에 있는
Event. 이는 식별자가 Conversion 객체에 직접 연결되는 Campaign Manager 360 API와 다릅니다.
UserIdentifier (Campaign Manager 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 (Campaign Manager 360 API) |
CartData (Data Manager API) |
참고 |
|---|---|---|
kind |
- 동등한 보고서 없음 | 메타데이터 필드이며 Data Manager API에서 사용되지 않습니다. |
merchantId |
merchantId |
|
merchantFeedLabel |
merchantFeedLabel |
|
merchantFeedLanguage |
merchantFeedLanguageCode |
|
items |
items |
Item 객체 목록입니다. 자세한 내용은 항목 필드를 참고하세요. |
장바구니 데이터의 항목 필드
Item (Campaign Manager 360 API) |
Item (Data Manager API) |
참고 |
|---|---|---|
kind |
- 동등한 보고서 없음 | 메타데이터 필드이며 Data Manager API에서 사용되지 않습니다. |
| - 동등한 보고서 없음 | itemId |
선택사항입니다. 항목의 고유 식별자입니다. |
itemId |
merchantProductId |
필수사항. 항목의 판매자 센터 제품 ID로 설정합니다. |
quantity |
quantity |
필수사항. |
unitPrice |
unitPrice |
필수사항. |