(전환 API) 구글 애즈 오프라인 전환 API

팔로우
Avatar
Jonathan Chen
Updated
문서
웹, PC, 콘솔 이벤트 에대한 전환 포스트백은 Singular의 웹, PC, 콘솔 게임 어트리뷰션에 액세스할 수 있는 Singular 고객만 사용할 수 있습니다.

Singular와 구글 광고 오프라인 전환 API ( 업로드클릭컨버젼이라고도 함)의 연동을 통해 광고주는 Singular 어트리뷰션된 구글 광고 클릭 전환을 구글에 전송할 수 있습니다. 이 연동은 Singular 웹, PC, 콘솔 측정에 대해 지원됩니다. Singular의 모바일 측정과 구글 애즈와의 연동에 대한 자세한 내용은 해당 주제에 대한 도움말 센터 문서를 참조하세요.

구글 애즈 오프라인 전환 API 연동을 구성하는 방법

  1. 웹, PC 또는 콘솔 앱이 Singular와 연동되어 있는지 확인합니다.
  2. Singular > 어트리뷰션 > 파트너 구성으로 이동합니다.
  3. "파트너 추가"를 클릭하고,"구글 애즈 오프라인 전환 API (S2S)"를 입력하고 선택합니다.
  4. Singular를 인증할 기존 사용자를 추가하거나 선택합니다.
  5. 대화 상자에서 구성할 앱과 앱 사이트(플랫폼)를 선택합니다. 이 연동에서는 웹, PC, 콘솔 앱만 지원됩니다.
  6. '고객 ID' 아래에 Google 광고의 고객 ID를 입력합니다. 고객 ID는 Google 광고 대시보드의 오른쪽 상단에서 찾을 수 있습니다. 하이픈은 필요하지 않습니다.

    앱에 대한 캠페인을 실행하는 Google 광고 계정이 여러 개 있는 경우 관리자(MCC) 계정을 사용한 계정 간 전환 추적을 통해 관리자(MCC) 계정의'고객 ID'를 사용해야 합니다. MCC 계정 구성에 대한 가이드는 Google 도움말 센터 문서를 참조하세요.
  7. PC 및 콘솔 앱 전용: Google 광고 계정에서'설치'에 대한 전환 액션을 생성합니다. 생성된'설치 전환 액션 ID'를 복사하여 붙여넣습니다.
  8. Google 광고 계정에서 전송하려는 다른 이벤트에 대한 전환 액션을 생성하고 각 이벤트를 해당'전환 액션 ID'에 매핑합니다.
  9. "저장"을 클릭하여 완료합니다.

FAQ

Google 광고 전환 API용 전환 액션은 어떻게 생성하나요?
  1. "새 전환 액션"을 클릭합니다.


  2. "가져오기"를 선택합니다.


  3. "API 또는 업로드를 사용한 수동 가져오기" ->"클릭에서 전환 추적"을 선택합니다.

    참고: MCC 계정에서는"API 또는 업로드를 사용한 수동 가져오기" 옵션이 표시되지 않을 수 있습니다. 이 경우"기타 데이터 소스 또는 CRM","클릭에서 전환 추적","이 단계 건너뛰고 나중에 데이터 소스 설정"을 선택하여 전환 액션을 계속 생성합니다.

  4. Google의 메시지가 표시되면 계속해서 전환 세부 정보를 구성합니다. 완료되면"생성 및 계속"을 클릭합니다.

  5. '전환 목표' 페이지로 돌아가서 방금 생성한 전환 액션을 찾아 클릭하여 세부 정보를 확인합니다.


  6. 전환 액션"세부 정보" 페이지에서 URL 매개 변수"ctId="에서"전환 액션 ID"를 복사합니다.



  7. "전환 액션 ID"를 입력하라는 메시지가 표시되면 이"전환 액션 ID"를 Singular 파트너 구성에 붙여넣습니다.
Google 광고 전환 API용 전환 액션은 어떻게 생성하나요(UI 업데이트)?
  1. 생성 >"새 전환 액션"을 클릭합니다.


  2. 아직 선택하지 않은 경우, 오프라인 전환 > 계속()을 선택합니다.
  3. 아직 오프라인 전환을 설정하지 않은 경우 이 화면이 표시될 수 있습니다."이 단계를 건너뛰고 나중에 데이터 소스 설정"을 선택합니다.
  4. 측정하려는 표준 전환 액션을 선택합니다.
  5. "이 카테고리에 이벤트 추가" >"오프라인 데이터 소스"를 클릭합니다.
