Shopify için Pinterest Conversions API: kurulum rehberi

Pinterest Conversions API, Pinterest'in dönüşüm olaylarını sunucudan sunucuya gönderme yoludur. Mağazanız ya da ROASaurus gibi bir araç, yalnızca alışveriş yapanın tarayıcısındaki Pinterest Tag'e güvenmek yerine satın alım gibi olayları doğrudan Pinterest reklam hesabınıza gönderir. Pinterest bu veriyi dönüşüm raporlaması, kampanya optimizasyonu ve hedefleme için kullanır.

Bu rehber v5 API'yi ve kabul ettiği olayları, epik tıklama kimliğini, müşteri verisinin nasıl hash'lendiğini, Pinterest Tag ile mükerrer kayıt önlemenin nasıl çalıştığını, nasıl test edileceğini ve hepsinin Shopify'da nasıl kurulacağını kapsar.

Pinterest Conversions API nedir?

Pinterest Tag, alışveriş yapanın tarayıcısındaki bir betiktir. Conversions API aynı işi bir sunucudan yapar. API sürüm 5'te olayları, Pinterest Ads Manager'da oluşturduğunuz bir dönüşüm erişim token'ıyla yetkilendirilmiş şekilde reklam hesabınızın olaylar uç noktasına gönderirsiniz. Her olay nerede gerçekleştiğini söyler: bir online mağaza için eylem kaynağı web'dir.

Pinterest, Tag'i de kullanan reklamverenlerden her olayla birlikte bir event_id göndererek bir dönüşümü iki kez saymaktan kaçınmalarını ister. Ayrıca olayların gerçek zamanlı olarak ya da gerçekleştikten en geç bir saat sonra gönderilmesini ister.

Shopify'da sunucu bağlantısının net bir avantajı vardır: satın alımlar siparişin kendisinden gelir. Shopify her ödenmiş siparişi ROASaurus'a webhook ile bildirir ve ROASaurus bunu, Tag tarayıcıda çalışsa da çalışmasa da ödemeden kısa süre sonra Pinterest'e gönderir. Shopify'da sunucu tarafı takip rehberi fikri daha ayrıntılı açıklar.

Pinterest Conversions API hangi olayları kabul eder?

Pinterest'in page_visit, add_to_cart ve checkout gibi, küçük harfle ve alt çizgiyle yazılan sabit bir standart olay adı listesi vardır. Ayrıca reklamveren başına en fazla 15 özel olay türü tanımlayabilirsiniz. ROASaurus beş Shopify alışveriş olayını şöyle eşler:

Ad kafa karıştırabilir. Pinterest'in checkout'u tamamlanmış satın alımdır, ödeme sürecinin başlangıcı değil. Ödemenin başlangıcı ayrı bir olaydır: initiate_checkout.

Pinterest, checkout olayı için tutarı, para birimini, sipariş kimliğini, içerik kimliklerini ve ürün sayısını göndermenizi önerir. ROASaurus beşini de gönderir, ayrıca her ürünün adedini ve fiyatını. Pinterest tutarın vergi ve kargo hariç olmasını ister. Shopify'da ROASaurus tam olarak bunu gönderir: sipariş toplamından vergi ve kargo düşülmüş tutarı, hem sunucudan hem de tarayıcı etiketinden. Bir online mağaza platformu vergiyi ve kargoyu ayrı bildirmiyorsa ROASaurus sipariş toplamını gönderir.

Pinterest bir olayı bir kişiyle nasıl eşleştirir?

Her olay kullanıcı verisi taşır. Pinterest üç şeyden en az birini ister: hash'lenmiş bir e-posta adresi, hash'lenmiş bir mobil reklam kimliği ya da user agent ile birlikte IP adresi. Bir online mağazanın reklam kimliği yoktur, bu yüzden e-postaya veya IP adresi ile user agent'a ihtiyaç duyar. ROASaurus, Pinterest'in kullanamayacağı bir olay göndermek yerine ikisine de sahip olmayan olayı atlar.

epik tıklama kimliği

