ドキュメントExperience Platformソースコネクタガイド

[ベータ版]{class="badge informative"}

Pinterest Ads

最終更新日： 2026年10月2日

作成対象：

  • 開発者
NOTE
Pinterest Ads ソースはベータ版です。 利用条件については、​ ソースの概要をお読みください。
IMPORTANT
Pinterest Ads ソースは、Customer Journey Analytics SKUの一部として利用できます。

Pinterest Ads ソースを使用して広告アカウントを接続し、有料メディアのメタデータとパフォーマンス指標を取り込みます。 Adobe Experience Platformは、このデータを有料メディアデータセットに公開します。 Adobe Customer Journey Analyticsでこれらのデータセットを使用して、マーケティングキャンペーンを分析します。

アカウントを接続するには、Pinterestにログインし、Experience Platformに広告データへのアクセスを許可してください。 API資格情報を手動で生成したり入力したりする必要はありません。

取り込みの仕組み how-it-works

データフローを作成して広告アカウントを選択すると、Experience Platformはデータセットとスケジュールの取り込みを自動的にプロビジョニングします。

プロセス
動作
データセットのプロビジョニング
組織内の既存の有料メディアデータセットを再利用し、存在しない場合は作成します。
初期バックフィル
データフローの作成から30分後に実行され、過去30日間のメタデータと指標を取得します。
日別取り込み
データフロー作成の翌日から1日1回実行し、前日のメタデータと指標を取得します。
再表示
1日の取り込み実行ごとに3回実行します。その実行の1日後、2日後、3日後です。

Restatementは、以前に報告された指標の変更を考慮して、更新された履歴データを取得します。 バックフィル、毎日の取り込み、または再表示スケジュールは、自分で設定しないでください。

アカウントの前提条件 prerequisites

アカウントを接続する前に、次の項目を確認してください。

  • 既存のPinterest広告アカウント。
  • 広告アカウントでキャンペーンや広告がすでに設定されています。
  • Pinterestにログインし、Experience Platformが選択した広告アカウントにアクセスすることを許可するためのアクセス権。

データセットの自動設定 schema-and-dataset-provisioning

コネクタは、データセット、スキーマ、フィールドマッピングを自動的に割り当てます。 データフローの作成時に、ターゲットスキーマを作成したり、ターゲットデータセットを選択したり、フィールドをマッピングしたりすることはありません。

マッピングされるエンティティのタイプは、アカウント、キャンペーン、広告グループ、広告、アセット、エクスペリエンス、概要の指標です。 AssetsはPinterest ピンを表します。 エクスペリエンスレコードは、個別のエクスペリエンス APIではなく、ピンと広告からの情報を組み合わせます。

XDM フィールドマッピング pinterest-fields

次の表を使用して、Experience Data Model （XDM）スキーマにマッピングされたコアフィールドを理解します。 コネクタはpaidMedia.adNetworkをpinterestにマッピングします。

アカウントフィールド account-fields

アカウントスキーマには、広告アカウント IDとアカウントの詳細が保存されます。

Pinterestフィールド
XDM フィールド
説明
id
paidMedia.accountID
広告アカウントのID。
name
paidMedia.accountDetails.accountName
広告アカウント名。
country
paidMedia.accountDetails.country
国コード。
currency
paidMedia.accountDetails.currency
通貨コード。
permissions
paidMedia.accountDetails.permissions
アカウント権限の配列。
time_zone
paidMedia.accountDetails.timezone
広告アカウントのタイムゾーン。
created_time
paidMedia.metadata.createdTime
作成タイムスタンプ。ISO 8601に変換されます。
updated_time
paidMedia.metadata.updatedTime
ISO 8601に変換された変更タイムスタンプ。

キャンペーンフィールド campaign-fields

キャンペーンスキーマは、広告アカウントに対するキャンペーン ID、ステータス、関係を保存します。

Pinterestフィールド
XDM フィールド
説明
id
paidMedia.campaignID
キャンペーンのID。
ad_account_id
paidMedia.accountID
親広告アカウントのID。
name
paidMedia.metadata.name
キャンペーン名。
status
paidMedia.metadata.status
正規化されたキャンペーンステータス。
summary_status
paidMedia.metadata.servingStatus
正規化された配信ステータス。
created_time
paidMedia.metadata.createdTime
作成タイムスタンプ。ISO 8601に変換されます。
updated_time
paidMedia.metadata.updatedTime
ISO 8601に変換された変更タイムスタンプ。

キャンペーン、広告グループ、広告の場合、コネクタはACTIVE、PAUSED、ARCHIVED、DRAFTを小文字のステータス値に正規化します。 DELETED_DRAFTをdeletedにマッピングします。

広告グループフィールド ad-group-fields

広告グループスキーマは、広告グループ IDおよびキャンペーンやアカウントとの関係を保存します。

Pinterestフィールド
XDM フィールド
説明
id
paidMedia.adGroupID
広告グループのID。
ad_account_id
paidMedia.accountID
親広告アカウントのID。
campaign_id
paidMedia.campaignID
親キャンペーンのID。
name
paidMedia.metadata.name
広告グループ名。
status
paidMedia.metadata.status
正規化された広告グループのステータス。
summary_status
paidMedia.metadata.servingStatus
正規化された配信ステータス。

