[Beta]{class="badge informative"}

Flow Service API를 사용하여 Google Ads을(를) Experience Platform에 연결

기본 연결은 소스와 Adobe Experience Platform 간의 인증된 연결을 나타냅니다. 이 자습서를 사용하여 Flow Service API를 사용하여 Google 광고 계정을 Experience Platform에 연결합니다.

Google Ads 기본 연결은 Google Ads API에 액세스하는 데 필요한 인증 세부 정보를 저장하고, 이후 단계에서 소스 구성을 탐색하고 데이터 흐름을 만드는 데 사용할 연결 ID를 만듭니다.

시작

이 안내서를 사용하려면 Experience Platform의 다음 구성 요소에 대해 이해하고 있어야 합니다.

다음 섹션에서는 Flow Service API를 사용하여 Google Ads에 성공적으로 연결하기 위해 알아야 할 추가 정보를 제공합니다.

Experience Platform API 사용

Experience Platform API를 성공적으로 호출하는 방법에 대한 자세한 내용은 Experience Platform API 시작에 대한 안내서를 참조하십시오.

필수 헤더에 대한 값 수집

Experience Platform API를 호출하려면 먼저 인증 자습서를 완료해야 합니다. 인증 자습서를 완료하면 아래와 같이 모든 Experience Platform API 호출에서 필요한 각 헤더의 값이 제공됩니다.

Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}
x-sandbox-name: {SANDBOX_NAME}
Content-Type: application/json

Experience Platform의 모든 리소스는 특정 가상 샌드박스로 분리됩니다. Experience Platform API에 대한 모든 요청에는 작업이 수행될 샌드박스의 이름을 지정하는 헤더가 필요합니다.

필요한 자격 증명 수집

인증에 대한 자세한 내용은 Google Ads 원본 개요를 참조하세요.

기본 연결 만들기

기본 연결은 소스의 인증 자격 증명, 연결의 현재 상태 및 고유한 기본 연결 ID를 포함하여 소스와 Experience Platform 간에 정보를 유지합니다.

기본 연결 ID를 만들려면 요청 매개 변수의 일부로 Google Ads 인증 자격 증명을 제공하는 동안 /connections 끝점에 대한 POST 요청을 만듭니다.

API 형식

POST /connections

요청

다음 요청은 Google Ads에 대한 기본 연결을 만듭니다.

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json'
  -d '{
      "name": "Google Ads base connection",
      "description": "Google Ads base connection",
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "clientCustomerID": "{CLIENT_CUSTOMER_ID}",
              "loginCustomerID": "{LOGIN_CUSTOMER_ID}",
              "developerToken": "{DEVELOPER_TOKEN}",
              "refreshToken": "{REFRESH_TOKEN}",
              "clientId": "{CLIENT_ID}",
              "clientSecret": "{CLIENT_SECRET}",
              "googleAdsApiVersion": "v19"

          }
      },
      "connectionSpec": {
          "id": "d771e9c1-4f26-40dc-8617-ce58c4b53702",
          "version": "1.0"
      }
  }'

대상 광고주 계정에 직접 액세스할 수 있고 관리자 계정 라우팅이 필요하지 않은 경우 auth.params 개체에서 loginCustomerID을(를) 생략할 수 있습니다.

응답

성공한 응답은 고유 식별자(id)를 포함하여 새로 만든 기본 연결의 세부 정보를 반환합니다. 다음 단계에서 소스 연결을 만들려면 이 ID가 필요합니다.

{
    "id": "2484f2df-c057-4ab5-84f2-dfc0577ab592",
    "etag": "\"10033e77-0000-0200-0000-5e96785b0000\""
}

연결 세부 정보 확인

기본 연결을 만든 후 계속하기 전에 다음 사항을 확인하십시오.

인증이 성공하지만 다운스트림 데이터 액세스가 실패하면 가장 일반적인 원인은 잘못되었거나 불필요한 loginCustomerId입니다.

다음 단계

이 자습서에 따라 흐름 서비스 API를 사용하여 Google Ads 기본 연결을 만들었습니다.

이제 다음 튜토리얼을 계속 진행할 수 있습니다.

문제 해결

하위 광고주 계정에 대한 인증 오류

하위 광고주 계정에 액세스하려고 할 때 요청이 실패하는 경우 loginCustomerId이(가) 올바른 관리자 계정으로 설정되어 있는지 확인하십시오. 이는 MCC 계층 구조를 통해 액세스를 중개할 때 필요합니다.

유효하지 않거나 취소된 새로 고침 토큰

커넥터가 액세스 토큰을 새로 고칠 수 없는 경우 Google Ads 계정을 다시 인증하여 새 새로 고침 토큰을 생성합니다.

지원되지 않는 API 버전

버전 불일치로 인해 요청이 실패하는 경우 googleAdsApiVersion이(가) Experience Platform에서 지원하는 버전으로 설정되어 있는지 확인하십시오.