Ta strona została przetłumaczona przez Cloud Translation API.

Atrybucja aplikacji zgodna z zasadami ochrony prywatności

Podsumowanie

Klienci, którzy korzystają ze śledzenia konwersji w aplikacji i interfejsu API remarketingu w Google Ads do bezpośredniego przekazywania konwersji w aplikacji, powinni przestrzegać następujących wskazówek dotyczących Androida i iOS. Dzięki temu kliknięcia pochodzące od użytkowników, którzy zrezygnowali z śledzenia reklam lub personalizacji reklam, są przypisywane tylko za pomocą procedur zgodnych z prywatnością. Więcej informacji o definicjach parametrów i oczekiwanych wartościach znajdziesz w specyfikacji żądania i odpowiedzi.

Aplikacje na Androida

Zakres

Instalacja aplikacji i zaangażowanie w aplikację z wykorzystaniem wszystkich kampanii Google Ads

Tło

Obecnie użytkowników Androida, którzy zrezygnowali z personalizacji reklam, nie można śledzić za pomocą identyfikatora wyświetlania reklam na urządzeniach z Androidem (zgodnie z zasadami Google). Zamiast tego Google korzysta z parametru gclid kliknięcia, który nie zachowuje się na urządzeniu.

Wskazówki

Klienci, którzy chcą korzystać ze śledzenia konwersji w aplikacji i interfejsu API remarketingu, muszą prawidłowo przechowywać i przekazywać gclid.

Obsługiwane scenariusze

Obsługiwany scenariusz: instalacja (użytkownik nie zainstalował wcześniej aplikacji)

Gdy instalacja aplikacji jest realizowana przez precyzyjny link, który przekierowuje do Sklepu Google Play, a użytkownik otwiera aplikację po raz pierwszy, przeanalizuj wartość gclid z pola Play Install Referrer API install_referrer i zapisz ją na urządzeniu lub po stronie serwera z identyfikatorem własnym. Ten element gclid powinien być przechowywany przez 180 dni lub do momentu zastąpienia go przez nowszą stronę odsyłającą do instalacji w Google Play gclid.Ten element gclid można przekazać w polu żądania konwersji market_referrer_gclid.

Identyfikator wyświetlania reklam jest dostępny

