요약
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 ×tamp=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 ×tamp=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 ×tamp=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 ×tamp=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 ×tamp=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 ×tamp=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 ×tamp=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 ×tamp=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 ×tamp=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 ×tamp=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 ×tamp=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 ×tamp=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 ×tamp=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 ×tamp=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 ×tamp=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 ×tamp=1432681913.123456 &gclid=Cj0KEQjw0dy4BRCuuL_e5M &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u &gclid_only_request=1
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 ×tamp=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 ×tamp=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 ×tamp=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 ×tamp=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 ×tamp=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 ×tamp=1432681913.123456 &gbraid=Cj0KEQjw0dy4BRCuuL_e5M &app_open_source=organic