REST Resource: customers.adsDataLinks

• 리소스: AdsDataLink
  • JSON 표현
• 항목
  • JSON 표현
• EntityType
• 플랫폼
• 측정항목
• GmpExportScope
• 메서드

리소스: AdsDataLink

광고 데이터 링크를 나타냅니다.

JSON 표현
{ "name": string, "linkedEntity": { object (Entity) }, "parentEntity": { object (Entity) }, "childEntities": [ { object (Entity) } ], "platform": enum (Platform), "customerLink": { object (CustomerLink) }, "status": enum (LinkStatus), "createTime": string, "updateTime": string, "vendorClientId": string, "metrics": [ enum (Metric) ], "gmpExportScopes": [ enum (GmpExportScope) ] }

필드
name	string AdsDataLink 리소스를 고유하게 식별하는 이름입니다. customer/[customerId]/adsDataLinks/[resource_id] 형식을 사용합니다. 리소스 ID는 서버에서 생성됩니다.
linkedEntity	object (Entity) 이 AdsDataLink를 통해 연결된 항목입니다.
parentEntity	object (Entity) 관련 상위 항목(있는 경우) 연결된 항목이 Google Ads 캠페인인 경우 이 필드에는 캠페인이 속한 Google Ads 고객이 포함됩니다.
childEntities[]	object (Entity) 관련 하위 항목(있는 경우) 연결된 항목이 고객-관리자 링크에 해당하는 Google Ads 고객인 경우 하위 항목은 이 링크를 통해 Ads Data Hub로 가져온 데이터를 포함하여 완전히 확장된 Google Ads 고객 집합을 포함합니다.
platform	enum (Platform) 연결된 항목과 연결된 광고 플랫폼입니다.
customerLink	object (CustomerLink) 연결된 데이터에 액세스할 수 있는 고객 링크입니다. 이름, 고객 ID, displayName만 채워집니다.
status	enum (LinkStatus) 데이터 링크의 상태입니다.
createTime	string (Timestamp format) 연결이 생성된 시간입니다. RFC3339 UTC "Zulu' 형식의 타임스탬프로, 나노초 해상도와 최대 9자리 소수를 나타냅니다. 예: "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z".
updateTime	string (Timestamp format) 연결 상태가 마지막으로 업데이트된 시간입니다. RFC3339 UTC "Zulu' 형식의 타임스탬프로, 나노초 해상도와 최대 9자리 소수를 나타냅니다. 예: "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z".
vendorClientId	string 공급업체 클라이언트 ID(있는 경우)
metrics[]	enum (Metric) 이 데이터 링크를 통해 액세스할 수 있는 측정항목입니다. 비어 있으면 측정항목 제한이 적용되지 않습니다. 이 필드는 현재 한 가지이며 링크 항목 유형이 GOOGLE_ADS_CAMPAIGN 또는 YT_RESERVE_LINE_ITEM인 경우에만 지원됩니다.
gmpExportScopes[]	enum (GmpExportScope) Display &Video 360 연결을 위해 내보낼 데이터 유형입니다. 플랫폼이 GOOGLE_MARKETING_PLATFORM인 경우에만 채워집니다. 비어 있으면 지정되지 않으며 이 둘의 조합을 사용할 수 있습니다.

항목

Ads Data Hub 고객과 연결할 수 있는 광고 항목을 나타냅니다.

JSON 표현
{ "entityId": string, "displayName": string, "type": enum (EntityType) }

필드
entityId	string (int64 format) 엔티티 ID 여기에 나열된 값은 항목 유형에 따라 다릅니다.
displayName	string 항목 표시 이름입니다.
type	enum (EntityType) 연결된 항목의 유형입니다.

EntityType

지원되는 광고 항목

