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_d1u
Przykł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_d1u
Identyfikator 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=1
Przykł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=1
Obsł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_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=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