Pinterest tıklama kimliği iki yerden gelebilir: açılış sayfası URL'sindeki bir epik parametresinden ya da alan adınızdaki _epik çerezinden. Pinterest'in API rehberi _epik çerez değerini iletmeyi önerir, çünkü URL parametresi eksik olduğunda ya da kaldırıldığında da çalışır ve bu daha iyi kapsam sağlar.

ROASaurus ikisini de mağazanızda okur; yeni bir tıklama bir parametre getirdiğinde URL parametresini, aksi halde çerezi kullanır. Tıklama kimliğini ziyaretçiyle birlikte saklar ve satın alım dahil her sunucu olayının click_id alanında gönderir. epik taşıyan ziyaretler ROASaurus atıf raporlarında Pinterest ziyareti sayılır.

POST https://api.pinterest.com/v5/ad_accounts/549755885175/events

{
  "data": [{
    "event_name": "checkout",
    "action_source": "web",
    "event_time": 1793016000,
    "event_id": "order-5512345678901",
    "event_source_url": "https://example-store.com/checkouts/…/thank-you",
    "user_data": {
      "em": ["a3f1…9c2e"],
      "ph": ["7b40…11d8"],
      "external_id": ["e05c…4a7f"],
      "client_ip_address": "203.0.113.24",
      "client_user_agent": "Mozilla/5.0 (iPhone; …)",
      "click_id": "dj0yJnU9…"
    },
    "custom_data": {
      "currency": "USD",
      "value": "84",
      "order_id": "5512345678901",
      "content_ids": ["44123456789"],
      "contents": [{ "id": "44123456789", "quantity": 2, "item_price": "42" }],
      "num_items": 2
    }
  }]
}

Pinterest Tag ile mükerrer kayıt önleme nasıl çalışır?

Tag ve API ikisi de bir satın alım bildirirse Pinterest tek sipariş için iki olay alır. Bunları tek olay saymak için iki tarafta da aynı kimliğe ihtiyaç vardır: Tag'deki olay kimliği, sunucu olayındaki event_id ile eşleşmelidir. Pinterest aldığı ilk olayı tutar ve 48 saat içinde gelen mükerrer kayıtları kaldırır.

ROASaurus satın alım kimliğini Shopify sipariş kimliğinden oluşturur. 5512345678901 numaralı siparişin satın alımının olay kimliği order-5512345678901'dir; hem ödeme sayfasında çalışan Tag'de hem de sunucu olayında.

Beş olayın tamamında mükerrer kayıt önlenir

ROASaurus'taki her alışveriş olayının tek bir olay kimliği vardır; tarayıcıdaki Tag de sunucu olayı da bunu kullanır. Tag aynı olaylar için Pinterest'in kendi adlarını kullanır: pagevisit, viewcontent, addtocart, initiatecheckout ve checkout; bunlar API'deki page_visit, view_content, add_to_cart, initiate_checkout ve checkout ile eşleşir. Dolayısıyla ikisi birlikte çalıştığında Pinterest her sayfa ziyaretinin, ürün görüntülemenin, sepete eklemenin, ödeme başlangıcının ve satın alımın tek bir kopyasını tutar.

İki şekilde çalıştırabilirsiniz:

• Tag ve Conversions API birlikte. Tag tarayıcı sinyallerini ekler, sunucu Tag'in kaçırdıklarını tamamlar, Pinterest de kopyaları birleştirir.
• API'yi Tag olmadan çalıştırın. Tag ID alanını boş bırakın veya Also load the browser tag seçeneğini kapatın. Bu durumda her olay yalnızca sunucudan, bir kez gönderilir.

Çift sayım hakkındaki yardım makalesi, diğer reklam platformları için aynı kontrolleri kapsar.

Pinterest Conversions API nasıl test edilir?

API'nin bir test bayrağı vardır. test=true ile gönderilen istekler bir sandbox'a gider: Pinterest bunları test verisi olarak ele alır ve raporlama ya da optimizasyon için kullanmaz.

1. Test modunu açın

   ROASaurus'ta Tracking & platforms altında Pinterest pikselini düzenleyin ve Test mode (events show under Test events, max 20) seçeneğini işaretleyin. Bundan sonra her sunucu olayı test=true ile gönderilir. Pinterest her toplu istekte en fazla 20 test olayı işler.

