Pinterest 이벤트 전달 확장 기능

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:

작성 대상:

개발자

Pinterest은(는) 레시피, 홈 장식, 스타일 영감 등의 아이디어를 찾는 시각적 검색 엔진입니다. Pinterest에 수십억 개의 고정 항목이 있으며, Pinterest에 다른 사용자와 공유할 수도 있습니다. 사용자 상호 작용 이벤트를 대조하고 Pinterest Analytics을(를) 활용하여 사용자 행동을 이해하고 타깃팅된 광고를 실행할 수 있습니다.

Pinterest 전환 API 이벤트 전달 확장을 사용하면 Adobe Experience Platform Edge Network에서 캡처한 데이터를 활용하여 Pinterest에 보낼 수 있습니다. 이 문서에서는 확장의 사용 사례, 설치 방법 및 해당 기능을 이벤트 전달 규칙에 통합하는 방법에 대해 설명합니다.

전환 액세스 토큰은 Pinterest API와 상호 작용할 때 Pinterest에서 사용하는 인증 방법입니다.

사용 사례

Pinterest에 있는 Edge Network의 데이터를 사용하여 Customer Analytics 기능을 이용하려면 이 확장을 사용해야 합니다.

예를 들어 조직의 마케팅 팀을 생각해 보십시오. 팀은 웹 사이트에서 사용자 인터랙션 이벤트 데이터를 캡처하고 이 이벤트 전달 확장을 사용하여 Pinterest에 로드합니다.

그런 다음 마케팅 및 분석 팀은 Pinterest 분석 기능을 활용하여 주요 사용자 상호 작용 및 동작을 이해함으로써 사용자를 더 잘 이해하고 타깃팅된 광고 캠페인을 타깃팅할 수 있습니다.

Pinterest과(와) 관련된 사용 사례에 대한 자세한 내용은 Pinterest 사용 사례 설명서를 참조하세요.

Pinterest개 필수 구성 요소 prerequisites

이 확장을 사용하려면 올바른 Pinterest 비즈니스 계정이 있어야 합니다. 아직 계정이 없는 경우 Pinterest 등록 페이지(으)로 이동하여 등록하고 계정을 만드십시오.

Pinterest 비즈니스 계정과 연결되어야 하는 Pinterest 개발자 계정도 필요합니다. 개발자 계정을 비즈니스 계정에 연결하려면 Pinterest 개발자 계정을 참조하세요.

필요한 구성 세부 정보 수집 configuration-details

Experience Platform을 Pinterest에 연결하려면 다음 입력이 필요합니다.

자격 증명

설명

예

광고 계정 ID

Pinterest 광고 계정 ID입니다. 자세한 내용은 Pinterest 설명서를 참조하세요.

123456789012

전환 액세스 토큰

Pinterest 전환 액세스 토큰입니다. 지침은 Pinterest 전환 API 문서를 참조하십시오.
토큰이 만료되지 않으므로 한 번만 수행하면 됩니다.

Pinterest 확장 설치 및 구성 install

확장을 설치하려면 이벤트 전달 속성을 만들거나 대신 편집할 기존 속성을 선택하십시오.

왼쪽 탐색에서 확장 을 선택합니다. 카탈로그 탭의 Pinterest 확장 카드에서 설치 를 선택합니다.

Install이 강조 표시된 Pinterest 확장을 표시하는 카탈로그.

Pinterest 확장 구성

IMPORTANT

구현 요구 사항에 따라 확장을 구성하기 전에 스키마, 데이터 요소 및 데이터 세트를 만들어야 할 수 있습니다. 사용 사례에 대해 설정해야 하는 엔터티를 결정하려면 시작하기 전에 모든 구성 단계를 검토하십시오.

왼쪽 탐색에서 확장 을 선택합니다. 설치됨 탭의 Pinterest 확장 카드에서 구성 **을 선택합니다.

구성이 강조 표시된 설치 탭에 표시되는 Pinterest 확장.

다음 화면에서는 구성 세부 정보 섹션에서 이전에 수집한 광고 계정 ID 및 전환 액세스 토큰을(를) 입력합니다. 완료되면 저장 을 선택합니다.

광고 계정 ID 및 전환 액세스 토큰 입력 필드를 강조 표시하는 Pinterest 구성 화면입니다.

이벤트 전달 규칙 구성 config-rule

모든 데이터 요소가 설정되면 이벤트가 Pinterest에 전송되는 시기와 방법을 결정하는 이벤트 전달 규칙을 만들 수 있습니다.

이벤트 전달 속성에 새 규칙을(를) 만듭니다. 작업 에서 새 작업을 추가하고 확장을 Pinterest(으)로 설정합니다. Edge Network 이벤트를 Pinterest에 보내려면 작업 유형 을(를) 이벤트 보내기.(으)로 설정하십시오.

Pinterest 이벤트 보내기 규칙 만들기

선택 후 이벤트를 추가로 구성하는 추가 컨트롤이 나타납니다. Pinterest 이벤트 속성을 이전에 만든 데이터 요소에 매핑해야 합니다.

이벤트 데이터

새 규칙을 만들려면 다음 이벤트 데이터가 필요합니다.

필드 이름

