Thiết lập đích đến

Mỗi Destination 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 trên 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.

Nếu bạn là nhà quảng cáo hoặc công ty quảng cáo, 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ạo Destination:

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ạo Destination để gửi dữ liệu đến một tài khoản có đườ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:

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 thiết lập Destination 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.

Đường dẫn truy cập 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 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ếpTrườ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:

Đí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 không đặt login_account hoặc đặt thành cùng 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 hoặc hành động chuyển đổi.

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 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:

Đí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ã nhận dạng của đối tượng hoặc hành động chuyển đổi.

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:

Đí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 không đặt login_account hoặc đặt thành cùng 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.

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": "ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "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:

Đí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 không đặt login_account hoặc đặt thành cùng 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.

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": "PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "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:

Đí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.

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 PARTNER_ID và tài khoản nhà quảng cáo Display & Video 360 ADVERTISER_ID phải là tài khoản con của tài khoản đối tác PARTNER_ID.

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

Google Analytics

Lưu ý: operating_accountlogin_account phải giống nhau khi đích đến là một tài khoản Google Analytics. 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.

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

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.

Đường dẫn truy cập của đối tác dữ liệu

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 tài khoản đố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, tài khoản Google Ads và người dùng

Đố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.

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:

Đí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ã nhận dạng của đối tượng hoặc hành động chuyển đổi.

Sau đây là ví dụ về một trường hợp sử dụng đường liên kết trực tiếp đến sản phẩm bằng các tài khoản trong sơ đồ. 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 đến 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:

Đí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ã nhận dạng của đối tượng hoặc hành động chuyển đổi.

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 một 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.

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:

Đí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ã nhận dạng của đối tượng hoặc hành động chuyển đổi.

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:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "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.

Đí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ã nhận dạng của đối tượng hoặc hành động chuyển đổi.

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 đối tác Display & Video 360:

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

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ụ:

Đí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ã nhận dạng của đối tượng hoặc hành động chuyển đổi.

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 Destination, 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:

login_account

Không phải lúc nào bạn cũng cần login_account và mặc định là operating_account.

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 login_account.

  2. login_account là một trong những giá trị sau:

    • Giống như operating_account. Đây là giá trị mặc định nếu bạn không đặt login_account.

    • Một 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.

    • Một tài khoản đối tác dữ liệu có đường liên kết đến sản phẩm linked_account.

linked_account

linked_account cho biết tài khoản nào có đường liên kết đến sản phẩm login_account.

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.

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.

Cách lấy mã đối tượng từ API Google Ads:

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

    SELECT
      user_list.id,
      user_list.name
    FROM user_list
    WHERE user_list.name = 'USER_LIST_NAME'
    
  2. Lấy mã nhận dạng đối tượng từ trường id trong user_list trong phản hồi.

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

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.

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.

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 phần 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.