Jeśli identyfikator wyświetlania reklam na urządzeniach z Androidem jest dostępny, element market_referrer_gclid musi zostać wysłany z odpowiednim zdarzeniem first_open. market_referrer_gclid można wysyłać z sesjami na ścieżce i zdarzeniami w aplikacjach (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
       &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

Przykład: zdarzenia w sesji i 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
       &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

Identyfikator wyświetlania reklam NIE jest dostępny

Gdy Identyfikator wyświetlania reklam na urządzeniach z Androidem NIE jest dostępny, właściwość market_referrer_gclid jest wymagana razem z odpowiednim zdarzeniem first_open i WSZYSTKI sesjami niższego szczebla; zdarzeniami aplikacji (np. session_start, add_to_cart, in_app_purchase itd.) wraz z dodatkowym polem/wartością gclid_only_request=1. Uwaga: wartość rdid powinna wynosić 0 (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
       &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

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

Obsługiwany scenariusz: Zaangażowanie w aplikację (użytkownik już ją zainstalował)

Gdy sesja aplikacji jest wywoływana za pomocą precyzyjnego linku, przeanalizuj wartość gclid i zapisz ją na urządzeniu lub po stronie serwera z identyfikatorem własnym.
gclid musi być przechowywany przez 180 dni lub do momentu, gdy inny, gclid zostanie zastąpiony przez inny. Tę wartość możesz następnie przekazać w polu żądania konwersji gclid.

Identyfikator wyświetlania reklam jest dostępny

Jeśli identyfikator wyświetlania reklam na urządzeniach z Androidem jest dostępny, zdarzenie gclid musi być wysłane z odpowiednim zdarzeniem session_start. gclid można wysyłać ze zdarzeniami w aplikacji (np. add_to_cart, in_app_purchase itd.). gclid NIE powinien być przekazywany za pomocą zdarzeń session_start niższego poziomu.

Przykład: sesja z precyzyjnymi linkami

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

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

Przykład: sesja sekwencyjna i 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
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M

Identyfikator wyświetlania reklam NIE jest dostępny

Jeśli identyfikator wyświetlania reklam na urządzeniu z Androidem NIE jest dostępny, wymagany jest parametr gclid, który należy przesłać z odpowiednim zdarzeniem session_start i WSZYSTKIMI sesjami i zdarzeniami w aplikacji (takimi jak session_start, add_to_cart, in_app_purchase itd.). Uwaga: cała wartość powinna wynosić zero, ponieważ użytkownik zrezygnował z personalizacji reklam.

Przykład: sesja z precyzyjnymi linkami

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

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

Przykład: sesja sekwencyjna i 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
       &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

Obsługiwany scenariusz: instalacja + zaangażowanie

Gdy instalacja aplikacji jest oparta na precyzyjnym linku do Sklepu Google Play, a następnie sesja aplikacji, której źródłem jest precyzyjny link, przeanalizuj wartości podane w interfejsie API do instalacji gclid z Google Play i linkiem gclid precyzyjnego linku. Zapisz je też na urządzeniu lub po stronie serwera z własnym identyfikatorem. Wartości gclid powinny być przechowywane przez 180 dni lub do momentu, gdy inny precyzyjny link gclid zastąpi precyzyjny link gclid, lub interfejs Play Install Referrer gclid, który zastąpi istniejący interfejs Play Install Referrer gclid. Interfejs Play Install API gclid należy przekazać za pomocą tagu market_referrer_gclid field, AND precyzyjnego linku gclid w polu gclid.

Identyfikator wyświetlania reklam jest dostępny

Gdy identyfikator wyświetlania reklam na urządzeniach z Androidem jest dostępny, oba te zdarzenia (market_referrer_gclid AND gclid) muszą być wysyłane razem z odpowiednimi zdarzeniami session_start i zdarzeń w aplikacji (np. add_to_cart, in_app_purchase itp.). W przypadku zdarzeń event_start następującego po sobie zdarzenia przekazującego market_referrer_gclid , ale (link precyzyjny) gclid nie należy przekazywać.

Przykład: sesja z precyzyjnymi linkami

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

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

Przykład: sesja sekwencyjna i 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
       &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

Identyfikator wyświetlania reklam NIE jest dostępny

Gdy Identyfikator wyświetlania reklam na urządzeniach z Androidem NIE jest dostępny, oba parametry market_referrer_gclid ORAZ gclid muszą być wysyłane razem z odpowiednimi zdarzeniami session_start oraz WSZYSTKIE zdarzeniami związanymi z sesją i aplikacją (tj. session_start, add_to_cart, in_app_purchase itd.). Uwaga: wartość rdid powinna być zerowa (ponieważ użytkownik zrezygnował z personalizacji reklam).

Przykład: sesja z precyzyjnymi linkami

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

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

Przykład: sesja sekwencyjna i 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
       &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

Ważne: interfejs Play Install Referrer API gclid (przekazany jako market_referrer_gclid) i precyzyjny link gclid (przekazany jako gclid) to 2 osobne źródła dla gclid i nie należy ich używać zamiennie. Wartości gclid powinny być przechowywane przez 180 dni lub do momentu, gdy poprzedni link gclid zastąpi precyzyjny link gclid, lub przez interfejs Play Install Referrer gclid, aby zastąpić istniejący interfejs Play Install Referrer gclid.

Aplikacje na iOS

Zakres

Zaangażowanie w aplikację dzięki wyszukiwarce w Google Ads, Zakupach Google i sieci reklamowej; ACi w iOS + precyzyjne linki

Tło

Użytkownicy urządzeń z systemem iOS 14.5 lub nowszym, którzy nie włączyli śledzenia aplikacji, nie mogą korzystać z identyfikatora IDFA (zgodnie z zasadami ATT firmy Apple). Zamiast tego Google używa zbiorczych parametrów adresu URL gbraid.

Wskazówki

Klienci, którzy korzystają ze śledzenia konwersji w aplikacji i interfejsu API remarketingu, muszą zadbać o prawidłowe przekazanie wszystkich parametrów kliknięć, w tym gclid i gbraid.

Obsługiwane scenariusze

Obsługiwany scenariusz: Zaangażowanie w aplikację (użytkownik już ją zainstalował)

Gdy sesja aplikacji jest wywoływana za pomocą precyzyjnego linku, przeanalizuj wartości gclid i gbraid, a następnie zapisz je na urządzeniu lub po stronie serwera z identyfikatorem własnym. Wartości te powinny być przechowywane przez 180 dni lub do momentu zastąpienia ich nowszą wartością. Wartość gclid można następnie przekazać w polu żądania konwersji gclid, a wartość gbraid – w polu żądania konwersji gbraid.

Identyfikator IDFA jest dostępny

Jeśli identyfikator IDFA jest dostępny, zarówno gclid ORAZ gbraid, jak gclid i gbraid mogą być wysyłane razem z sesjami na ścieżce i zdarzeniami w aplikacji (np. session_start, add_to_cart, in_app_purchase itp.). W przypadku kolejnych sesji niższego poziomu dodaj dodatkowe pole/wartość: app_open_source=organic.

Przykład: sesja z precyzyjnymi linkami

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

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

Przykład: sesja sekwencyjna i 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
       &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

Identyfikator IDFA NIE jest dostępny

Jeśli IDFA nie jest dostępne, gbraid musi być wysyłany z odpowiednim zdarzeniem session_start i dodatkowym polem/wartością app_open_source=ad_click. oraz WSZYSTKIE zdarzenia w aplikacji (np. add_to_cart, in_app_purchase itd.). Uwaga: pole gclid należy pominąć, a wartość rdid powinna mieć wartość zero (ponieważ użytkownik nie wyraził zgody). gbraidWymagany jest również w przypadku sesji niższego poziomu i odpowiadających im zdarzeń w aplikacji (np. session_start, add_to_cart, in_app_purchase itd.). W przypadku kolejnych sesji niższego poziomu dodaj dodatkowe pole/wartość: app_open_source=organic.

Przykład: sesja z precyzyjnymi linkami

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

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

Przykład: sesja sekwencyjna i 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
       &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

Uwaga: w scenariuszach instalacji nie można używać gbraid, bo użytkownicy są najpierw przekierowywani do iTunes.