Thiết lập đích đến và tiêu đề

Cả khái niệm Destination và tiêu đề của yêu cầu đều xuất hiện thường xuyên khi làm việc với Data Manager API. Hãy đọc hướng dẫn này để hiểu cách định cấu hình đích đến và tiêu đề cho các trường hợp khác nhau.

Trường hợp sử dụng đích đến hoặc tiêu đề

• Sử dụng Destination trong yêu cầu nhập dữ liệu. Yêu cầu nhập sử dụng IngestionService để thêm hoặc xoá thành viên trong một đối tượng hoặc gửi sự kiện. Danh sách destinations trong IngestAudienceMembersRequest hoặc IngestEventsRequest xác định:

  1. Tài khoản nhận dữ liệu. Ví dụ: tài khoản Google Ads hoặc tài sản Google Analytics.
  2. Thực thể đích cho dữ liệu trong tài khoản, chẳng hạn như một hành động chuyển đổi trên Google Ads hoặc một luồng Google Analytics.
  3. Đường dẫn truy cập cho thông tin xác thực của yêu cầu đến tài khoản nhận dữ liệu.

  Bạn có thể thêm nhiều đích đến trong cùng một yêu cầu nhập.

  Lưu ý: Đừng đặt tiêu đề yêu cầu trong yêu cầu IngestionService. Data Manager API bỏ qua các tiêu đề trong yêu cầu nhập dữ liệu.

• Sử dụng tiêu đề của yêu cầu trong yêu cầu quản lý tài nguyên để tạo, cập nhật, xoá hoặc truy xuất tài nguyên. Tiêu đề xác định đường dẫn truy cập cho thông tin xác thực của yêu cầu đến tài khoản mục tiêu của yêu cầu quản lý tài nguyên. Dưới đây là danh sách các tài nguyên có phương thức quản lý tài nguyên hỗ trợ tiêu đề của yêu cầu:

  • Insights
  • PartnerLink
  • UserList
  • UserListDirectLicense
  • UserListGlobalLicense
  • UserListGlobalLicenseCustomerInfo

Ví dụ: nếu bạn muốn tạo một đối tượng, thêm thành viên vào đối tượng đó, kiểm tra thông tin chẩn đoán, rồi truy xuất đối tượng để kiểm tra quy mô của đối tượng, thì sau đây là từng bước, loại yêu cầu cần sử dụng và việc bạn nên sử dụng đích đến hay tiêu đề của yêu cầu:

Bước	Loại yêu cầu	Tiêu đề của đích đến hoặc yêu cầu
Tạo đối tượng	Quản lý tài nguyên	Tiêu đề của yêu cầu
Thêm thành viên vào đối tượng	Nhập	Điểm đến
Kiểm tra thông tin chẩn đoán	Nhập	Điểm đến
Truy xuất đối tượng	Quản lý tài nguyên	Tiêu đề của yêu cầu

Lưu ý: Yêu cầu RetrieveRequestStatus không trực tiếp chấp nhận đích đến hoặc tiêu đề của yêu cầu. Thay vào đó, Data Manager API sẽ xác minh thông tin uỷ quyền bằng cách sử dụng đích đến và đường dẫn truy cập từ yêu cầu nhập ban đầu. Để biết thông tin chi tiết, hãy xem phần Uỷ quyền trong hướng dẫn chẩn đoán.

Chuyển đổi giữa các thông tin chi tiết trong hướng dẫn này cho từng loại yêu cầu bằng cách nhấp vào thẻ Nhập dữ liệu hoặc Quản lý tài nguyên xung quanh mỗi bảng.

Nếu bạn là nhà quảng cáo hoặc đại lý, hãy chuyển đến phần Các trường hợp của nhà quảng cáo để xem ví dụ về cách đặt tiêu đề và tạo Destination:

• Google Ads
• Display & Video 360
• Google Analytics
• Floodlight

Nếu bạn là đối tác dữ liệu, hãy chuyển đến phần Các trường hợp đối tác dữ liệu để xem ví dụ về cách đặt tiêu đề và tạo Destination để quản lý tài nguyên và gửi dữ liệu đến một tài khoản có đường liên kết đối tác đến tài khoản đối tác dữ liệu của bạn:

• Google Ads
• Display & Video 360
• Google Ad Manager
• Google Analytics
• Floodlight

Phần Yêu cầu chi tiết trình bày chi tiết các yêu cầu và quy tắc xác thực.

Các tình huống khi sử dụng AdSense

Sau đây là cách định cấu hình Destination hoặc tiêu đề của yêu cầu cho các trường hợp phổ biến đối với nhà quảng cáo và công ty quảng cáo. Sơ đồ này cho thấy cách API Trình quản lý dữ liệu sử dụng thông tin xác thực và các trường Destination để truy cập vào tài khoản nhà quảng cáo.

Google Ads

Dưới đây là biểu đồ minh hoạ một ví dụ về một nhóm tài khoản Google Ads và người dùng.

Tài khoản người quản lý M1

M1 có hai tài khoản con trực tiếp:

1. Tài khoản người quản lý M2
2. Tài khoản khách hàng C1

