カタログの利用を開始する前に

カタログを利用できない国・地域から本フォームにアクセスしているようです。Pinterest Business アカウントでカタログが利用できる国・地域をご覧ください。

詳細

「カタログ」を設定するには、最初にこちらの手順を実行する必要があります。下記のリンクをクリックすると、各手順の詳しい説明を確認できます。

カタログの利用可能条件

カタログとは、ウェブサイトで商品を販売するビジネス向けのフィード取得ツールです。カタログの利用には、以下を所有している必要があります。

  • Pinterest ビジネス向けアカウント
  • データソース(商品と対応する属性情報を組み合わせてリストにしたファイルです。商品カタログまたは商品フィードと呼ばれることもあります。)
  • ドメイン所有権を認証済みのウェブサイト
  • ウェブサイトは Pinterest の販売事業者ガイドラインを遵守しており、配送ポリシー、返金ポリシー、連絡先が明確かつ見つけやすい場所に記載されていること
  • データソースのホスティング(商品のデータソースを常にホスティング/保存し、毎日 Pinterest に送信できる状態にする必要があります。)

上記の条件を満たさなかった場合においても、e コマースのウェブサイトと提携して Pinterest 向けに商品のデータ形式を整えることでショップピンを作成することができます。現時点で、Pinterest は GoDataFeed および Productsup と提携しています。また、その他にも Pinterest でコンテンツをプロモートする方法があります。

データソースの概要

データソースとは?

データソース(別名:商品カタログ、商品フィード、データフィード)とは、商品と対応する属性情報を特定の方法で組み合わせたリストで構成されるファイルです。このファイルは毎日処理され、更新情報に応じて都度商品のピンを作成します。

データソースの仕組み

Pinterest にデータソースを送信するには、データソースのファイルにアクセスできる URL のリンクを提供する必要があります。Pinterest はファイルを審査したのち、審査に合格した各アイテムのプロダクトピンを作成します。データソースの仕様については、こちらをご覧ください。

データソースの管理

データソースをホスティング開始以降は、その後も最新の在庫情報を元に、データソースの情報も継続的に更新する必要があります。Pinterest はあなたのデータソースを毎日取得し、エラーがないかどうか確認します。エラーが発生した場合、なるべく迅速に修正し、最新且つ確実な情報を提供できているか常に確認することが重要です。

エラーの種類によっては、フィード全体、もしくは一部のアイテムのみ更新されなかった場合、またベストプラクティスに従って修正が必要となるケースもあります。エラーメッセージのトラブルシューティングについては、こちらをご覧ください。

その他データソースについて

  • 毎日のアップデート:Pinterest は 24 時間ごとに 1 回データソースを取得します。商品データを最新に保つには、毎日更新されたデータソースにアクセスできるようにしてください。スケジュール取得またはオンデマンドの取得には対応していません。
  • データソースのホスティング。データソースは FTP/SFTP サーバー上あるいは HTTP/HTTPS のダイレクトダウンロードリンクを使用してホスティングしてください。ユーザーエージェントでアクセス可能で、IP または SSH キーのホワイトリストを必要としない場所に配置する必要があります。ダイレクトダウンロードリンクを使用する場合、Pinterest がファイルにアクセスするには、追加のナビゲーションを必要としないようにしてください。Pinterest はデータソースのホスティングサービスを提供していません。
  • 最大 500 万件の商品に対応: アカウントごとに最大 500 万件の商品を扱うことができます。データソースに 500 万件以上の商品がある場合、Pinterest は最初の 500 万件のみを処理します。
  • 1 件のビジネス向けアカウントに対し 1 件のデータソースを連携できます。

Pinterest でドメイン所有権を認証したウェブサイトを用意する

データソースのリンク先 URL には、Pinterest でドメイン所有権を認証したウェブドメインが含まれている必要があります。ビジネス/サービス/会社で複数のドメインを認証することは可能ですが、Pinterest ビジネス向けアカウント 1 件につき認証できるドメインは 1 件のみです。ウェブサイトのドメイン所有権の認証方法は、こちらをご覧ください。

