Singular는 Google Ads의 App Conversion API 와의 자체 귀속(self-attributing) 서버-투-서버 연동을 통해 Google Ads 캠페인을 트래킹하며, 여기에는 다음이 포함됩니다:

• 모든 Google Ads 캠페인으로 인해 발생한 모든 설치 및 리인게이지먼트 트래킹
• 클릭스루 및 뷰스루 귀속 모두

이 연동은 Link ID 를 사용하며, 이는 Google Ads에서 생성되고 각 앱마다 고유합니다. Link ID 가 Singular에 구성되면 Singular는 모든 설치, 세션 및 구성된 인앱 전환 이벤트를 Google에 전송하기 시작합니다.

Google에서 반환된 귀속 클릭 정보를 사용하여 Singular는 라스트 터치 귀속(last-touch attribution)을 수행할 수 있으며( Singular의 귀속 프로세스 참조), Google Ads 대시보드에서 받는 것과 동일한 세분화된 캠페인 정보를 사용하여 캠페인 성과에 대한 리포트를 제공합니다.

Google Ads 캠페인과 관련된 전환 및 이벤트 트래킹을 시작하려면 먼저 Google Ads 계정으로 이동하여 전환 액션을 설정 해야 합니다. 이는 이벤트 가져오기 라고도 합니다.

자세한 지침은 Google Ads 귀속 연동: 이벤트 가져오는 방법 을 참조하세요.

다음으로 Google Ads 캠페인을 구성하고 시작할 수 있습니다. Google의 지침 을 따라 옵션과 구성 방법에 대해 자세히 알아보세요.

귀속이 트래킹되면 Google Ads 캠페인이 Singular 리포팅 인터페이스에 표시됩니다.

Singular는 클릭스루 및 뷰스루 설치와 리인게이지먼트에 대한 귀속된 Google Ads 앱 캠페인 데이터의 리포팅을 지원합니다. 현재 사용 가능한 데이터에는 Google 채널(YouTube, Display, Search)과 함께 Google 캠페인 ID , 캠페인 이름 , 광고 그룹 ID 가 포함됩니다. 이 데이터는 Singular에서 각각 "Campaign ID", "Campaign Name", "Sub Campaign ID", "Sub Ad Network"로 매핑됩니다.

Google Ads의 "conversions" 는 Singular의 설치 와 리인게이지먼트 를 모두 의미한다는 점에 유의하세요.

또한 Google Ads 문서 에 설명된 대로 Google Ads와 모든 서드파티 간에는 본질적인 불일치가 존재합니다.

2020년 1월부터 Search용 설치 App Campaigns는 더 이상 Google Ads에서 귀속되지 않으므로 유저 레벨 리포팅에 표시되지 않습니다. 자세한 내용은 Google의 공지 를 참조하세요.

Singular SDK 구현에 딥링크 및 디퍼드 딥링크 지원 이 포함되어 있는지 확인하세요.

구현이 완료되면 Google과의 Singular 연동은 피드를 활용하는 Google 캠페인 에 대해 디퍼드 딥링킹을 자동으로 활성화합니다.

Google Ads에서 보고하는 앱 전환은 결정론적(deterministic) 소스와 모델링된(modeled) 소스가 혼합되어 있을 수 있습니다. 모델링된 전환이 캠페인에 어떤 영향을 미칠 수 있는지 이해하려면 Google 문서 를 참조하세요.

모델링된 전환은 Singular한 특정 광고 상호작용과 연결되지 않기 때문에 Google은 Singular나 Google의 App Attribution Partner에게 대응하는 결정론적 응답을 제공할 수 없습니다. 이로 인해 Google과 서드파티(3P) 간에 보고된 전환 불일치가 발생할 수 있습니다.

옵트아웃 유저의 앱 활동은 광고 ID가 0으로 처리된 상태로 Google에 보고되므로 Google은 개별적으로 식별 가능한 정보를 받지 않습니다.

Google이 광고를 게재할 때 자동 태깅이 활성화되어 있으면 "ID"도 함께 추가합니다:

• Gbraid (iOS): iOS 14.5 이상 클릭에 추가되는 식별자
• Gclid (Android, iOS): Google 클릭 ID

이러한 광고가 딥링크 활성화된 경우, 유저가 앱으로 딥링크될 때 Singular SDK/S2S 연동이 ID를 캡처합니다. Singular는 사용 가능한 모든 ID를 Google에 전달하며, 이는 Singular에서 리인게이지먼트로 자체 귀속되어 보고됩니다. "gbraid"의 경우 이러한 리인게이지먼트 귀속은 세분화 수준이 낮습니다. "Gbraid" 기반 리인게이지먼트 귀속에는 다음이 포함됩니다:

• Campaign ID
• Campaign Name

참여 조회는 10초 이상 지속된 동영상 광고에 대한 유저 임프레션입니다. 참여 조회는 Google 및 Singular 리포팅에서 클릭스루 귀속 으로 집계됩니다.

Singular의 유저 레벨 로그에서 참여 조회 전환은 Google에 귀속된 전환/이벤트 데이터의 "passthrough" 필드 내 "interaction_type" = "engagement" 로 보고됩니다.

집계 리포팅에서 참여 조회 전환은 "conversion type" = "click-through" 로 보고됩니다.

Google의 연동 전환 측정은 서드파티 App Attribution Partner 인터페이스에서 Google App 캠페인에 대해 보다 실시간적이고, 포괄적이며, 정확한 귀속을 제공합니다. 이벤트 데이터를 사용한 온디바이스 전환 측정과 같은 혁신적인 기술을 연동하여 유저 프라이버시를 손상시키지 않으면서 측정 정확도를 향상시킵니다. 그 결과 유저 레벨 식별자가 없는 경우에도 이벤트 레벨의 인사이트를 얻을 수 있습니다.

적용 범위:

• App Tracking Transparency (ATT)를 거부한 iOS 14.5 이상 유저
• 유럽 경제 지역(EEA)의 Android 유저, Android에서 광고 개인화 설정을 옵트아웃한 유저.
• ICM은 Kids 앱에 대해 지원됩니다.

적용되지 않는 범위

• ICM은 EEA/UK 지역에 위치한 iOS 기기에서는 지원되지 않습니다.

Google Ads의 연동 전환 측정은 클릭스루 설치 측정만 지원합니다.

연동 전환 측정 귀속은 Singular에서 다음과 같이 보고됩니다:

• 클릭스루
• 설치
• 확률론적(probabilistic)으로 귀속됨(세부 분석은 Singular 유저 레벨 리포트에서만 사용 가능)
• Sub Network Type은 사용할 수 없음

iOS 연동 전환 측정은 이벤트 데이터를 사용한 온디바이스 측정을 사용하며 Google의 ODM SDK와 함께 Singular SDK(또는 S2S API) 업데이트를 연동해야 합니다.

1. 다음 세 가지 옵션 중 하나를 사용하여 이벤트 데이터를 사용한 Google의 온디바이스 측정(ODM SDK)을 연동합니다:

   Google Analytics for Firebase Swift Package Manager Cocoapods

   Google 가이드 를 참조하세요

   1. Xcode에서 File > Add Packages 로 이동합니다.
   2. 나타나는 프롬프트에서 GoogleAdsOnDeviceConversion GitHub 저장소를 입력합니다: https://github.com/googleads/google-ads-on-device-conversion-ios-sdk
   3. 완료되면 Xcode가 백그라운드에서 패키지 종속성을 해결하고 다운로드하기 시작합니다.

   1. Podfile에 GoogleAdsOnDeviceConversion pod을 추가합니다.

      pod 'GoogleAdsOnDeviceConversion'

   2. 다음을 실행합니다

      pod install --repo-update

