설명서Experience Platform소스 커넥터 안내서

[Beta]{class="badge informative"}

Pinterest Ads

마지막 업데이트: 2026년 10월 2일

작성 대상:

  • 개발자
NOTE
Pinterest Ads 원본이 Beta 버전입니다. 사용 약관은 소스 개요를 참조하세요.
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일 동안의 메타데이터 및 지표를 검색합니다.
일일 수집
는 데이터 흐름이 생성된 다음 날부터 매일 한 번 실행되며, 이전 날의 메타데이터 및 지표를 검색합니다.
Restatement
각 일일 수집 실행에 대해 해당 실행 후 1일, 2일 및 3일 동안 세 번 실행됩니다.

Restatement는 이전에 보고된 지표에 대한 변경 사항을 설명하기 위해 업데이트된 내역 데이터를 검색합니다. 채우기, 일일 수집 또는 재작성 일정을 직접 구성하지 않습니다.

계정 사전 요구 사항 prerequisites

계정을 연결하기 전에 다음을 확인하십시오.

  • 기존 Pinterest 광고 계정입니다.
  • 캠페인 및 광고가 해당 광고 계정에 이미 설정되어 있습니다.
  • Pinterest에 로그인하고 Experience Platform에게 선택한 광고 계정에 액세스하도록 승인할 수 있는 액세스 권한을 부여합니다.

자동 데이터 세트 설정 schema-and-dataset-provisioning

커넥터가 데이터 세트, 스키마 및 필드 매핑을 자동으로 할당합니다. 대상 스키마를 만들거나, 대상 데이터 세트를 선택하거나, 데이터 흐름을 만드는 동안 필드를 매핑하지 않습니다.

매핑된 엔티티 유형은 계정, 캠페인, 광고 그룹, 광고, 자산, 경험 및 요약 지표입니다. Assets은 Pinterest핀을 나타냅니다. 경험 레코드는 별도의 경험 API가 아닌 핀과 광고의 정보를 결합합니다.

XDM 필드 매핑 pinterest-fields

다음 표를 사용하여 XDM(Experience 데이터 모델) 스키마에 매핑된 핵심 필드를 이해할 수 있습니다. 커넥터가 paidMedia.adNetwork을(를) pinterest에 매핑합니다.

계정 필드 account-fields

계정 스키마는 광고 계정 ID 및 계정 세부 사항을 저장합니다.

Pinterest 필드
XDM 필드
설명
id
paidMedia.accountID
광고 계정 식별자.
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
캠페인 식별자.
ad_account_id
paidMedia.accountID
상위 광고 계정 식별자.
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
광고 그룹 식별자.
ad_account_id
paidMedia.accountID
상위 광고 계정 식별자.
campaign_id
paidMedia.campaignID
상위 캠페인 식별자.
name
paidMedia.metadata.name
광고 그룹 이름입니다.
status
paidMedia.metadata.status
표준화된 광고 그룹 상태.
summary_status
paidMedia.metadata.servingStatus
표준화된 게재 상태.

광고 필드 ad-fields

광고 스키마는 광고 ID, 검토 상태 및 다른 유료 미디어 엔티티와의 관계를 저장합니다.

Pinterest 필드
XDM 필드
설명
id
paidMedia.adID
광고 식별자.
ad_group_id
paidMedia.adGroupID
상위 광고 그룹 식별자.
campaign_id
paidMedia.campaignID
상위 캠페인 식별자.
ad_account_id
paidMedia.accountID
상위 광고 계정 식별자.
pin_id
paidMedia.assetID
관련 핀 식별자.
name
paidMedia.metadata.name
광고 이름.
status
paidMedia.metadata.status
표준화된 광고 상태.
review_status
adDetails.reviewStatus
pending, rejected, approved 또는 not_reviewed과(와) 같은 검토 상태입니다.

Creative 제목 및 설명은 광고 개체가 아닌 관련 Pin에서 가져옵니다.

에셋 필드 asset-fields

에셋 스키마는 Pin 콘텐츠 및 미디어 속성을 저장합니다. 다음 매핑에서는 단일 이미지 또는 비디오가 있는 핀을 설명합니다.

Pinterest 필드
XDM 필드
설명
id
paidMedia.assetID
Pin 식별자.
title
assetDetails.title
핀 제목.
description
assetDetails.description
Pin 설명.
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 크리에이티브 유형
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

여러 미디어 항목이 있는 Pin의 경우 커넥터가 항목당 하나의 항목으로 experienceDetails.carouselProperties.cards[]을(를) 채웁니다. 각 카드는 생성된 에셋 식별자를 참조합니다.

요약 지표 필드 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 광고 UI 자습서를 따르십시오.

기본 광고 API에 대한 자세한 내용은 Pinterest API 설명서를 사용하십시오.

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