İzleyici ayarları

Metinsel ve görsel reklamlar için veri formatı

Herhangi bir Rich In-App Events formatındaki her türlü eylem desteklenir.

Ürün reklamları ve katalog sayfaları için reklamlar için veri formatı

Rich In-App Events formatındaki şu eylemler gereklidir:

• Ürün görüntüleme – af_content_view;
• Sepete ekleme – af_add_to_cart;
• Sepetten çıkarma – remove_from_cart;
• Satın alma – af_purchase.

Tüm eylemlerde af_content_id parametresi eklenmeli ve bu parametreye ürün kimliği (id) iletilmelidir.

Daha fazla bilgi için eylem kodu uygulama belgelerine bakın.

RHO sınırlamalı Maksimum dönüşüm stratejisi için gereklilikler

Mobil uygulama eylemlerinde gelir toplama af_revenue parametresinde yapılandırılmalıdır. Geliştiriciler için talimatlar:

• Android
• iOS

Metinsel ve görsel reklamlar için veri formatı

Herhangi bir Adjust eylemi desteklenir.

Ürün reklamları ve katalog sayfaları için reklamlar için veri formatı

Partner Parameters’li eylemler desteklenir (Adjust SDK 4.0 ve üstü sürümlerde mevcuttur), burada beklenen parametre offer_id olup, değeri ya bir ürün kimliği ya da json formatında bir ürün listesi olabilir.

AdjustEvent event = new AdjustEvent("VIEWED_CONTENT");
event.addPartnerParameter("offer_id", "10001");
Adjust.trackEvent(event);

AdjustEvent event = new AdjustEvent("PURCHASED");
event.addPartnerParameter("offer_id", "[\"1234\",\"5678\"]");
Adjust.trackEvent(event);

Eğer eylem parametrelerinde ürün kimliği varsa ancak adı offer_id’den farklıysa, uygulamada değişiklik gerekmeyecektir – eylemlerin Yandex Direct’e iletilmesini yapılandırırken bunu Parameter Mapping yardımıyla değiştirebilirsiniz.

Deeplink izleme ile ilişkilendirme

Adjust’ın, uygulamaya geçişten sonra dönüşümleri ilişkilendirmesi için kendi içinde deeplink izlemeyi desteklemesi gerekir. Geliştiriciler için talimatlar:

• Android
• iOS

RHO sınırlamalı Maksimum dönüşüm stratejisi için gereklilikler

Mobil uygulama eylemlerinde gelir toplamanın yapılandırılması gerekiyor. Geliştiriciler için talimatlar:

• Android
• iOS

Genel yapılandırma kuralları

1. Integrated Partners bölümünü açın ve Yandex Direct ortağını seçin.

2. Integration sekmesine gidin.

3. Activate partner seçeneğini etkinleştirin.

4. Yandex App ID alanında mobil uygulama Yandex Direct’e eklenirken App ID’yi belirtin.

5. İşlem aktarımı için In-app events postback seçeneğini etkinleştirin.

6. Eylemleri seçin ve SDK Event Name > Partner Event Identifier uygunluğunu yapılandırın. Önceden tanımlanmış olanlardan hiçbiri uygun değilse EVENT_1, EVENT_2 veya EVENT_3 tanımlayıcılarını kullanın.

7. Gelirin ve eylem parametrelerinin aktarılması için Sending option: All media sources, including organic ve Send revenue: Values & revenue seçeneklerini seçin.

Ürün reklamları ve katalog sayfaları reklamları için gereklilikler

1. Yandex Ecom Feed Counter ID alanında Metrica sayacını 12345 formatında belirtin.

Elektronik ticaretin yapılandırılmış olduğu sitedeki sayacın kullanılmasını öneririz – böylece makine öğrenimi algoritmaları, uygulamada görüntülenen ürünleri site ziyaretçileri (ve bunun tersi) için dikkate alacaktır. Bu, yeniden hedeflemenin etkinliğini artırır.

2. Eylemleri seçin:

• af_content_view > VIEWED_CONTENT (zorunlu);

• af_added_to_cart > ADDED_TO_CART (zorunlu),

• remove_from_cart > REMOVED_FROM_CART (tercihen);