データソースを準備する

フィードを設定する前に、データソースを作成する必要があります。これは商品と対応する属性情報を組み合わせてリストにしたファイルです。

カタログに使用するデータソースのホスティング要件

自前の FTP サーバーまたは SFTP サーバーのホスティングを提供するか、HTTP または HTTPS のダイレクトダウンロードリンクを設定する必要があります。Pinterest はユーザーにホスティングを提供しません。データソースは、ユーザーエージェントでアクセス可能で、IP または SSH キーのホワイトリストを必要としない場所に配置してください。HTTP または HTTPS の形でダイレクトダウンロードリンクを使用する場合、Pinterest がファイルにアクセスするために、追加のナビゲーションを必要としないようリンクを設定する必要があります。

カタログに使用するデータソースの形式に関する要件

サポートされている形式:

形式のヒント:

  • csv 形式の場合、ファイルの解析エラーが生じないように値をすべて二重引用符("")で囲みます。
  • 区切り文字(コンマ、タブ)を追加使用すると、アイテムまたはファイルが適切に処理されない可能性があります。
  • 各行にある区切り文字の数が同じとなるよう、全ての列および行の区切り文字が正しく設定されていることを確認してください。
  • フィードの仕様は、必須の値と設定値で標準的なアメリカ英語に従う必要があります。
  • タブ区切り形式またはコンマ区切り形式のファイルのデータソースファイルは UTF-8 または Latin1 にエンコードにする必要があります。

商品データに関する要件

Pinterest の販売事業者ガイドラインに従っていることを確認してください。違反すると商品またはアカウントが削除される場合があります。

必須のフィールドと任意のフィールド

必須のフィールドは 7 つあります。これらのフィールドが空欄になっている場合、または正しくフォーマットされていない場合、フィード全体の取り込みに失敗します。

必須のフィールド:

  • id
  • title
  • description
  • link
  • image_link
  • price
  • availability

また、任意のフィールドを追加すると、Pinterest より的確に商品をユーザーに紹介することができます。提供する情報が多ければ多いほど、あなたのピンはより関連性の高いユーザーに表示されます。任意のフィールドを追加してより多くの詳細情報をフィードに提供し、関連性を高めることを推奨します。

必須のフィールド

一列目の各タイトル 説明 構文/サポートされている値 必須
id

ユーザーが作成した、商品を示す固有の ID。

使用できるのは Unicode 文字のみです。

最大 127 文字 DS0294-L 必須
title 商品の名前。ランディングページに表示されている商品名と同一にしてください。色やサイズなどバリエーション情報を含みます。 最大 500 文字 レディースデニムシャツ(L) 必須
description 商品の説明文。HTML には対応していません。適切に表示させるにはプレーンテキストにする必要があります。 最大 10,000 文字 上質な国産のデニム生地で作られたカジュアルフィットのデニムシャツです。 必須
link 商品のランディングページ。データソース内で指定した商品に直接アクセスでき、指定したデータが表示されるリンクでなければなりません。ハードウォールは使用しないことを推奨します。URL は http:// または https:// で始まる必要があります。 最大 511 文字 https://www.example.com/cat/womens-clothing/denim-shirt-0294 必須
image_link

商品画像へのリンク。ユーザーエージェントでアクセス可能な URL で、正しい画像を送信する URL にする必要があります。リンク先がテンプレートまたはプレースホルダー画像ではないことを確認してください。URL は http:// または https:// で始まる必要があります。

画像リンクの一部にコンマが使用されている場合は、エンコードするか削除してください。現在のところコンマを含む画像リンクを処理することはできません。

  https://scene.example.com/image/image.jpg 必須