열거형
ENTITY_TYPE_UNSPECIFIED	지정되지 않은 항목 유형입니다.
GOOGLE_ADS_CUSTOMER	Google Ads 고객 entityId는 Google Ads API의 Customer.id에 해당합니다.
GOOGLE_ADS_CAMPAIGN	Google Ads 캠페인 entityId는 Google Ads API의 Campaign.id에 해당합니다.
GMP_CM_ACCOUNT	Campaign Manager 360 계정 entityId는 Campaign Manager 360 API의 Accounts.id에 해당합니다.
GMP_CM_FLOODLIGHT	Campaign Manager 360 플러드라이트 계정 entityId는 Campaign Manager 360 API의 FloodlightConfigurations.accountId에 해당합니다.
GMP_DV360_PARTNER	Display &Video 360 파트너 ID입니다. entityId는 Display &Video 360 파트너 ID입니다.
GMP_DV360_ADVERTISER	Display &Video 360 광고주 ID입니다. entityId는 Display &Video 360 광고주 ID입니다.
GMP_DV360_ORDER	Display &Video 360 주문 ID entityId는 Display &Video 360 주문 ID입니다.
GMP_DV360_LINE_ITEM	Display &Video 360 광고 항목 ID입니다. entityId는 Display &Video 360 광고 항목 ID입니다.
YT_RESERVE_ORDER	YouTube Reserve 주문 ID입니다. entityId는 Google Ad Manager API의 Order.id에 해당합니다.
YT_RESERVE_LINE_ITEM	YouTube Reserve 광고 항목입니다. entityId는 Google Ad Manager API의 LineItem.id에 해당합니다.
VENDOR_CLIENT_ID_REGISTRATION	서드 파티 측정 기능을 제공하기 위해 서드 파티 광고 기술 공급업체에서 직접 등록한 공급업체 클라이언트 ID입니다.
GOOGLE_AD_MANAGER_ORDER	Google Ad Manager 주문 ID입니다. entityId는 Google Ad Manager API의 Order.id에 해당합니다.
GOOGLE_AD_MANAGER_LINE_ITEM	Google Ad Manager 광고 항목입니다. entityId는 Google Ad Manager API의 LineItem.id에 해당합니다.

플랫폼

지원되는 광고 플랫폼

열거형
PLATFORM_UNSPECIFIED	지정되지 않은 플랫폼
GOOGLE_ADS	항목이 Google Ads와 연결되어 있습니다.
GOOGLE_MARKETING_PLATFORM	항목이 Google Marketing Platform과 연결되어 있습니다.
YOUTUBE_RESERVE	항목이 YouTube Reserve와 연결되어 있습니다.
GOOGLE_AD_MANAGER	항목이 Google Ad Manager와 연결되어 있습니다.
FREEWHEEL	항목이 FreeWheel과 연결되어 있습니다.

측정항목

광고 데이터 링크를 통해 노출될 수 있는 측정항목입니다.

열거형
METRIC_UNSPECIFIED	지정되지 않은 측정항목입니다.
BRAND_LIFT	브랜드 광고효과에 해당하는 측정항목입니다.
BRAND_SAFETY	브랜드 안전성에 해당하는 측정항목입니다.
REACH	고객이 광고주인 도달범위에 해당하는 측정항목입니다.
VIEWABILITY	고객이 광고주인 조회가능성에 해당하는 측정항목입니다.
PUBLISHER_REACH	도달범위에 해당하는 측정항목으로, 고객이 게시자/콘텐츠 제공업체입니다.
PUBLISHER_VIEWABILITY	고객이 게시자/콘텐츠 제공업체인 조회가능성에 해당하는 측정항목입니다.

GMPExportScope

GMP 링크에 내보낼 수 있는 다양한 유형의 데이터

열거형
GMP_EXPORT_SCOPE_UNSPECIFIED	범위가 지정되지 않았습니다.
GMP_EXPORT_SCOPE_YT_TRUEVIEW	Display &Video 360 YouTube TrueView 데이터를 내보내야 합니다.
GMP_EXPORT_SCOPE_DT	데이터 전송 데이터를 내보내야 합니다.

메서드
batchApprove	대기 중인 광고 데이터 링크 목록을 승인합니다.
batchReject	대기중인 광고 데이터 링크 목록을 거부합니다.
list	지정된 고객과 다른 Google 광고 항목 간의 연결이 표시됩니다.