• af_purchase > PURCHASED (zorunlu).

3. Gelirin ve eylem parametrelerinin aktarılması için Sending option: All media sources, including organic ve Send revenue: Values & revenue seçeneklerini seçin.

RHO sınırlamalı Maksimum dönüşüm stratejisi için gereklilikler

Gelirin aktarılması için Send revenue: Values & revenue seçeneğini seçin.

Genel yapılandırma kuralları

1. Uygulama ayarlarına gidin ve Partner Setup bölümünü açın.

2. Add Partner → Yandex Direct → (+) seçeneğini seçin.

3. Yandex App ID alanında mobil uygulama Yandex Direct’e eklenirken App ID’yi belirtin.

4. In-App Revenue Forwarding, Parameter Forwarding ve Session Forwarding seçeneklerini etkinleştirin.

5. Listedeki ile ilgili adları belirterek Event Linking bölümünde eylemlerin aktarılmasını yapılandırın. Tüm ayarlar iOS ve Android için ayrı ayrı belirtilir.

Ürün reklamları ve katalog sayfaları reklamları için gereklilikler

1. Yandex Ecom Feed Counter alanında Metrica sayacını 12345 formatında belirtin.

Elektronik ticaretin yapılandırılmış olduğu sitedeki sayacın kullanılmasını öneririz – böylece makine öğrenimi algoritmaları, uygulamada görüntülenen ürünleri site ziyaretçileri (ve bunun tersi) için dikkate alacaktır. Bu, yeniden hedeflemenin etkinliğini artırır.

2. Event Linking bölümünde etkinlik iletimini ayarlayın.

• Ürün görüntüleme – Viewed content (zorunlu);

• Sepete ekleme – Added to cart (zorunlu);

• Sepetten çıkarma – Removed from cart (tercihen);

• Satın alma – Purchased (zorunlu).

3. Eylemlerde ürün ID’si offer_id adını taşımıyorsa Partner Parameter Mapping’e basın. FROM APP alanında bu parametrenin SDK’da hangi adı taşıdığını belirtin, TO PARTNER alanında ise offer_id’yi belirtin.

Bağlantıda başka değişikliklerin yapılması gerekmez. Tıklamalar, Yandex Direct’ten AppsFlyer’a server-to-server (sunucudan sunucuya) izleme ile gönderilecektir.

Sunucular arası tıklama gönderimi, Yandex Direct’te kampanya ayarlarında etkinleştirilir. Kampanya oluşturmaya başlayın, mobil uygulama için bir hedef seçin. Ondan sonra aşağıdaki sayfada mobil uygulama izleyicisine tıklama aktarımını etkinleştiren bir blok görünecektir.

Evrensel bağlantıya parametreler ekleyin:

• adjust_ya_click_id={logid};

• adjust_campaign={campaign_name};

• adjust_t=abc_def: izleyici belirtecinin ID’sini yazın (her Adjust izleyicisi için otomatik olarak oluşturulan benzersiz kimlik belirteci). Android için abc yerine, iOS için def yerine. Ortadaki alt çizgiyi bırakın. Uygulama çok platformlu ise, tek bir izleyici ID’si belirtilir: adjust_t=abc. adjust_t yerine adjust_tracker parametresini kullanmak kabul edilebilir.

Bağlantı örneği:

https://example.ru/cars/new/group/bmw/3er/21398591-21398651?adjust_ya_click_id={logid}&adjust_t=abc_def&adjust_campaign={campaign_name}

Kampanyada evrensel bağlantılar kullanmadan önce, onları test etmek önemlidir. Bu, doğru yapılandırılmalarını, kullanıcıya yönelik içeriğin teslim edilmesini ve bu bağlantıların Adjust tarafından izlenmesini sağlar.

Ayrıca Adjust’te evrensel bağlantılar hakkında SSS bölümüne göz atabilirsiniz.

Nasıl ayarlanır?

1. Bağlantıları yapılandırın:

• iOS
• Android App Links
• Samsung OS – URI şemaları

2. Bir OneLink şablonu ekleyin.

Bu, reklam kampanyalarında kullanılan tüm OneLink bağlantıları için yönlendirme mantığının temelidir:

• Uygulama yüklü değil – kullanıcı ilgili uygulama mağazasına veya mobil web adresine yönlendirilir.

  Yapılandırma

  Talimat – 1-8, 10 numaralı adımları tamamlayın. Senaryoya bağlı olarak, 6. adımda uygulama mağazasına veya mobil web sayfasına yönlendirmeyi belirtin. Gerekirse markalı bir alan adı ekleyin. Daha fazla bilgi için AppsFlyer makalesine göz atın.

• Uygulama zaten yüklü – kullanıcı Android App Links, iOS Universal Links veya URI şemaları aracılığıyla uygulamayı açar.

  Yapılandırma

  Talimat.

  • iOS evrensel bağlantıları için Team ID’yi belirtin.

  • Android App Links için SHA256 parmak izini belirtin ve otomatik olarak oluşturulan niyet filtresi kodunu kaydedin – bu, Android App Links yapılandırmasını tamamlamak için gereklidir.

3. OneLink bağlantılarını yapılandırın – bunlar reklam ilanlarında görüntülenen tıklanabilir bağlantılardır.

Zorunlu bağlantı parametreleri

• pid=yandexdirect_int
• clickid={logid}
• is_retargeting=true

UTM etiketleri ve diğer kullanıcı parametreleri OneLink bağlantı şablonu ayarlarında belirtilebilir.

Bağlantı örneği:

https://app.appsflyer.com/ru.magnit.express.android?c={campaign_name}&af_siteid={source_type}{source}&af_adset_id={gbid}&af_ad_id={ad_id}&af_keywords={keyword}&keyword_id={phrase_id}&is_retargeting=true&af_click_lookback=7d&af_reengagement_window=30d&af_inactivity_window=0d&google_aid={google_aid}&android_id={android_id}&af_ad={ad_id}&af_sub1={region_neme}&af_sub2={match_type}&af_sub3={position_type}_{position}&af_sub4={keyword}&af_ip={client_ip}&af_ua={user_agent}&af_lang={device_lang}&af_web_dp=https%3A%2F%2Fdostavka.magnit.ru%2Fexpress%2Fpromotion&af_xp=social&deep_link_value=magnit.dostavka%3A%2F%2Fexpress%2Fpromotion&af_dp=magnit.dostavka%3A%2F%2Fexpress%2Fpromotion&deep_link_sub1=magnit.dostavka%3A%2F%2Fexpress%2Fpromotion&advertising_id={google_aid}&oaid={oaid}&pid=yandexdirect_int&clickid={logid}&af_c_id=

Opsiyonel parametreler

• af_click_lookback – ilişkilendirme penceresi (tıklamadan uygulamaya geçişe kadar). Gün olarak belirtilir (ör. 14d). Varsayılan değer (parametre belirtilmezse) – 7 gündür.
• af_reengagement_window – etkileşim penceresi (ilişkilendirmeden, dönüşüme kadar). Gün olarak belirtilir. Varsayılan değer – 30 gündür.

Feed’deki bağlantıların güncellenmesi

Oluşturulan bağlantı şablonunu geliştiriciye iletin, böylece feed’deki ürün bağlantıları yeniden oluşturulabilir.

Feed’de, izleme bağlantısını ürün bağlantısını içeren ögeye ekleyin. Bağlantı, kullanıcıyı web sitesinde veya uygulamada belirli bir ürüne yönlendirmelidir. XML / YML feed’leri için ek gerekliliklere uyun.

Bağlantı, AppsFlyer Yardım’da açıklanmıştır.

Ayrıca Universal Links tabanlı izleme bağlantıları bölümüne göz atın.

Nasıl ayarlanır?

1. Uygulamalarda derin bağlantı için bağlantıları yapılandırın.

2. Yeniden ilişkilendirme ve ertelenmiş derin bağlantı için bağlantıları yapılandırın.

Ertelenmiş derin bağlantının çalışması için şunlar gereklidir:

• iOS ve Android üzerinde derin bağlantı yoluyla yeniden ilişkilendirmeyi destekleyin;
• İzleme bağlantısına cihaz tanımlayıcısı ekleyin (iOS için IDFA ve Android için GPS_ADID).

