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

Cả khái niệm Destination và tiêu đề yêu cầu đều xuất hiện thường xuyên khi bạn 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 nhiều trường hợp.

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

• Sử dụng Destination trong yêu cầu truyền dữ liệu. Yêu cầu tiếp nhận 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ư hành động chuyển đổi trên Google Ads hoặc luồng dữ liệu Google Analytics.
  3. Đường dẫn truy cập cho thông tin đăng nhập 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 truyền tải.

• Sử dụng tiêu đề 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 đăng nhập 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. Sau đâ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 đề 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ì đây là từng bước, loại yêu cầu cần sử dụng và liệu bạn có nên sử dụng đích đến hay tiêu đề yêu cầu:

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ẻ Truyền nhận 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 công ty quảng cáo, hãy chuyển đế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

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 thiết lập 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 đến sản phẩm với tài khoản đối tác dữ liệu của bạn:

• Google Ads
• Display & Video 360
• Google Analytics

Mục Yêu cầu chi tiết trình bày kỹ lưỡng các yêu cầu và quy tắc xác thực.

Các tình huống của nhà quảng cáo

Sau đây là cách định cấu hình Destination hoặc tiêu đề 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 Data Manager API sử dụng các trường thông tin xác thực và Destination để truy cập vào tài khoản của nhà quảng cáo.

Google Ads

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

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

M1 có 2 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 cloudysanfrancisco@gmail.com là một người dùng trong M1.

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

M2 có 2 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 baklavainthebalkans@gmail.com là một người dùng trong M2.

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

C1 có 2 tài khoản người quản lý chính 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 jeffersonloveshiking@gmail.com 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 gốc 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 đích đến để gửi dữ liệu đến các tài khoản này.

Kịch bản 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à cho một Tài khoản Google là người dùng trong tài khoản Google Ads:

Sau đây là ví dụ về một trường hợp truy cập trực tiếp, sử dụng các tài khoản trong sơ đồ và thông tin đăng nhập cho Tài khoản 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"
    }
  ]
}

Trường hợp cấp quyền 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à cho một Tài khoản Google là người dùng trong một 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:

Dưới đây là ví dụ về trường hợp cấp quyền truy cập của người quản lý cho tài khoản khách hàng Google Ads C2 trong sơ đồ và thông tin đăng nhập cho Tài khoản 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"
    }
  ]
}

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 C2 trên Google Ads và thông tin đăng nhập cho Tài khoản Google cloudysanfrancisco@gmail.com, là một người dùng trên tài khoản người quản lý M1 trên Google Ads:

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

Display & Video 360

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

1. Quyền truy cập trực tiếp, trong đó thông tin đăng nhập là cho một Tài khoản Google là người dùng trong tài khoản đối tác hoặc tài khoản 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à cho 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 hoạt động là tài khoản nhà quảng cáo Display & Video 360 trong 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 tài khoản nhà quảng cáo Display & Video 360 và thông tin đăng nhập của bạn là cho một Tài khoản Google là người dùng trong tài khoản nhà quảng cáo:

Sau đâ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 trên Display & Video 360:

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

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

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

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

Trường hợp cấp quyền truy cập cho đố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 trên Display & Video 360 và thông tin đăng nhập của bạn là cho 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:

Sau đây là ví dụ về Destination cho trường hợp cấp quyền truy cập cho đối tác để gửi dữ liệu đến một nhà quảng cáo trên 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.

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

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 login_account thành các giá trị giống như operating_account. Nếu không, yêu cầu sẽ không thành công và trả về lỗi OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH.

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

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

Các trường hợp sử dụng đố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 một đối tác dữ liệu gửi dữ liệu đến tài khoản của nhà quảng cáo có mối liên kết sản phẩm đã thiết lập với 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 của nhà quảng cáo thông qua một mối liên kết đến sản phẩm.

Google Ads

Sau đây là sơ đồ minh hoạ 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 đối tác dữ liệu, cũng như các mối liên kết sản phẩm giữa các tài khoản.

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

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

Tài khoản Google 222larabrown@gmail.com 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 sản phẩm giữa D2 và tài khoản khách hàng C1 trên Google Ads.

Tài khoản Google jeffersonloveshiking@gmail.com là một người dùng trong D2.

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

M1 có 2 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ó 2 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ó 2 tài khoản người quản lý chính 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 gốc trực tiếp duy nhất của C2.

Bạn có thể làm những việc sau 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 cho Tài khoản Google 222larabrown@gmail.com để gửi dữ liệu đến tài khoản người quản lý M2, tài khoản khách hàng C1 hoặc tài khoản khách hàng C2, bằng cách 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.

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 sản phẩm 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 jeffersonloveshiking@gmail.com để 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 và linked_account được đặt thành tài khoản khách hàng C1.

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 sản phẩm nào 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ý chính của các tài khoản đó.

Sự khác biệt chính giữa các đố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ề trường hợp liên kết sản phẩm 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 đường liên kết trực tiếp đến sản phẩm.

