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.

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:

Tıklama ve Gösterim URL'leri, Reklam Takibi URL'leri kısmında eklenmelidir.

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.
1. 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.
2. 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:
1. Parametre eşleştirmesi 'ni seçin.
2. SDK parametresi alanına ağ ile paylaşmak istediğiniz SDK parametresinin adını girin.
3. Partner parametresi alanına SDK parametresine karşılık gelen ağ parametresini girin.

Not:

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

Overview

To send in-app events to Pinterest, required credentials depend on the API version you’re using:

API v5 (Recommended):

Ad Account ID
Access Token

Legacy API:

Tag ID

You can retrieve your Access Token in Pinterest Ads Manager: Ad Account Overview > Conversions > Set Up API

More information available here

Best practice

Pinterest supports both iOS and Android“deep linking” conversions campaigns. Before enabling the integration, contact Pinterest so they can assist with campaign setup.

Predefined parameters

You can send predefined parameters with your events using the Adjust SDK. When attached correctly, these parameters are forwarded to Pinterest.

Refer to the SDK documentation for the correct way to attach partner parameters to your events.

Parameter	Description	Supported in API v5	Format / Notes
external_id	External user ID	✅	Comma- or semicolon-separated string list
event_source_url	URL of the webpage where the event occurred	✅	String (URL format)
em	Email address hashes	✅	SHA256 hash of the lowercase email address
ph	Phone number hashes	✅	SHA256 hash of phone number with digits only, incl. country and area code
event_id	Unique event identifier	✅	String
content_ids	Product or content identifiers	✅	Comma- or semicolon-separated string list
order_id	Order identifier	✅	String
value	Value of purchase or add to cart	✅	Numeric (Supported also in the old API)
currency	Currency for the value field	✅	ISO 4217 code (e.g., USD, EUR) — supported also in the old API

For more details on formatting external_id, em and ph, refer to the Pinterest API documentation.

The values of value and currency parameters are used as fallback values and are only forwarded to Pinterest if Adjust does not receive any revenue data for the in-app event directly from the SDK.

For more information, refer to the Adjust documentation on event revenue recording.

Grouped item-level parameters

The following parameters describe item-level metadata and should be aligned in order across the event payload.

Parameter	Description	Format / Notes
id	Unique identifiers for items	Ordered string list (comma- or semicolon-separated)
quantity	Quantity of each item	Ordered string list
item_name	Name of each item	Ordered string list
item_price	Price of each item	Ordered string list
item_category	Category of each item	Ordered string list
item_brand	Brand of each item	Ordered string list

Önemli:

The order of values must match across these fields.

(e.g., the first value in item_price should match the first in item_name, id, etc.)

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