Gizlilik Uyumlu Uygulama İlişkilendirmesi

Özet

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

Android Uygulamaları

Kapsam

Tüm Google Ads kampanyaları aracılığıyla 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 kalıcı olmayan bir tıklama URL'si parametresi olan gclid kullanır. Ayrıca Google, kullanıcı düzeyinde izin verilmemiş olduğu diğer senaryolarda toplu tıklama URL'si parametresi olan gbraid'i kullanabilir.

Yönerge

Uygulama Dönüşümü İzleme ve Yeniden Pazarlama API'si kullanıcıları, gclid ve gbraid değerlerinin doğru şekilde saklandığından ve iletildiğinden emin olmalıdır.

Desteklenen Senaryolar

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

Bir uygulama yüklemesi, Google Play Store'a yönlendiren bir derin bağlantı tarafından yönlendirildiğinde ve kullanıcı uygulamayı ilk kez açtığında gclid değerini Play Install Referrer API install_referrer alanından ayrıştırın ve cihazda veya sunucu tarafında birinci taraf tanımlayıcısıyla anahtarlanmış olarak saklayın. Her değer 180 gün boyunca veya daha yeni bir değerle değiştirilene kadar saklanmalıdır. gclid değeri, market_referrer_gclid dönüşüm isteği alanı üzerinden iletilmelidir.

Reklam kimliği kullanılabilir

Android Reklam Kimliği kullanılabildiğinde, market_referrer_gclid parametresinin ilgili first_open etkinliği ve TÜM sonraki oturumlar ve uygulama etkinlikleriyle (ör. session_start,add_to_cart, in_app_purchase vb.) birlikte gönderilmesi gerekir.

Ö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
       &eea=0
       &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
       &eea=0
       &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 KULLANILAMIYOR

Android reklam kimliği KULLANILAMIYORSA, market_referrer_gclid parametresinin ilgili first_open etkinliğiyle birlikte gönderilmesi ZORUNLUDUR.Ayrıca ek alan/değerle birlikte TÜM sonraki oturumlar ve uygulama etkinlikleri (ör. session_start, add_to_cart, in_app_purchase vb.) gclid_only_request=1 parametresiyle birlikte gönderilmelidir. Not: Kullanıcı izin vermediğinden rdid değeri sıfır olmalıdır.

Ö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
       &eea=0
       &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
       &eea=0
       &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ıyla yönlendirildiğinde, yönlendiren URL'den gclid ve gbraid değerlerini ayrıştırın ve bunları cihazda veya sunucu tarafında birinci taraf tanımlayıcısıyla anahtarlanmış şekilde saklayın. Her değer 180 gün boyunca veya daha yeni bir değerle değiştirilene kadar saklanmalıdır. Derin bağlantı gclid değeri, gclid dönüşüm isteği alanı üzerinden, derin bağlantı gbraid değeri ise gbraid dönüşüm isteği alanı üzerinden iletilmelidir.

Reklam kimliği kullanılabilir

Android Reklam Kimliği kullanılabildiğinde, gclid ve gbraid,ilgili session_start etkinliği ve TÜM sonraki oturumlar ve uygulama etkinlikleriyle (ör. session_start,add_to_cart, in_app_purchase vb.) birlikte gönderilmelidir.

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
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Ö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
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Ö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
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Reklam kimliği KULLANILAMIYOR

Android Reklam Kimliği KULLANILAMIYORSA, ilgili gclid, karşılık gelen session_start etkinliği ve TÜM sonraki oturumlar ve uygulama etkinlikleriyle (ör. session_start, add_to_cart, in_app_purchase vb.) birlikte gönderilmesi gerekir. Not: Kullanıcı reklam kişiselleştirmeyi devre dışı bıraktığı için rdid değeri sıfır olmalıdır.

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
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Ö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
       &eea=0
       &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
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Ö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
       &eea=0
       &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
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O

Desteklenen Senaryo: Yükleme + Etkileşim

