이 페이지는 Cloud Translation API를 통해 번역되었습니다.

대상 구성

IngestAudienceMembersRequest 또는 IngestEventsRequest의 각 Destination은 다음을 정의합니다.

데이터를 수신하는 계정입니다. 예를 들어 Google Ads 계정 또는 Google 애널리틱스 속성입니다.
계정 내 데이터의 대상 항목입니다(예: Google Ads 전환 액션 또는 Google 애널리틱스 스트림).
데이터를 수신하는 계정에 대한 요청의 사용자 인증 정보의 액세스 경로입니다.

광고주 또는 대행사인 경우 Destination를 구성하는 방법의 예를 보려면 광고주 시나리오로 이동하세요.

Google Ads
Display & Video 360
Google 애널리틱스

데이터 파트너인 경우 Destination를 구성하여 데이터 파트너 계정에 대한 제품 링크가 있는 계정에 데이터를 전송하는 방법의 예를 보려면 데이터 파트너 시나리오로 이동하세요.

Google Ads
Display & Video 360
Google 애널리틱스

세부 요구사항 섹션에서는 요구사항과 유효성 검사 규칙을 자세히 다룹니다.

광고주 시나리오

광고주와 대행사의 일반적인 시나리오에 맞게 Destination를 구성하는 방법은 다음과 같습니다. 이 다이어그램은 데이터 관리 도구 API가 사용자 인증 정보와 Destination 필드를 사용하여 광고주 계정에 액세스하는 방법을 보여줍니다.

광고주 액세스 경로

Google Ads

다음은 Google Ads 계정 및 사용자의 집합을 보여주는 다이어그램입니다.

Google Ads 계정 및 사용자

관리자 계정 M1

M1에는 다음과 같은 두 개의 직접 하위 계정이 있습니다.

관리자 계정 M2
고객 계정 C1

Google 계정 cloudysanfrancisco@gmail.com이 M1의 사용자입니다.

관리자 계정 M2

M2에는 다음과 같은 두 개의 직접 하위 계정이 있습니다.

고객 계정 C1
고객 계정 C2

Google 계정 baklavainthebalkans@gmail.com은 M2의 사용자입니다.

고객 계정 C1

C1에는 다음과 같은 두 개의 직속 상위 관리자 계정이 있습니다.

관리자 계정 M1
관리자 계정 M2

Google 계정 jeffersonloveshiking@gmail.com은 C1의 사용자입니다.

고객 계정 C2

관리자 계정 M2는 C2의 유일한 직접 상위 계정입니다.

나열된 Google 계정 중 C2의 사용자는 없습니다.

직접 액세스 시나리오와 관리자 액세스 시나리오에서는 이러한 계정으로 데이터를 전송하도록 대상을 구성하는 방법을 보여줍니다.

직접 액세스 시나리오

Google Ads 계정으로 데이터를 전송하고 싶고 사용자 인증 정보가 Google Ads 계정의 사용자 계정인 Google 계정인 경우:

대상

operating_account

`account_id`	Google Ads 계정의 고객 ID
`account_type`	`GOOGLE_ADS`

login_account login_account를 설정하지 않거나 operating_account과 동일한 값으로 설정합니다.

linked_account linked_account 필드를 설정하지 마세요.

product_destination_id 잠재고객 또는 전환 액션의 ID입니다.

다음은 다이어그램의 계정과 Google 계정 jeffersonloveshiking@gmail.com의 사용자 인증 정보를 사용하는 직접 액세스 시나리오의 예입니다.

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"

      },
      "loginAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"

      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

관리자 액세스 시나리오

Google Ads 계정으로 데이터를 전송하려고 하는데 사용자 인증 정보가 광고주 계정이 하위 계정인 Google Ads 관리자 계정의 Google 계정에 해당하는 경우 다음 단계를 따르세요.

대상

operating_account

`account_id`	Google Ads 고객 계정의 고객 ID
`account_type`	`GOOGLE_ADS`

login_account

`account_id`	Google Ads 관리자 계정의 고객 ID
`account_type`	`GOOGLE_ADS`

linked_account linked_account 필드를 설정하지 마세요.

product_destination_id 잠재고객 또는 전환 액션의 ID입니다.