Tài khoản Google [e-mail] là một người dùng trong M1.

Tài khoản người quản lý M2

M2 có hai tài khoản con trực tiếp:

1. Tài khoản khách hàng C1
2. Tài khoản khách hàng C2

Tài khoản Google [e-mail] là một người dùng trong M2.

Tài khoản khách hàng C1

C1 có hai tài khoản người quản lý cấp trên trực tiếp:

1. Tài khoản người quản lý M1
2. Tài khoản người quản lý M2

Tài khoản Google [e-mail] là một người dùng trong C1.

Tài khoản khách hàng C2

Tài khoản người quản lý M2 là tài khoản người quản lý cấp trên trực tiếp duy nhất của C2.

Không có Tài khoản Google nào trong danh sách là người dùng trong C2.

Trường hợp truy cập trực tiếp và Trường hợp truy cập của người quản lý cho biết cách bạn định cấu hình một đích đến để gửi dữ liệu đến các tài khoản này.

Trường hợp truy cập trực tiếp

Nếu bạn muốn gửi dữ liệu đến một tài khoản Google Ads và thông tin đăng nhập của bạn là của một Tài khoản Google là người dùng trong tài khoản Google Ads đó:

Nhập

Đích đến
operating_account	account_id Mã khách hàng của tài khoản Google Ads account_type GOOGLE_ADS
login_account	Bạn có thể không đặt login_account hoặc đặt thành cùng một giá trị với operating_account.
linked_account	Đừng đặt trường linked_account.
product_destination_id	Mã của đối tượng hoặc hành động chuyển đổi.

Quản lý tài nguyên

Tiêu đề của yêu cầu
login-account	accountTypes/GOOGLE_ADS/accounts/GOOGLE_ADS_CUSTOMER_ID
linked-account	Đừng đặt tiêu đề linked-account.

Dưới đây là ví dụ về trường hợp truy cập trực tiếp, sử dụng các tài khoản trong biểu đồ và thông tin đăng nhập cho Tài khoản Google [e-mail]:

Nhập

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

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

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

Quản lý tài nguyên

Tiêu đề của yêu cầu
login-account	accountTypes/GOOGLE_ADS/accounts/C1_CUSTOMER_ID
linked-account	Đừng đặt tiêu đề linked-account.

Trường hợp truy cập của người quản lý

Nếu bạn muốn gửi dữ liệu đến một tài khoản Google Ads và thông tin đăng nhập của bạn là của một Tài khoản Google là người dùng trong tài khoản người quản lý Google Ads, trong đó tài khoản nhà quảng cáo là tài khoản con:

Nhập

Đích đến
operating_account	account_id Mã khách hàng của tài khoản khách hàng Google Ads account_type GOOGLE_ADS
login_account	account_id Mã khách hàng của tài khoản người quản lý Google Ads account_type GOOGLE_ADS
linked_account	Đừng đặt trường linked_account.
product_destination_id	Mã của đối tượng hoặc hành động chuyển đổi.

Quản lý tài nguyên

Tiêu đề của yêu cầu
login-account	accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID
linked-account	Đừng đặt tiêu đề linked-account.

Dưới đây là ví dụ về trường hợp quyền truy cập của người quản lý đối với tài khoản khách hàng Google Ads C2 trong biểu đồ và thông tin đăng nhập cho Tài khoản Google [e-mail]:

Nhập

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

Quản lý tài nguyên

Tiêu đề của yêu cầu
login-account	accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID
linked-account	Đừng đặt tiêu đề linked-account.

Dưới đây là một ví dụ khác về trường hợp truy cập của người quản lý đối với tài khoản khách hàng Google Ads C2 và thông tin đăng nhập cho Tài khoản Google [e-mail], là người dùng trên tài khoản người quản lý Google Ads M1:

Nhập

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

Quản lý tài nguyên

Tiêu đề của yêu cầu
login-account	accountTypes/GOOGLE_ADS/accounts/M1_CUSTOMER_ID
linked-account	Đừng đặt tiêu đề linked-account.

Display & Video 360

Bạn có thể gửi dữ liệu đến Display & Video 360 bằng hai cách:

1. Quyền truy cập trực tiếp, trong đó thông tin đăng nhập là của một Tài khoản Google của người dùng trong tài khoản đối tác hoặc nhà quảng cáo Display & Video 360.
2. Quyền truy cập của đối tác Display & Video 360, trong đó thông tin đăng nhập là của một Tài khoản Google là người dùng trong tài khoản đối tác Display & Video 360 và tài khoản điều hành là một tài khoản nhà quảng cáo Display & Video 360 thuộc tài khoản đối tác.

Các trường hợp truy cập trực tiếp

Nếu bạn muốn gửi dữ liệu đến một tài khoản nhà quảng cáo Display & Video 360 và thông tin đăng nhập của bạn là của một Tài khoản Google là người dùng trong tài khoản nhà quảng cáo:

Nhập

Đích đến
operating_account	account_id Mã nhận dạng của tài khoản nhà quảng cáo Display & Video 360 account_type DISPLAY_VIDEO_ADVERTISER
login_account	Bạn có thể không đặt login_account hoặc đặt thành cùng một giá trị với operating_account.
linked_account	Đừng đặt trường linked_account.
product_destination_id	Mã nhận dạng của đối tượng.