2. Singular SDK 또는 S2S API 구현 업데이트

   iOS SDK Unity SDK Flutter, React-Native, Cordova REST S2S API

   • 네이티브 SDK 최소 버전 12.8.1
   • 앱 타겟의 " Other Linker Flags "에 " -ObjC "를 반드시 추가하세요

   • Singular SDK를 초기화할 때 SingularConfig 에 enableOdmWithTimeoutInterval 구성 옵션을 추가하여 Singular가 ODM 정보를 수집하도록 활성화합니다.
     
     enableOdmWithTimeoutInterval 은 초 단위의 타임아웃 값으로 설정됩니다. 5초의 타임아웃 값을 사용하는 것이 권장됩니다. 타임아웃 값은 설치 후 첫 실행 시 Singular SDK가 ODM SDK로부터 ODM 정보를 기다리기 위해 초기화를 지연시키는 최대 시간을 설정합니다.

     중요: ODM SDK로부터 ODM 정보를 기다리는 과정은 Singular 딥링크 콜백 핸들러와 같은 Singular SDK 콜백을 지연시킵니다. 따라서 딥링크가 지연될 수 있습니다

     
     Swift:

     config.enableOdmWithTimeoutInterval = 5

     Objective C:

     config.enableOdmWithTimeoutInterval = 5;

   • Unity SDK 최소 버전 v5.5.0

   • SingularSDKObject 에 Enable ODM With Timeout Interval 구성 옵션을 추가하여 Singular가 ODM 정보를 수집하도록 활성화합니다.
     
     Enable ODM With Timeout Interval 은 초 단위의 타임아웃 값으로 설정됩니다. 5초의 타임아웃 값을 사용하는 것이 권장됩니다. 타임아웃 값은 설치 후 첫 실행 시 Singular SDK가 ODM SDK로부터 ODM 정보를 기다리기 위해 초기화를 지연시키는 최대 시간을 설정합니다.

     중요: ODM SDK로부터 ODM 정보를 기다리는 과정은 Singular 딥링크 콜백 핸들러와 같은 Singular SDK 콜백을 지연시킵니다. 따라서 딥링크가 지연될 수 있습니다

     
     

   • Flutter SDK 최소 버전 v1.8.0
   • React Native SDK 최소 버전 v3.9.0
   • Cordova SDK 최소 버전 v1.8.0
   • 앱 타겟의 " Other Linker Flags "에 " -ObjC "를 반드시 추가하세요

   • Singular SDK를 초기화할 때 SingularConfig 에 enableOdmWithTimeoutInterval 구성 옵션을 추가하여 Singular가 ODM 정보를 수집하도록 활성화합니다.
     
     enableOdmWithTimeoutInterval 은 초 단위의 타임아웃 값으로 설정됩니다. 5초의 타임아웃 값을 사용하는 것이 권장됩니다. 타임아웃 값은 설치 후 첫 실행 시 Singular SDK가 ODM SDK로부터 ODM 정보를 기다리기 위해 초기화를 지연시키는 최대 시간을 설정합니다.

     중요: ODM SDK로부터 ODM 정보를 기다리는 과정은 Singular 딥링크 콜백 핸들러와 같은 Singular SDK 콜백을 지연시킵니다. 따라서 딥링크가 지연될 수 있습니다

     config.enableOdmWithTimeoutInterval = 5

   1. 앱이 처음 실행된 직후 On Device 정보를 가져옵니다
      
      Swift:

      import GoogleAdsOnDeviceConversion
      
      // Set the time when the app was first launched.
      ConversionManager.sharedInstance.setFirstLaunchTime(Date())
      
      // Fetch the conversion info.
      ConversionManager.sharedInstance.fetchAggregateConversionInfo(for: .installation)
      { aggregateConversionInfo, error in
         guard error == nil else { return }
         guard let info = aggregateConversionInfo else {
            // Troubleshoot:
            // 1. Check that the Date passed to setFirstLaunchTime() was when the app
            //    first launched.
            // 2. Check that your app is running in an approved region.
            return
         }
         guard info.count  0 else { return }
      
         print("Conversion info \(info)")
         // Use info as the value in the odm_info query parameter in
         // the App Conversion API detailed in Step 6.
         // For example, if info is "abcdEfadGdaf", then odm_info=abcdEfadGdaf.
      }

      
      Objective C:

      @import GoogleAdsOnDeviceConversion;
      
      // Set the time when the app was first launched.
      [[ODCConversionManager sharedInstance] setFirstLaunchTime:[NSDate date]];
      
      // Fetch the conversion info.
      [[ODCConversionManager sharedInstance]
         fetchAggregateConversionInfoForInteraction:ODCInteractionTypeInstallation
         completion:^(NSString * _Nullable aggregateConversionInfo,
                      NSError * _Nullable error) {
         if (error) {
            return;
         }
         if (aggregateConversionInfo.length == 0) {
            // Troubleshoot:
            // 1. Check that the NSDate passed to setFirstLaunchTime() was when the app
            //    first launched.
            // 2. Check that your app is running in an approved region.
            return;
         }
      
         NSLog(@"Conversion info %@", aggregateConversionInfo);
         // Use aggregateConversionInfo as the value in the odm_info query parameter in
         // the App Conversion API detailed in Step 6.
         // For example, if aggregateConversionInfo is "abcdEfadGdaf",
         // then odm_info=abcdEfadGdaf.
      }];

      중요:

      • 이 단계는 비동기 작업이므로 완료되기 전까지 Session 이벤트를 전송하지 않아야 할 수 있습니다.
      • odm_info 를 수집하여 첫 세션에 추가할 수 있도록 앱 스토리지에 공유하세요. 이 값은 "odm_info" 파라미터를 통해 Singular의 S2S API로 전달됩니다
      • 오류가 있는 경우 오류를 수집하세요. 이 값은 " odm_error " 파라미터를 통해 Singular의 S2S API로 전달됩니다
      • setFirstLaunchTime 과 함께 전달되는 날짜 타임스탬프는 " utime " 파라미터를 통해 Singular의 S2S API로 전달되는 설치 타임스탬프와 크게 차이가 나서는 안 된다는 점에 유의하세요.
   2. On Device 정보를 Singular의 S2S API로 전달합니다
      
      모든 앱 설치 세션(install=true)에 대해 ODM info와 ODM error를 Singular S2S /launch 엔드포인트에 포함하세요.