다음은 다이어그램의 Google Ads 고객 계정 C2에 대한 관리자 액세스 시나리오와 Google 계정 baklavainthebalkans@gmail.com의 사용자 인증 정보의 예입니다.

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

다음은 Google Ads 고객 계정 C2의 관리자 액세스 시나리오와 Google 계정 cloudysanfrancisco@gmail.com의 사용자 인증 정보의 또 다른 예입니다. Google 계정 cloudysanfrancisco@gmail.com는 Google Ads 관리자 계정 M1의 사용자입니다.

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

Display & Video 360

다음 두 가지 방법을 사용하여 Display & Video 360에 데이터를 전송할 수 있습니다.

직접 액세스: Display & Video 360 광고주 또는 파트너 계정의 사용자에게 부여된 Google 계정의 사용자 인증 정보입니다.
Display & Video 360 파트너 액세스: 사용자 인증 정보가 Display & Video 360 파트너 계정의 사용자이고 운영 계정이 파트너 계정의 Display & Video 360 광고주 계정인 Google 계정용입니다.

직접 액세스 시나리오

Display & Video 360 광고주 계정에 데이터를 전송하고 사용자 인증 정보가 광고주 계정의 사용자 Google 계정에 해당하는 경우 다음 단계를 따르세요.

대상

operating_account

`account_id`	Display & Video 360 광고주 계정의 ID
`account_type`	`DISPLAY_VIDEO_ADVERTISER`

login_account login_account를 설정하지 않거나 operating_account과 동일한 값으로 설정합니다.

linked_account linked_account 필드를 설정하지 마세요.

product_destination_id 잠재고객의 ID입니다.

Display & Video 360 광고주에게 데이터를 전송하는 직접 액세스 시나리오의 Destination 예는 다음과 같습니다.

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

마찬가지로 Display & Video 360 파트너 계정으로 데이터를 전송하고 사용자 인증 정보가 파트너 계정의 사용자 계정인 Google 계정의 경우 다음을 수행합니다.

대상

operating_account

`account_id`	Display & Video 360 파트너 계정의 ID
`account_type`	`DISPLAY_VIDEO_PARTNER`

login_account login_account를 설정하지 않거나 operating_account과 동일한 값으로 설정합니다.

linked_account linked_account 필드를 설정하지 마세요.

product_destination_id 잠재고객의 ID입니다.

Display & Video 360 파트너에게 데이터를 전송하는 직접 액세스 시나리오의 Destination 예는 다음과 같습니다.

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Display & Video 360 파트너 액세스 시나리오

Display & Video 360 광고주에게 데이터를 전송하려고 하는데 사용자 인증 정보가 광고주의 상위 Display & Video 360 파트너 계정의 사용자 Google 계정인 경우 다음 단계를 따르세요.

대상

operating_account

`account_id`	Display & Video 360 광고주 계정의 ID
`account_type`	`DISPLAY_VIDEO_ADVERTISER`

login_account

`account_id`	Display & Video 360 파트너 계정의 ID
`account_type`	`DISPLAY_VIDEO_PARTNER`

linked_account linked_account 필드를 설정하지 마세요.

product_destination_id 잠재고객의 ID입니다.

Display & Video 360 광고주에게 데이터를 전송하는 파트너 액세스 시나리오의 Destination 예는 다음과 같습니다. 이 시나리오에서 사용자 인증 정보는 Display & Video 360 파트너 계정 PARTNER_ID의 사용자이고 Display & Video 360 광고주 계정 ADVERTISER_ID이 파트너 계정 PARTNER_ID의 하위 계정인 Google 계정의 사용자 인증 정보여야 합니다.

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Google 애널리틱스

참고: 대상이 Google 애널리틱스 계정인 경우 operating_account와 login_account가 동일해야 합니다. 그렇지 않으면 OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH 오류와 함께 요청이 실패합니다.

대상

operating_account

`account_id`	Google 애널리틱스 속성의 ID
`account_type`	`GOOGLE_ANALYTICS_PROPERTY`

login_account login_account를 설정하지 않거나 operating_account과 동일한 값으로 설정합니다.

linked_account linked_account 필드를 설정하지 마세요.

product_destination_id 데이터 스트림의 측정 ID입니다.

Google 애널리틱스로 이벤트를 전송하는 Destination의 예는 다음과 같습니다.

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "loginAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ]
}

