Pinterest kurulumu
Pinterest, Adjust ile entegre bir reklam ağıdır. Entegrasyonumuz ile Pinterest, attribution ve uygulama içi event verilerini otomatik callback'ler ile alabilir.
Bu makalede, Pinterest ölçümlemesini uygulamanız için nasıl yapılandırabileceğinizi bulabilirsiniz. Buna entegrasyonu etkinleştirmek, bir kampanya linki oluşturmak ve Adjust'ın Pinterest ile hangi verileri paylaşabileceğini seçmek de dahildir.
Başlamadan önce
Gereklilikler
- Adjust'ta Admin, Editör ya da Özel Editör izinlerine sahip olmak.
- SDK parametrelerini Pinterest parametreleri ile eşleştirmek için Adjust SDK v4.0.0 ve üstü. Bu özelliği kullanmak için aşağıdaki rehberleri takip edebilirsiniz.
iOS | Android | Pencereler | Unity | React Native | Flutter | Adobe Air | Kordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
Giriş bilgileri
TAG ID (required for events), Pinterest Account ID, ve Pinterest Authentication Token
- Giriş bilgilerinizi bulmakta yardıma ihtiyacınız varsa Pinterest temsilcinizle iletişime geçin.
Pinterest dashboard'unda:
Adjust S2S tıklama link'leri, Pinterest'te paralel tıklama tracker'ları olarak ayarlanmalıdır. Daha fazla bilgiyi burada bulabilirsiniz.
Campaign Lab'de Pinterest seçeneğini seçin ve uygulamanızı seçin
- Campaign Lab kısmında Partnerler seçeneğini seçin.
- Yeni partner > Pinterest seçeneğini seçin. İleri 'yi seçerek sonraki ekrana geçin.
- Uygulama seçimi ekranında linkini oluşturmak istediğiniz uygulamayı seçin ve Pinterest ile veri paylaşımı için entegrasyonu etkinleştirin.
- İleri 'yi seçin.
Veri paylaşımını etkinleştir
Pinterest entegrasyonu için veri paylaşımını etkinleştirin. Veri paylaşımını etkinleştirmek için:
- TAG ID (required for events), Pinterest Account ID ve Pinterest Authentication Token 'larınızı girin.
Pinterest ile veri paylaşımını etkinleştirdiğinizde Adjust, varsayılan olarak aşağıdaki verileri Pinterest partnerine otomatik olarak gönderecektir:
- event
Veri paylaşımı seçeneklerinizi belirleyin
Veri paylaşımı birden fazla platformda etkin olan bir multi-platform uygulama ile çalışıyorsanız aşağıdakileri yapabilirsiniz:
- Platforma özgü ayarları kullan seçeneğini seçerek veri paylaşımı seçeneklerini platform seviyesinde ayırabilirsiniz.
- Birden fazla platformda aynı veri paylaşımı seçeneklerini kullanmak için Global ayarları kullan seçeneğini seçin.
Varsayılan olarak neler paylaşılır? kısmında Adjust'ın varsayılan olarak Pinterest ile paylaştığı aktiviteleri kontrol edebilirsiniz:
- event
Ek veriler göndermek
Pinterest ile callback'ler aracılığıyla paylaşmak istediğiniz veri miktarını ve türünü seçin. Pinterest, bu bilgileri performansı optimize etmek için kullanabilir.
- Hangi veri kaynaklarını paylaşmak istiyorsunuz? kısmında Pinterest ile paylaştığınız verilerin attribution kaynağını seçin:
- Tüm attribution kaynaklarından gelen veriler
- Sadece Pinterest ile attribute edilen veriler
Uygulama-içi revenue (uygulama-içi alışverişlerden)
Uygulama-içi revenue paylaşımı ile Pinterest partnerinin revenue miktarlarını revenue event verileriniz ile birlikte almasını sağlayabilirsiniz. Bu verileri paylaşmak için revenue yaratan event'leri eşleştirmeniz gerekir.
Event eşleştirmesi
Paylaşmak istediğiniz event'leri Pinterest ürünlerinin alabileceği değerler ile eşleştirin. Eşleştirilmemiş event'lere dair veriler Pinterest ile paylaşılmaz.
Event'leri tekil eşleştirin
Multi-platform Uygulamanız varsa, Pinterest ile her platformda farklı event'leri paylaşmayı seçebilirsiniz. Bu size aşağıdaki imkanları sunar:
- Her platformun kampanya stratejilerini yönetmek için tekil event'ler belirleyin.
- Veri paylaşımını her platform için özelleştirin.
Event eşleştirmesi kısmında bu adımları takip ederek Pinterest partnerine doğrudan göndermek istediğiniz uygulama-içi event'leri seçin.
Event eşleştirmesi 'ni seçin.
Adjust event'i listesinde Pinterest ile paylaşmak istediğiniz Adjust event'ini seçin.
Partner event'i altında Adjust event'ine karşılık gelen Pinterest event'ini seçmeniz gerekir.
Veri paylaşımının tek bir platformda etkinleştirildiği tek platformlu uygulamalar ve multi-platform uygulamalar için, sadece o platforma dair veri paylaşım seçeneklerini belirleyebilirsiniz. Veri paylaşımı birden fazla platformda etkin olan multi-platform uygulamalar için aşağıdakileri yapabilirsiniz:
- Ayrı event'leri platform seviyesinde eşleştirmek için ya da event'leri belli platformların eşleştirmesini yapmamak için Platforma özgü eşleştirmeyi kullan seçeneğini seçin.
- Tüm platformlar için aynı event'leri eşleştirmek için Global eşleştirmeyi kullan seçeneğini seçin.
Partner event'i listesinde Adjust event'i ile eşleştirmek istediğiniz özel event adını girin ya da bir özel event seçin.
Uygula 'yı seçin.
Pinterest artık bağlı event'lerinizin her biri için uygulama-içi event verilerini alacaktır.
Tüm event'leri eşleştir
Pinterest, tüm event'lerin otomatik olarak eşleştirilmesini destekliyorsa, Event'leri eşleştir kısmında Tüm event'leri eşleştir seçeneğini seçin. Bu, event'leri tekil eşleştirirken zamandan tasarruf etmenizi sağlar.
Pinterest artık bağlı event'lerinizin her biri için uygulama-içi event verilerini alacaktır.
Parametreleri eşleştirmek
Özel verileri Pinterest ile paylaşmak için genellikle parametreleri eşleştirmeniz gerekir.
Partner parametreleri (Adjust SDK sürüm 4.0 ve üstü), Adjust'ın özelleştirilmiş veri noktalarını uygulamanızdan alıp Pinterest'e göndermesini sağlar. Bu, Pinterest partnerinin bağlı event'lerinizin her biri için özel event detaylarını almasını sağlar.
Yeni partner parametrelerini Adjust SDK'ya eklemeden önce gereksinimlerinizi karşılayan mevcut partner parametrelerinin olmadığını kontrol edin.
Partner parametrelerini Pinterest ile paylaşmak için bu adımları takip edin.
Adjust SDK içindeki partner parametrelerini ayarlayın.
- Tüm SDK geliştirme platform linkleri için Başlamadan önce'yi inceleyin.
Veri paylaşımı seçeneklerinizi belirleyin altından Parametreler seçimini yapın.
Parametre eşleştirmesi 'nin altında, SDK'da tanımlanan partner parametrelerini ağa nasıl göndermek istediğinizi belirleyebilirsiniz:
- Parametre eşleştirmesi 'ni seçin.
- SDK parametresi alanına ağ ile paylaşmak istediğiniz SDK parametresinin adını girin.
- Partner parametresi alanına SDK parametresine karşılık gelen ağ parametresini girin.
Partner parametrelerini Adjust SDK'da dashboard'daki parametre paylaşımını yapılandırmadan yapılandırırsanız Adjust, parametreleri Adjust SDK'daki isimleri ile gönderir.
Linkinizi ve ayarlarınızı yapılandırın
Ayar yapabilecekleriniz:
Linkinizi oluşturun ve Pinterest ile paylaşın
Yaptığınız seçimleri Yapılandırma kontrolü ekranında kontrol edin. Bu noktada geri dönebilir ve aşağıdakilerde değişiklik yapabilirsiniz:
- Seçtiğiniz uygulama
- Veri paylaşımı seçenekleri
- Link yapısı parametreleri
- Kullanıcı hedefleri
- Attribution ayarları
Tıklama URL'ini, gösterim URL'ini, QR kodunu ve link token'ınızı oluşturmak için Link oluştur 'u seçin. Bir link oluşturmak aynı zamanda veri paylaşımını ve Pinterest ile entegrasyon da sağlar.
Linkinizi oluşturduktan sonra kampanyalarınızda kullanmaları için Pinterest ile paylaşın.
Partnerlere özgü yapılandırma yönergeleri
Genel bakış
Uygulama içi event'leri Pinterest'e göndermek için gereken giriş bilgileri, kullandığınız API versiyonuna bağlıdır:
API v5 (Önerilen):
- Reklam Hesabı ID'si
- Erişim Token'ı (Access Token)
Eski API:
- Tag ID
Access Token 'ınızı Pinterest Ads Manager 'da Ad Account Overview> Conversions> Set Up API kısmından alabilirsiniz.
Daha fazla bilgiyi burada bulabilirsiniz
Eski API'dan API v5'e geçiş
Pinterest, Eski API versiyonunu kullanımdan kaldıracak ve API v5 'e geçiyor. Bu dokümantasyonda doğrulama, event eşleştirmesi ve eski yapılandırmaların kaldırılması da dahil olmak üzere yapılandırma sürecine dair bilgiler bulabilirsiniz.
1. Giriş Bilgilerini Girin
Campaign Lab'de Pinterest'i ve uygulamanızı seçtikten sonra bu bilgileri girin:
- Account ID
- Erişim Token'ı (Access Token)
İki alan da API v5 için gereklidir. Doğru Account ID için Erişim Token'larını nereden alabileceğinize dair yönergeleri burada bulabilirsiniz.
2. Event eşleştirmesi
Event eşleştirme alanları
- Ad (Eski) – Sadece eski API ile kullanılır.
- Yeni ad (API v5) – API v5 için gereken event değerleri.
Eşleştirmek istediğiniz uygulama içi event'i, Adjust event'i alanından seçin ve bunu Yeni ad açılır menüsünden bir değerle eşleştirin.
Eski API (Ad) ile API v5 (Yeni ad) arasındaki event adı eşleştirme önerilerini aşağıda bulabilirsiniz. Ayrıca Eski API (Ad) event'lerini Pinterest için mevcut diğer API v5 (Yeni ad) event'leri ile de eşleştirebilirsiniz.
Ad (Legacy) | Yeni ad (API v5) |
Add to cart | Add to cart |
Purchase | Checkout |
Registration | Signup |
Search | Search |
Lead | Lead |
Page visit | Page visit |
3. Eski Tag ID'yi kaldırmak (opsiyonel)
API v5 ile artık Tag ID'ye gerek yoktur. Tag ID'yi yapılandırmanızdan güvenle kaldırabilirsiniz. Yine de Hesap ID'si ve Access Token ile birlikte bir Tag ID sağlarsanız ve Yeni Ad alanı için bir değer girerseniz, sistem API v5 'e öncelik verir ve Eski API için Tag ID'yi gözardı eder.
en iyi yöntem
Pinterest, hem iOS hem de Android "deeplink" dönüşüm kampanyalarını destekler. Entegrasyonu etkinleştirmeden önce kampanya yapılandırması sırasında destek almak için Pinterest ile iletişime geçin .
Ön tanımlı parametreler
Adjust SDK'yı kullanarak event'leriniz ile ön tanımlı parametreleri gönderebilirsiniz. Bu parametreler doğru bir şekilde eklendiğinde Pinterest'e gönderilir.
Partner parametrelerinin event'lere nasıl eklenmesi gerektiğine dair bilgiler için SDK dokümantasyonuna göz atın.
Parametre | Açıklama | API v5'te desteklenir | Format / Notlar |
external_id | Harici kullanıcı ID'si | ✅ | Virgülle ya da noktalı virgülle ayrılmış string listesi |
event_source_url | Event'in gerçekleştiği web sayfasının URL'i | ✅ | String (URL formatı) |
em | E-posta adresi hash'leri | ✅ | Küçük harflerle e-posta adresinin SHA256 hash’i |
ph | Telefon numarası hash'leri | ✅ | Sadece rakamlarla ülke ve alan kodu da dahil olmak üzere SHA256 telefon numarasının hash'i |
event_id | Benzersiz cihaz tanımlayıcısı | ✅ | String |
content_ids | Ürün ya da içerik tanımlayıcıları | ✅ | Virgülle ya da noktalı virgülle ayrılmış string listesi |
order_id | Sipariş tanımlayıcısı | ✅ | String |
Değer | Alışveriş ya da sepete ekleme değeri | ✅ | Numerik (eski API'da da desteklenir) |
currency | Değer alanı için para birimi | ✅ | ISO 4217 kodu (örn. USD, EUR) — eski API'da da desteklenir |
external_id
, em
ve ph
formatları hakkında daha fazla bilgi için Pinterest API dokümantasyonuna göz atabilirsiniz.
Value (değer) ve Currency (para birimi) parametrelerinin değerleri fallback değeri olarak kullanılır ve sadece Adjust, uygulama-içi event için herhangi bir ciro verisini doğrudan SDK'dan almazsa Pinterest'e gönderilir.
Event revenue kaydına dair daha fazla bilgi için Adjust dokümantasyonuna göz atabilirsiniz.
Gruplanmış ürün seviyesi parametreler
Aşağıdaki parametreler, ürün seviyesi metadata 'yı açıklar ve event payload'unda sırayla yerleştirilmelidir .
Parametre | Açıklama | Format / Notlar |
id | Ürünler için benzersiz tanımlayıcılar | Sıralı string listesi (virgül ya da noktalı virgülle ayrılmış) |
quantity | Her ürünün miktarı | Sıralı string listesi |
item_name | Her ürünün adı | Sıralı string listesi |
item_price | Her ürünün fiyatı | Sıralı string listesi |
item_category | Her ürünün kategorisi | Sıralı string listesi |
item_brand | Her ürünün markası | Sıralı string listesi |
Bu alanlarda değerlerin sırası aynı olmalıdır.
(örneğin, item_price
'daki ilk değer item_name
, id
vb. alanlarındaki ilk değerle eşleşmelidir.)
Pinterest partnerine yönlendirilen tüm parametrelerin listesi
Pinterest, Adjust'ın bu parametreleri (veri noktaları) callback'ler ile birlikte göndermesini gerektirir:
Placeholder | Bilgi |
{city} | Cihaz şehri |
{country} | Cihazın iki karakterlik ülke kodu |
{currency} | Adjust SDK'dan gönderilen Orijinal ISO 4217 para birimi kodu |
{device_name} | Cihaz modeli numarası |
{gps_adid} | Google Play Store reklam ID'si |
{idfa} | ID for advertisers (sadece iOS) |
{ip_address} | Cihazın IP adresi |
{isp} | Cihazın internet servis sağlayıcısı |
{language} | Cihazın iki karakterlik dil kodu |
{os_name} | Cihazın işletim sistemi |
{os_version} | İşletim sistemi versiyonu numarası |
{partner_parameters} | Adjust SDK ya da S2S request'i tarafından toplanan ve postback'ler ile üçüncü parti sağlayıcılara gönderilen özel partner parametreleri |
{revenue_usd} | Revenue, ABD doları cinsinden |
{revenue} | Revenue, Adjust SDK'dan gönderildiği gibi cent cinsinden |
{sdk_version} | Adjust SDK versiyonu (her uygulama için) |
{tracking_limited} | Takip sınırlıysa 1, değilse 0 |
{user_agent} | Gelen ham user agent |
{app_id} | Store App ID ya da Google Play Store |
{app_name} | Uygulamanın adı |
{app_version_short} | Uygulama versiyon numarası (Android), bundle için release versiyonu numarası (iOS) |
{created_at} | Aktivite timestamp'i |
{impression_based} | Gösterim bazlı etkileşim ise 1, değilse 0 |