Bir uygulama yüklemesi, Google Play Store'a yönlendiren bir derin bağlantı tarafından tetiklendiğinde ve ardından uygulamaya yönlendiren bir derin bağlantı tarafından tetiklenen bir uygulama oturumu gerçekleştiğinde hem Play Install Referrer API install_referrer alanındaki gclid değerini hem de yönlendiren URL'deki gclid ve gbraid değerlerini ayrıştırın ve bunları cihazda veya sunucu tarafında birinci taraf tanımlayıcısıyla anahtarlanmış şekilde saklayın. Her değer 180 gün boyunca veya daha yeni bir değerle değiştirilene kadar saklanmalıdır. Yükleme yönlendiren gclid değeri, market_referrer_gclid dönüşüm isteği alanı üzerinden, derin bağlantı gclid değeri, gclid dönüşüm isteği alanı üzerinden ve derin bağlantı gbraid değeri, gbraid dönüşüm isteği alanı üzerinden iletilmelidir.

Reklam kimliği kullanılabilir

Android reklam kimliği kullanılabildiğinde, market_referrer_gclid VE gclid değerlerinin ilgili session_start etkinliği ve uygulama etkinlikleriyle (ör. add_to_cart, in_app_purchase vb.) birlikte gönderilmesi gerekir. Aşağı akış session_start etkinlikleri için market_referrer_gclid iletin ancak (derin bağlantı) gclid iletilmemelidir.

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
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Ö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
       &eea=0
       &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
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Ö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
       &eea=0
       &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
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Reklam kimliği KULLANILAMIYOR

Android reklam kimliği KULLANILAMIYORSA, hem market_referrer_gclid HEM DE gclid, ilgili session_start etkinliğiyle birlikte gönderilmelidir ve TÜM aşağı akış oturum ve uygulama etkinlikleri (ör. session_start, add_to_cart, in_app_purchase vb.) Not: Kullanıcı reklam kişiselleştirmeyi devre dışı bıraktığı için rdid değeri sıfır olmalıdır.

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
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Ö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
       &eea=0
       &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
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Ö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
       &eea=0
       &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
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O

iOS Uygulamaları

Kapsam

Google Ads Arama, Alışveriş ve iOS ACi + derin bağlantılar aracılığıyla uygulama etkileşimi

Arka plan

Uygulama izlemeyi etkinleştirmeyen iOS 14.5 ve sonraki sürümleri kullanan kullanıcılar, IDFA kullanılarak izlenemez (Apple'ın ATT politikası uyarınca). Bunun yerine Google, toplu bir tıklama URL'si parametresi olan gbraid kullanır. Ayrıca Google, kullanıcı düzeyinde izin verilmemiş diğer senaryolarda da gbraid kullanabilir.

Yönerge

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

Desteklenen Senaryolar

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

Bir uygulama oturumu derin bağlantıyla yönlendirildiğinde, yönlendiren URL'den gclid ve gbraid değerlerini ayrıştırın ve bunları cihazda veya sunucu tarafında birinci taraf tanımlayıcısıyla anahtarlanmış olarak saklayın. Her değer 180 gün boyunca veya daha yeni bir değerle değiştirilene kadar saklanmalıdır. gclid değeri, gclid dönüşüm isteği alanı üzerinden, gbraid değeri ise gbraid dönüşüm isteği alanı üzerinden iletilmelidir.

IDFA Kullanılabilir

IDFA kullanılabilir olduğunda, gclid VE gbraid, ek alan/değer app_open_source=ad_click ile birlikte ilgili session_start etkinliğiyle gönderilmelidir. Ayrıca gclid ve gbraid parametrelerinin de aşağı akış oturumları ve uygulama etkinlikleriyle (ör. session_start, add_to_cart, in_app_purchase vb.) birlikte gönderilmesi gerekir. Sonraki alt akış oturumları için ek alan/değer app_open_source=organic'yi ekleyin.

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
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       &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
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Ö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
       &eea=0
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       &app_open_source=organic
IDFA KULLANILAMIYOR

IDFA kullanılamadığında, gbraid session_start etkinliğiyle birlikte ek alan/değer app_open_source=ad_click ile gönderilmelidir. Bu işlem zorunludur. ve TÜM aşağı akış uygulama etkinlikleri (ör. add_to_cart, in_app_purchase vb.). Not: gclid alanı atlanmalı ve rdid değeri tamamen sıfır olmalıdır (kullanıcı izin vermediği için). Ayrıca gbraid, aşağı akış oturumlarıyla ve ilgili uygulama etkinlikleriyle (ör. session_start, add_to_cart, in_app_purchase vb.) birlikte gönderilmelidir. Sonraki aşağı akış oturumları için ek alan/değer ekleyin, 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
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       &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
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Ö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
       &eea=0
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       &app_open_source=organic