리마케팅 잠재고객 개발자 가이드

이 문서에서는 Management API를 사용하여 Google 애널리틱스 리마케팅 잠재고객을 관리하는 방법을 설명합니다.

소개

Management API를 사용하면 Google 애널리틱스 속성의 리마케팅 잠재고객을 create, get, delete, list, update, patch할 수 있습니다. 리마케팅 잠재고객의 작동 방식에 대해 자세히 알아보려면 고객센터의 애널리틱스의 리마케팅 잠재고객에 관해 고객센터 도움말을 참고하세요.

사용 사례

리마케팅 잠재고객 리소스는 get, delete, list, patch, update를 지원하지만 주요 사용 사례는 다음과 같습니다.

리마케팅 잠재고객 나열

속성에 대한 모든 리마케팅 잠재고객을 나열하려면 다음 단계를 따르세요.

  1. Management API 또는 계정 탐색기를 사용하여 accountId 및 webPropertyId를 검색합니다.
  2. 리마케팅 잠재고객 리소스의 list 메서드를 실행합니다.

리마케팅 잠재고객 리소스의 list 메서드에 대한 자세한 내용은 API 참조를 확인하세요.

새 리마케팅 잠재고객 만들기

속성에 대해 새 리마케팅 잠재고객을 만드는 방법은 다음과 같습니다.

  1. Management API 또는 계정 탐색기를 사용하여 accountId 및 webPropertyId을 검색합니다.
  2. Management API 또는 계정 탐색기를 사용하여 linkedViews [] 속성의 보기 (프로필) ID를 가져옵니다.
  3. Google Ads 링크 컬렉션을 사용하여 linkedAdAccounts.linkedAccountId의 Google Ads 계정 ID를 가져옵니다.
    • linkedAdAccounts[] 속성은 현재 하나의 linkedForeignAccount로만 제한됩니다.
    • linkedAdAccounts[].type를 ADWORDS_LINKS, DBM_LINKS, MCC_LINKS 또는 OPTIMIZE로 설정할 수 있습니다.
  4. 세그먼트 컬렉션을 사용하여 includeConditions의 segment 속성을 설정할 수 있습니다. 상태 기반 잠재고객을 만드는 경우 excludeConditions도 같은 작업을 수행합니다. 세그먼트를 정의하는 방법은 세그먼트 참조도 참고하세요.
    • includeConditions에는 membershipDurationDays 및 daysToLookBack 값이 선택적으로 포함될 수 있습니다.
    • excludeConditions.exclusionDuration를 PERMANENT로 선택적으로 설정할 수 있습니다.
  5. 리마케팅 잠재고객 리소스의 insert 메서드를 실행합니다.

API를 사용하면 SIMPLE 및 STATE_BASED, 두 가지 유형의 잠재고객을 만들 수 있습니다. SIMPLE 잠재고객의 경우 NOT 연산자 (! 문자) 없이 양의 segment을 사용하여 audienceDefinition만 구성하면 됩니다. 제외 조건을 포함하려면 statebasedDefinition를 정의해야 합니다. 자세한 내용은 상태 기반 잠재고객을 참고하세요. 자세한 내용은 참조 예를 참고하세요.

기존 리마케팅 잠재고객 업데이트

속성의 기존 리마케팅 잠재고객을 업데이트하는 방법은 다음과 같습니다.

  1. 이미 리마케팅 잠재고객 ID가 있는 경우 get를 호출할 수 있습니다. 그렇지 않으면 list을 호출하고 업데이트할 잠재고객을 선택할 수 있습니다.
  2. 쓰기 가능 필드를 업데이트하고 업데이트된 잠재고객 객체를 전달하는 update를 호출합니다.