Quản lý tài nguyên

Tiêu đề của yêu cầu
login-account	accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID
linked-account	Đừng đặt tiêu đề linked-account.

Dưới đây là ví dụ về Destination cho trường hợp truy cập trực tiếp để gửi dữ liệu đến một nhà quảng cáo Display & Video 360:

Nhập

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

Quản lý tài nguyên

Tiêu đề của yêu cầu
login-account	accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID
linked-account	Đừng đặt tiêu đề linked-account.

Tương tự, nếu bạn muốn gửi dữ liệu đến một tài khoản đối tác Display & Video 360 và thông tin đăng nhập của bạn là dành cho một Tài khoản Google của người dùng trong tài khoản đối tác:

Nhập

Đích đến
operating_account	account_id Mã nhận dạng của tài khoản đối tác Display & Video 360 account_type DISPLAY_VIDEO_PARTNER
login_account	Bạn có thể không đặt login_account hoặc đặt thành cùng một giá trị với operating_account.
linked_account	Đừng đặt trường linked_account.
product_destination_id	Mã nhận dạng của đối tượng.

Quản lý tài nguyên

Tiêu đề của yêu cầu
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	Đừng đặt tiêu đề linked-account.

Dưới đây là ví dụ về Destination cho trường hợp truy cập trực tiếp để gửi dữ liệu đến một đối tác của Display & Video 360:

Nhập

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

Quản lý tài nguyên

Tiêu đề của yêu cầu
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	Đừng đặt tiêu đề linked-account.

Trường hợp truy cập của đối tác Display & Video 360

Nếu bạn muốn gửi dữ liệu đến một nhà quảng cáo Display & Video 360 và thông tin đăng nhập của bạn là của một Tài khoản Google là người dùng trong tài khoản đối tác Display & Video 360 chính của nhà quảng cáo:

Nhập

Đích đến
operating_account	account_id Mã nhận dạng của tài khoản nhà quảng cáo Display & Video 360 account_type DISPLAY_VIDEO_ADVERTISER
login_account	account_id Mã nhận dạng của tài khoản đối tác Display & Video 360 account_type DISPLAY_VIDEO_PARTNER
linked_account	Đừng đặt trường linked_account.
product_destination_id	Mã nhận dạng của đối tượng.

Quản lý tài nguyên

Tiêu đề của yêu cầu
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	Đừng đặt tiêu đề linked-account.

Sau đây là ví dụ về Destination cho trường hợp truy cập của đối tác để gửi dữ liệu đến một nhà quảng cáo Display & Video 360. Trong trường hợp này, thông tin đăng nhập phải là của một Tài khoản Google là người dùng trong tài khoản đối tác Display & Video 360 DISPLAY_VIDEO_PARTNER_ID và tài khoản nhà quảng cáo Display & Video 360 DISPLAY_VIDEO_ADVERTISER_ID phải là tài khoản con của tài khoản đối tác DISPLAY_VIDEO_PARTNER_ID.

Nhập

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

Quản lý tài nguyên

Tiêu đề của yêu cầu
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	Đừng đặt tiêu đề linked-account.

Google Analytics

Lưu ý: Nếu operating_account là một tài khoản Google Analytics, thì bạn không nên đặt login_account hoặc đặt giá trị giống như operating_account. Nếu không, yêu cầu sẽ không thành công và có lỗi OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH.

Nhập

Đích đến
operating_account	account_id Mã của tài sản Google Analytics account_type GOOGLE_ANALYTICS_PROPERTY
login_account	Bạn có thể không đặt login_account hoặc đặt thành cùng một giá trị với operating_account.
linked_account	Đừng đặt trường linked_account.
product_destination_id	Mã đo lường của một luồng dữ liệu web. Mã ứng dụng Firebase của một luồng dữ liệu ứng dụng.

Quản lý tài nguyên

Tiêu đề của yêu cầu
login-account	accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account	Đừng đặt tiêu đề linked-account.

Sau đây là ví dụ về Destination để gửi sự kiện đến Google Analytics:

Nhập

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

Quản lý tài nguyên

Tiêu đề của yêu cầu
login-account	accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account	Đừng đặt tiêu đề linked-account.

Floodlight

Lưu ý: Nếu operating_account là một cấu hình Floodlight, thì bạn không nên đặt login_account hoặc đặt giá trị giống như operating_account. Nếu không, yêu cầu sẽ không thành công và có lỗi OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH.

Nhập

Đích đến
operating_account	account_id Mã cấu hình Floodlight Nếu nhà quảng cáo của bạn là nhà quảng cáo con của một nhà quảng cáo mẹ, hãy sử dụng mã nhận dạng của nhà quảng cáo mẹ trong Campaign Manager 360 làm mã cấu hình Floodlight. Nếu không, hãy sử dụng mã nhận dạng của nhà quảng cáo. Xem cách tìm mã nhận dạng nhà quảng cáo trong giao diện người dùng của Campaign Manager 360. account_type FLOODLIGHT_CONFIG
login_account	Bạn có thể không đặt login_account hoặc đặt thành cùng một giá trị với operating_account.
linked_account	Đừng đặt trường linked_account.
product_destination_id	Mã hoạt động Floodlight

