Dzięki kodom zdarzeń możesz zmierzyć wpływ swoich reklam na Pintereście na określone działania podejmowane w witrynie. Kody zdarzeń są wymagane do prowadzenia kampanii automatycznie zoptymalizowanych pod kątem określonych zdarzeń, np. kampanii konwersji lub reklam wykorzystujących dynamiczne retargetowanie. Kody zdarzeń są również wymagane, aby
Po dodaniu
W poniższej tabeli przedstawiono zdarzenia, które można śledzić za pomocą tagu Pinteresta. Możesz użyć ich do
Zdarzenie | Cel |
---|---|
Checkout | Śledzenie osób finalizujących transakcje. |
AddToCart | Śledzenie osób dodających produkty do koszyka. |
Pagevisit | Śledzenie osób przeglądających najważniejsze strony, takie jak strony produktów i strony artykułów. |
Signup | Śledzenie osób rejestrujących się w celu uzyskania produktu lub skorzystania z usługi. |
WatchVideo | Śledzenie osób oglądających filmy. |
Lead | Śledzenie osób wykazujących zainteresowanie produktem lub usługą. |
Wyszukiwanie | Śledzenie osób szukających w witrynie określonych produktów lub lokalizacji sklepów. |
ViewCategory | Śledzenie osób przeglądających strony kategorii. |
Custom | Śledzenie zdarzeń niestandardowych. Ta nazwa zdarzenia umożliwia śledzenie zdarzeń specjalnych, które mają zostać uwzględnione w raporcie konwersji. |
[User-defined event] | Umożliwia dodanie zdarzeń zdefiniowanych do celów związanych z kierowaniem reklam do grup odbiorców. Raportowanie konwersji w przypadku zdarzeń unikatowych nie jest możliwe. Pamiętaj, że wszelkie spacje w nazwach zdarzeń niestandardowych przekazywanych przez tag zostaną usunięte. |
Istnieją wymagane i zalecane zdarzenia w zależności od kampanii reklamowej, którą zdecydujesz się uruchomić.
Typ kampanii | Wymagane zdarzenia | Zalecane zdarzenia | Wymagane dane zdarzenia | Zalecane dane zdarzenia |
---|---|---|---|---|
Świadomość marki | Brak |
|
Brak | Poprawione dopasowanie |
Sprzedaż katalogowa |
|
|
|
|
Rozważenie zakupu | Brak |
|
Brak | Poprawione dopasowanie |
Konwersje |
Co najmniej jedno z poniższych zdarzeń:
|
|
Brak |
|
Wyświetlenia filmu | Brak | Brak | Brak | Poprawione dopasowanie |
Istnieją wymagane i zalecane zdarzenia w zależności od funkcji, których chcesz użyć.
Funkcja | Wymagane zdarzenia | Zalecane zdarzenia | Wymagane dane zdarzenia | Zalecane dane zdarzenia |
---|---|---|---|---|
Statystyki konwersji |
|
Brak | currency | Brak |
Program zweryfikowanych sprzedawców |
|
Brak | currency | Brak |
Dynamiczne retargetowanie |
|
Brak |
|
Brak |
Jeśli postanowisz użyć opcji ręcznej konfiguracji, konieczne będzie samodzielne dodanie kodu zdarzenia do witryny. Poniższe kroki przeznaczone są dla osób korzystających z opcji ręcznej konfiguracji.
- Zaloguj się na konto firmowe na Pintereście za pośrednictwem komputera.
- Kliknij
ikonę trzech linii w lewym górnym rogu strony. - W obszarze Firma kliknij Konwersje.
- Kliknij Pierwsze kroki.
- Wybierz tylko tag Pinteresta, a następnie kliknij Kontynuuj.
- Kliknij Pomiń w prawym dolnym rogu ekranu.
- Kliknij Przejdź do konfiguracji ręcznej.
- Skopiuj kod podstawowy, a następnie kliknij Kontynuuj.
- Zdecyduj, czy chcesz włączyć automatyczne poprawione dopasowanie, a następnie kliknij Kontynuuj.
- Kliknij Kopiuj kod pod szarym polem obok kodu zdarzenia, które chcesz dodać.
- Otwórz kod strony witryny, na której chcesz śledzić zdarzenie.
- Wklej kod zdarzenia na stronie, na której ma wystąpić zdarzenie, pamiętaj, aby zastąpić dowolne przykładowe wartości wartością odpowiednią dla witryny. Oznacza to, że zdarzenie uruchomi się przy każdym załadowaniu strony.
- Kliknij Gotowe.
Uwaga: jeśli zdarzenie uruchamiane jest dopiero po podjęciu przez kogoś określonego działania na stronie, np. po kliknięciu przycisku lub przesłaniu formularza, upewnij się, że kod zdarzenia uruchamia się wyłącznie w wyniku tego działania. Wymaga to zrozumienia sposobu działania istniejących programów obsługi zdarzeń w kodzie JavaScript na danej stronie.
Możesz przekazać dodatkowe dane dotyczące zdarzenia poprzez dołączenie obiektu zawierającego dane zdarzenia. Na potrzeby kierowania reklam do grup odbiorców dostępne są wszystkie dane zdarzenia, ale w przypadku raportów dotyczących konwersji płatnych i organicznych dostępne są tylko wartości value oraz order_quantity.
Dane zdarzenia | Przykładowa wartość | Typ |
---|---|---|
value | 100.00 | Liczba (całkowita lub zmiennoprzecinkowa) |
event_id | eventId0001 |
Cuąg (ciąg identyfikatora unikatowo identyfikującego zdarzenie) Pamiętaj, że identyfikator można wysłać w którymkolwiek z poniższych pól, z uwzględnieniem wielkości liter: |
order_quantity | 1 | Liczba całkowita |
order_id | 1234OrderID | Ciąg (order_id jest wymagany do raportowania analizy konwersji) |
product_name | Parker Boots | Tablica line_items, ciąg |
product_id | 1414 | Tablica line_items, ciąg |
product_category | Buty | Tablica line_items, ciąg |
product_variant_id | 1414-czerwone | Tablica line_items, ciąg |
product_variant | czerwone | Tablica line_items, ciąg |
product_price | 99.99 | Liczba (całkowita lub zmiennoprzecinkowa), tablica line_items, ciąg |
product_quantity | 1 | Liczba całkowita, tablica line_items, ciąg |
product_brand | Parker | Tablica line_items, ciąg |
promo_code | ZIMA10 | Ciąg |
property | Athleta | Ciąg |
search_query | buty | Ciąg |
video_title | Dobieranie butów firmy Parker Boots | Ciąg |
lead_type | Newsletter | Ciąg |
currency | USD |
Jedna z następujących wartości: AED, AMD, ARS, AUD, AZN, BAM, BGN, BHD, BMD, BND, BOB, BRL, BSD, CAD, CHF, CLP, CNY, COP, CRC, CZK, DKK, DOP, EGP, EUR, FJD, GBP, GEL, GIP, HKD, HNL, HRK, HUF, IDR, ILS, INR, ISK, JMD, JPY, KGS, KRW, KWD, KZT, MAD, MDL, MOP, MXN, MYR, NOK, NZD, OMR, PAB, PEN, PHP, PKR, PLN, QAR, RON, RSD, RUB, SAR, SEK, SGD, THB, TRY, TWD, UAH, USD, UYU, VND lub ZAR. Uwaga: gdy razem ze zdarzeniem tagu przesłana zostanie waluta, przeliczymy kwotę według kursu wymiany, aby była zgodna z walutą konta reklamodawcy. |
Tag IMG to fragment kodu wchodzący w skład tagu Pinteresta i działający jako element rezerwowy w razie wyłączenia przez użytkownika obsługi skryptów JavaScript w przeglądarce. Zalecamy uwzględnienie danych zdarzenia również w tagu IMG w celu skuteczniejszego kierowania reklam do użytkowników. Możesz uznać, że chcesz używać tylko tagu IMG, bez tagu JavaScript, ale wówczas musisz usunąć z kodu tagi
Poniżej znajdują się przykłady poszczególnych typów zdarzeń. Możesz je kopiować i wklejać bezpośrednio w swojej witrynie. Pamiętaj, aby zastąpić wartości przykładowe odpowiednią dla witryny zmienną dynamiczną.
Checkout
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=checkout&ed[event_id]=YOUR_EVENT_ID&ed[value]=10.00&ed[order_quantity]=2&noscript=1" />
Dane zdarzenia: event_id, value, order_quantity i currency
Pamiętaj o wprowadzeniu prawidłowego kodu waluty dla witryny.
AddToCart
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=AddToCart&ed[value]=10.00&ed[order_quantity]=2&noscript=1" />
Dane zdarzenia: value, order_quantity i currency.
Pamiętaj o wprowadzeniu prawidłowego kodu waluty dla witryny.
Pagevisit
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=pagevisit&noscript=1" />
Dane zdarzenia: brak
Signup
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=signup&noscript=1" />
Dane zdarzenia: brak
WatchVideo
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=watchvideo&ed[video_title]=My+Product+Video+01&noscript=1" />
Dane zdarzenia: video_title
Lead
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=lead&ed[lead_type]=Newsletter&noscript=1" />
Dane zdarzenia: lead_type
Wyszukiwanie
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=search&ed[search_query]=horse&noscript=1" />
Dane zdarzenia: search_query
ViewCategory
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=viewcategory&noscript=1" />
Dane zdarzenia: brak
Custom
Typ zdarzenia musi mieć nazwę custom. W przeciwnym razie konwersje śledzone za pomocą tego tagu nie zostaną zaraportowane w Menedżerze reklam.
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=custom&noscript=1" />
Dane zdarzenia: brak
Value (wartość) oraz order_quantity (zamawiana ilość) to dwa elementy danych zdarzenia dostępne w raportach dotyczących konwersji płatnych i organicznych. Jeśli chcesz dodać wartość i ilość, możesz te informacje przekazać dynamicznie. Wartość dynamiczna może się zmienić w zależności od działania podjętego w witrynie. Jeśli zdecydujesz się przekazywać wartości value i order_quantity, ich konfiguracja będzie specyficzna dla witryny oraz sposobu rejestrowania sprzedaży. Wartość i ilość produktu w poszczególnych zamówieniach składanych w witrynie zwykle są różne.
<script>
pintrk('track', 'checkout', {
value: {{Enhanced Transaction Revenue}},
order_quantity: {{item.quantity}}
});
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=checkout&ed[value]={{Enhanced Transaction Revenue}}&ed[order_quantity]={{item.quantity}}&noscript=1" />
</noscript>
Raportowana wartość: dynamicznie generowana kwota za zakupy w danym zdarzeniu przejścia do kasy
Raportowana ilość: dynamicznie generowana liczba zakupionych produktów w danych zdarzeniu przejścia do kasy
Uwaga: konfiguracja wartości dynamicznych value i order_quantity jest specyficzna dla danej witryny.
Oprócz danych zdarzenia możesz przekazać funkcję wywołania zwrotnego JavaScript jako opcjonalny argument funkcji pintrk(). Dzięki temu możesz uzyskać dodatkowe informacje, gdy wystąpi jakiś problem z tagiem — sprawdzisz je w stosowanym narzędziu dla programistów. Funkcja wywołania zwrotnego jest uruchamiana przy każdym wywołaniu funkcji śledzenia zdarzenia, czyli funkcji pintrk().
W funkcji wywołania zwrotnego używane są następujące dwa argumenty:
function(didInit, error) {}
didInit: ten pierwszy argument przyjmuje wartość logiczną. Jest to wartość true, gdy wywołanie funkcji śledzenia zdarzenia jest prawidłowo skonstruowane, lub wartość false w razie wykrycia błędu podczas wywołania funkcji śledzenia zdarzenia.
error: ten drugi argument pobiera ciąg z opisem błędu, gdy argument didInit przybiera wartość false. Gdy argument didInit ma wartość true, ciąg pozostaje niezdefiniowany.
<script>
pintrk('track', 'checkout', {
value: 10.00,
order_quantity: 2,
currency: 'USD',
event_id: 'eventId0001',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_price: 5.00,
product_quantity: 1
},
{
product_name: 'Parker Sandals'
product_id: 'ABC',
product_price: 5.00,
product_quantity: 1
}
]
}, function(didInit, error) { if (!didInit) { console.log(error); }
});
</script>
Aby umożliwić śledzenie i raportowanie konwersji, w kodzie zdarzenia podaj jeden z dziewięciu typów zdarzeń. Zastąp również element YOUR_TAG_ID identyfikatorem tagu konwersji Pinteresta. Pamiętaj, że w przypadku poszczególnych zdarzeń możesz użyć dowolnej kombinacji danych zdarzenia, a nie tylko tych pokazanych w poniższych przykładach.
W tej części przedstawiono kompletne przykłady wszystkich typów zdarzeń w formacie umożliwiającym ich skopiowanie, a następnie umieszczenie bezpośrednio w witrynie. Każdy z przykładów zawiera dane zdarzenia niezbędne do rozpoczęcia śledzenia działań w witrynie. Pamiętaj, aby zastąpić przykładowe wartości odpowiednimi dla danej witryny wartościami statycznymi lub zmiennymi dynamicznymi. Przykładowo najprawdopodobniej zechcesz śledzić wartość zamówienia dynamicznie, ponieważ wartość poszczególnych zamówień składanych w witrynie różni się w zależności od tego, co kto kupuje. Jednak możesz przypisać wartość statyczną do elementu lead_type (typ potencjalnego klienta) danych zdarzenia, jeśli jest on umieszczany wyłącznie na jednej, konkretnej stronie.
Checkout
<script>
pintrk('track', 'checkout', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Dane zdarzenia: value, order_quantity, currency, event_id.
Pamiętaj o wprowadzeniu prawidłowego kodu waluty dla witryny.
AddToCart
<script>
pintrk('track', 'addtocart', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Dane zdarzenia: value, order_quantity i currency.
Pamiętaj o wprowadzeniu prawidłowego kodu waluty dla witryny.
Pagevisit
<script>
pintrk('track', 'pagevisit', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Signup
<script>
pintrk('track', 'signup', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
WatchVideo
<script>
pintrk('track', 'watchvideo', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Dane zdarzenia:Video_title
Lead
<script>
pintrk('track', 'lead', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Dane zdarzenia: lead_type
Wyszukiwanie
<script>
pintrk('track', 'search', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Dane zdarzenia: search_query
ViewCategory
<script>
pintrk('track', 'viewcategory', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Zdarzenia zdefiniowane przez użytkownika
<script>
pintrk('track', 'user_defined_event_name', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Custom
Typ zdarzenia musi mieć nazwę custom. W przeciwnym razie konwersje śledzone za pomocą tego tagu nie zostaną uwzględnione w raportach w Menedżerze reklam.
<script>
pintrk('track', 'custom', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Oto kilka przykładów zastosowania kodu podstawowego w połączeniu z kodami zdarzeń. Pamiętaj, aby sprawdzić, czy kod zdarzenia został umieszczony w witrynie po kodzie podstawowym.
Przykład identyfikatora tagu konwersji: 123456789 (zastąp go identyfikatorem tagu konwersji Pinteresta)
Przykład kodu zdarzenia: PageVisit
<head>
<script type="text/javascript">
!function(e){if(!window.pintrk){window.pintrk=function(){window.pintrk.queue.push(
Array.prototype.slice.call(arguments))};var
n=window.pintrk;n.queue=[],n.version="3.0";var
t=document.createElement("script");t.async=!0,t.src=e;var
r=document.getElementsByTagName("script")[0];r.parentNode.insertBefore(t,r)}}
("https://s.pinimg.com/ct/core.js"); pintrk('load', '123456789'); pintrk('page');
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&noscript=1" />
</noscript>
<script>
pintrk('track', 'pagevisit');
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=pagevisit&noscript=1" />
</noscript>
</head>
Przykład identyfikatora tagu konwersji: 123456789 (zastąp go identyfikatorem tagu konwersji Pinteresta)
Przykład kodów zdarzeń: PageVisit i AddToCart
<head>
<script type="text/javascript">
!function(e){if(!window.pintrk){window.pintrk=function(){window.pintrk.queue.push(
Array.prototype.slice.call(arguments))};var
n=window.pintrk;n.queue=[],n.version="3.0";var
t=document.createElement("script");t.async=!0,t.src=e;var
r=document.getElementsByTagName("script")[0];r.parentNode.insertBefore(t,r)}}
("https://s.pinimg.com/ct/core.js"); pintrk('load', '123456789'); pintrk('page');
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&noscript=1" />
</noscript>
<script>
pintrk('track', 'pagevisit');
pintrk('track', 'addtocart');
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=pagevisit&noscript=1" />
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=addtocart&noscript=1" />
</noscript>
</head>