데이터 파트너 시나리오

다음은 데이터 파트너 계정에 대한 제품 링크가 설정된 광고주 계정에 데이터를 전송하는 데이터 파트너의 일반적인 시나리오에 맞게 Destination를 구성하는 방법입니다.

이 다이어그램은 데이터 관리 도구 API가 제품 링크를 통해 광고주 계정에 액세스하기 위해 사용자 인증 정보와 Destination 필드를 사용하는 방법을 보여줍니다.

데이터 파트너 액세스 경로

Google Ads

다음은 Google Ads 및 데이터 파트너 계정 집합의 예를 보여주는 다이어그램입니다. 또한 이 다이어그램에는 각 Google Ads 또는 데이터 파트너 계정의 사용자인 Google 계정과 계정 간 제품 링크도 표시됩니다.

데이터 파트너, Google Ads 계정, 사용자

데이터 파트너 D1

D1과 Google Ads 관리자 계정 M2 사이에 제품 연결이 있습니다.

Google 계정 222larabrown@gmail.com이 D1의 사용자입니다.

데이터 파트너 D2

D2와 Google Ads 고객 계정 C1 간에 제품 연결이 있습니다.

Google 계정 jeffersonloveshiking@gmail.com은 D2의 사용자입니다.

관리자 계정 M1

M1에는 다음과 같은 두 개의 직접 하위 계정이 있습니다.

관리자 계정 M2
고객 계정 C1

관리자 계정 M2

M2에는 다음과 같은 두 개의 직접 하위 계정이 있습니다.

고객 계정 C1
고객 계정 C2

고객 계정 C1

C1에는 다음과 같은 두 개의 직속 상위 관리자 계정이 있습니다.

관리자 계정 M1
관리자 계정 M2

고객 계정 C2

관리자 계정 M2는 C2의 유일한 직접 상위 계정입니다.

이 계정 집합으로 할 수 있는 작업은 다음과 같습니다.

데이터 파트너 D1로 활동

데이터 파트너 D1로 작동하려면 Google 계정 222larabrown@gmail.com의 사용자 인증 정보를 사용하여 login_account이 데이터 파트너 계정 D1로 설정되고 linked_account이 관리자 계정 M2로 설정된 대상을 사용하여 관리자 계정 M2, 고객 계정 C1 또는 고객 계정 C2로 데이터를 전송합니다.

데이터 파트너 D1은 D1과 M1 사이에 제품 링크가 없으므로 관리자 계정 M1에 데이터를 전송할 수 없습니다.

데이터 파트너 D2로 행동

데이터 파트너 D2로 작동하려면 Google 계정 jeffersonloveshiking@gmail.com의 사용자 인증 정보를 사용하여 login_account이 데이터 파트너 계정 D2로 설정되고 linked_account이 고객 계정 C1로 설정된 대상과 함께 고객 계정 C1에 데이터를 전송합니다.

데이터 파트너 D2는 D2와 해당 계정 또는 상위 관리자 계정 간에 제품 링크가 없으므로 관리자 계정 M1, 관리자 계정 M2 또는 고객 계정 C2로 데이터를 전송할 수 없습니다.

데이터 파트너 D1과 D2의 주요 차이점은 데이터 파트너가 Google Ads 계정에 연결되는 방식입니다.

데이터 파트너 D1이 Google Ads 관리자 계정에 연결되어 있습니다. 관리자 제품 링크 시나리오의 예입니다.
데이터 파트너 D2가 Google Ads 고객 계정에 연결되어 있습니다. 직접 제품 링크 시나리오의 예입니다.

직접 제품 링크 시나리오

Google Ads 계정으로 데이터를 전송하고 제품 링크가 Google Ads 계정과 데이터 파트너 계정 사이에 있는 경우 다음 단계를 따르세요.

대상

operating_account

`account_id`	Google Ads 계정의 고객 ID
`account_type`	`GOOGLE_ADS`

login_account

`account_id`	데이터 파트너 계정의 고객 ID
`account_type`	`DATA_PARTNER`

linked_account linked_account 필드를 설정하지 마세요.

product_destination_id 잠재고객 또는 전환 액션의 ID입니다.