Dưới đây là ví dụ về Destination để gửi sự kiện đến Floodlight:

Nhập

        {
          "destinations": [
            {
              "operatingAccount": {
                "accountId": "FLOODLIGHT_CONFIG_ID",
                "accountType": "FLOODLIGHT_CONFIG"
              },
              "loginAccount": {
                "accountId": "FLOODLIGHT_CONFIG_ID",
                "accountType": "FLOODLIGHT_CONFIG"
              },
              "productDestinationId": "FLOODLIGHT_ACTIVITY_ID"
            }
          ]
        }
      

Các trường hợp đối tác dữ liệu

Sau đây là cách định cấu hình Destination cho các trường hợp phổ biến đối với đối tác dữ liệu gửi dữ liệu đến tài khoản nhà quảng cáo có đường liên kết đối tác đã thiết lập đến tài khoản đối tác dữ liệu.

Lưu ý: Trong mọi trường hợp đối tác dữ liệu, thông tin đăng nhập phải là của một Tài khoản Google là người dùng trong tài khoản đối tác dữ liệu.

Sơ đồ này cho thấy cách Data Manager API sử dụng thông tin xác thực và các trường Destination để truy cập vào tài khoản nhà quảng cáo thông qua một đường liên kết của đối tác.

Google Ads

Dưới đây là sơ đồ minh hoạ một ví dụ về một nhóm tài khoản Google Ads và tài khoản đối tác dữ liệu. Sơ đồ này cũng cho biết Tài khoản Google nào là người dùng trong mỗi tài khoản Google Ads hoặc tài khoản đối tác dữ liệu, cũng như đường liên kết đối tác giữa các tài khoản.

Đối tác dữ liệu D1

Có một mối liên kết đối tác giữa D1 và tài khoản người quản lý Google Ads M2.

Tài khoản Google [e-mail] là một người dùng trong D1.

Đối tác dữ liệu D2

Có một mối liên kết đối tác giữa D2 và tài khoản khách hàng Google Ads C1.

Tài khoản Google [e-mail] là người dùng trong D2.

Tài khoản người quản lý M1

M1 có hai tài khoản con trực tiếp:

1. Tài khoản người quản lý M2
2. Tài khoản khách hàng C1

Tài khoản người quản lý M2

M2 có hai tài khoản con trực tiếp:

1. Tài khoản khách hàng C1
2. Tài khoản khách hàng C2

Tài khoản khách hàng C1

C1 có hai tài khoản người quản lý cấp trên trực tiếp:

1. Tài khoản người quản lý M1
2. Tài khoản người quản lý M2

Tài khoản khách hàng C2

Tài khoản người quản lý M2 là tài khoản người quản lý cấp trên trực tiếp duy nhất của C2.

Sau đây là những việc bạn có thể làm với nhóm tài khoản này:

Đóng vai trò là đối tác dữ liệu D1

Để đóng vai trò là đối tác dữ liệu D1, hãy sử dụng thông tin đăng nhập của Tài khoản Google [e-mail] để:

• Gửi dữ liệu đến tài khoản khách hàng C1 hoặc tài khoản khách hàng C2, sử dụng một đích đến có login_account được đặt thành tài khoản đối tác dữ liệu D1 và linked_account được đặt thành tài khoản người quản lý M2.

• Gửi dữ liệu trực tiếp đến tài khoản người quản lý M2, sử dụng một đích đến có login_account được đặt thành tài khoản đối tác dữ liệu D1. Không đặt linked_account.

Là đối tác dữ liệu D1, bạn không thể gửi dữ liệu đến tài khoản người quản lý M1 vì không có mối liên kết đối tác giữa D1 và M1.

Đóng vai trò là đối tác dữ liệu D2

Để đóng vai trò là đối tác dữ liệu D2, hãy sử dụng thông tin đăng nhập cho Tài khoản Google [e-mail] để gửi dữ liệu đến tài khoản khách hàng C1, sử dụng một đích đến có login_account được đặt thành tài khoản đối tác dữ liệu D2. Không trả lời linked_account.

Là đối tác dữ liệu D2, bạn không thể gửi dữ liệu đến tài khoản người quản lý M1, tài khoản người quản lý M2 hoặc tài khoản khách hàng C2 vì không có mối liên kết đối tác giữa D2 và bất kỳ tài khoản nào trong số đó hoặc tài khoản người quản lý mẹ của các tài khoản đó.

Sự khác biệt chính giữa đối tác dữ liệu D1 và D2 là cách đối tác dữ liệu được liên kết với tài khoản Google Ads.

• Đối tác dữ liệu D1 được liên kết với một tài khoản người quản lý Google Ads. Đây là ví dụ về tình huống liên kết đối tác của người quản lý.
• Đối tác dữ liệu D2 được liên kết với một tài khoản khách hàng Google Ads. Đây là ví dụ về trường hợp liên kết đối tác trực tiếp.