중요 이 연동에서는 앱 설치 전환 액션을 사용해서는 안 됩니다. 전환 오프라인 전환 액션 중 하나를 사용하여 웹에서 앱 설치에 대한 새 전환 액션을 만들어야 합니다.
  1. 방금 추가한 전환 액션 옆의 설정
  2. 전환 액션의 이름을 원하는 전환 액션 이름으로 변경하고, 이 이벤트에 대해 원하는 측정 및 최적화 목표에 맞게 전환 액션 설정을 업데이트합니다. 그런 다음 저장을 클릭합니다.
  3. 저장 후 계속을 클릭합니다.
  4. 마침을 클릭합니다
  5. 이제 요약 화면에 전환 액션이 표시됩니다. 전환 소스는"웹사이트(클릭에서 가져오기)"여야 합니다. 전체 설정을 완료하고 Singular가 Google에 어트리뷰션 이벤트를 보내기 시작할 때까지 상태는 비활성 상태인 것이 정상입니다.
  6. 전환 액션을 클릭한 다음, 브라우저 주소창에서 ctld 값을 복사합니다.
  7. Singular 구글 광고 웹 이벤트 파트너 구성에 ctld 값을 추가합니다().
Singular는 오프라인 전환 API를 통해 어떤 데이터를 전송하나요?
파라미터 세부 정보
gclid, gbraid (coming soon), wbraid (coming soon)
  • 자동으로 전달됨
hashed email
  • 선택 사항
  • 해시된 이메일은 Singular 계측 이벤트 속성"ehash"로 전달될 수 있습니다.
  • 해시된 이메일 값은 정규화되고 SHA 256 해시되어야 합니다.
hashed phone number
  • 선택 사항
  • 해시된 전화번호는 Singular 계측 이벤트 속성"phashE164"로 전달될 수 있습니다.
  • 해시된 전화 번호는 E164 정규화 및 SHA 256 해시되어야 합니다.
"USER_PERMISSION_DENIED"에서 포스트백이 실패했습니다.

이 오류는 권한이 부여된 사용자에게 구성된 MCC 계정에 대한 권한이 없는 경우 발생합니다.

이 문제를 해결하려면 Google 광고 계정으로 이동하여 Singular에서 권한이 부여된 사용자에게 구성된 MCC 계정에 대한 전체 권한이 있는지 확인하세요.

"고객_비활성화된_향상된_전환_을위한_리드"에서 포스트백이 실패합니다.

이 오류는 Google의 향상된 전환 처리 약관에 동의하지 않은 경우 발생합니다.

이 문제를 해결하려면 Google 광고 계정으로 이동하여 사이드 메뉴의 설정으로 들어가'목표'에서'전환' 화면을 선택한 다음 아래와 같이 리드에 대한 향상된 전환을 사용 설정하세요:

자세한 내용은 여기에서 Google 광고 설명서를 참조하세요.

Google 광고 오프라인 전환 API의 제한 사항은 무엇인가요?
  • 클릭 전환만 지원
  • 모델링은 지원되지 않습니다.
Google 광고 오프라인 전환 API에서 모바일 이벤트가 지원되나요?
  • 구글 OCI 포스트백은 모바일 앱 사이트에서 Singular의 모바일 웹 투 앱 어트리뷰션 플로우(즉, 구글 광고 클릭 → Singular 웹 SDK를 통한 광고주 소유 랜딩 페이지 → Singular 모바일 웹 투 앱 클릭 → 설치)를 사용할 때만 앱 이벤트를 전송하도록 구성해야 합니다.
  • 구글 웹 캠페인에서 직접 광고 클릭 → 스토어 플로우를 활용하는 경우(예: 구글 광고 클릭 → 앱 스토어), 대신 구글 애즈 웹 연동을 사용하세요.
  • 이 연동은 표준 모바일 앱 설치 및 리타겟팅 캠페인에 사용해서는 안 됩니다. 모바일 캠페인에는 구글 애즈 모바일 앱 캠페인 연동을 사용하세요.