개인 정보 보호 앱 기여 분석

요약

Google Ads의 앱 전환 추적 및 리마케팅 API를 활용하여 앱 전환을 직접 전달하는 API 소비자는 다음 Android 및 iOS 안내를 따라야 합니다. 그러면 광고 추적 또는 광고 개인 최적화를 거부한 사용자의 클릭이 개인 정보 보호 준수 워크플로를 통해서만 반영됩니다. 매개변수 정의 및 예상 값에 대한 자세한 내용은 요청 및 응답 사양 개요를 참고하세요.

Android 앱

범위

모든 Google Ads 캠페인을 통한 앱 설치 및 앱 참여

배경

현재 광고 개인 최적화를 거부한 Android 사용자는 Google 정책에 따라 Android 광고 ID를 사용하여 추적할 수 없습니다. 대신 Google은 기기와 연결되지 않는 클릭 URL 매개변수인 gclid를 활용합니다. 또한 Google은 사용자 수준 동의가 부여되지 않은 다른 시나리오에서 집계 클릭 URL 매개변수인 gbraid를 사용할 수 있습니다.

안내

앱 전환 추적 및 리마케팅 API 소비자는 gclid 및 gbraid가 올바르게 저장되고 전달되는지 확인해야 합니다.

지원되는 시나리오

지원되는 시나리오: 설치 (사용자가 이전에 앱을 설치하지 않음)

앱 설치가 Google Play 스토어로 리디렉션되는 딥 링크로 구동되고, 사용자가 처음 앱을 여는 경우 Play Install Referrer API install_referrer 필드의 gclid 값을 파싱한 후 퍼스트 파티 식별자를 키로 삼아 이 값을 기기 또는 서버 측에 저장합니다. 각 값은 180일 동안 또는 다른 최신 값으로 대체될 때까지 저장해야 합니다. gclid 값은 market_referrer_gclid 전환 요청 필드를 통해 전달되어야 합니다.

광고 ID를 사용할 수 있음

Android 광고 ID를 사용할 수 있는 경우 market_referrer_gclid는 해당 first_open 이벤트 및 모든 다운스트림 세션 및 앱 이벤트(예: session_start, add_to_cart, in_app_purchase 등)와 함께 전송되어야 합니다.

예: 처음 열 때
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
예: 세션 및 앱 이벤트
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
광고 ID를 사용할 수 없음

Android 광고 ID를 사용할 수 없는 경우 market_referrer_gclid는 반드시 해당 first_open 이벤트 및 모든 다운스트림 및 앱 이벤트(예: session_start, add_to_cart, in_app_purchase 등)와 추가 필드/값 gclid_only_request=1과 함께 전송되어야 합니다. 참고: 사용자가 동의하지 않으므로 rdid 값은 모두 0이어야 합니다.

예: 처음 열 때
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1
예: 세션 및 앱 이벤트
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1

지원되는 시나리오: 앱 참여 (사용자가 이미 앱을 설치함)

앱 세션이 딥 링크로 구동되는 경우, 리퍼러 URL에서 gclid 및 gbraid 값을 파싱한 후 퍼스트 파티 식별자를 키로 삼아 이 값을 기기 또는 서버 측에 저장합니다. 각 값은 180일 동안 또는 다른 최신 값으로 대체될 때까지 저장해야 합니다. 딥 링크 gclid 값은 gclid 전환 요청 필드를 통해 전달되어야 하고, 딥 링크 gbraid 값은 gbraid 전환 요청 필드를 통해 전달되어야 합니다.

광고 ID를 사용할 수 있음

Android 광고 ID를 사용할 수 있는 경우 gclid 및 gbraid는 해당 session_start 이벤트 및 모든 다운스트림 세션 및 앱 이벤트 (예: session_start, add_to_cart, in_app_purchase 등)와 함께 전송되어야 합니다.

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
예: 앱 이벤트
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
예: 후속/자연 세션
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
광고 ID를 사용할 수 없음

Android 광고 ID를 사용할 수 없는 경우 gclid는 반드시 해당 session_start 이벤트 및 모든 다운스트림 세션 및 앱 이벤트 (예: session_start, add_to_cart, in_app_purchase 등)와 함께 전송되어야 합니다. 참고: 사용자가 광고 개인 최적화를 거부했으므로 RDID 값은 모두 0이어야 합니다.

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
예: 앱 이벤트
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
예: 후속/자연 세션
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O

지원되는 시나리오: 설치 및 참여

