전환 조정

IngestEvents 메서드를 사용하여 이전에 기록된 Google Ads 전환을 조정합니다. Data Manager API에서 조정은 전환 가치를 수정하거나 사용자 데이터를 보완할 수 있습니다.

Google Ads API에서 이전하는 경우 Google Ads API에서 업그레이드를 참고하여 각 API에서 조정이 처리되는 방식을 비교하세요.

지원되는 전환 유형

다음 Google Ads 전환 유형을 조정할 수 있습니다.

조정 작동 방식

동일한 전환 액션 내에서 Google Ads는 다음을 사용하여 이벤트를 매칭합니다. transactionId

  • transactionId이 동일한 전환 액션의 기존 전환과 일치하는 경우 Data Manager API는 요청을 전환 조정으로 처리합니다.
  • transactionId이 기존 전환과 일치하지 않으면 Google Ads에서 새 전환을 만듭니다. 일치하지 않는 이벤트를 참고하세요.

조정 보내기

기존 전환을 조정하려면 다음을 포함하는 IngestEvents 요청을 전송하세요.

  • 원본 이벤트와 동일한 transactionId입니다.
  • 원본 이벤트와 동일한 대상 및 전환 액션
  • 조정하려는 필드의 업데이트된 값입니다.

조정 유형을 지정할 필요가 없습니다. Data Manager API는 transactionId 및 사용자가 제공한 필드를 기반으로 요청을 처리하는 방법을 추론합니다.

수집 요청 전송에 대한 자세한 내용은 이벤트 전송을 참고하세요.

지원되는 필드

다음 표에는 조정할 수 있는 필드와 업데이트가 적용되는 방식이 나와 있습니다.

필드 동작
conversionValue, currency 덮어쓰기됨. 새 값이 기록된 값을 대체합니다.
userData 원래 이벤트에 사용자 데이터가 없는 경우 보완됨, 그렇지 않은 경우 무시됨
adIdentifiers.gclid와 같은 다른 모든 필드는 무시됨

전환 가치

기록된 전환의 값을 다시 지정하기 위해 새 conversionValue 및 currency를 전송합니다. 새 값은 전환 수를 늘리지 않고 보고 및 입찰에서 이전에 기록된 값을 재정의합니다.

사용자 데이터

Google Ads에서 이메일 주소나 전화번호와 같은 userData를 처리하는 방법은 다음과 같습니다.

  • 누락된 경우 보완: 원래 이벤트가 사용자 데이터 없이 포착된 경우 조정에서 기여 분석을 개선하기 위해 사용자 데이터를 첨부합니다.

  • 있는 경우 무시됨: Google 태그 또는 이전 업로드에서 이미 사용자 데이터를 캡처한 경우 신규 사용자 데이터는 무시됩니다. 기존 사용자 데이터는 덮어쓰거나 추가되지 않습니다.

기타 필드

adIdentifiers.gclid와 같은 전환 가치, 통화, 사용자 데이터를 제외한 식별자 및 메타데이터는 일치하는 이벤트에 대해 업데이트할 수 없습니다. Google Ads에서는 이러한 필드를 무시하고 원래 이벤트에 기록된 값을 유지합니다.

일치하지 않는 이벤트

transactionId이 기존 이벤트와 일치하지 않으면 요청이 조정이 아닌 새 전환 업로드로 처리됩니다.

Google Ads에서는 제공된 식별자(예: adIdentifiers.gclid 또는 userData)를 사용하여 새 전환에 광고 클릭 기여도를 부여하려고 합니다.