Podsumowanie
Klienci interfejsu API, którzy używają interfejsu Google Ads App Conversion Tracking and Remarketing API do bezpośredniego przekazywania konwersji w aplikacji, powinni postępować zgodnie z tymi wskazówkami dotyczącymi Androida i iOS. Dzięki temu kliknięcia użytkowników, którzy zrezygnowali ze śledzenia reklam lub personalizacji reklam, będą przypisywane tylko przy użyciu przepływów pracy zgodnych z zasadami ochrony prywatności. Więcej informacji o definicjach parametrów i oczekiwanych wartościach znajdziesz w omówieniu specyfikacji żądań i odpowiedzi.
Aplikacje na Androida
Zakres
Instalacje aplikacji i zaangażowanie w aplikację w ramach wszystkich kampanii Google Ads
Tło
Obecnie użytkownicy Androida, którzy zrezygnowali z personalizacji reklam, nie mogą być śledzeni za pomocą identyfikatora wyświetlania reklam na urządzeniach z Androidem (zgodnie z zasadami Google). Zamiast tego Google używa parametru gclid, czyli parametru klikanego URL-a, który nie jest przechowywany na urządzeniu. Dodatkowo Google może używać parametru gbraid, czyli zbiorczego parametru adresu URL kliknięcia, w innych scenariuszach, w których nie uzyskano zgody na poziomie użytkownika.
Wskazówki
Użytkownicy interfejsu API do śledzenia konwersji w aplikacji i remarketingu muszą zadbać o prawidłowe przechowywanie i przekazywanie parametrów gclid i gbraid.
Obsługiwane scenariusze
Obsługiwany scenariusz: instalacja (użytkownik nie zainstalował wcześniej aplikacji)
Gdy instalacja aplikacji jest wynikiem działania linku bezpośredniego, który przekierowuje do Sklepu Google Play, a użytkownik po raz pierwszy otwiera aplikację, przeanalizuj wartość gclid z pola interfejsu Play Install Referrer API
install_referrer i zapisz ją na urządzeniu lub po stronie serwera, używając jako klucza identyfikatora własnego.
Każda wartość powinna być przechowywana przez 180 dni lub do momentu zastąpienia jej nowszą wartością.
Wartość gclid należy przekazać w polu żądania konwersji market_referrer_gclid.
Identyfikator wyświetlania reklam jest dostępny
Gdy dostępny jest identyfikator wyświetlania reklam na urządzeniu z Androidem, parametr market_referrer_gclid musi być wysyłany z odpowiednim zdarzeniem first_open i WSZYSTKIMI sesjami i zdarzeniami w aplikacji (np. session_start,add_to_cart, in_app_purchase itp.).
Przykład: Pierwsze uruchomienie
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
×tamp=1432681913.123456
&market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1uPrzykład: sesja i zdarzenia w aplikacji
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
×tamp=1432681913.123456
&market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1uIdentyfikator wyświetlania reklam jest NIEDOSTĘPNY
Gdy identyfikator wyświetlania reklam na urządzeniu z Androidem jest niedostępny, parametr
market_referrer_gclid musi być wysyłany ze zdarzeniem
first_open i WSZYSTKIMI kolejnymi sesjami i zdarzeniami w aplikacji (np. session_start, add_to_cart, in_app_purchase itp.) oraz dodatkowym polem/wartością gclid_only_request=1. Uwaga: wartość rdid powinna być równa zeru (ponieważ użytkownik nie wyraził zgody).
Przykład: Pierwsze uruchomienie
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
×tamp=1432681913.123456
&market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
&gclid_only_request=1Przykład: sesje i zdarzenia w aplikacji
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
×tamp=1432681913.123456
&market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
&gclid_only_request=1Obsługiwany scenariusz: zaangażowanie w aplikację (użytkownik ma już zainstalowaną aplikację)
Gdy sesja aplikacji jest wywoływana przez precyzyjny link, przeanalizuj wartości gclid i gbraid
z adresu URL odsyłającego i zapisz je na urządzeniu lub po stronie serwera, używając identyfikatora własnego jako klucza.
Każda wartość powinna być przechowywana przez 180 dni lub do momentu zastąpienia jej nowszą wartością.
Wartość linku do aplikacji gclid powinna być przekazywana w polu żądania konwersji gclid, a wartość linku do aplikacji gbraid powinna być przekazywana w polu żądania konwersji gbraid.
Identyfikator wyświetlania reklam jest dostępny
Gdy dostępny jest identyfikator wyświetlania reklam na urządzeniach z Androidem, parametry gclid i gbraid muszą być przesyłane z odpowiednim zdarzeniem session_start oraz WSZYSTKIMI sesjami i zdarzeniami w aplikacji (np. session_start, add_to_cart, in_app_purchase itp.).
Przykład: sesja z precyzyjnym linkiem
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
×tamp=1432681913.123456
&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Przykład: zdarzenia w aplikacji
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
×tamp=1432681913.123456
&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Przykład: kolejna sesja lub sesja bezpłatna
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
×tamp=1432681913.123456
&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Identyfikator wyświetlania reklam jest NIEDOSTĘPNY
Gdy identyfikator wyświetlania reklam na urządzeniu z Androidem jest niedostępny, parametr gclid musi być wysyłany z odpowiednim zdarzeniem session_start oraz WSZYSTKIMI sesjami i zdarzeniami w aplikacji (np. session_start, add_to_cart, in_app_purchase itp.). Uwaga: wartość rdid powinna składać się z samych zer (ponieważ użytkownik zrezygnował z personalizacji reklam).
Przykład: sesja z precyzyjnym linkiem
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
×tamp=1432681913.123456
&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&gclid_only_request=1
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Przykład: zdarzenia w aplikacji
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
×tamp=1432681913.123456
&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&gclid_only_request=1
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Przykład: kolejna sesja lub sesja bezpłatna
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
×tamp=1432681913.123456
&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&gclid_only_request=1
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Obsługiwany scenariusz: instalacja + zaangażowanie
Gdy instalacja aplikacji jest wywoływana przez link bezpośredni do Sklepu Google Play, a sesja aplikacji jest wywoływana przez link bezpośredni do aplikacji, przeanalizuj wartość gclid z pola install_referrer interfejsu Play Install Referrer API oraz wartości gclid i gbraid z adresu URL odsyłającego i zapisz je na urządzeniu lub po stronie serwera, używając jako klucza identyfikatora własnego.
Każda wartość powinna być przechowywana przez 180 dni lub do momentu zastąpienia jej nowszą wartością.
Wartość gclid instalatora powinna być przekazywana w polu żądania konwersji market_referrer_gclid, wartość gclid linku do konkretnego miejsca w aplikacji powinna być przekazywana w polu żądania konwersji gclid, a wartość gbraid linku do konkretnego miejsca w aplikacji powinna być przekazywana w polu żądania konwersji gbraid.
Identyfikator wyświetlania reklam jest dostępny
Gdy dostępny jest identyfikator wyświetlania reklam na Androida, w przypadku odpowiedniego zdarzenia session_start i zdarzeń w aplikacji (np. add_to_cart, in_app_purchase itp.) wymagane jest wysyłanie zarówno market_referrer_gclid, JAK I gclid. W przypadku zdarzeń session_start przekazywanych do dalszych systemów przekaż market_referrer_gclid, ale gclid (precyzyjny link) NIE powinien być przekazywany.
Przykład: sesja z precyzyjnym linkiem
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
×tamp=1432681913.123456
&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Przykład: zdarzenia w aplikacji
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
×tamp=1432681913.123456
&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Przykład: kolejna sesja lub sesja bezpłatna
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
×tamp=1432681913.123456
<&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Identyfikator wyświetlania reklam jest NIEDOSTĘPNY
Gdy identyfikator wyświetlania reklam na urządzeniu z Androidem jest NIEDOSTĘPNY, zarówno market_referrer_gclid, JAK I gclid muszą być wysyłane ze zdarzeniem session_start, a WSZYSTKIE zdarzenia sesji i aplikacji (np. session_start, add_to_cart, in_app_purchase itp.). Uwaga: wartość parametru rdid powinna być zerowa (ponieważ użytkownik zrezygnował z personalizacji reklam).
Przykład: sesja z precyzyjnym linkiem
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
×tamp=1432681913.123456
&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
&gclid_only_request=1
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Przykład: zdarzenia w aplikacji
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
×tamp=1432681913.123456
&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
&gclid_only_request=1
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Przykład: kolejna sesja lub sesja bezpłatna
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
×tamp=1432681913.123456
&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
&gclid_only_request=1
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Aplikacje na iOS
Zakres
Zaangażowanie w aplikację w wyszukiwarce Google Ads, Zakupach Google i kampaniach ACi na iOS z precyzyjnymi linkami
Tło
Użytkownicy iOS 14.5 lub nowszego, którzy nie wyrazili zgody na śledzenie aplikacji, nie mogą być śledzeni za pomocą identyfikatora IDFA (zgodnie z zasadami ATT firmy Apple). Zamiast tego Google używa parametru gbraid, czyli zbiorczego parametru adresu URL kliknięcia. Dodatkowo Google może używać parametru gbraid w innych scenariuszach, w których użytkownik nie wyraził zgody na poziomie użytkownika.
Wskazówki
Klienci interfejsu API śledzenia konwersji w aplikacji i remarketingu muszą zadbać o to, aby wszystkie parametry kliknięć były przekazywane prawidłowo, w tym gclid i gbraid.
Obsługiwane scenariusze
Obsługiwany scenariusz: zaangażowanie w aplikację (użytkownik ma już zainstalowaną aplikację)
Gdy sesja w aplikacji jest wywoływana przez link bezpośredni, przeanalizuj wartości gclid i gbraid z adresu URL odsyłającego i zapisz je na urządzeniu lub po stronie serwera, używając jako klucza własnego identyfikatora.
Każda wartość powinna być przechowywana przez 180 dni lub do momentu zastąpienia jej nowszą wartością.
Wartość gclid należy przekazać w polu żądania konwersji gclid, a wartość gbraid – w polu żądania konwersji gbraid.
IDFA jest dostępny
Gdy identyfikator IDFA jest dostępny, zarówno gclid, JAK I gbraid muszą być wysyłane z odpowiednim zdarzeniem session_start wraz z dodatkowym polem/wartością app_open_source=ad_click. Parametry gclid i gbraid muszą być też przesyłane w sesjach i zdarzeniach aplikacji (np. session_start, add_to_cart, in_app_purchase itp.). W przypadku kolejnych sesji podrzędnych uwzględnij dodatkowe pole/wartość app_open_source=organic.
Przykład: sesja z precyzyjnym linkiem
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
×tamp=1432681913.123456
&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
&app_open_source=ad_click
Przykład: zdarzenie w aplikacji
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
×tamp=1432681913.123456
&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Przykład: kolejna sesja lub sesja bezpłatna
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
×tamp=1432681913.123456
&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
&app_open_source=organic
Identyfikator IDFA jest NIEDOSTĘPNY
Gdy IDFA jest niedostępny, gbraid musi być wysyłany z odpowiednim zdarzeniem session_start wraz z dodatkowym polem/wartością app_open_source=ad_click. i WSZYSTKIE zdarzenia w aplikacjach podrzędnych (np. add_to_cart, in_app_purchase itp.). Uwaga: pole gclid powinno zostać pominięte, a wartość rdid powinna składać się z samych zer (ponieważ użytkownik nie wyraził zgody).
W przypadku sesji podrzędnych i odpowiednich zdarzeń w aplikacji (np. session_start, add_to_cart, in_app_purchase itp.) gbraid jest RÓWNIEŻ wymagany. W przypadku kolejnych sesji podrzędnych uwzględnij dodatkowe pole/wartość app_open_source=organic.
Przykład: sesja z precyzyjnym linkiem
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
×tamp=1432681913.123456
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
&app_open_source=ad_clickPrzykład: zdarzenie w aplikacji
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
×tamp=1432681913.123456
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Przykład: kolejna sesja lub sesja bezpłatna
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
×tamp=1432681913.123456
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
&app_open_source=organic