이 페이지는 Cloud Translation API를 통해 번역되었습니다.

개인 정보 보호 앱 기여 분석

요약

Google Ads의 앱 전환 추적 및 리마케팅 API를 활용하여 앱 전환을 직접 전달하는 API 소비자는 다음 Android 및 iOS 안내를 따라야 합니다. 이렇게 하면 광고 추적 또는 광고 개인 최적화를 선택 해제한 사용자의 클릭이 개인 정보 보호 워크플로를 사용하는 경우에만 기여 분석됩니다. 매개변수 정의 및 예상 값에 대한 자세한 내용은 요청 및 응답 사양 개요를 참조하세요.

Android 앱

범위

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

배경

현재 광고 개인 최적화를 거부한 Android 사용자는 Google 정책에 따라 Android 광고 ID를 사용하여 추적할 수 없습니다. 대신 Google에서는 기기와 함께 유지되지 않는 클릭 URL 매개변수인 gclid를 사용합니다.

추진 방향

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

지원되는 시나리오

지원되는 시나리오: 설치 (사용자가 앱을 설치하지 않은 경우)

앱 설치가 Google Play 스토어로 리디렉션되는 딥 링크로 구동되고 사용자가 먼저 앱을 열 때 Play Install Referrer API install_referrer 필드의 gclid 값을 파싱하여 기기 또는 퍼스트 파티 식별자로 키가 지정된 서버 측에 저장합니다. 이 gclid는 180일 동안 또는 최근의 다른 Play 설치 리퍼러(gclid)가 이를 저장할 때까지 저장해야 합니다.이 gclid는 market_referrer_gclid 전환 요청 필드를 통해 전달될 수 있습니다.

광고 ID 사용 가능