price 商品の価格。米ドルでない場合は ISO-4217 準拠の通貨コードを含めてください。通貨コードがない場合はデフォルトで米ドル表記となります。通貨コードは価格の後に入力します。数値と通貨コードの間のスペースは、あってもなくても構いません。通貨は ISO-4217 準拠の通貨コードに従ってください。価格は 0 にはできません。通貨記号は使用しないでください。

<数値>

<ISO 4217>

24.99 USD
24.99USD
24.99
24.99 GBP
必須
availability 商品の在庫状況。「in stock」(在庫あり)「out of stock」(在庫なし)「preorder」(予約注文)のいずれかの値にしてください。 in stock
out of stock
preorder
in stock 必須

オプションの一般属性

一列目の各タイトル 説明 構文/サポートされている値 必須
product_type あなた独自の商品用語を元にした商品の分類。下位分類は区切り文字「 > 」を使用して送信する必要があります。> の前後にはスペースを挿入してください。コンマやパイプなど他の区切り文字は認識されません。

L0 > L1 > L2 > L3 > L4

最大 1000 文字

衣料品 > レディース > シャツ > デニム 省略可
additional_image_link

商品の追加画像へのリンク。各画像はコンマで区切ります。文字列全体を二重引用符("")で囲むことを推奨します。http:// または https:// で始める必要があります。

画像リンクの一部にコンマが使用されている場合、エンコードするか削除してください。現在コンマを含む画像リンクを処理することはできません。
 

送信した追加画像のリンクごとに新しいピンを作成します。

  "https://scene.example.com/image/image_v2.jpg, https://scene.example.com/image/image_v3.jpg" 省略可
mobile_link モバイルデバイスに最適化されたランディングページ。http:// または https:// で始める必要があります。   https://m.example.com/cat/womens-clothing/denim-shirt-0294 省略可
sale_price 商品の割引価格。sale_price は price より低く設定する必要があります。price と同一の通貨コードを使用します。米ドルでない場合は ISO-4217 準拠の通貨コードを含めてください。通貨が含まれない場合はデフォルトで米ドル表記となります。通貨コードは価格の後に入力します。数値と通貨コードの間のスペースは、あってもなくても構いません。割引価格は 0 にはできません。通貨記号は使用しないでください。

<数値>

<ISO 4217>

14.99 米ドル
14.99 米ドル
14.99
14.99 英ポンド
省略可

オプションの商品の識別子

一列目の各タイトル 説明 構文/サポートされている値 必須
item_group_id 商品の親 ID。  最大 127 文字 DS0294 複数のバリエーションがあるアイテムの場合は必須

brand

商品のブランド。   ジョシーズデニム 省略可
gtin 一意の国際標準商品 ID。 数値 3234567890126 省略可
mpn 製品部品番号。これは商品のメーカーが作成した英数字のコードで、同じメーカーの全商品の中で該当商品を識別するために使用します。  英数字 "mpn":
"PI12345NTEREST"
省略可

オプションの商品特性

一列目の各タイトル 説明 構文/サポートされている値 必須

color

商品のメインの色   ブルー 省略可
gender 商品と関連付けられた性別。送信する場合は「male」(男性)「female」(女性)「unisex」(ユニセックス)のいずれかの値にする必要があります。 male
female
unisex
female 省略可
age_group 商品の人口統計学的範囲に適用する年齢層。「newborn」(新生児)「infant」(乳児)「toddler」(幼児)「kids」(子供)「adult」(大人)のいずれかの値にしてください。 newborn
infant
toddler
kids
adult
adult 省略可
material 商品の材料。   綿 省略可
pattern 商品に用いられている柄の説明。   タータンチェック 省略可
size 商品のサイズ。   M 省略可
size_type サイズに関する追加説明。送信する場合は「regular」(レギュラーサイズ)「petite」(小さいサイズ)「plus」(女性の大きいサイズ)「big_and_tall」(男性の大きいサイズ)「maternity」(マタニティー)のいずれかの値にする必要があります。 regular
petite
plus
big_and_tall
maternity
regular 省略可
size_system 商品を提出している国のサイズシステムを示します。 国コード