설명

예

이벤트 이름

사용자 이벤트의 유형입니다. 모든 이벤트 유형일 수 있지만 Pinterest Analytics을(를) 활용하려면 Pinterest 이벤트 코드를 사용하는 것이 좋습니다.

* 체크아웃
* add_to_cart
* page_visit
* 등록
* [사용자 정의 이벤트]

작업 Source

전환 이벤트가 발생한 위치를 나타내는 소스.

* app_android
* app_ios
* 웹
* 오프라인

이벤트 시간

이벤트 시간을 나타냅니다. 사용되는 기본 시간 형식은 UNIX이며 로컬 시간대에 따라 <seconds>.<miliseconds> 형식입니다. 자세한 내용은 Pinterest API를 참조하세요.

1433188255.500은 epoch 후 또는 2015년 6월 1일 월요일 오후 7:50:55분 GMT에서 1433188255초 및 500밀리초를 나타냅니다.

이벤트 ID

이 이벤트를 식별하고 전환 API 및 Pinterest 추적을 통해 수집된 이벤트 간에 중복 제거하는 데 사용할 수 있는 고유한 ID 문자열입니다. 이 기능이 없으면 이벤트 데이터가 두 번 계산되고 지표 인플레이션을 보고할 가능성이 높습니다.

ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad

이벤트 속성

이벤트의 사용자 지정 속성이 포함된 JSON 개체입니다. 원시 JSON을 제공하거나 간소화된 키-값 입력 세트를 사용하여 선택하십시오.

{ "event_source_url": "http://site.com" }

규칙 작업에 강조 표시된 Pinterest 이벤트 데이터입니다.

다음 이벤트 속성을 구성할 수 있습니다.

필드 이름

설명

이벤트 Source URL

웹 전환 이벤트의 URL.

애플리케이션 저장소 ID

앱스토어 앱 ID입니다.

애플리케이션 이름

애플리케이션 이름.

Application Version

애플리케이션의 버전입니다.

장치 브랜드

사용자가 사용 중인 장치의 브랜드입니다.

장치 캐리어

해당 디바이스에 대한 사용자의 이동통신사입니다.

장치 모델

사용자 디바이스의 모델입니다.

장치 유형

사용자가 사용 중인 장치의 유형입니다.

OS 버전

장치의 운영 체제 버전입니다.

사용자 언어

사용자의 언어를 나타내는 두 문자 ISO-639-1 언어 코드.

사용자 데이터

에서 입력할 수 있는 다음 사용자 데이터는 필수 필드가 아닙니다.

필드 이름

설명

예

이메일

사용자 이메일 주소 또는 사용자 주소 이메일의 SHA256 해시입니다.

ebd543592…f2b7e1

모바일 광고 ID

사용자의 "Google Advertising ID"(GAID) 또는 "Apple의 광고주용 식별자"(IDFA)의 Sha256 해시

ebd543592…f2b7e1

클라이언트 IP 주소

IPv4 또는 IPv6 형식일 수 있는 사용자의 IP 주소입니다. 일치에 사용됩니다.

192.168.0.1

클라이언트 사용자 에이전트

사용자 웹 브라우저의 사용자 에이전트 문자열입니다.

Mozilla/5.0 (platform; rv:geckoversion) Gecko/geckotrail Firefox/firefoxversion

고객 정보 데이터

다른 고객 정보가 포함된 JSON 개체입니다. 원시 JSON을 제공하거나 간소화된 키-값 입력 세트를 사용하여 선택하십시오.

{ "ph": "122333445" }

규칙 작업에 강조 표시된 Pinterest 사용자 데이터입니다.

구성할 수 있는 고객 정보 속성은 다음과 같습니다.

필드 이름

설명

휴대폰

사용자 연락처 번호. 숫자만 허용되며 국가 코드, 지역 코드 및 번호로 입력해야 합니다.

성별

성별은 여성의 경우 "f", 남성의 경우 "m" 또는 이진이 아닌 경우 "n"으로 입력할 수 있습니다.

생일

연도, 월, 일로 입력된 생년월일.

성

사용자의 성.

이름

사용자의 이름.

구/군/시

사용자의 상주 도시입니다. 이는 주로 청구 목적으로 사용됩니다.

주/도

소문자로 된 두 자리 코드로 제공되는 사용자 상태.

우편번호

주로 청구 용도로 사용되는 사용자의 우편 번호입니다.

국가

사용자의 국가를 나타내는 두 문자 ISO-3166 국가 코드.

외부 ID

스페이스에서 사용자를 식별하는 광고주의 고유 ID. 예: 사용자 ID, 충성도 ID 등.

클릭 ID

도메인의 _epik 쿠키 또는 URL의 &epik= 쿼리 매개 변수에 저장된 고유 식별자입니다.

IMPORTANT

데이터를 Pinterest API 끝점으로 보내기 전에 확장에서 해시하고 전자 메일, 전화 번호, 이름, 성, 성별, 생년월일, 도시, 주, 우편 번호, 국가 및 외부 ID 필드의 값을 정규화합니다. SHA256 문자열이 이미 있는 경우 확장 프로그램은 이러한 필드의 값을 해시하지 않습니다.