Genel bakış

Dönüşümler için Pinterest API, reklamverenlerin sunucudan sunucuya bağlantıyla dönüşümleri doğrudan Pinterest'e göndermesini sağlar. Pinterest API ile kaydedilen dönüşümler daha sonra kampanyalarda yeniden hedefleme için kullanılabilir ve daha iyi dönüşüm görünürlüğü için dönüşüm raporlarında incelenebilir.

Reklamverenler, Dönüşümler için Pinterest API'si aracılığıyla şunları gönderebilir:

  • Web dönüşümleri
  • Uygulama İçi Dönüşümler
  • Çevrimdışı Dönüşümler
  • Etkinlikler gerçek zamanlı olarak veya etkinliğin gerçekleşmesinden ve kaydedilmesinden sonra bir saat içinde alınabilir. Bu aralık dışında veya geciken bir toplu iş etkinliğinin parçası olarak alınan etkinlikler çevrimdışı dönüşümler olarak sayılır. 

    Dönüşümler için Pinterest API'sinin yanı sıra Pinterest Etiketi'nin kullanılması, kaydedilen dönüşümlerin görünürlüğünü en üst düzeye çıkarmanızı sağlayabilir. En iyi uygulamamız, dönüşüm kampanyanızın performansını kapsamlı bir şekilde görüntülediğinizden emin olmak için her iki dönüşüm yakalama çözümünü birlikte kullanmaktır.

    Pinterest API'si

    Dönüşümler için Pinterest API'si, Pinterest API ekosistemimiz içinde bulunan ürünlerden biridir. Pinterest Business hesabı olan herkes Dönüşümler için Pinterest API'sini kullanabilir ancak bu, daha geniş Pinterest API'sine otomatik olarak erişim izni vermez. 

    Pinterest Geliştirici Platformu, Pinterest'in tüm API ürünleri hakkında bilgilere sahiptir. 

    Başlayın

    Pinterest Business hesabı olan herkes Dönüşümler için Pinterest API'sine erişebilir.

    Başlangıç olarak bir erişim belirteci oluşturmanız gerekir. Erişim belirteci, isteklerin oluşturulduğunu ve doğru kullanıcı hesabına gönderildiğini doğrulayan bir karakter dizesidir. 

    Bir erişim belirteci oluşturmak için: 

  • Pinterest İşletme Hesabınızda oturum açın
  • Üst menüde Reklamlar'a tıklayın ve Dönüşümler'i seçin
  • Sol taraftaki menüden Dönüşüm erişim belirteci sayfasını seçin
  • Yeni belirteç oluştur düğmesine tıklayın
  • Yeni erişim belirtecini kopyalayın ve kurulum işlemine dönün.
  • Size ait olmayan bir hesaba erişmeye çalışıyorsanız önce İşletme Erişimi ayarlamanız gerekir. 

    Uygulama

    Dönüşüm Etkinlikleri: Pinterest Etiketinde yakalanabilecek tüm etkinlik türleri, Dönüşümler için Pinterest API'si aracılığıyla da kullanılabilir. Etkinliklerin tam listesini ve önemi hakkında daha fazla bilgiyi Pinterest API Geliştirici Belgelerimizde bulabilirsiniz.

    Sunucudan sunucuya bir API entegrasyonu ayarlamak için web sitesi sahibinin geliştirici ve mühendislik kaynakları kullanılır. Teknik geliştiricinin bu işlem için ne kadar zorlanacağı aşağıdakilere bağlı olarak değişir:

  • Geliştiricinizin API entegrasyonları ile ilgili bilgi düzeyi. Daha önce hiç API entegrasyonu yapmadılarsa fazladan çalışmaları gerekebilir.  Başka dönüşüm API'leri kullanıyorsanız geliştiricinizin yalnızca birkaç kademeden oluşan değişiklikler yapması gerekir.
  • İzlenen etkinliklerin sayısı ve dönüşüm süreci verilerinin hangi aşamada bize gönderileceği.
  • Reklamverenlerin üçüncü taraf bir entegrasyon (ör. Shopify, GTM, Tealium) yapma isteği veya ihtiyacı.
  • Pinterest Etiketini zaten kullanıyorsanız

    Dönüşümlerinizi en üst düzeye çıkardığınızdan emin olmak için Pinterest Etiketinin yanı sıra Dönüşümler için Pinterest API'sini kullanmanızı öneririz. 

    Pinterest Etiketini daha önce ayarladıysanız, dönüşümlerin bir kez Pinterest Etiketi aracılığıyla, bir kez de API aracılığıyla olmak üzere iki kez sayılmadığından emin olmanız gerekir. 

    Bunun için, hem Pinterest Etiketi hem de Dönüşümler için Pinterest API'si tarafından kaydedilen dönüşümlerle birlikte event_id parametresinin iletildiğinden emin olmanız gerekir. 

    Bu durumda sistemimiz event_ids değerlerini kopya olarak tanır ve sadece kaydedilen ilk dönüşümü saklar. Bu tekilleştirmenin başarılı olması için event_ids ile ilgili olarak:

  • Aynı dönüşümler için event_ids değerlerinin aynı olması gerekir - Bir kişi bir web sayfasına gittiğinde hem Pinterest Etiketi hem de Pinterest API'si tarafından bir sayfa ziyareti dönüşümü tetiklenir. Sistemimizin iki dönüşümün aynı dönüşüm olduğunu anlaması için bu dönüşümlerin eşleşen event_ids göndermesi gerekir. 
  • Farklı dönüşümler için event_ids değerlerinin benzersiz olması gerekir - Bir kişi bir web sayfasına gittiğinde hem Pinterest Etiketi hem de Pinterest API'si tarafından bir sayfa ziyareti dönüşümü tetiklenir. Kişi daha sonra sepetine bir tişört ekler ve bu da AddToCart etkinliğini hem Pinterest Etiketinde hem de Pinterest API'sinde tetikler. Aynı etkinlikler için event_ids değerlerinin eşleşmesi gerekir ancak Sayfa ziyareti ve AddToCart etkinlikleri için gönderilen event_ids değerleri benzersiz olmalıdır. Bu şekilde sistemimiz onları ayrı etkinlikler olarak tanır.
  • Bu etkinlik tanımlayıcısı ve event_name değerine dayalı olarak, (a) etkinliğin çevrimdışı gerçekleşmemesi (action_source değerinin çevrimdışı olmaması) ve (b) Pinterest'in yinelenen etkinlikleri birbiri ardına 48 saat içinde alması koşuluyla, Pinterest yinelenen etkinlikleri kayıttan kaldırır.

    Ayarlarınızı doğrulama

    API kurulumunu tamamladıktan sonra, dönüşüm etkinliklerinin alındığını şunları kontrol ederek doğrulayabilirsiniz:

  • Yanıt Kodları: API entegrasyonunuzu ayarlayan geliştirici, bir dönüşüm işlemi tetiklendiğinde gönderilen her bir istekle döndürülen yanıt kodlarını inceleyebilir. 
  • Reklam Yöneticisi'ndeki Tekilleştirme Sayfası: Tekilleştirme sonrasında dönüşümler Reklam Yöneticisi'nin Tekilleştirme Sayfasında görünür. Çoğaltma sayfasına erişmek için:
    • Pinterest İşletme Hesabınızda oturum açın
    • Üst menüde Reklamlar'a tıklayın ve Dönüşümler'i seçin
    • Sol taraftaki menüden Tekilleştirme'ye tıklayın.
  • Kalite ve dayanıklılık

    Dayanıklılık, Dönüşümler için API kurulumunun en yüksek sinyal eşleştirme ve ilişkilendirme seviyesine izin veren durumudur. Bu ek veriler, reklam sektöründeki politikalar değiştikçe ve geliştikçe daha doğru raporlar sunmamıza yardımcı olacaktır.

    Dayanıklılık Durumu

    Dayanıklılık durumunun iki kategorisi vardır: İyi ve Kötü. Dayanıklılık durumunuz Reklam Yöneticisi'nin Dönüşüm Durumu bölümünde görülebilir.

    İyi dayanıklılık

    Seçenek 1: Belirli Tanımlayıcı Kapsamı

  • Tanımlayıcı kapsamı
    • Etkinliklerin %90'ı veya daha fazlası IP/UA, 
    • Alt huni etkinliklerinin %10'u veya daha fazlası şifrelenmiş E-posta veya MAID, 
    • Etkinliklerin %10'u veya daha fazlası harici kimlik sahibi olmalıdır.
  • Etiket verileriyle çakışma (varsa)
    • CAPI üzerinden %90* veya daha fazla Etiket etkinliği alınmalıdır 
  • Veya:

    Seçenek 2: Temel Eşleşme Oranına Ulaşma

  • CAPI Kullanıcı Eşleşme oranı %60 veya daha fazla
  • Etiket verileriyle çakışma (varsa)
  • CAPI üzerinden %90* veya daha fazla Etiket etkinliği alınmalıdır 


  • Kötü dayanıklılık

    İyi olmayan tüm ayarlar.

    Dayanıklılık Kimlikleri ve Sinyalleri

    Esnek reklamveren durumuna ulaşmak için aşağıdaki sinyalleri gönderin.

    API Kimlikleri/Sinyalleri Ağırlıklar/Sıralama
    client_ip_address + client_user_agent Yüksek
    em Yüksek
    external_id Yüksek
    hashed_maid Yüksek
    click_id Yüksek
    fn + ln Düşük
    ph Düşük
    ge, bd, ct, st, zp, ülke Düşük

    *Eşleşme oranını artırma olasılığına dayalı ağırlıklar/sıralama

    Üçüncü Taraf Uygulaması

    Pinterest'te API kullanım sürecinizi destekleyecek çeşitli Üçüncü Taraf Entegrasyonları bulunmaktadır. 

    Google Etiket Yöneticisi - Sunucu Tarafı

    Pinterest'in mağazanızdaki trafiği ve ürünlerinizin satışını ne kadar etkilediğini öğrenmek için Google Etiket Yöneticisi hesabınızı Dönüşümler için Pinterest API'sine bağlayın.

    Bu entegrasyon, tercih ettiğiniz bulut sağlayıcıyı ve sunucu tarafı etiketleme bilgisini kullanarak bir sunucu kapsayıcısı dağıtmanızı gerektirir. Daha fazla bilgi için geliştiricinin sitesini ziyaret edin

    Shopify

    Bu Dönüşümler için API entegrasyonu, Pinterest Etiketini yüksek veri kapsamı ve kalitesi sağlayacak şekilde tamamlar. Shopify uygulaması yüklüyse bu geliştirmeden yararlanmak için herhangi bir işlem gerekmez. Değişiklikler satıcının mağazasına otomatik olarak uygulanır.

    Tealium

    Tealium ile ilgilenen reklamverenler, Dönüşümler için API'yi doğrudan üçüncü tarafla ayarlayabilir. Tealium şablonu oluşturur ve reklamverenle entegrasyonu kolaylaştırır. 

    Uygulama süreci Tealium'un Öğrenme Merkezi'nde özetlenmiştir. Uygulama desteği ile ilgili sorularınızı support [at] tealium.com (support[at]tealium[dot]com) adresine gönderebilirsiniz. 

    Ek üçüncü taraf entegrasyonlarıyla ilgileniyorsanız daha fazla bilgi için lütfen satış temsilcinize ulaşın. 

    Sınırlı Veri İşlemeyi Anlama

    1 Ocak 2023'ten itibaren, reklamverenler Kaliforniya Gizlilik Hakları Yasası ile değiştirilen Kaliforniya Tüketici Gizliliği Yasası'na (birlikte, CCPA) uymalarına yardımcı olacak şekilde Sınırlı Veri İşleme bayrağı kullanabilir. Bu bayrak varsa, Pinterest reklamverenlerin kullanıcı gizlilik ayarlarına uymasına yardımcı olacak şekilde belirli verileri kullanma biçimlerimizi sınırlandıracaktır. Örneğin, bir reklamveren, verilerinin CCPA altında satılmasını veya paylaşılmasını devre dışı bırakmış Kaliforniya kullanıcıları için Sınırlı Veri İşleme bayrağını uygulayabilir. Sınırlı Veri İşleme bayrağı kullanıldığında, Pinterest Kaliforniya'daki kullanıcıların işaretledikleri verileriyle ilgili olarak CCPA altında bir hizmet sağlayıcısı olarak hareket eder.

    Reklamverenler, kullanıcı engellemelerine uymak ve Sınırlı Veri İşleme bayrağını uygularken kullanıcının ikamet ettiği eyaleti tanımlamaktan sorumludur.

    End of Other articles Links
    Yine de yardıma mı ihtiyacınız var? Bize ulaşın
    User feedback
    Bu makale faydalı mıydı?

    collection_fields

    Bu makaleyi nasıl daha iyi hale getirebiliriz?