US
UK

省略可

オプションの税金と配送に関するデータ

一列目の各タイトル 説明 構文/サポートされている値 必須
tax それぞれの税金属性グループは「country:region:rate(必須):tax_ship」という4 種類の下位属性で構成されます。
値が空白の場合も、コロンを挿入する必要があります。
country:region:rate(必須):tax_ship US:1025433:6.00:y 省略可
shipping それぞれの配送属性グループは「country, region, service, price(必須)」という4 種類の下位属性で構成されます。
値が空白の場合も、コロンを挿入する必要があります。
country:region:service:price(必須)

US:CA:Ground:0 USD

US::Express:13.12

省略可

shipping_weight

商品の重量。数値と単位の間にスペースを使用してください。 <数値> <単位> 3 kg
5 lbs
省略可
shipping_width 商品を発送する際に必要なパッケージの幅。数値と単位の間にスペースを使用してください。 <数値> <単位> 16 in 省略可
shipping_height 商品を発送する際に必要なパッケージの高さ。数値と単位の間にスペースを使用してください。 <数値> <単位> 12 in 省略可

オプションのアダルト関連商品フラグ

一列目の各タイトル 説明 構文/サポートされている値 必須
adult 「アダルト(成人向け)」とみなされるアイテムを提出する場合、この属性を TRUE に設定します。Pinterest には表示されなくなります。 TRUE
FALSE
true 省略可

任意のカスタムラベル

商品のカスタムグループ。シーズン限定、プロモーション、ベストセラーなど、さまざまな目的に使用することができます。カスタムラベルは最大 5 つまで使用可能です。

カスタムラベルを使って、カタログで商品グループを作成できるようになります。

一列目の各タイトル 説明 構文/サポートされている値 必須
custom_label_0 商品のカスタムグループ。 最大 1000 文字

ベストセラー

サマープロモーション

省略可
custom_label_1 商品のカスタムグループ。 最大 1000 文字   省略可
custom_label_2 商品のカスタムグループ。 最大 1000 文字   省略可
custom_label_3 商品のカスタムグループ。 最大 1000 文字   省略可
custom_label_4 商品のカスタムグループ。 最大 1000 文字   省略可

任意のショッピング広告フィールド

一列目の各タイトル 説明 構文/サポートされている値 必須
ad_link 広告主は、Pinterest のショッピング広告からのトラフィックを追跡できる個別の URL を特定できるようになります。トラッキングパラメータだけでなく、トラッキングを含む完全な URL を送信してください。現時点で、Pinterest はインプレッショントラッキングに対応していません。URL はhttp:// または https:// で始まる必要があります。 文字列 URL https://www.example.com/cat/denim-shirt/item012?utm_source=Pinterest 省略可
condition 商品の状態。「new」(新品)「used」(中古品)「refurbished」(再生品)のいずれかの値にしてください。 new
used
refurbished
new 省略可
google_product_category 標準化された Google 商品用語を元にした商品の分類。設定済みの用語を使用します。テキスト値と数値コードを使用することができます。 用語リスト ファッション・アクセサリー > 衣料品 > トップス
212
省略可

 

Required and optional fields

There are 7 required fields. If any of these fields are missing, or are not properly formatted, your entire feed will fail ingestion.

Required fields:

  • id
  • title
  • description
  • link
  • image_link
  • price
  • availability

There are also optional fields you can add to help Pinterest better map your products to Pinners. The more information you provide, the more relevant your Pins will be to the Pinners who see them. We strongly recommend adding our optional fields as well to add more detail to your feed and improve relevancy.

Required fields

Column name Description Syntax/supported values Example Requirement
id

The user-created unique ID that represents the product.

Only Unicode characters are accepted.