Trường hợp liên kết trực tiếp với đối tác

Nếu bạn muốn gửi dữ liệu đến một tài khoản Google Ads và mối liên kết đối tác là giữa tài khoản Google Ads và tài khoản đối tác dữ liệu của bạn:

Nhập

Đích đến
operating_account	account_id Mã khách hàng của tài khoản Google Ads account_type GOOGLE_ADS
login_account	account_id Mã khách hàng của tài khoản đối tác dữ liệu account_type DATA_PARTNER
linked_account	Đừng đặt trường linked_account.
product_destination_id	Mã của đối tượng hoặc hành động chuyển đổi.

Quản lý tài nguyên

Tiêu đề của yêu cầu
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	Đừng đặt tiêu đề linked-account.

Dưới đây là ví dụ về trường hợp liên kết đối tác trực tiếp sử dụng tài khoản trong biểu đồ và tiêu đề của yêu cầu tương ứng cho các yêu cầu quản lý tài nguyên. Trong trường hợp này, đối tác dữ liệu D2 gửi dữ liệu thành viên trong phân khúc đối tượng đến khách hàng của khách hàng Google Ads C1 bằng cách sử dụng đường liên kết đối tác giữa D2 và C1, cũng như thông tin đăng nhập cho Tài khoản Google [e-mail]:

Nhập

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

Quản lý tài nguyên

Tiêu đề của yêu cầu
login-account	accountTypes/DATA_PARTNER/accounts/D2_CUSTOMER_ID
linked-account	Đừng đặt tiêu đề linked-account.

Trường hợp liên kết đối tác quản lý

Nếu bạn muốn gửi dữ liệu đến một tài khoản Google Ads và đường liên kết của đối tác là giữa tài khoản người quản lý Google Ads chính và tài khoản đối tác dữ liệu của bạn:

Nhập

Đích đến
operating_account	account_id Mã khách hàng của tài khoản khách hàng Google Ads account_type GOOGLE_ADS
login_account	account_id Mã khách hàng của tài khoản đối tác dữ liệu account_type DATA_PARTNER
linked_account	account_id Mã khách hàng của tài khoản người quản lý Google Ads account_type GOOGLE_ADS
product_destination_id	Mã của đối tượng hoặc hành động chuyển đổi.

Quản lý tài nguyên

Tiêu đề của yêu cầu
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID

Sau đây là ví dụ về trường hợp liên kết đối tác của người quản lý sử dụng các tài khoản trong biểu đồ. Trong trường hợp này, đối tác dữ liệu D1 gửi dữ liệu thành viên trong phân khúc đối tượng đến khách hàng của khách hàng Google Ads C2 bằng cách sử dụng đường liên kết của đối tác giữa D1 và M2, cũng như thông tin đăng nhập cho Tài khoản Google [e-mail]:

Nhập

{
  "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"
    }
  ]
}

Quản lý tài nguyên

Tiêu đề của yêu cầu
login-account	accountTypes/DATA_PARTNER/accounts/D1_CUSTOMER_ID
linked-account	accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID

Display & Video 360

Là đối tác dữ liệu, bạn có thể gửi dữ liệu đến tài khoản Display & Video 360 bằng hai phương pháp:

1. Sử dụng mối liên kết trực tiếp với đối tác giữa tài khoản đối tác dữ liệu và tài khoản đối tác hoặc nhà quảng cáo Display & Video 360.
2. Gửi dữ liệu đến một nhà quảng cáo Display & Video 360 bằng cách sử dụng đường liên kết đối tác giữa tài khoản đối tác dữ liệu và tài khoản đối tác Display & Video 360 chính của nhà quảng cáo.

Các trường hợp liên kết trực tiếp với đối tác

Nếu bạn muốn gửi dữ liệu đến một nhà quảng cáo Display & Video 360 và mối liên kết đối tác là giữa tài khoản nhà quảng cáo Display & Video 360 và tài khoản đối tác dữ liệu của bạn:

Nhập

Đích đến
operating_account	account_id Mã nhận dạng của tài khoản nhà quảng cáo Display & Video 360 account_type DISPLAY_VIDEO_ADVERTISER
login_account	account_id Mã khách hàng của tài khoản đối tác dữ liệu account_type DATA_PARTNER
linked_account	Đừng đặt trường linked_account.
product_destination_id	Mã của đối tượng hoặc hành động chuyển đổi.

Quản lý tài nguyên

Tiêu đề của yêu cầu
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	Đừng đặt tiêu đề linked-account.

Dưới đây là ví dụ về Destination cho trường hợp liên kết trực tiếp với đối tác để gửi dữ liệu đến một nhà quảng cáo Display & Video 360, và các tiêu đề yêu cầu tương ứng cho các yêu cầu quản lý tài nguyên:

Nhập

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

Quản lý tài nguyên

Tiêu đề của yêu cầu
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	Đừng đặt tiêu đề linked-account.

Nếu muốn gửi dữ liệu đến một tài khoản đối tác Display & Video 360, bạn phải có một mối liên kết đối tác giữa tài khoản đối tác Display & Video 360 và tài khoản đối tác dữ liệu của bạn.