Trường hợp đường liên kết trực tiếp đến sản phẩm

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 sản phẩm là giữa tài khoản Google Ads và tài khoản đối tác dữ liệu của bạn:

Sau đây là ví dụ về một trường hợp liên kết trực tiếp đến sản phẩm bằng cách sử dụng các tài khoản trong sơ đồ 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. Trong trường hợp này, đối tác dữ liệu D2 gửi dữ liệu về thành viên đối tượng cho khách hàng C1 của Google Ads bằng cách sử dụng mối liên kết sản phẩm giữa D2 và C1, cũng như thông tin đăng nhập cho Tài khoản Google jeffersonloveshiking@gmail.com:

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

Tình huống liên kết sản phẩm 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à mối liên kết sản phẩm là giữa một tài khoản người quản lý Google Ads mẹ và tài khoản đối tác dữ liệu của bạn:

Sau đây là ví dụ về một trường hợp liên kết sản phẩm của người quản lý bằng cách sử dụng các tài khoản trong sơ đồ. Trong trường hợp này, đối tác dữ liệu D1 gửi dữ liệu thành viên đối tượng đến khách hàng C2 của Google Ads bằng cách sử dụng mối liên kết sản phẩm giữa D1 và M2, cũng như thông tin đăng nhập cho Tài khoản Google 222larabrown@gmail.com:

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

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 giữa tài khoản đối tác dữ liệu và tài khoản đối tác hoặc tài khoản 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 mối liên kết sản phẩm 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 sử dụng đường liên kết trực tiếp đến sản phẩm

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

Sau đây là ví dụ về Destination cho trường hợp liên kết trực tiếp đến sản phẩm để 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:

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

Nếu muốn gửi dữ liệu đến tài khoản đối tác Display & Video 360, bạn phải có mối liên kết sản phẩm 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 mình.

Sau đây là ví dụ về một Destination cho trường hợp liên kết trực tiếp đến sản phẩm để gửi dữ liệu cho một đối tác 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:

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

Tình huống liên kết sản phẩm 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 trên Display & Video 360 và đường liên kết đến sản phẩm trong 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 trên Display & Video 360, trong đó tài khoản nhà quảng cáo là tài khoản phụ:

Sau đây là ví dụ về một Destination cho trường hợp liên kết sản phẩm của đố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 sản phẩm giữa đối tác dữ liệu và đối tác Display & Video 360 chính của nhà quảng cáo:

{
  "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 Analytics

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

Các yêu cầu chi tiết

Phần này chứa các yêu cầu chi tiết đối với các trường tài khoản của một Destination cho yêu cầu IngestionService, các tiêu đề yêu cầu tương đương cho yêu cầu quản lý tài nguyên, các mẹo về cách đặt product_destination_id và cách xác định nơi thông tin đăng nhập 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:

operating_account

Bạn bắt buộc phải nhập operating_account.

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 của nhà quảng cáo Display & Video 360
• Tài khoản đối tác Display & Video 360
• Một 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 quyền sở hữu của tài khoản đối tác dữ liệu.

Không có tiêu đề 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 hoạt động.

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

login_account không phải lúc nào cũng bắt buộc và 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 đề 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 thuộc một trong những loại sau:

   • Giống 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.

   • Một người quản lý Google Ads hoặc tài khoản đối tác Display & Video 360 là tài khoản mẹ của operating_account trong yêu cầu IngestionService hoặc 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 đến sản phẩm 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 đề yêu cầu linked-account

Biểu tượng linked_account cho biết tài khoản nào có mối liên kết sản phẩm 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 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ã nhận dạng đối tượng cho Google Ads hoặc Display & Video 360, mã nhận dạng hành động chuyển đổi cho Google Ads hoặc mã nhận dạng đo lường cho một 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ã nhận dạng đích của sản phẩm để thu nạp thành viên đối tượng là mã nhận dạng đối tượng. Truy xuất mã nhận dạng 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 trên 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 nằm 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 đề 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ã nhận dạng đích đến của sản phẩm để thu nạp sự kiện là mã nhận dạng hành động chuyển đổi.

Cách lấy mã hành động chuyển đổi trên 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 để xem thông tin chi tiết.

3. Mã hành động chuyển đổi là giá trị cho tham số truy vấn URL có tên là ctId.

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

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

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ã nhận dạng đích của sản phẩm để thu nạp thành viên đối tượng là mã nhận dạng đối tượng. Truy xuất mã nhận dạng 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 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 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 Đối tượng trong 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 đề 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ã nhận dạng đích đến của sản phẩm để tiếp nhận sự kiện là mã đo lường của luồng dữ liệu.

Xác định nơi thông tin đăng nhập 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 Data Manager API đượ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 đăng nhập 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 đăng nhập.
• Nếu bạn sử dụng thông tin đăng nhập vào 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ụ.

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

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 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 có trong danh sách tài khoản xuất hiện trên thẻ Người dùng.

Display & Video 360

1. Chuyển đến phần 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 mục Quản lý người dùng cho biết Tài khoản Google cho thông tin đăng nhập của bạn là một người dùng trên login_account.

Google Analytics

1. Chuyển đến phần 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.