Bu sayfa, Cloud Translation API ile çevrilmiştir.

Gizlilik Uyumlu Uygulama İlişkilendirmesi

Özet

Uygulama dönüşümlerini doğrudan iletmek için Google Ads'in Uygulama Dönüşüm İzleme ve Yeniden Pazarlama API'sinden yararlanan API tüketicileri, aşağıdaki Android ve iOS yönergelerini uygulamalıdır. Bu sayede, reklam izleme veya reklam kişiselleştirmeyi devre dışı bırakan kullanıcıların tıklamaları yalnızca gizlilikle uyumlu iş akışları kullanılarak ilişkilendirilir. Parametre tanımları ve beklenen değerler hakkında daha fazla bilgi için lütfen İstek &Yanıt Spesifikasyonları Genel Bakış bölümüne bakın.

Android Uygulamaları

Kapsam

Tüm Google Ads kampanyalarından Uygulama Yükleme ve Uygulama Etkileşimi

Arka plan

Şu anda, reklam kişiselleştirmeyi devre dışı bırakan Android kullanıcıları Android Reklam Kimliği kullanılarak izlenemez (Google'ın politikası uyarınca). Bunun yerine Google, cihazda var olmayan bir tıklama URL'si parametresi olan gclid'yi kullanır.

Yönerge

Uygulama Dönüşüm İzleme ve Yeniden Pazarlama API'si tüketicileri, gclid öğesinin doğru şekilde depolandığından ve iletildiğinden emin olmalıdır.

Desteklenen Senaryolar

Desteklenen Senaryo: Yükleme (kullanıcı uygulamayı daha önce yüklememiş)

Uygulama yükleme işlemi, Google Play Store'a yönlendiren bir derin bağlantı tarafından yönlendirildiğinde ve kullanıcı uygulamayı ilk kez açtığında Play Yükleme Referansı API'siinstall_referrer alanından gclid değerini ayrıştırın ve cihazda veya birinci taraf tanımlayıcı tarafından girilen sunucu tarafında depolayın. Bu gclid, 180 gün boyunca veya daha yeni bir Play Yükleme Yönlendiren tarafından değiştirilene kadar gclid boyunca depolanmalıdır.Bu gclid, market_referrer_gclid dönüşüm isteği alanı üzerinden iletilebilir.

Reklam Kimliği Mevcuttur

Android Reklam Kimliği mevcut olduğunda, market_referrer_gclid etiketinin karşılık gelen first_open etkinliğiyle birlikte gönderilmesi gerekir. market_referrer_gclid, aşağı akış oturumları ve uygulama etkinlikleriyle (ör. session_start, add_to_cart, in_app_purchase vb.) gönderilebilir.

Örnek: İlk Açılış

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

Örnek: Oturum ve Uygulama Etkinlikleri

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

Reklam Kimliği VERİLMEZ

Android Reklam Kimliği kullanılamıyorsa market_referrer_gclid, ilgili first_open etkinliği ve TÜM aşağı akış oturumlarıyla (ör. session_start, add_to_cart, in_app_purchase vb.) birlikte ek alan/değerle birlikte gclid_only_request=1 gönderilmesi zorunludur. Not: rdid değeri tamamen sıfır olmalıdır (kullanıcı izin vermediği için).

Örnek: İlk Açılış

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

Örnek: Oturum ve Uygulama Etkinlikleri

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

Desteklenen Senaryo: Uygulama Etkileşimi (kullanıcı uygulamayı zaten yüklemiş)

Bir uygulama oturumu derin bağlantı tarafından tetiklendiğinde, gclid değerini ayrıştırın ve cihazda veya 1. taraf tanımlayıcı tarafından anahtarlanan sunucu tarafında depolayın.
gclid, 180 gün veya başka bir gclid değiştirilene kadar saklanır. Bu değer, gclid dönüşüm isteği alanı aracılığıyla geçirilebilir.

Reklam Kimliği Mevcuttur

Android Reklam Kimliği mevcut olduğunda gclid öğesinin ilgili session_start etkinliği ile gönderilmesi gerekir. gclid, uygulama etkinlikleriyle (ör. add_to_cart, in_app_purchase vb.) gönderilebilir. gclid, aşağı akış session_start etkinlikleriyle GEÇMEMELİDİR.

Örnek: Derin Bağlantı Oturumu

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

Örnek: Uygulama Etkinlikleri

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

Örnek: Sonraki/Organik Oturum

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

Reklam Kimliği VERİLMEZ

Android Reklam Kimliği kullanılamıyorsa ilgili gclid etkinliği ve tüm aşağı akış oturumları ve uygulama etkinlikleriyle (ör. session_start, add_to_cart, in_app_purchase vb.) birlikte gclid gönderilmesi gerekir. Not: Kullanıcı reklam kişiselleştirmeyi devre dışı bıraktığından sıfır değer sıfır olmalıdır.

Örnek: Derin Bağlantı Oturumu

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

Örnek: Uygulama Etkinlikleri

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

Örnek: Sonraki/Organik Oturum

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

Desteklenen Senaryo: Yükleme + Etkileşim

Bir uygulama yükleme işlemi Google Play Store'a bir derin bağlantı tarafından ve ardından uygulamaya bir derin bağlantı tarafından yönlendirilen bir uygulama oturumu yapıldığında, hem Play Yükleme Referansı API'si gclid hem de derin bağlantı gclid değerlerini ayrıştırın ve bunları bir cihazda veya birinci taraf tanımlayıcı tarafından anahtarlanan sunucu tarafında depolayın. Bu gclid değerleri 180 gün boyunca veya yeni bir derin bağlantı gclid derin bağlantısı gclid olana veya bir Play Install Referrer API'si gclid yenilenene kadar saklanmalıdır, mevcut Play Install Referrer API'si gclid Play Yükleme Yönlendiren API'sı gclid market_referrer_gclid field aracılığıyla iletilmelidir VE derin bağlantı gclid URL'si gclid alanı üzerinden geçirilmelidir.

Reklam Kimliği Mevcuttur

Android Reklam Kimliği mevcut olduğunda ilgili session_start etkinliği ve uygulama etkinlikleriyle (ör. add_to_cart, in_app_purchase) hem market_referrer_gclid hem de gclid gönderilmesi gerekir. Akış yönünden session_start etkinlikleri için market_referrer_gclid öğesini iletin, ancak () derin bağlantısı gclid geçirilmemelidir.

Örnek: Derin Bağlantı Oturumu

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

Örnek: Uygulama Etkinlikleri

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

Örnek: Sonraki/Organik Oturum

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

Reklam Kimliği VERİLMEZ

Android Reklam Kimliği kullanılamıyorsa hem session_start hem de ALL yayın içi oturum ve uygulama etkinlikleriyle (ör. session_start, add_to_cart, in_app_purchase) hem market_referrer_gclid hem de gclid gönderilmesi gerekir. Not: Kullanıcı, reklam kişiselleştirmesini devre dışı bıraktığından rdid değerinin tamamı sıfır olmalıdır.

Örnek: Derin Bağlantı Oturumu

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

Örnek: Uygulama Etkinlikleri

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

Örnek: Sonraki/Organik Oturum

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

Önemli: Play Yükleme Yönlendiren API'sı gclid (market_referrer_gclid olarak aktarılır) ve derin bağlantı gclid (gclid olarak aktarılır) gclid için iki ayrı kaynaktır ve birbirinin yerine kullanılmamalıdır. Bu gclid değerlerinin 180 gün boyunca veya mevcut başka derin bağlantı gclid yerine mevcut bir başka derin bağlantı gclid yer aldığına ya da Play Store Yönlendiren API'sinin gclid, mevcut Play Yükleme Yönlendiricisi gclid'nin yerini aldığını unutmayın.

iOS Uygulamaları

Kapsam

Google Ads Arama Ağı, Alışveriş ve &iOS; iOS ACi + Derin Bağlantılar üzerinden Uygulama Etkileşimi

Arka plan

Uygulama izlemeyi etkinleştirmemiş iOS14.5+ kullanıcıları IDFA (Apple'ın ATT politikası uyarınca) kullanılarak izlenemez. Bunun yerine, Google, toplu tıklama URL parametresi olan gbraid'yi kullanır.

Yönerge

Uygulama Dönüşümü İzleme ve Yeniden Pazarlama API'si tüketicileri, gclid ve gbraid dahil olmak üzere tüm tıklama parametrelerinin doğru bir şekilde iletildiğinden emin olmalıdır.

Desteklenen Senaryolar

Desteklenen Senaryo: Uygulama Etkileşimi (kullanıcı uygulamayı zaten yüklemiş)

Bir uygulama oturumu bir derin bağlantı tarafından tetiklendiğinde, gclid ve gbraid değerlerini ayrıştırın ve bunları bir birinci taraf tanımlayıcı tarafından cihazda veya sunucu tarafında anahtarlı olarak depolayın. Bu değerler, 180 gün veya daha yeni bir değerle değiştirilene kadar saklanır. Daha sonra, gclid değeri gclid dönüşüm isteği alanı aracılığıyla ve gbraid değeri, gbraid dönüşüm isteği alanı aracılığıyla aktarılabilir.

IDFA Mevcut

IDFA kullanılabildiğinde hem gclid VE gbraid hem de ilgili session_start etkinliği ve bu alanların ek değeri/app_open_source=ad_click ile gönderilmelidir. gclid ve gbraid aşağı akış oturumları ve uygulama etkinlikleriyle (ör. session_start, add_to_cart, in_app_purchase vb.) gönderilebilir. Sonraki aşağı akışlar için ek alan/değer ekle: app_open_source=organic.

Örnek: Derin Bağlantı Oturumu

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

Örnek: Uygulama Etkinliği

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

Örnek: Sonraki/Organik Oturum

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 KULLANILAMIYOR DEĞİL

IDFA KULLANILAMIYORSA gbraid, karşılık gelen session_start etkinliğiyle birlikte app_open_source=ad_click alan ek değeri/değeriyle gönderilmesi zorunludur. ve TÜM yayın dışı uygulama etkinlikleri (add_to_cart, in_app_purchase vb.) Not: gclid alanı atlanmalı ve rdid değeri sıfır olmalıdır (kullanıcı izin vermediği için). Aşağı akış oturumları ve ilgili uygulama etkinlikleriyle (ör. session_start, add_to_cart, in_app_purchase vb.) gönderilmesi için gbraid AYRICA gereklidir. Sonraki aşağı akışlar için ek alan/değer ekle, app_open_source=organic.

Örnek: Derin Bağlantı Oturumu

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

Örnek: Uygulama Etkinliği

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

Örnek: Sonraki/Organik Oturum

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

Not: Kullanıcılar ilk olarak iTunes'a yönlendirildiği için gbraid yükleme senaryolarında kullanılamaz.