Nhập

Đích đến
operating_account	account_id Mã nhận dạng của tài khoản đối tác Display & Video 360 account_type DISPLAY_VIDEO_PARTNER
login_account	account_id Mã khách hàng của tài khoản đối tác dữ liệu account_type DATA_PARTNER
linked_account	Đừng đặt trường linked_account.
product_destination_id	Mã của đối tượng hoặc hành động chuyển đổi.

Quản lý tài nguyên

Tiêu đề của yêu cầu
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	Đừng đặt tiêu đề linked-account.

Dưới đây là ví dụ về Destination cho trường hợp liên kết đối tác trực tiếp để gửi dữ liệu đến đối tác Display & Video 360 và tiêu đề của yêu cầu tương ứng cho các yêu cầu quản lý tài nguyên:

Nhập

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

Quản lý tài nguyên

Tiêu đề của yêu cầu
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	Đừng đặt tiêu đề linked-account.

Trường hợp liên kết với đối tác mẹ

Nếu bạn muốn gửi dữ liệu đến một nhà quảng cáo Display & Video 360 và đường liên kết đối tác đến tài khoản đối tác dữ liệu của bạn là với một tài khoản đối tác Display & Video 360, trong đó tài khoản nhà quảng cáo là tài khoản con:

Nhập

Đích đến
operating_account	account_id Mã nhận dạng của tài khoản nhà quảng cáo Display & Video 360 account_type DISPLAY_VIDEO_ADVERTISER
login_account	account_id Mã khách hàng của tài khoản đối tác dữ liệu account_type DATA_PARTNER
linked_account	account_id Mã nhận dạng của tài khoản đối tác Display & Video 360 account_type DISPLAY_VIDEO_PARTNER
product_destination_id	Mã của đối tượng hoặc hành động chuyển đổi.

Quản lý tài nguyên

Tiêu đề của yêu cầu
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID

Sau đây là ví dụ về Destination cho trường hợp liên kết đối tác để gửi dữ liệu đến một nhà quảng cáo Display & Video 360 bằng cách sử dụng mối liên kết đối tác giữa đối tác dữ liệu và đối tác Display & Video 360 chính của nhà quảng cáo:

Nhập

{
  "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"
    }
  ]
}

Quản lý tài nguyên

Tiêu đề của yêu cầu
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID

Google Ad Manager

Nếu bạn muốn gửi dữ liệu đến một tài khoản Google Ad Manager và bạn có đường liên kết đối tác giữa tài khoản đối tác dữ liệu và tài khoản Google Ad Manager:

Nhập

Đích đến
operating_account	account_id Mã liên kết đối tượng của tài khoản Google Ad Manager account_type GOOGLE_AD_MANAGER_AUDIENCE_LINK
login_account	account_id Mã khách hàng của tài khoản đối tác dữ liệu account_type DATA_PARTNER
linked_account	Đừng đặt trường linked_account.
product_destination_id	Mã nhận dạng của đối tượng.

Quản lý tài nguyên

Tiêu đề của yêu cầu
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	Đừng đặt tiêu đề linked-account.

Dưới đây là ví dụ về Destination để gửi dữ liệu đến một tài khoản Google Ad Manager bằng đường liên kết của đối tác:

Nhập

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

Quản lý tài nguyên

Tiêu đề của yêu cầu
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	Đừng đặt tiêu đề linked-account.

Google Analytics

Data Manager API không hỗ trợ việc gửi dữ liệu đến tài khoản Google Analytics bằng đường liên kết của đối tác. Thay vào đó, hãy sử dụng phương pháp các trường hợp của nhà quảng cáo cho Google Analytics.

Floodlight

Data Manager API không hỗ trợ việc gửi dữ liệu đến một cấu hình Floodlight bằng đường liên kết của đối tác. Thay vào đó, hãy sử dụng phương pháp các trường hợp của nhà quảng cáo cho Floodlight.

Yêu cầu chi tiết

Phần này trình bày các yêu cầu chi tiết đối với trường tài khoản của Destination cho một yêu cầu IngestionService, tiêu đề của yêu cầu tương đương cho yêu cầu quản lý tài nguyên, mẹo về cách đặt product_destination_id và cách xác định nơi thông tin xác thực của bạn có quyền truy cập.

Trường tài khoản

Một Destination có thể có tối đa 3 tài khoản khác nhau:

operating_account

operating_account là trường bắt buộc.

operating_account cho biết tài khoản nào nhận dữ liệu trong yêu cầu. operating_account có thể là bất kỳ giá trị nào sau đây:

• Tài khoản Google Ads
• Tài khoản nhà quảng cáo Display & Video 360
• Tài khoản đối tác Display & Video 360
• Tài khoản Google Ad Manager
• Tài sản Google Analytics
• Tài khoản đối tác dữ liệu nếu gửi dữ liệu đến một đối tượng thuộc sở hữu của tài khoản đối tác dữ liệu.

Không có tiêu đề của yêu cầu nào tương ứng với trường operating_account của Destination. Khi gửi yêu cầu quản lý tài nguyên, tài khoản mục tiêu của yêu cầu là tài khoản điều hành.