다음은 다이어그램의 계정을 사용하는 직접 제품 링크 시나리오의 예입니다. 이 시나리오에서 데이터 파트너 D2는 D2와 C1 간의 제품 링크와 Google 계정 jeffersonloveshiking@gmail.com의 사용자 인증 정보를 사용하여 잠재고객 구성원 데이터를 Google Ads 클라이언트 고객 C1에 전송합니다.

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "D2_CUSTOMER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

관리자 제품 연결 시나리오

Google Ads 계정으로 데이터를 전송하고 제품 링크가 상위 Google Ads 관리자 계정과 데이터 파트너 계정 사이에 있는 경우 다음 단계를 따르세요.

대상

operating_account

`account_id`	Google Ads 고객 계정의 고객 ID
`account_type`	`GOOGLE_ADS`

login_account

`account_id`	데이터 파트너 계정의 고객 ID
`account_type`	`DATA_PARTNER`

linked_account

`account_id`	Google Ads 관리자 계정의 고객 ID
`account_type`	`GOOGLE_ADS`

product_destination_id 잠재고객 또는 전환 액션의 ID입니다.

다음은 다이어그램의 계정을 사용하는 관리자 제품 링크 시나리오의 예입니다. 이 시나리오에서 데이터 파트너 D1은 D1과 M2 간의 제품 링크와 Google 계정 222larabrown@gmail.com의 사용자 인증 정보를 사용하여 잠재고객 구성원 데이터를 Google Ads 클라이언트 고객 C2에 전송합니다.

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "D1_CUSTOMER_ID",
        "accountType": "DATA_PARTNER"
      },
      "linkedAccount": {
        "accountId": "M2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

Display & Video 360

데이터 파트너는 다음 두 가지 방법을 사용하여 Display & Video 360 계정에 데이터를 전송할 수 있습니다.

데이터 파트너 계정과 Display & Video 360 파트너 또는 광고주 계정 간에 직접 제품 링크를 사용합니다.
데이터 파트너 계정과 광고주의 상위 Display & Video 360 파트너 계정 간의 제품 링크를 사용하여 Display & Video 360 광고주에게 데이터를 전송합니다.

직접 제품 링크 시나리오

Display & Video 360 광고주에게 데이터를 전송하고 제품 링크가 Display & Video 360 광고주 계정과 데이터 파트너 계정 사이에 있는 경우 다음 단계를 따르세요.

대상

operating_account

`account_id`	Display & Video 360 광고주 계정의 ID
`account_type`	`DISPLAY_VIDEO_ADVERTISER`

login_account

`account_id`	데이터 파트너 계정의 고객 ID
`account_type`	`DATA_PARTNER`

linked_account linked_account 필드를 설정하지 마세요.

product_destination_id 잠재고객 또는 전환 액션의 ID입니다.

다음은 Display & Video 360 광고주에게 데이터를 전송하는 직접 제품 링크 시나리오의 Destination 예입니다.

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Display & Video 360 파트너 계정으로 데이터를 전송하려면 Display & Video 360 파트너 계정과 데이터 파트너 계정 간에 제품 링크가 있어야 합니다.

대상

operating_account

`account_id`	Display & Video 360 파트너 계정의 ID
`account_type`	`DISPLAY_VIDEO_PARTNER`

login_account

`account_id`	데이터 파트너 계정의 고객 ID
`account_type`	`DATA_PARTNER`

linked_account linked_account 필드를 설정하지 마세요.

product_destination_id 잠재고객 또는 전환 액션의 ID입니다.

다음은 Display & Video 360 파트너에게 데이터를 전송하는 직접 제품 링크 시나리오의 Destination 예입니다.

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Display & Video 360 파트너 제품 링크 시나리오

Display & Video 360 광고주에게 데이터를 전송하고 데이터 파트너 계정의 제품 링크가 광고주 계정이 하위 계정인 Display & Video 360 파트너 계정에 연결되어 있는 경우 다음 단계를 따르세요.

대상

operating_account

`account_id`	Display & Video 360 광고주 계정의 ID
`account_type`	`DISPLAY_VIDEO_ADVERTISER`

login_account

`account_id`	데이터 파트너 계정의 고객 ID
`account_type`	`DATA_PARTNER`

linked_account

`account_id`	Display & Video 360 파트너 계정의 ID
`account_type`	`DISPLAY_VIDEO_PARTNER`

product_destination_id 잠재고객 또는 전환 액션의 ID입니다.

다음은 데이터 파트너와 광고주의 상위 Display & Video 360 파트너 간의 제품 연결을 사용하여 Display & Video 360 광고주에게 데이터를 전송하는 파트너 제품 연결 시나리오의 Destination 예입니다.

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "linkedAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Google 애널리틱스

데이터 관리 도구 API는 제품 링크를 사용하여 Google 애널리틱스 계정으로 데이터를 전송하는 것을 지원하지 않습니다. 대신 Google 애널리틱스의 광고주 시나리오 접근 방식을 사용하세요.

세부 요구사항

이 섹션에는 Destination의 계정 필드에 대한 자세한 요구사항, product_destination_id 설정 방법 관련 도움말, 사용자 인증 정보가 액세스할 수 있는 위치를 확인하는 방법이 포함되어 있습니다.

계정 필드

Destination에는 최대 3개의 서로 다른 계정이 있을 수 있습니다.

operating_account

operating_account은 필수입니다.

operating_account는 요청에서 데이터를 수신하는 계정을 나타냅니다. operating_account은 다음 중 하나일 수 있습니다.

Google Ads 계정
Display & Video 360 광고주 계정
Display & Video 360 파트너 계정
Google 애널리틱스 속성
데이터 파트너 계정이 소유한 잠재고객에게 데이터를 전송하는 경우 데이터 파트너 계정

login_account

login_account은 항상 필요한 것은 아니며 기본값은 operating_account입니다.

데이터 관리자 API는 다음을 확인합니다.

자격 증명의 Google 계정이 login_account의 사용자입니다.
login_account은 다음 중 하나입니다.
- operating_account과 동일합니다. login_account을 설정하지 않으면 이 값이 기본값입니다.
- operating_account의 상위 계정인 Google Ads 관리자 또는 Display & Video 360 파트너 계정입니다.
- linked_account에 제품이 연결된 데이터 파트너 계정

linked_account

linked_account는 login_account에 대한 제품 링크가 있는 계정을 나타냅니다.

제품 도착 ID

Destination의 product_destination_id는 operating_account에서 데이터를 수신하는 객체를 식별합니다. 예를 들어 Google Ads 또는 Display & Video 360의 잠재고객 ID, Google Ads의 전환 액션 ID 또는 Google 애널리틱스 스트림의 측정 ID일 수 있습니다.

각 제품 대상 유형의 ID를 찾는 방법은 다음과 같습니다.

Google Ads 잠재고객

잠재고객 구성원을 수집하는 제품 대상 ID는 잠재고객 ID입니다.

Google Ads UI에서 잠재고객 ID를 가져오려면 다음 단계를 따르세요.

Google Ads UI에서 잠재고객 관리자로 이동합니다.
세부정보를 보려면 잠재고객 이름을 클릭합니다.
잠재고객 ID는 목록 ID 옆에 표시됩니다.

Google Ads API에서 잠재고객 ID를 가져오려면 다음 단계를 따르세요.

다음 쿼리를 사용하여 GoogleAdsService에 Search 또는 SearchStream 요청을 보냅니다.

SELECT
  user_list.id,
  user_list.name
FROM user_list
WHERE user_list.name = 'USER_LIST_NAME'

응답의 user_list에 있는 id 필드에서 잠재고객 ID를 가져옵니다.

[
  {
    "results": [
      {
        "userList": {
          "resourceName": "customers/CUSTOMER_ID/userLists/USER_LIST_ID",
          "id": "USER_LIST_ID",
          "name": "USER_LIST_NAME"
        }
      }
    ]
  }
]

Google Ads 이벤트

이벤트를 수집하는 제품 대상 ID는 전환 액션 ID입니다.

Google Ads UI에서 전환 액션 ID를 가져오려면 다음 단계를 따르세요.

Google Ads UI에서 전환으로 이동합니다.
전환 액션 이름을 클릭하여 세부정보를 확인합니다.

전환 액션 ID는 ctId라는 URL 쿼리 매개변수의 값입니다.

https://ads.google.com/aw/conversions/detail?ocid=...&ctId=CONVERSION_ACTION_ID&...

Google Ads API에서 전환 액션 ID를 가져오려면 다음 단계를 따르세요.

다음 쿼리를 사용하여 GoogleAdsService에 Search 또는 SearchStream 요청을 보냅니다.

SELECT
  conversion_action.id,
  conversion_action.name
FROM conversion_action
WHERE conversion_action.name = 'CONVERSION_ACTION_NAME'

응답의 conversion_action에서 id 필드의 전환 액션 ID를 가져옵니다.

[
  {
    "results": [
      {
        "conversionAction": {
          "resourceName": "customers/CUSTOMER_ID/conversionActions/CONVERSION_ACTION_ID",
          "id": "CONVERSION_ACTION_ID",
          "name": "CONVERSION_ACTION_NAME"
        }
      }
    ]
  }
]

Display & Video 360 잠재고객

잠재고객 구성원을 수집하는 제품 대상 ID는 잠재고객 ID입니다.

Display & Video 360 UI에서 잠재고객 ID를 가져오려면 다음 단계를 따르세요.

https://displayvideo.google.com에서 Display & Video 360 UI에 로그인합니다.
operating_account에 사용할 Display & Video 360 파트너 또는 광고주로 이동합니다.
왼쪽 메뉴에서 잠재고객으로 이동한 다음 모든 잠재고객을 선택합니다.
목록에서 잠재고객을 찾습니다. 잠재고객 ID는 이름 열의 이름 옆에 있는 숫자입니다.

Google 애널리틱스 이벤트

이벤트를 수집하는 제품 대상 ID는 데이터 스트림의 측정 ID입니다.

사용자 인증 정보가 액세스할 수 있는 위치 확인

Data Manager API 요청을 승인하는 데 사용하는 사용자 인증 정보는 특정 Google 계정과 연결되어 있습니다.

사용자 사용자 인증 정보를 사용하는 경우 사용자 인증 정보를 생성할 때 사용자를 대신하여 작업할 권한을 부여한 사용자의 Google 계정으로 요청이 승인됩니다.
서비스 계정 사용자 인증 정보를 사용하는 경우 요청은 서비스 계정의 Google 계정으로 승인됩니다.

사용자 인증 정보의 Google 계정에 Google Ads, Display & Video 360 또는 Google 애널리틱스 계정에 대한 액세스 권한이 있는지 확인하는 방법은 다음과 같습니다.

Google Ads 또는 데이터 파트너

login_account의 Google Ads UI에서 액세스 및 보안으로 이동합니다.
사용자 탭을 선택합니다.
login_account이 Google Ads 관리자 계정인 경우 전체 계층 구조에서 사용자 표시 전환 버튼을 꺼서 하위 계정의 사용자를 숨깁니다.
사용자 인증 정보의 Google 계정이 사용자 탭에 표시된 계정 목록에 있는지 확인합니다.

Display & Video 360

Display & Video 360 UI에서 사용자 관리 및 이메일 환경설정으로 이동합니다.
사용자 관리에 사용자 인증 정보의 Google 계정이 login_account의 사용자로 표시되는지 확인합니다.

Google 애널리틱스

Google 애널리틱스 UI에서 속성 액세스 관리로 이동합니다.
login_account에 지정된 Google 애널리틱스 속성이 선택되어 있는지 확인합니다.
사용자 인증 정보의 Google 계정에 속성에 대한 편집자 또는 관리자 역할이 있는지 확인합니다.

사용자 데이터 형식 지정

대상 구성 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

광고주 시나리오

Google Ads

직접 액세스 시나리오

관리자 액세스 시나리오

Display & Video 360

직접 액세스 시나리오

Display & Video 360 파트너 액세스 시나리오

Google 애널리틱스

데이터 파트너 시나리오

Google Ads

직접 제품 링크 시나리오

관리자 제품 연결 시나리오

Display & Video 360

직접 제품 링크 시나리오

Display & Video 360 파트너 제품 링크 시나리오

Google 애널리틱스

세부 요구사항

계정 필드

제품 도착 ID

Google Ads 잠재고객

Google Ads 이벤트

Display & Video 360 잠재고객

Google 애널리틱스 이벤트

사용자 인증 정보가 액세스할 수 있는 위치 확인

Google Ads 또는 데이터 파트너

Display & Video 360

Google 애널리틱스

대상 구성