Google Play 스토어로 연결되는 딥 링크로 구동되는 앱 설치가 발생한 후 앱으로 연결되는 딥 링크로 구동되는 앱 세션이 이어서 발생하는 경우, Play Install Referrer API install_referrer 필드의 gclid 값과 참조 URL의 gclid 및 gbraid 값을 모두 파싱한 후 퍼스트 파티 식별자를 키로 삼아 이 값을 기기 또는 서버 측에 저장합니다. 각 값은 180일 동안 또는 다른 최신 값으로 대체될 때까지 저장해야 합니다. 그러면 설치 리퍼러 gclid 값이 market_referrer_gclid 전환 요청 필드를 통해 전달되고, 딥 링크 gclid 값이 gclid 전환 요청 필드를 통해 전달되고, 딥 링크 gbraid 값이 gbraid 전환 요청 필드를 통해 전달됩니다.

광고 ID를 사용할 수 있음

Android 광고 ID를 사용할 수 있는 경우 market_referrer_gclid와 gclid 모두 해당 session_start 이벤트 및 앱 이벤트(예: add_to_cart, in_app_purchase 등)와 함께 전송되어야 합니다. 다운스트림 session_start 이벤트의 경우 market_referrer_gclid를 전달하지만 (딥 링크) gclid를 전달해서는 안 됩니다.

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
예: 앱 이벤트
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
예: 후속/자연 세션
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       <&gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
광고 ID를 사용할 수 없음

Android 광고 ID를 사용할 수 없는 경우 market_referrer_gclid와 gclid 모두 해당 session_start 이벤트 및 모든 다운스트림 세션 및 앱 이벤트 (예: session_start, add_to_cart, in_app_purchase 등)와 함께 전송되어야 합니다. 참고: 사용자가 광고 개인 최적화를 거부했으므로 rdid 값은 모두 0이어야 합니다.

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
예: 앱 이벤트
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
예: 후속/자연 세션
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O

iOS 앱

범위

Google Ads 검색, 쇼핑, iOS ACi 및 딥 링크를 통한 앱 참여

배경

앱 추적에 동의하지 않은 iOS 14.5 이상 사용자는 Apple의 ATT 정책에 따라 IDFA를 사용하여 추적할 수 없습니다. 대신 Google은 집계 클릭 URL 매개변수인 gbraid를 사용합니다. 또한 사용자 수준 동의가 부여되지 않은 다른 시나리오에서 Google이 gbraid를 사용할 수 있습니다.

안내

앱 전환 추적 및 리마케팅 API 소비자는 gclid 및 gbraid를 포함한 모든 클릭 매개변수가 올바르게 전달되는지 확인해야 합니다.

지원되는 시나리오

지원되는 시나리오: 앱 참여 (사용자가 이미 앱을 설치함)

앱 세션이 딥 링크로 구동되는 경우, 참조 URL에서 gclid 및 gbraid 값을 파싱한 후 퍼스트 파티 식별자를 키로 삼아 이 값을 기기 또는 서버 측에 저장합니다. 각 값은 180일 동안 또는 다른 최신 값으로 대체될 때까지 저장해야 합니다. gclid 값은 gclid 전환 요청 필드를 통해 전달되어야 하고, gbraid 값은 gbraid 전환 요청 필드를 통해 전달되어야 합니다.

IDFA를 사용할 수 있음

IDFA를 사용할 수 있는 경우 gclid 및 gbraid는 해당 session_start 이벤트 및 추가 필드/값 app_open_source=ad_click과 함께 전송되어야 합니다. gclid 및 gbraid는 다운스트림 세션 및 앱 이벤트 (예: session_start, add_to_cart, in_app_purchase 등)와 함께 전송되어야 합니다. 후속 다운스트림 세션에는 추가 필드/값 app_open_source=organic이 포함됩니다.

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       &app_open_source=ad_click
예: 앱 이벤트
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
예: 후속/자연 세션
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       &app_open_source=organic
IDFA를 사용할 수 없음

IDFA를 사용할 수 없는 경우 gbraid는 반드시 해당 session_start 이벤트, 추가 필드/값 app_open_source=ad_click 및 모든 다운스트림 앱 이벤트 (예: add_to_cart, in_app_purchase)와 함께 전송되어야 합니다. 참고: gclid 필드는 생략해야 하며, rdid 값은 사용자가 동의하지 않으므로 모두 0이어야 합니다. 또한 다운스트림 세션 및 해당 앱 이벤트 (예: session_start, add_to_cart, in_app_purchase 등)와 함께 전송되려면 gbraid가 필요합니다. 후속 다운스트림 세션에는 추가 필드/값 app_open_source=organic이 포함됩니다.

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=idfa
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       &app_open_source=ad_click
예: 앱 이벤트
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=idfa
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
예: 후속/자연 세션
POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=idfa
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       &app_open_source=organic