Trường login_account và tiêu đề của yêu cầu login-account

Bạn không phải lúc nào cũng cần login_account và giá trị mặc định là operating_account trong yêu cầu IngestionService và tài khoản mục tiêu trong yêu cầu quản lý tài nguyên. Trong yêu cầu quản lý tài nguyên, hãy sử dụng tiêu đề của yêu cầu login-account để xác định tài khoản đăng nhập.

Data Manager API xác minh rằng:

1. Tài khoản Google của thông tin đăng nhập là một người dùng trong tài khoản đăng nhập.

2. Tài khoản đăng nhập là một trong những tài khoản sau:

   • Tương tự như operating_account. Đây là giá trị mặc định nếu bạn không đặt login_account của Destination trong yêu cầu IngestionService hoặc không đặt tiêu đề login-account trong yêu cầu quản lý tài nguyên.

   • Tài khoản người quản lý Google Ads hoặc đối tác Display & Video 360 là tài khoản mẹ của operating_account trong yêu cầu IngestionService hoặc là tài khoản mẹ của tài khoản mục tiêu trong yêu cầu quản lý tài nguyên.

   • Tài khoản đối tác dữ liệu có đường liên kết của đối tác đến linked_account trong yêu cầu IngestionService, hoặc tiêu đề linked-account trong yêu cầu quản lý tài nguyên.

Trường linked_account và tiêu đề của yêu cầu linked-account

Lưu ý: Chỉ chỉ định tài khoản được liên kết nếu tài khoản đăng nhập có account_type được đặt thành DATA_PARTNER và tài khoản mẹ của operating_account được liên kết với tài khoản đối tác dữ liệu. Nếu operating_account được liên kết trực tiếp với tài khoản đối tác dữ liệu, đừng đặt linked_account.

linked_account cho biết tài khoản nào có mối liên kết đối tác với login_account của yêu cầu IngestionService hoặc tài khoản mục tiêu của yêu cầu quản lý tài nguyên.

Mã đích đến của sản phẩm

product_destination_id của Destination xác định đối tượng nào trong operating_account nhận dữ liệu. Ví dụ: đây có thể là mã đối tượng cho Google Ads hoặc Display & Video 360, mã hành động chuyển đổi cho Google Ads hoặc mã đo lường cho luồng dữ liệu Google Analytics.

Sau đây là cách tìm mã nhận dạng cho từng loại vị trí xuất hiện của sản phẩm.

Đối tượng trên Google Ads

Mã đích đến của sản phẩm để nhập thành viên trong phân khúc đối tượng là mã đối tượng. Truy xuất mã này bằng giao diện người dùng Google Ads hoặc Data Manager API.

Giao diện người dùng Google Ads

Cách lấy mã đối tượng từ giao diện người dùng Google Ads:

1. Chuyển đến Công cụ quản lý đối tượng trong giao diện người dùng Google Ads.
2. Nhấp vào tên đối tượng để xem thông tin chi tiết.
3. Mã đối tượng được liệt kê bên cạnh Mã danh sách.

Data Manager API

Truy xuất UserList bằng phương thức List, cung cấp tiêu đề của yêu cầu nếu cần và sử dụng id của UserList cho mã nhận dạng đích đến của sản phẩm.

Sự kiện trên Google Ads

Mã đích đến của sản phẩm để nhập sự kiện là mã hành động chuyển đổi. Truy xuất mã nhận dạng này bằng giao diện người dùng Google Ads hoặc API Google Ads.

Giao diện người dùng Google Ads

Cách lấy mã hành động chuyển đổi từ giao diện người dùng Google Ads:

1. Chuyển đến mục Lượt chuyển đổi trong giao diện người dùng Google Ads.
2. Nhấp vào tên hành động chuyển đổi.
3. Chuyển tới thẻ Chi tiết.
4. Mã hành động chuyển đổi là số bên cạnh Mã loại chuyển đổi.

API Google Ads

Cách lấy mã hành động chuyển đổi từ Google Ads API:

1. Gửi yêu cầu Search hoặc SearchStream đến GoogleAdsService bằng truy vấn sau:

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

2. Lấy mã hành động chuyển đổi từ trường id trong conversion_action trong phản hồi.

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

Đối tượng Display & Video 360

Mã đích đến của sản phẩm để nhập thành viên trong phân khúc đối tượng là mã đối tượng. Truy xuất mã này bằng giao diện người dùng Display & Video 360 hoặc Data Manager API.

Giao diện người dùng của Display & Video 360

Cách lấy mã đối tượng từ giao diện người dùng Display & Video 360:

1. Đăng nhập vào giao diện người dùng của Display & Video 360 tại https://displayvideo.google.com.
2. Chuyển đến đối tác hoặc nhà quảng cáo Display & Video 360 mà bạn đang sử dụng cho operating_account.
3. Chuyển đến mục Đối tượng trên trình đơn bên trái, rồi chọn Tất cả đối tượng.
4. Tìm đối tượng trong danh sách. Mã đối tượng là số bên cạnh tên trong cột Tên.

Data Manager API