Max 127 characters DS0294-L required
title The name of the product. Must be the same name as the product from the landing page. Include the variant details, such as color and size. Max 500 characters Women’s denim shirt, large required
description Description of the product. This field does not support HTML and must be in plain text for optimal experience. Max 10,000 characters Casual fit denim shirt made with the finest quality Japanese denim.  required
link The landing page for the product. The link must lead directly to the same product and showcase the same data. We recommend against hardwalls. The URL must start with http:// or https://  Max 511 characters https://www.example.com/cat/womens-clothing/denim-shirt-0294 required
image_link

The link to the product image. The URL must be accessible by a user-agent, and send the accurate image. Please make sure there are no template or placeholder images at the link. Must start with http:// or https://

Commas must be encoded or removed if they are part of the image link, as currently we are unable to process image links containing commas.

  https://scene.example.com/image/image.jpg required
price The price of the product. The price should include currency in ISO-4217 if it is not US dollars. If the currency is not included, we default to US dollars. We accept currency after the numeric price value, with or without space. Currency should follow the standard ISO-4217 code. We do not accept 0 values for price. Do not use currency symbols.

<numeric>

<ISO 4217>

24.99 USD
24.99USD
24.99
24.99 GBP
required
availability The availability of the product. Must be one of the following values: ‘in stock’, ‘out of stock’, ‘preorder’. in stock
out of stock
preorder
in stock required

Optional general attributes

Column name Description Syntax/supported values Example Requirement
product_type The categorization of your product based on your custom product taxonomy. Subcategories must be sent separated by “ > “. The > must be wrapped by spaces. We do not recognize any other delimiters such as comma or pipe.

L0 > L1 > L2 > L3 > L4

Max 1000 characters

Clothing > Women’s > Shirts > Denim optional
additional_image_link

The links to additional images for your product. Separate each additional image with comma. We recommend enclosing the whole string with quotes. Must begin with http:// or https://

Commas must be encoded or removed if they are part of the image link, as currently we are unable to process image links containing commas.
 

We will create a new pin for every additional image link sent.

  "https://scene.example.com/image/image_v2.jpg, https://scene.example.com/image/image_v3.jpg" optional
mobile_link The mobile-optimized version of your landing page. Must begin with http:// or https://   https://m.example.com/cat/womens-clothing/denim-shirt-0294 optional
sale_price The discounted price of the product. The sale_price must be lower than the price. Include currency in the same setup as price. It should include currency in ISO-4217 if it is not US dollars. If the currency is not included, we default to US dollars. We accept currency after the numeric price value, with or without space. We do not accept 0 values. Do not use currency symbols.

<numeric>

<ISO 4217>

14.99 USD
14.99USD
14.99
14.99 GBP
optional

Optional product identifier

Column name Description Syntax/supported values Example Requirement
item_group_id The parent ID of the product.  Max 127 characters DS0294 required for items with multiple variants

brand

The brand of the product.   Josie’s Denim optional
gtin The unique universal product identifier. Numeric 3234567890126 optional
mpn Manufacturer Part Number are alpha-numeric codes created by the manufacturer of a product to uniquely identify it among all products from the same manufacturer.  Alphanumeric "mpn":
"PI12345NTEREST"
optional

Optional product characteristics

Column name Description Syntax/supported values Example Requirement

color

The primary color of the product   blue optional
gender The gender associated with the product. Must be one of the following values if sent: ‘male’, ‘female’, ‘unisex’ male
female
unisex
female optional
age_group The age group to apply a demographic range to the product. Must be the one of the following values: ‘newborn’, ‘infant’, ‘toddler’, ‘kids’, ‘adult’ newborn
infant
toddler
kids
adult
adult optional
material The material used to make the product.   cotton optional
pattern Description of the pattern used for the product.   plaid optional
size The size of the product.   M optional
size_type Additional description for the size. Must be one of the following values if sent: ‘regular’, ‘petite’, ‘plus’, ‘big_and_tall’, ‘maternity’ regular
petite
plus
big_and_tall
maternity
regular optional
size_system Indicates the country’s sizing system in which you are submitting your product. Country code