EEA 유저에 대한 유저 동의 신호를 언제 어떻게 수집할지는 유저 프라이버시에 대한 비즈니스 및 앱의 요구사항을 준수해야 합니다. 앱이 GDPR, ePrivacy Directive, Digital Markets Act와 같은 내부 프라이버시 정책 및 프라이버시 규정을 어떻게 준수해야 하는지 이해하려면 비즈니스의 법률 자문을 받으세요.

유저 동의 신호를 수집하기로 결정한 경우 일반적으로 다음이 권장됩니다:

• 유저 동의 신호는 유저가 명시적으로 옵트인 또는 옵트아웃한 경우에만 설정합니다. 유저가 선택하지 않은 경우 LDS는 설정하지 않은 상태로 두는 것이 권장됩니다. 유저 신호의 부재가 중요할 수 있습니다.
• 유저 동의 신호는 일반적으로 앱 경험 중 "Privacy Choices" 또는 "Privacy Settings"에서 수집됩니다.
• 가능한 경우, 그리고 앱의 동의 프롬프트 설계 및 전략에 따라, Singular 및 기타 SDK가 유저 동의 신호를 가능한 한 빨리 수집할 수 있도록 앱 플로우 초기에 프라이버시 프롬프트를 표시하세요
  

EEA 유저에 대한 EU 프라이버시 규정이 귀하의 앱에 적용된다고 비즈니스가 판단한 경우: 앱이 이러한 유저에게 제시하는 동의 프롬프트를 기반으로 Singular SDK/S2S "Limit Data Sharing" 기능을 구현하세요.

EU 프라이버시 규정이 귀하의 앱에 적용되지 않는다고 비즈니스가 판단한 경우 , Singular에서 EEA 유저 동의 신호를 옵트아웃할 수 있습니다. 파트너 구성의 "User Privacy" 섹션에서 "EEA opt-out" 옵션을 체크하세요. 이 옵션을 사용하면 LDS 및 유저 동의 신호는 Google에서 사용되지 않습니다.

• 이 옵션을 사용하는 경우 EEA 유저에 대한 LDS 구현은 필요하지 않습니다
• 이 옵션은 Google의 3월 업데이트가 적용되기 전에 활성화할 수 있습니다

Singular의 Limit Data Sharing (LDS)은 앱 개발자가 각 유저의 유저 동의 신호를 Singular에 전달할 수 있게 하는 기능입니다. LDS는 유저별로 설정되며 SDK 초기화 전후에 설정할 수 있습니다. LDS는 Singular User Privacy Postbacks에 사용되며, Google과 같은 특정 파트너에게 전달되어 그들이 자체 데이터 관행을 준수하는 데 사용됩니다.

" Limit Data Sharing으로 유저 프라이버시 선택 지원하기 FAQ "를 참조하세요

Google은 필요한 유저 동의 신호를 지원하는 동의 관리 플랫폼 (CMP)을 나열합니다. 이러한 CMP 중 하나를 사용하는 경우 유저 동의 신호를 추출하여 Singular의 LimitDataSharing 기능을 통해 전달 할 수 있습니다.

유저 동의를 옵트아웃하는 EEA 유저의 경우:

• Google Ads 캠페인에 대한 유저 레벨 귀속은 Singular에서 사용할 수 없습니다. Google은 이러한 귀속을 MMP에 보고할 수 없습니다
• Google Ads는 이러한 유저에 대한 전환을 모델링하며, 이는 Singular가 Google Ads 데이터 커넥터에서 가져오는 집계 네트워크 지표에 반영됩니다.
• Google Ads는 이러한 유저의 데이터를 광고 목적으로 사용할 수 없습니다

유저 동의를 옵트인하는 EEA 유저의 경우:

• Google Ads 캠페인에 대한 유저 레벨 귀속이 가능합니다
• Google Ads는 이 데이터를 광고 목적으로 사용합니다