Truy xuất UserList bằng phương thức List, cung cấp tiêu đề của yêu cầu nếu cần và sử dụng id của UserList cho mã nhận dạng đích đến của sản phẩm.

Sự kiện trong Google Analytics

Mã đích đến của sản phẩm phụ thuộc vào loại luồng dữ liệu.

Luồng dữ liệu web

Sử dụng mã đo lường của luồng dữ liệu.

Luồng dữ liệu ứng dụng

Sử dụng Mã ứng dụng Firebase của luồng dữ liệu. Sau đây là hai cách để tìm Mã ứng dụng Firebase:

• Trong giao diện người dùng của Google Analytics, hãy chuyển đến mục Luồng dữ liệu, nhấp vào luồng dữ liệu rồi tìm MÃ ỨNG DỤNG FIREBASE.
• Sử dụng bảng điều khiển của Firebase.

Sự kiện Floodlight

Mã đích đến của sản phẩm để nhập sự kiện vào Floodlight là mã hoạt động Floodlight. Truy xuất mã nhận dạng này bằng giao diện người dùng Campaign Manager 360 hoặc Campaign Manager 360 API.

Giao diện người dùng của Campaign Manager 360

Cách lấy mã hoạt động Floodlight từ giao diện người dùng Campaign Manager 360:

1. Đăng nhập vào giao diện người dùng của Campaign Manager 360.
2. Chuyển đến nhà quảng cáo Campaign Manager 360 mà bạn đang sử dụng cho operating_account.
3. Chuyển đến Floodlight trên trình đơn bên trái, sau đó chọn Hoạt động.
4. Tìm hoạt động Floodlight trong danh sách. Mã nhận dạng là số bên cạnh tên trong cột Tên hoạt động.

Campaign Manager 360 API

Cách lấy mã hoạt động Floodlight từ Campaign Manager 360 API:

1. Gửi yêu cầu list đến tài nguyên floodlightActivities.
2. Chỉ định floodlightConfigurationId của cấu hình Floodlight.
3. Bạn có thể sử dụng tham số searchString để lọc theo tên hoạt động.
4. Lấy mã hoạt động Floodlight từ trường id của FloodlightActivity đã chọn trong phản hồi.

Xác định nơi thông tin xác thực có quyền truy cập

Thông tin đăng nhập mà bạn dùng để uỷ quyền cho một yêu cầu API Trình quản lý dữ liệu được liên kết với một Tài khoản Google cụ thể.

• Nếu bạn sử dụng thông tin xác thực của người dùng, thì các yêu cầu sẽ được uỷ quyền dưới dạng Tài khoản Google của người dùng đã cấp quyền thay mặt họ khi bạn tạo thông tin xác thực.
• Nếu bạn sử dụng thông tin đăng nhập tài khoản dịch vụ, thì các yêu cầu sẽ được uỷ quyền dưới dạng Tài khoản Google của tài khoản dịch vụ.

Sau đây là cách xác minh rằng Tài khoản Google cho thông tin xác thực của bạn có quyền truy cập vào tài khoản Google Ads, Display & Video 360, Google Analytics hoặc Campaign Manager 360.

Google Ads hoặc đối tác dữ liệu

1. Chuyển đến mục Quyền truy cập và bảo mật trong giao diện người dùng Google Ads cho login_account.
2. Chọn thẻ Người dùng.
3. Nếu login_account là tài khoản người quản lý Google Ads, hãy tắt nút bật/tắt Hiển thị người dùng trong toàn bộ thứ bậc để ẩn người dùng khỏi các tài khoản con.
4. Xác minh rằng Tài khoản Google cho thông tin đăng nhập của bạn nằm trong danh sách tài khoản hiển thị trên thẻ Người dùng.

Display & Video 360

1. Chuyển đến mục Quản lý người dùng và lựa chọn ưu tiên về email trong giao diện người dùng Display & Video 360.
2. Xác minh rằng trang Quản lý người dùng cho thấy Tài khoản Google cho thông tin đăng nhập của bạn là người dùng trên login_account.

Google Analytics

1. Chuyển đến mục Quản lý quyền truy cập vào tài sản trong giao diện người dùng Google Analytics.
2. Xác nhận rằng bạn đã chọn tài sản Google Analytics được chỉ định trong login_account.
3. Xác minh rằng Tài khoản Google cho thông tin đăng nhập của bạn có vai trò Người chỉnh sửa hoặc Quản trị viên đối với tài sản.

Floodlight (Campaign Manager 360)

1. Đăng nhập vào giao diện người dùng của Campaign Manager 360.
2. Chuyển đến mục Quản trị > Hồ sơ người dùng trong trình đơn bên trái.
3. Xác minh rằng Tài khoản Google cho thông tin đăng nhập của bạn có trong danh sách hồ sơ hiển thị.
4. Nhấp vào hồ sơ và xác minh rằng hồ sơ đó có quyền truy cập vào tài khoản nhà quảng cáo được dùng làm login_account. Nếu bạn không đặt login_account trong yêu cầu, thì giá trị mặc định sẽ là operating_account. Đảm bảo tài khoản có vai trò người dùng có quyền Chèn lượt chuyển đổi ngoại tuyến.