イベントコードを使うと、お客様の Pinterest アドがサイト上の特定のアクションに与えている効果・影響を測定することができます。コンバージョンキャンペーンやダイナミックリターゲティング広告など、特定のイベントを自動的に最適化するキャンペーンを開始する際に必要となります。
以下の表は、Pinterest タグでトラッキングできるイベントを示しています。これらを使用すれば、
イベント | 目的 |
---|---|
Checkout | トランザクションを完了したユーザーをトラッキングします。 |
AddToCart | アイテムをショッピングカートに追加したユーザーをトラッキングします。 |
Pagevisit | 商品のページや記事のページなど、トップページを閲覧したユーザーをトラッキングします。 |
Signup | 商品またはサービスに登録したユーザーをトラッキングします。 |
WatchVideo | 動画を視聴したユーザーをトラッキングします。 |
Lead | 商品やサービスに関心を持ったユーザーをトラッキングします。 |
Search | あなたのサイトで特定の商品や店舗情報を検索したユーザーをトラッキングします。 |
ViewCategory | カテゴリページを閲覧したユーザーをトラッキングします。 |
Custom | 特別なイベントをトラッキングします。コンバージョンレポートに含めたい特別なイベントをトラッキングするには、このイベント名を使用します。 |
[User-defined event] | オーディエンスのターゲティング目的でユーザーが定義して追加できるイベント。独自のイベントはコンバージョンレポートに使用できません。また、タグから渡された元のカスタムイベント名に空白となっているスペースがある場合、そのスペースは削除されます。 |
実行する広告キャンペーンに応じて、必須イベントとおすすめのイベントがあります。
キャンペーンのタイプ | 必須イベント | おすすめのイベント | 必須イベントデータ | おすすめのイベントデータ |
---|---|---|---|---|
ブランド認知度 | なし |
|
なし | エンハンスドマッチ |
カタログ販売 |
|
|
|
|
比較検討 | なし |
|
なし | エンハンスドマッチ |
コンバージョン |
以下のうち少なくとも 1 種類:
|
|
なし |
|
動画視聴 | なし | なし | なし | エンハンスドマッチ |
使用したい機能に応じて、必須イベントとおすすめのイベントがあります。
機能 | 必須イベント | おすすめのイベント | 必須イベントデータ | おすすめのイベントデータ |
---|---|---|---|---|
コンバージョンインサイト |
|
なし | 通貨 | なし |
認定ショッププログラム(VMP) |
|
なし | 通貨 | なし |
ダイナミックリターゲティング |
|
なし |
|
なし |
手動で設定することを決めたら、自分でイベントコードをウェブサイトに追加する必要があります。以下の手順は、手動設定オプションを使用しているユーザー向けです。
- デスクトップから Pinterest のビジネスアカウントにログインします。
- ページ左上にある
ハンバーガーアイコン をクリックします - 「ビジネス」で「コンバージョン」をクリックします。
- 「始める」をクリックします。
- 「Pinterest タグのみ」を選択し、「続行」をクリックします。
- 画面下部で「スキップ」をクリックします。
- 「スキップして手動で設定する」をクリックします。
- ベースコードをコピーして「続行」をクリックします。
- 自動エンハンスドマッチを有効にするかどうかを選択し、「続行」をクリックします。
- 追加するイベントコードの横にある灰色のボックスの下の「コードをコピー」をクリックします。
- イベントを追跡したいウェブサイトのページでコードを開きます。
- イベントが発生するページにイベントコードを貼り付けます。例の値は、自分のウェブサイトに合わせて適切な値に置き換えてください。こうすると、ページが読み込まれるたびにイベントが開始します。
- 「完了」をクリックします。
注意:ユーザーがページ上で特定の行動(ボタンのクリックやフォームの送信など)をした後でのみ開始するイベントの場合、行動の結果イベントコードが開始するように配置されていることを確認してください。このようにコードを配置するには、ページ上の JavaScript コードの既存のイベントハンドラについて十分理解している必要があります。
イベントデータを含むオブジェクトを付加することで、特定のイベントに関する追加情報を提供することができます。オーディエンスターゲティングにはすべてのイベントデータを利用できますが、ペイドとオーガニックのコンバージョンレポートに対応しているのは value(値)および order_quantity(注文数)のイベントデータのみです。
イベントデータ | サンプルの値 | タイプ |
---|---|---|
value | 100.00 | 数値(整数または少数) |
event_id | eventId0001 |
文字列(イベントを一意に識別する ID 文字列) 注:この ID は以下のいずれかのフィールド名で送信できます。なお、いずれも大文字と小文字を区別します。 |
order_quantity | 1 | 整数 |
order_id | 1234orderID | 文字列(order_id はコンバージョン分析レポートに必須です) |
product_name | パーカーブーツ | line_items の配列、文字列 |
product_id | 1414 | line_items の配列、文字列 |
product_category | 靴 | line_items の配列、文字列 |
product_variant_id | 1414-Red | line_items の配列、文字列 |
product_variant | 赤 | line_items の配列、文字列 |
product_price | 99.99 | 数値(整数または少数)、line_items の配列、文字列 |
product_quantity | 1 | 整数、line_items の配列、文字列 |
product_brand | パーカー | line_items の配列、文字列 |
promo_code | WINTER10 | 文字列 |
property | アスレタ | 文字列 |
search_query | ブーツ | 文字列 |
video_title | パーカーブーツのおしゃれなコーデ | 文字列 |
lead_type | ニュースレター | 文字列 |
currency | USD |
次のいずれか 1 つの文字列: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、ZAR 注意:タグイベントに通貨を設定すると、Pinterest は広告主アカウントの通貨に合わせて為替レートを計算します。 |
IMG タグは、ユーザーがブラウザで JavaScript を無効にしている場合の予備的手段となる Pinterest タグ内のコードの一部です。ユーザーのターゲティングをより有効にするために、IMG タグにイベントデータを含めることをおすすめします。JavaScript タグではなく IMG タグのみを使用することも選択できますが、その場合はコードから
以下はそのまま自分のウェブサイトにコピーして貼り付けることができる全イベントタイプの例です。例の値は、自分のウェブサイトに合わせて動的な変数に置き換える必要があります。
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"/>
イベントデータ:event_id、value、order_quantity、currency
ウェブサイトに合わせて通貨コードを入力してください。
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"/>
イベントデータ:value、order_quantity、currency。
ウェブサイトに合わせて通貨コードを入力してください。
Pagevisit
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=pagevisit&noscript=1"/>
イベントデータ:なし
Signup
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=signup&noscript=1"/>
イベントデータ:なし
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"/>
イベントデータ: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"/>
イベントデータ:lead_type
Search
<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"/>
イベントデータ: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"/>
イベントデータ:なし
Custom
イベントタイプは必ず Custom(カスタム)にしてください。そうしないとタグがトラッキングしたコンバージョンがアドマネージャーのレポートに反映されません。
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=custom&noscript=1"/>
イベントデータ:なし
value(値)と order_quantity(注文数)はペイドとオーガニックのコンバージョンレポートに対応している 2 種類のイベントデータです。value(値)と order_quantity(注文数)をレポートに追加するには、動的に渡すことができます。動的な値は、サイトで実行されたアクションによって変わります。value(値)と order_quantity(注文数)を渡すことを選んだ場合、その方法はあなたのウェブサイトに固有の、売上の記録方法となります。一般に、ウェブサイトで注文される商品の値と数量は、注文ごとに違います。
<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]={{EnhancedTransaction Revenue}}&ed[order_quantity]={{item.quantity}}&noscript=1" />
</noscript>
レポートに渡される値:該当する checkout(購入)イベントの動的な購入金額
レポートに渡される数量:該当する checkout(購入)イベントの動的な購入数量
注意:動的な order_quantity(注文数)と value(値)は、あなたのウェブサイトに固有の設定になります。
イベントデータに加えて、関数 pintrk() にオプションの引数として JavaScript のコールバック機能を渡すことができます。これにより、タグに何か問題があった場合に追加情報が提供され、デベロッパーツールを確認することができます。このコールバック機能は、イベントトラッキングコールの関数 pintrk() がトリガーすると毎回実行されます。
コールバック機能には次の 2 件の引数を使用します。
function(didInit, error) {}
didInit:この最初の引数は真偽値を受け取ります。イベントトラッキングコールが正しく構築された場合は true(真)を返し、イベントトラッキングコールの作成中にエラーが検出された場合には false(偽)を返す設定になっています。
error:この 2 番目の引数は文字列を受け取ります。didInit が false(偽)を返した場合はエラーの内容を説明しますが、didInit が true(真)を返した時の文字列は定義されていません。
<script>
pintrk('track', 'checkout', {
value: 10.00,
order_quantity: 2,
currency: 'USD',
event_id: 'eventId0001',
line_items: [
{
product_name: 'パーカー ブーツ',
product_id: '1414',
product_price: 5.00,
product_quantity: 1
},
{
product_name: 'パーカー サンダル'
product_id: 'ABC',
product_price: 5.00,
product_quantity: 1
}
]
}, function(didInit, error) { if (!didInit) { console.log(error);}
});
</script>
コンバージョントラッキングとコンバージョンレポートでは、イベントコードの 9 件のイベントタイプのうち 1 件を指定する必要があります。また、YOUR_TAG_ID を Pinterest コンバージョンタグ ID で置き換えることも必要です。以下の例に表示されている以外にも、イベントごとに任意の組み合わせのイベントデータを使用することができます。
このセクションには、コピー可能な形式かつ完璧な状態で各イベントタイプの例を表示しているので、そのまま自分のサイトに貼り付けることができます。それぞれの例には、ウェブサイト上のアクティビティをトラッキングするために必要なイベントデータも含まれています。例の値は、自分のウェブサイトに合わせた適切な静的な値または動的な変数に置き換える必要があります。例えば、ユーザーが何を購入するかに応じてウェブサイト上の各注文の値が変わるため、注文の値は動的にトラッキングしたいと考えるでしょう。一方で、ある特定のページのみに設置する場合、lead_type(リードタイプ)イベントデータには静的な値を割り当ててもかまいません。
Checkout
<script>
pintrk('track', 'checkout', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'アレスタ',
search_query: 'ブーツ',
video_title: 'パーカーブーツのおしゃれなコーデ',
lead_type: 'ニュースレター',
line_items: [
{
product_name: 'パーカーブーツ',
product_id: '1414',
product_category: '靴',
product_variant_id: '1414-Red',
product_variant: '赤',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
イベントデータ:value、order_quantity、currency、event_id
ウェブサイトに合わせて通貨コードを入力してください。
AddToCart
<script>
pintrk('track', 'addtocart', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'アレスタ',
search_query: 'ブーツ',
video_title: 'パーカーブーツのおしゃれなコーデ',
lead_type: 'ニュースレター',
line_items: [
{
product_name: 'パーカーブーツ',
product_id: '1414',
product_category: '靴',
product_variant_id: '1414-Red',
product_variant: '赤',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
イベントデータ:value、order_quantity、currency。
ウェブサイトに合わせて通貨コードを入力してください。
Pagevisit
<script>
pintrk('track', 'pagevisit', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'アレスタ',
search_query: 'ブーツ',
video_title: 'パーカーブーツのおしゃれなコーデ',
lead_type: 'ニュースレター',
line_items: [
{
product_name: 'パーカーブーツ',
product_id: '1414',
product_category: '靴',
product_variant_id: '1414-Red',
product_variant: '赤',
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: 'アレスタ',
search_query: 'ブーツ',
video_title: 'パーカーブーツのおしゃれなコーデ',
lead_type: 'ニュースレター',
line_items: [
{
product_name: 'パーカーブーツ',
product_id: '1414',
product_category: '靴',
product_variant_id: '1414-Red',
product_variant: '赤',
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: 'アレスタ',
search_query: 'ブーツ',
video_title: 'パーカーブーツのおしゃれなコーデ',
lead_type: 'ニュースレター',
line_items: [
{
product_name: 'パーカーブーツ',
product_id: '1414',
product_category: '靴',
product_variant_id: '1414-Red',
product_variant: '赤',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
イベントデータ: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: 'アレスタ',
search_query: 'ブーツ',
video_title: 'パーカーブーツのおしゃれなコーデ',
lead_type: 'ニュースレター',
line_items: [
{
product_name: 'パーカーブーツ',
product_id: '1414',
product_category: '靴',
product_variant_id: '1414-Red',
product_variant: '赤',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
イベントデータ:lead_type
Search
<script>
pintrk('track', 'search', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'アレスタ',
search_query: 'ブーツ',
video_title: 'パーカーブーツのおしゃれなコーデ',
lead_type: 'ニュースレター',
line_items: [
{
product_name: 'パーカーブーツ',
product_id: '1414',
product_category: '靴',
product_variant_id: '1414-Red',
product_variant: '赤',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
イベントデータ: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: 'アレスタ',
search_query: 'ブーツ',
video_title: 'パーカーブーツのおしゃれなコーデ',
lead_type: 'ニュースレター',
line_items: [
{
product_name: 'パーカーブーツ',
product_id: '1414',
product_category: '靴',
product_variant_id: '1414-Red',
product_variant: '赤',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
User-defined event
<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: 'アレスタ',
search_query: 'ブーツ',
video_title: 'パーカーブーツのおしゃれなコーデ',
lead_type: 'ニュースレター',
line_items: [
{
product_name: 'パーカーブーツ',
product_id: '1414',
product_category: '靴',
product_variant_id: '1414-Red',
product_variant: '赤',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Custom
イベントタイプは必ず Custom(カスタム)にしてください。そうしないとタグがトラッキングしたコンバージョンがアドマネージャーのレポートに反映されません。
<script>
pintrk('track', 'custom', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'アレスタ',
search_query: 'ブーツ',
video_title: 'パーカーブーツのおしゃれなコーデ',
lead_type: 'ニュースレター',
line_items: [
{
product_name: 'パーカーブーツ',
product_id: '1414',
product_category: '靴',
product_variant_id: '1414-Red',
product_variant: '赤',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
ここではベースコードとイベントコードを組み合わせた例を示します。必ずベースコード、イベントコードの順に配置するようにしてください。
例のコンバージョンタグ ID:123456789(自分の Pinterest コンバージョンタグに置き換えます)
例のイベントコード: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>
例のコンバージョンタグ ID:123456789(自分の Pinterest コンバージョンタグに置き換えます)
例のイベントコード:PageVisit、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>