US
UK

optional

Optional tax and shipping data

Column name Description Syntax/supported values Example Requirement
tax Each tax attribute group can consist of 4 sub-attributes: country:region:rate (required):tax_ship
All colons, even for blank values, are required.
country:region:rate(required):tax_ship US:1025433:6.00:y optional
shipping Each delivery attribute group can consist of 4 sub-attributes: country, region, service, and price (required).
All colons, even for blank values, are required.
country:region:service:price(required)

US:CA:Ground:0 USD

US::Express:13.12

optional

shipping_weight

The weight of the product. Ensure there is a space between the numeric string and the metric. <numeric> <metric> 3 kg
5 lbs
optional
shipping_width The width of the package needed to ship the product. Ensure there is a space between the numeric string and the metric. <numeric> <metric> 16 in optional
shipping_height The height of the package needed to ship the product. Ensure there is a space between the numeric string and the metric. <numeric> <metric> 12 in optional

Optional adult product flag

Column name Description Syntax/supported values Example Requirement
adult Set this attribute to TRUE if you are submitting items that are considered “adult”. These will not be shown on Pinterest. TRUE
FALSE
true optional

Optional custom labels

Custom grouping of products. These can be used for a variety of purposes such as seasonal, promotions, best sellers. We accept up to 5 different custom labels.

You will be able to create product groups in Catalogs using custom labels.

Column name Description Syntax/supported values Example Requirement
custom_label_0 Custom grouping of products. Max 1000 characters

Best sellers

Summer promotion

optional
custom_label_1 Custom grouping of products. Max 1000 characters   optional
custom_label_2 Custom grouping of products. Max 1000 characters   optional
custom_label_3 Custom grouping of products. Max 1000 characters   optional
custom_label_4 Custom grouping of products. Max 1000 characters   optional

Optional shopping ad fields

Column name Description Syntax/supported values Example Requirement
ad_link Allows advertisers to specify a separate URL that can be used to track traffic coming from Pinterest shopping ads. Must send full URL including tracking, do not send tracking parameters only. At this time we do not support impression tracking. Must begin with http:// or https:// string URL https://www.example.com/cat/denim-shirt/item012?utm_source=Pinterest optional
condition The condition of the product. Must be one of the following values: ‘new’, ‘used’, ‘refurbished’. new
used
refurbished
new optional
google_product_category The categorization of the product based on the standardized Google Product Taxonomy. This is a set taxonomy. Both the text values and numeric codes are accepted. Full taxonomy Apparel & Accessories > Clothing > Shirts & Tops
212
optional

 

Pinterest タグを設定する

Pinterest タグとは、コンバージョン情報を収集し、サイト上のユーザー利用動向からターゲットオーディエンスを構築する目的であなたのウェブサイトに設置するシンプルな JavaScript コードです。

Pinterest タグを使用して、ショッピング専用の項目に入力してください。

  • 導入が必要な Pinterest タグは次のコンバージョンタイプです:PageVisitsAddToCartCheckouts 
  • PageVisitAddToCartCheckouts の属性として「product_id」のイベントデータを出力する必要があります。 
    • 該当する行項目の Product_id を出力する必要があります(「コンバージョン」ビューページには表示されません)。
    • Pinterest タグヘルパー Chrome 拡張機能を使用して、商品 ID が商品情報のページで出力されることをご確認ください。
  • タグで出力した product_id のデータはデータソースの「item_group_id」または「id」と一致する必要があります。
  • 過去 7 日間に商品 ID を出力する PageVisit イベントと AddtoCart イベントが合計で 10 万件以上あることを確認してください。
     

次のステップ

データソースの取得ガイドで商品のフィードを Pinterest とリンクする方法を確認してください。

ヘルプが必要ですか?
お問い合わせはこちら