3. Çok platformlu evrensel izleme bağlantısını yapılandırın:

• İşlenmemiş evrensel izleme bağlantısını ve izleyici belirtecini baz alan çok platformlu bir bağlantı oluşturun.

• iOS ve Android uygulamalarınızın sorgu yol ve parametrelerinin aynı olup olmadığını kontrol edin. Uygun formatı kullanın:

  • iOS ve Android aynı yol ve sorgu parametrelerini kullanıyor;
  • iOS ve Android uygulamalarında farklı yol ve sorgu parametreleri kullanılıyor.

  Evrensel bağlantıyı yapılandırmak için derin bağlantı oluşturucusunu kullanmak daha iyidir.

  Açıklamalı oluşturucu ekran görüntüleri

  

  PLATFORM (platform) – uygulama platformunun adını Adjust kontrol panelinde belirtildiği şekilde girin. Kullanılabilecek seçenekler: Android; iOS; Çok platformlu uygulamalar.

  AD ENVIRONMENT (reklam ortamı) – farklı reklam ortamlarında çalışan birkaç farklı derin bağlantı formatı mevcut. Yandex Direct için Other’ı (Diğer) seçin.

  FORMAT (format) – reklam ortamınıza bağlı olarak birkaç derin bağlantı formatı desteklenebilir. Burada, kullanılacak formatı belirtebilirsiniz. Yandex Direct için ulink’i (evrensel bağlantı) seçin.

  APP (uygulama) – açılır menüden bir uygulama seçin. Seçilen platformdaki tüm uygulamalar listelenecektir.

  TRACKER (izleyici) – kullanmak istediğiniz izleyiciyi seçin. Uygulamadaki ağ düzeyindeki tüm izleyiciler listelenecektir.

  RAW UNIVERSAL LINK (işlenmemiş evrensel bağlantı) – kontrol panelinde evrensel bağlantılar etkinleştirildiğinde uygulama seçildiğinde işlenmemiş evrensel bağlantı otomatik olarak eklenir.

  ANDROID APP SCHEME (Android uygulama şeması) – şema uygulama ayarlarında belirlenir ve bu alana otomatik olarak eklenir.

  IOS UNIVERSAL LINK PATH (iOS evrensel bağlantı yolu) – kullanıcıların yönlendirildiği, iOS uygulamasındaki hedefe giden yol. Uygulamadaki belirli bir ürün / bölüm yolunu veya bir şablonu belirtin.Şablonlar ve yol sentaksı hakkında daha fazla bilgi.

  ANDROID DEEPLINK PATH (Android derin bağlantı yolu) – kullanıcıların yönlendirildiği, Android uygulamasındaki hedefe giden yol. Uygulamadaki belirli bir ürün / bölüm yolunu veya bir şablonu belirtin.Şablonlar ve yol sentaksı hakkında daha fazla bilgi.

  CAMPAIGN, ADGROUP, CREATIVE (kampanya, grup, reklam ögesi) – Yandex Direct için makrolar otomatik olarak önerilecektir. Herhangi bir parametre almak istemiyorsanız, ilgili makroyu belirtmeyin.

  

  LABEL (etiket) – Adjust’taki diğer alanlara uymayan parametreleri burada belirtebilirsiniz.

  FALLBACK URL (yedek URL) – desteklenmeyen platformdaki kullanıcıları (yani desteklenmeyen bir işletim sisteminden gelen tıklamalar) yönlendirdiğiniz ilgili hedef sayfanın adresi. Önemli: Eğer izleyici iOS’u destekliyorsa; Adjust, macOS trafiğini App Store’a yönlendirebilir. Sorunu çözmek için macOS için REDIRECT MACOS alanına bir URL adresi belirtebilirsiniz.

  REDIRECT URL / MACOS / iOS / Android (URL / MACOS / iOS / Android yönlendirme) – varsayılan olarak uygulama mağazasına olan Adjust yönlendirmesini değiştirmek ve bunun yerine kullanıcıları belirli bir URL adresine yönlendirmek için yönlendirmenin URL adresini ekleyin. Kullanıcılar cihaz platformuna göre (REDIRECT MACOS / iOS / Android) yönlendirilebilir veya hepsi tek bir konuma (REDIRECT URL) gönderilebilir.

  DEVICE ID MACROS (cihaz kimliği makrosu) – Yandex Direct için makrolar otomatik olarak önerilecektir. Herhangi bir parametre almak istemiyorsanız, ilgili makroyu belirtmeyin.

  Adjust dokümantasyonundaki parametre açıklamaları

  Farklı senaryolar için bağlantı örnekleri

  Senaryoya bağlı olarak, yukarıda açıklanan alanlar aracılığıyla yapılandırılan aşağıdaki bağlantılar çalışacaktır:

  • Uygulaması olmayan bir kullanıcıyı uygulama mağazasına yönlendirmek gerekiyorsa:

    • iOS, uygulama var – evrensel bağlantı;

    • iOS, uygulama yok – otomatik olarak uygulama mağazasına geçiş;

    • Android, uygulama var – derin bağlantı;

    • Android, uygulama yok – otomatik olarak uygulama mağazasına geçiş;

    • Masaüstü – FALLBACK URL ve REDIRECT MACOS.

    Bağlantı örneği:

    https://nquw.adj.st/product/100586311342?adj_t=aflb3js&adj_fallback=https%3A%2F%2Fmarket.yandex.ru%2Fproduct--cold-steel-luzon-medium-20nql%2F388454980%3Fcpa%3D1%26sku%3D100586311342&adj_redirect_macos=https%3A%2F%2Fmarket.yandex.ru%2Fproduct--cold-steel-luzon-medium-20nql%2F388454980%3Fcpa%3D1%26sku%3D100586311342&adj_gps_adid=%7Bgoogle_aid%7D&yclid=%7Blogid%7D

  • Uygulaması olmayan kullanıcıyı bir web sayfasına yönlendirmek gerekiyorsa:

    • iOS, uygulama var – evrensel bağlantı;

    • iOS, uygulama yok – REDIRECT URL IOS;

    • Android, uygulama var – derin bağlantı;

    • Android, uygulama yok – REDIRECT URL ANDROID;

    • Masaüstü – REDIRECT URL.

    Bağlantı örneği:

    https://nquw.adj.st/product/100586311342?adj_t=aflb3js&adj_redirect_ios=https%3A%2F%2Fmarket.yandex.ru%2Fproduct--cold-steel-luzon-medium-20nql%2F388454980%3Fcpa%3D1%26sku%3D100586311342&adj_redirect_android=https%3A%2F%2Fmarket.yandex.ru%2Fproduct--cold-steel-luzon-medium-20nql%2F388454980%3Fcpa%3D1%26sku%3D100586311342&adj_gps_adid=%7Bgoogle_aid%7D&yclid=%7Blogid%7D&adj_redirect=https%3A%2F%2Fmarket.yandex.ru%2Fproduct--cold-steel-luzon-medium-20nql%2F388454980%3Fcpa%3D1%26sku%3D100586311342&adj_gps_adid=%7Bgoogle_aid%7D&yclid=%7Blogid%7D

Zorunlu parametreler

Zorunlu izleme parametreleri, uygulamalardaki eylemlerin Yandex Direct tıklaması ile ilişkilendirilebilmesi için bağlantıya eklenmelidir:

• İzleme bağlantısında: adj_ya_click_id={logid} veya adjust_ya_click_id={logid};

• İzleme bağlantısının içindeki fallback URL’sinde: yclid={logid}

UTM etiketleri fallback URL’sinde belirtilir.

Bağlantı örneği:

https://sb00.adj.st/cars/new/group/bmw/3er/21398591-21398651?adjust_ya_click_id={logid}&adjust_t=abc_def&adjust_campaign={campaign_name}&adjust_deeplink=autoru%3A%2F%2Fcars%2Fnew%2Fgroup%2Fbmw%2F3er%2F21398591-21398651&adjust_redirect=https%3A%2F%2Fauto.ru%2Fcars%2Fnew%2Fgroup%2Fbmw%2F3er%2F21398591-21398651%3Fyclid%3D

Ayrıca Universal Links tabanlı izleme bağlantıları bölümüne göz atın.