広告フィールド ad-fields

広告スキーマは、広告ID、レビューステータス、他の有料メディアエンティティとの関係を保存します。

Pinterestフィールド
XDM フィールド
説明
id
paidMedia.adID
広告ID。
ad_group_id
paidMedia.adGroupID
親広告グループの識別子。
campaign_id
paidMedia.campaignID
親キャンペーンのID。
ad_account_id
paidMedia.accountID
親広告アカウントのID。
pin_id
paidMedia.assetID
関連するPin ID。
name
paidMedia.metadata.name
広告名です。
status
paidMedia.metadata.status
正規化された広告ステータス：
review_status
adDetails.reviewStatus
レビューステータス（pending、rejected、approved、not_reviewedなど）。

Creativeのタイトルと説明は、広告オブジェクトではなく、関連するピンから取得されます。

アセットフィールド asset-fields

アセットスキーマには、Pin コンテンツとメディアプロパティが保存されます。 次のマッピングでは、単一の画像またはビデオを持つピンについて説明します。

Pinterestフィールド
XDM フィールド
説明
id
paidMedia.assetID
Pin識別子。
title
assetDetails.title
ピンのタイトル。
description
assetDetails.description
ピンの説明。
media.media_type
assetDetails.assetType
アセットタイプ（imageやvideoなど）。
media.images["1200x"].url
assetDetails.mediaProperties.url
使用可能な最大の画像URL。
media.images["150x150"].url
assetDetails.mediaProperties.thumbnailURL
画像サムネール URL。
media.video_url
assetDetails.mediaProperties.url
ビデオピンのビデオ URL。
media.cover_image_url
assetDetails.mediaProperties.thumbnailURL
ビデオピンのカバー画像URL。
media.duration
assetDetails.videoProperties.duration
Pinterestがミリ秒単位で提供するビデオのデュレーション。

複数の画像、ビデオ、または混在メディアを持つピンの場合、各項目は個別のアセットレコードになります。 コネクタは、{pin_id}_{index}を使用してアセット識別子を生成します。ここで、indexは項目の位置を0から始めます。 これらのアセットはcarousel_card アセットタイプを使用します。

エクスペリエンスフィールド experience-fields

エクスペリエンスレコードとは、ピンと広告から導き出されたクリエイティブエクスペリエンスを表します。 エクスペリエンス識別子はピン識別子を使用します。

Pinterest creative type
XDM エクスペリエンスタイプ
REGULAR
single_image
VIDEO, MAX_VIDEO, CTV_VIDEO
single_video
CAROUSEL
carousel
COLLECTION, MAX_WIDTH_REGULAR_COLLECTION, MAX_WIDTH_VIDEO_COLLECTION
collection
IDEA, SHOWCASE
instant_experience
QUIZ, SHOPPING, COLLAGE, APP
other

複数のメディア項目を持つピンの場合、コネクタは項目ごとに1つのエントリを持つexperienceDetails.carouselProperties.cards[]に入力します。 各カードは、生成されたアセット IDを参照します。

概要指標フィールド summary-metrics-fields

概要指標には、広告のパフォーマンスデータが保存されます。 コネクターは、アセットのグループ化キーとしてPIN_IDを使用して、広告分析から広告指標とアセット指標をマッピングします。

Pinterestフィールド
XDM フィールド
説明
SPEND_IN_MICRO_DOLLAR, SPEND_IN_DOLLAR
metrics.spend
Advertisingの予算。
PAID_IMPRESSION, TOTAL_IMPRESSION
metrics.impressions
インプレッション数：
TOTAL_CLICKTHROUGH, CLICKTHROUGH_1, CLICKTHROUGH_2
metrics.clicks
「カウント」をクリック。
CTR, ECTR, CTR_2
metrics.ctr
クリック率：
TOTAL_ENGAGEMENT, ENGAGEMENT_1, ENGAGEMENT_2
metrics.engagements
エンゲージメント数：
TOTAL_CONVERSIONS
metrics.conversions
コンバージョン数：
CHECKOUT_ROAS
metrics.roas
チェックアウトコンバージョンの広告費用対効果。
TOTAL_VIDEO_MRC_VIEWS, VIDEO_MRC_VIEWS_1, VIDEO_MRC_VIEWS_2
metrics.videoViews
ビデオの表示回数：
TOTAL_VIDEO_P100_COMPLETE, VIDEO_P100_COMPLETE_2
metrics.videoCompletions
完了したビデオの表示回数。

さらに、コストやコンバージョン、動画、アトリビューション、エンゲージメント指標などのマッピングも可能です。

エクスペリエンスの概要の指標には、広告ターゲティング分析からのデバイスとプレースメントの内訳が含まれます。 コネクタは、デバイスの内訳にAPPTYPEを要求し、プレースメントの内訳にPLACEMENTを要求します。 その他のターゲティングの内訳は要求されません。

アカウントを接続 connect-to-platform

データフローを作成するには、Pinterest Ads UI チュートリアル ​に従います。

基礎となる広告APIについて詳しくは、Pinterest API ドキュメント ​を使用してください。

recommendation-more-help
experience-platform-help-sources