표의 매핑을 사용하여 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와 같은 고정된 상수 값으로 설정하여 이벤트가 중복되지 않도록 할 수 있습니다. 데이터 관리 도구 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에서 사용자 식별자는 Event의 userData 필드 아래에 있는 UserData 객체 내에 그룹화됩니다. Campaign Manager 360 API에서는 식별자가 Conversion 객체에 직접 연결되므로 이와 다릅니다.
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 |
- 동등한 보고서 없음 | 현재 버전의 데이터 관리 도구 API에서는 지원되지 않습니다. |
addressInfo.state |
- 동등한 보고서 없음 | 현재 버전의 데이터 관리 도구 API에서는 지원되지 않습니다. |
addressInfo.hashedStreetAddress |
- 동등한 보고서 없음 | 현재 버전의 데이터 관리 도구 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 |
필수사항. |