2. Bir test siparişi verin

   Mağazanızı ziyaret edin, bir ürünü görüntüleyin, sepete ekleyin ve bir sipariş tamamlayın.

3. Sonucu okuyun

   Event log'u açın. Pinterest, bir istekteki bir olay başarısız olsa bile HTTP 200 yanıtı verebilir; bu yüzden ROASaurus her olayın durumunu kontrol eder ve hataları orada gösterir.

4. Test modunu kapatın

   Olayların raporlamada ve optimizasyonda sayılması için test modunun işaretini kaldırın.

5. Events Overview'u kontrol edin

   Pinterest Ads Manager'da Events Overview sayfasını açın. Gelen olayları ve mükerrer kaydı önlenmiş dönüşümleri gösterir. Pinterest, Event Quality Score için Good düzeyini hedeflemenizi önerir.

Pinterest Conversions API, ROASaurus ile Shopify'da nasıl kurulur

ROASaurus uygulaması kurulu bir Shopify mağazasına ve Pinterest Ads Manager erişimine ihtiyacınız var. Pinterest entegrasyon sayfası ROASaurus'un gönderdiği her alanı listeler.

1. Shopify mağazanızı bağlayın

   Add a store › Shopify yolunu izleyin, Install app'e tıklayın ve tema düzenleyicide ROASaurus app embed'ini açın. Her sayfada epik'i ve _epik çerezini yakalar. Shopify kurulum rehberi her adımı gösterir.

2. Bir dönüşüm erişim token'ı oluşturun

   Pinterest Ads Manager'da Conversions bölümüne gidin ve bir dönüşüm erişim token'ı oluşturun. Reklam hesabı kimliğinizi not edin.

3. ROASaurus'ta Pinterest pikselini ekleyin

   Tracking & platforms bölümüne gidin, Pinterest kartında Add pixel'e tıklayın ve Ad account ID ile Conversion access token alanlarını doldurun.

4. Tag ID'nizi ekleyin

   Tag ile mükerrer kayıt önleme için Pinterest Tag ID alanını doldurun ve Also load the browser tag işaretli kalsın. Tag ID olmadan ROASaurus yalnızca sunucu olaylarını gönderir ve Tag'i yüklemez.

5. Ödeme sayfası pikselini ekleyin

   Shopify admin › Settings › Customer events bölümünde ROASaurus adlı özel bir piksel ekleyin ve Tracking & platforms sayfanızdaki kod parçasını yapıştırın. Bu piksel, Tag'in checkout olayını Shopify'ın ödeme sayfasında, sipariş kimliğini event_id olarak kullanarak tetikler.

6. Sunucu olaylarını seçin, sonra test edin

   İstediğiniz sunucu olaylarını seçin ve yayına almadan önce test modunda test edin.

Varsayılan olan Respect visitor consent açıkken ROASaurus, alışveriş yapanın Shopify çerez bannerındaki tercihine uyar. Alışveriş yapan pazarlama çerezlerini reddettiğinde ROASaurus onun için Pinterest Tag'i yüklemez, ziyaretçi kimliği atamaz (böylece tıklamaları kendisiyle ilişkilendirilmez) ve gezinme olaylarını Pinterest'e göndermez. Ödenmiş siparişi yine de sunucudan Conversions API'ye gönderilir; hash'lenmiş sipariş verisi ile siparişin IP adresi ve user agent'ıyla, ancak tıklama kimliği olmadan. Rıza ve gizlilik rehberi nelerin saklandığını ve gönderildiğini açıklar.

Pinterest reklam hesabınızı Setup › Ad spend altında bağlayın; ROASaurus kampanya harcamasını her saat çeker ve kâr analitiğinde Pinterest ROAS'ını ve reklam sonrası kârı görürsünüz. TikTok Events API rehberi, iki yoldan da giden her olayda mükerrer kayıt önlemenin yapıldığı TikTok için aynı kurulumu kapsar.

Kaynaklar

1. Pinterest Developers: Track conversion events in the API
2. Pinterest Business help: The Pinterest Conversions API
3. Pinterest Developers: Track conversions with Pinterest Tag

ROASaurus'ta

• Pinterest entegrasyonu
• ROASaurus'ta sunucu tarafı takip
• Yardım: çift sayımı önleme

Okumaya devam edin