Android 광고 ID를 사용할 수 있는 경우 market_referrer_gclid을 해당하는 first_open 이벤트와 함께 전송해야 합니다. market_referrer_gclid는 다운스트림 세션 및 앱 이벤트 (예: 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
       &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
       &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를 사용할 수 없는 경우 해당 first_open 이벤트 및 모든 다운스트림 세션 및 앱 이벤트(예: session_start, add_to_cart, in_app_purchase)와 함께 market_referrer_gclid/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
       &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
       &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

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

딥 링크로 앱 세션을 구동하는 경우 gclid 값을 파싱하여 자사 식별자로 키가 지정된 기기 또는 서버 측에 저장합니다.
gclid는 180일 동안 또는 다른 최근 gclid가 이를 대체할 때까지 저장해야 합니다. 그러면 gclid 전환 요청 필드를 통해 이 값을 전달할 수 있습니다.

광고 ID 사용 가능

Android 광고 ID를 사용할 수 있는 경우 해당하는 session_start 이벤트와 함께 gclid를 전송해야 합니다. gclid는 앱 이벤트 (예: add_to_cart, in_app_purchase)와 함께 전송할 수 있습니다. gclid를 다운스트림 session_start 이벤트와 함께 전달해서는 안 됩니다.

예: 딥 링크 세션

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
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M

예: 앱 이벤트

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
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M

예: 후속/자연 세션

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
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M

광고 ID를 사용할 수 없습니다.

Android 광고 ID를 사용할 수 없는 경우 해당 session_start 이벤트, 모든 다운스트림 세션, 앱 이벤트 (예: session_start, add_to_cart, in_app_purchase 등)와 함께 gclid를 전송해야 합니다. 참고: 사용자는 광고 개인 최적화를 선택 해제했으므로 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
       &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

예: 앱 이벤트

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
       &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

예: 후속/자연 세션

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
       &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

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

앱 설치가 Google Play 스토어로 연결되는 딥 링크로 유도된 후 앱의 딥 링크로 이어지는 앱 세션이 발생하면 Play Install ReReferr API gclid 및 딥 링크 gclid 값을 모두 파싱하여 퍼스트 파티 식별자로 키가 지정된 기기 또는 서버 측에 저장합니다. 이러한 gclid 값은 180일 동안 또는 다른 최근 딥 링크 gclid가 기존 딥 링크 gclid을 대체하거나 Play Install Referrer API gclid가 기존 Play Install Referrer API gclid을 대체할 때까지 저장됩니다. Play Install Referrer API gclid는 market_referrer_gclid field를 통해 전달되고 그리고 딥 링크 gclid는 gclid 필드를 통해 전달되어야 합니다.

광고 ID 사용 가능

Android 광고 ID를 사용할 수 있는 경우 session_start 및 앱 이벤트(add_to_cart, in_app_purchase 등)와 함께 market_referrer_gclid 및 gclid를 모두 전송해야 합니다. 다운스트림 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
       &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

예: 앱 이벤트

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
       &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

예: 후속/자연 세션

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
       &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

광고 ID를 사용할 수 없습니다.

Android 광고 ID를 사용할 수 없는 경우 해당 session_start 이벤트와 모든 다운스트림 세션 및 앱 이벤트 (예: session_start, add_to_cart, in_app_purchase)와 함께 market_referrer_gclid 및 gclid를 모두 전송해야 합니다. 참고: 사용자가 광고 개인 최적화를 선택 해제했으므로 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
       &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

예: 앱 이벤트

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
       &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

예: 후속/자연 세션

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
       &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

중요: Play Install Referrer API gclid(market_referrer_gclid로 전달됨) 및 딥 링크(gclid로 전달됨)는 gclid의 별도의 소스이므로 서로 바꿔서 사용할 수 없습니다. 이러한 gclid 값은 180일 동안 또는 다른 최근 딥 링크 gclid가 기존 딥 링크 gclid을 대체하거나 Play Install Referrer API gclid가 기존 Play Install Referrer API gclid을 대체할 때까지 저장해야 합니다.

iOS 앱

범위

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

배경

앱 추적을 선택하지 않은 iOS 14.5 이상 사용자는 IDFA를 사용하여 추적할 수 없습니다 (Apple의 ATT 정책에 따름). 대신 Google에서는 집계된 클릭 URL 매개변수인 gbraid를 사용합니다.

추진 방향

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

지원되는 시나리오

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

딥 링크로 앱 세션을 구동하는 경우 gclid 및 gbraid 값을 파싱한 후 퍼스트 파티 식별자로 키가 지정된 기기 측 또는 서버 측에 저장합니다. 이 값은 180일 동안 또는 더 최근 값으로 대체할 때까지 저장해야 합니다. 그런 다음 gclid 값을 gclid 전환 요청 필드를 통해 전달할 수 있고 gbraid 값을 gbraid 전환 요청 필드를 통해 전달할 수 있습니다.

IDFA 사용 가능

IDFA를 사용할 수 있는 경우 추가 필드/값인 app_open_source=ad_click과 함께 gclid 및 gbraid을 해당하는 session_start 이벤트와 함께 전송해야 합니다. 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
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=BX3QojHp4mY5MrJtFM_d1u
       &gbraid=Cj0KEQjw0dy4BRCuuL_e5M
       &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
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=BX3QojHp4mY5MrJtFM_d1u

예: 후속/자연 세션

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
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=BX3QojHp4mY5MrJtFM_d1u
       &app_open_source=organic

IDFA를 사용할 수 없습니다.

IDFA를 사용할 수 없는 경우 gbraid를 추가 필드/값인 app_open_source=ad_click과 함께 해당하는 session_start 이벤트와 함께 전송해야 합니다. 모든 다운스트림 앱 이벤트 (예: add_to_cart, in_app_purchase 등)에 해당합니다. 참고: gclid 필드는 생략해야 하며, rdid 값은 사용자가 동의하지 않으므로 모두 0이어야 합니다. 또한 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=00000000-0000-0000-0000-000000000000
       &id_type=idfa
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=Cj0KEQjw0dy4BRCuuL_e5M
       &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
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=Cj0KEQjw0dy4BRCuuL_e5M

예: 후속/자연 세션

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
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=Cj0KEQjw0dy4BRCuuL_e5M
       &app_open_source=organic

참고: 사용자가 iTunes로 처음 리디렉션되므로 설치 시나리오에서는 gbraid를 활용할 수 없습니다.