این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

پیکربندی مقصدها

هر Destination در یک IngestAudienceMembersRequest یا IngestEventsRequest موارد زیر را تعریف می‌کند:

حسابی که داده‌ها را دریافت می‌کند. به عنوان مثال، یک حساب Google Ads یا یک ویژگی Google Analytics.
موجودیت مقصد برای داده‌های درون حساب، مانند یک اقدام تبدیل گوگل ادز یا یک جریان گوگل آنالیتیکس.
مسیر دسترسی برای اعتبارنامه‌های درخواست به حسابی که داده‌ها را دریافت می‌کند.

اگر تبلیغ‌کننده یا آژانس هستید ، برای مثال‌هایی از نحوه‌ی ساخت یک Destination ، به سناریوهای تبلیغ‌کننده مراجعه کنید:

تبلیغات گوگل
نمایش و ویدئو ۳۶۰
گوگل آنالیتیکس

اگر شما یک شریک داده هستید ، برای مثال‌هایی از نحوه ساخت یک Destination برای ارسال داده به یک حساب با لینک محصول به حساب شریک داده خود، به سناریوهای شریک داده بروید:

تبلیغات گوگل
نمایش و ویدئو ۳۶۰
گوگل آنالیتیکس

بخش الزامات تفصیلی، الزامات و قوانین اعتبارسنجی را به طور مفصل پوشش می‌دهد.

سناریوهای تبلیغ‌کننده

در اینجا نحوه پیکربندی یک Destination برای سناریوهای رایج برای تبلیغ‌کنندگان و آژانس‌ها آورده شده است. این نمودار نشان می‌دهد که چگونه API مدیریت داده از فیلدهای اعتبارنامه و Destination برای دسترسی به حساب تبلیغ‌کننده استفاده می‌کند.

مسیر دسترسی تبلیغ‌کننده

تبلیغات گوگل

در اینجا نموداری آورده شده است که نمونه‌ای از مجموعه‌ای از حساب‌ها و کاربران گوگل ادز را نشان می‌دهد.

حساب‌ها و کاربران گوگل ادز

حساب مدیر M1

M1 دو حساب فرزند مستقیم دارد:

حساب مدیر M2
حساب مشتری C1

حساب گوگل cloudysanfrancisco@gmail.com یک کاربر در M1 است.

حساب مدیر M2

M2 دو حساب فرزند مستقیم دارد:

حساب مشتری C1
حساب مشتری C2

حساب گوگل baklavainthebalkans@gmail.com یک کاربر در M2 است.

حساب مشتری C1

C1 دو حساب مدیر مستقیم والدین دارد:

حساب مدیر M1
حساب مدیر M2

حساب گوگل jeffersonloveshiking@gmail.com کاربری در C1 است.

حساب مشتری C2

حساب مدیر M2 تنها والد مستقیم C2 است.

هیچ یک از حساب‌های گوگل ذکر شده، کاربری در C2 نیستند.

سناریوی دسترسی مستقیم و سناریوی دسترسی مدیر نشان می‌دهد که چگونه یک مقصد را برای ارسال داده‌ها به این حساب‌ها پیکربندی می‌کنید.

سناریوی دسترسی مستقیم

اگر می‌خواهید داده‌ها را به یک حساب Google Ads ارسال کنید و اطلاعات کاربری شما مربوط به یک حساب Google است که کاربر حساب Google Ads است:

مقصد

operating_account

`account_id`	شناسه مشتری حساب گوگل ادز
`account_type`	`GOOGLE_ADS`

login_account یا login_account را تنظیم نکنید، یا روی همان مقادیر operating_account تنظیم کنید.

linked_account فیلد linked_account را تنظیم نکنید.

product_destination_id شناسه مخاطب یا اقدام تبدیل.

در اینجا مثالی از سناریوی دسترسی مستقیم، با استفاده از حساب‌های موجود در نمودار و اعتبارنامه‌های حساب گوگل jeffersonloveshiking@gmail.com آورده شده است.

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

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

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

سناریوی دسترسی مدیر

اگر می‌خواهید داده‌ها را به یک حساب Google Ads ارسال کنید و اطلاعات کاربری شما مربوط به یک حساب Google است که کاربر آن در یک حساب مدیر Google Ads است که در آن حساب تبلیغ‌کننده یک حساب فرزند است:

مقصد

operating_account

`account_id`	شناسه مشتری حساب کاربری گوگل ادز
`account_type`	`GOOGLE_ADS`

login_account

`account_id`	شناسه مشتری حساب مدیر تبلیغات گوگل
`account_type`	`GOOGLE_ADS`

linked_account فیلد linked_account را تنظیم نکنید.

product_destination_id شناسه مخاطب یا اقدام تبدیل.

در اینجا مثالی از سناریوی دسترسی مدیر برای حساب کاربری گوگل ادز C2 از نمودار و اعتبارنامه‌های حساب گوگل baklavainthebalkans@gmail.com آورده شده است:

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

در اینجا مثال دیگری از سناریوی دسترسی مدیر برای حساب کاربری گوگل ادز C2 و اطلاعات کاربری برای حساب گوگل cloudysanfrancisco@gmail.com که کاربری در حساب کاربری گوگل ادز M1 است، آورده شده است:

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

نمایش و ویدئو ۳۶۰

شما می‌توانید با استفاده از دو رویکرد، داده‌ها را به Display & Video 360 ارسال کنید:

دسترسی مستقیم، که در آن اطلاعات احراز هویت مربوط به یک حساب گوگل است که کاربر در حساب تبلیغ‌کننده یا شریک Display & Video 360 است.
دسترسی به شریک Display & Video 360، که در آن اطلاعات کاربری مربوط به یک حساب گوگل است که کاربر در حساب شریک Display & Video 360 است و حساب عملیاتی، یک حساب تبلیغ‌کننده Display & Video 360 تحت حساب شریک است.

سناریوهای دسترسی مستقیم

اگر می‌خواهید داده‌ها را به یک حساب تبلیغ‌کننده Display & Video 360 ارسال کنید و اطلاعات کاربری شما مربوط به یک حساب Google است که کاربر آن حساب تبلیغ‌کننده است:

مقصد

operating_account

`account_id`	شناسه حساب تبلیغ‌کننده Display & Video 360
`account_type`	`DISPLAY_VIDEO_ADVERTISER`

login_account یا login_account را تنظیم نکنید، یا روی همان مقادیر operating_account تنظیم کنید.

linked_account فیلد linked_account را تنظیم نکنید.

product_destination_id شناسنامه مخاطب.

در اینجا مثالی از یک Destination برای سناریوی دسترسی مستقیم برای ارسال داده‌ها به یک تبلیغ‌کننده Display & Video 360 آورده شده است:

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

به همین ترتیب، اگر می‌خواهید داده‌ها را به یک حساب همکار Display & Video 360 ارسال کنید و اطلاعات کاربری شما مربوط به یک حساب گوگل است که کاربر آن حساب همکار است:

مقصد

operating_account

`account_id`	شناسه حساب کاربری همکار Display & Video 360
`account_type`	`DISPLAY_VIDEO_PARTNER`

login_account یا login_account را تنظیم نکنید، یا روی همان مقادیر operating_account تنظیم کنید.

linked_account فیلد linked_account را تنظیم نکنید.

product_destination_id شناسنامه مخاطب.

در اینجا مثالی از یک Destination برای سناریوی دسترسی مستقیم برای ارسال داده به یک شریک Display & Video 360 آورده شده است:

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

سناریوی دسترسی شریک نمایش و ویدئو ۳۶۰

اگر می‌خواهید داده‌ها را به یک تبلیغ‌کننده Display & Video 360 ارسال کنید و اطلاعات کاربری شما مربوط به یک حساب گوگل است که در حساب همکار Display & Video 360 والد تبلیغ‌کننده قرار دارد:

مقصد

operating_account

`account_id`	شناسه حساب تبلیغ‌کننده Display & Video 360
`account_type`	`DISPLAY_VIDEO_ADVERTISER`

login_account

`account_id`	شناسه حساب کاربری همکار Display & Video 360
`account_type`	`DISPLAY_VIDEO_PARTNER`

linked_account فیلد linked_account را تنظیم نکنید.

product_destination_id شناسنامه مخاطب.

در اینجا مثالی از سناریوی دسترسی Destination برای یک شریک» برای ارسال داده‌ها به یک تبلیغ‌کننده Display & Video 360 آورده شده است. در این سناریو، اعتبارنامه‌ها باید برای یک حساب گوگل باشد که کاربر در حساب شریک Display & Video 360 با PARTNER_ID است و حساب تبلیغ‌کننده Display & Video 360 ADVERTISER_ID باید فرزند حساب شریک PARTNER_ID باشد.

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

گوگل آنالیتیکس

نکته: اگر مقصد یک حساب گوگل آنالیتیکس باشد، مقادیر operating_account و login_account باید یکسان باشند. در غیر این صورت، درخواست با خطای OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH با شکست مواجه می‌شود.

مقصد

operating_account

`account_id`	شناسه‌ی ویژگی گوگل آنالیتیکس
`account_type`	`GOOGLE_ANALYTICS_PROPERTY`

login_account یا login_account را تنظیم نکنید، یا روی همان مقادیر operating_account تنظیم کنید.

linked_account فیلد linked_account را تنظیم نکنید.

product_destination_id شناسه اندازه‌گیری جریان داده.

در اینجا مثالی از یک Destination برای ارسال رویدادها به گوگل آنالیتیکس آورده شده است:

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

سناریوهای شریک داده

در اینجا نحوه پیکربندی یک Destination برای سناریوهای رایج برای یک شریک داده که داده‌ها را به حساب‌های تبلیغ‌کننده با یک لینک محصول مشخص به حساب شریک داده ارسال می‌کند، آورده شده است.

این نمودار نشان می‌دهد که چگونه رابط برنامه‌نویسی کاربردی (API) مدیریت داده (Data Manager API) از فیلدهای اعتبارنامه و Destination برای دسترسی به حساب تبلیغ‌کننده از طریق لینک محصول استفاده می‌کند.

مسیر دسترسی شریک داده

تبلیغات گوگل

در اینجا نموداری آمده است که نمونه‌ای از مجموعه‌ای از حساب‌های کاربری تبلیغات گوگل و شرکای داده را نشان می‌دهد. این نمودار همچنین نشان می‌دهد که کدام حساب گوگل، کاربر هر حساب کاربری تبلیغات گوگل یا شرکای داده است و همچنین پیوندهای محصول بین حساب‌ها را نیز نشان می‌دهد.

حساب‌ها و کاربران شرکای داده و تبلیغات گوگل

شریک داده D1

یک لینک محصول بین D1 و حساب مدیریت تبلیغات گوگل M2 وجود دارد.

حساب گوگل 222larabrown@gmail.com ‎ یک کاربر در D1 است.

شریک داده D2

یک لینک محصول بین D2 و حساب کاربری گوگل ادز C1 وجود دارد.

حساب گوگل jeffersonloveshiking@gmail.com یک کاربر در D2 است.

حساب مدیر M1

M1 دو حساب فرزند مستقیم دارد:

حساب مدیر M2
حساب مشتری C1

حساب مدیر M2

M2 دو حساب فرزند مستقیم دارد:

حساب مشتری C1
حساب مشتری C2

حساب مشتری C1

C1 دو حساب مدیر مستقیم والدین دارد:

حساب مدیر M1
حساب مدیر M2

حساب مشتری C2

حساب مدیر M2 تنها والد مستقیم C2 است.

کارهایی که می‌توانید با این مجموعه حساب‌ها انجام دهید به شرح زیر است:

به عنوان شریک داده D1 عمل کنید

برای اینکه به عنوان شریک داده D1 عمل کنید، از اعتبارنامه‌های حساب گوگل 222larabrown@gmail.com برای ارسال داده‌ها به حساب مدیریتی M2، حساب کاربری C1 یا حساب کاربری C2 استفاده کنید، و از مقصدی استفاده کنید که login_account روی حساب کاربری شریک داده D1 و linked_account روی حساب مدیریتی M2 تنظیم شده باشد.

به عنوان شریک داده D1، شما نمی‌توانید داده را به حساب مدیر M1 ارسال کنید زیرا هیچ پیوند محصولی بین D1 و M1 وجود ندارد.

به عنوان شریک داده D2 عمل کنید

برای اینکه به عنوان شریک داده D2 عمل کنید، از اعتبارنامه‌های حساب گوگل jeffersonloveshiking@gmail.com برای ارسال داده‌ها به حساب کاربری C1 استفاده کنید، و از مقصدی با تنظیم login_account روی حساب کاربری شریک داده D2 و linked_account روی حساب کاربری C1 استفاده کنید.

به عنوان شریک داده D2، شما نمی‌توانید داده‌ها را به حساب مدیر M1، حساب مدیر M2 یا حساب مشتری C2 ارسال کنید زیرا هیچ پیوند محصولی بین D2 و هیچ یک از این حساب‌ها یا حساب‌های مدیر والد آنها وجود ندارد.

تفاوت کلیدی بین شرکای داده D1 و D2 در نحوه پیوند شریک داده با حساب‌های گوگل ادز است.

شریک داده D1 به یک حساب کاربری مدیریت تبلیغات گوگل (Google Ads manager) متصل است. این مثالی از سناریوی لینک محصول مدیریت است.
شریک داده D2 به یک حساب کاربری گوگل ادز متصل است. این مثالی از سناریوی لینک مستقیم محصول است.

سناریوی لینک مستقیم محصول

اگر می‌خواهید داده‌ها را به یک حساب Google Ads ارسال کنید و لینک محصول بین حساب Google Ads و حساب شریک داده شما قرار دارد:

مقصد

operating_account

`account_id`	شناسه مشتری حساب گوگل ادز
`account_type`	`GOOGLE_ADS`

login_account

`account_id`	شناسه مشتری حساب شریک داده
`account_type`	`DATA_PARTNER`

linked_account فیلد linked_account را تنظیم نکنید.

product_destination_id شناسه مخاطب یا اقدام تبدیل.

در اینجا مثالی از سناریوی لینک مستقیم محصول با استفاده از حساب‌های کاربری موجود در نمودار آورده شده است. در این سناریو، شریک داده D2 با استفاده از لینک محصول بین D2 و C1، داده‌های اعضای مخاطب را به مشتری C1 از مشتریان گوگل ادز ارسال می‌کند و اطلاعات احراز هویت حساب گوگل jeffersonloveshiking@gmail.com را ارائه می‌دهد:

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

سناریوی مدیریت لینک محصول

اگر می‌خواهید داده‌ها را به یک حساب Google Ads ارسال کنید و لینک محصول بین یک حساب مدیر Google Ads والد و حساب شریک داده شما قرار دارد:

مقصد

operating_account

`account_id`	شناسه مشتری حساب کاربری گوگل ادز
`account_type`	`GOOGLE_ADS`

login_account

`account_id`	شناسه مشتری حساب شریک داده
`account_type`	`DATA_PARTNER`

linked_account

`account_id`	شناسه مشتری حساب مدیر تبلیغات گوگل
`account_type`	`GOOGLE_ADS`

product_destination_id شناسه مخاطب یا اقدام تبدیل.

در اینجا مثالی از سناریوی مدیریت لینک محصول با استفاده از حساب‌های موجود در نمودار آورده شده است. در این سناریو، شریک داده D1 با استفاده از لینک محصول بین D1 و M2، داده‌های اعضای مخاطب را به مشتری C2 از مشتریان گوگل ادز ارسال می‌کند و اعتبارنامه‌های حساب گوگل 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 ارسال کنید:

از یک لینک مستقیم محصول بین حساب شریک داده و حساب شریک یا تبلیغ‌کننده Display & Video 360 استفاده کنید.
با استفاده از پیوند محصول بین حساب شریک داده و حساب شریک Display & Video 360 والد تبلیغ‌کننده، داده‌ها را به یک تبلیغ‌کننده Display & Video 360 ارسال کنید.

سناریوهای لینک مستقیم محصول

اگر می‌خواهید داده‌ها را به یک تبلیغ‌کننده Display & Video 360 ارسال کنید و لینک محصول بین حساب تبلیغ‌کننده Display & Video 360 و حساب شریک داده شما قرار دارد:

مقصد

operating_account

`account_id`	شناسه حساب تبلیغ‌کننده Display & Video 360
`account_type`	`DISPLAY_VIDEO_ADVERTISER`

login_account

`account_id`	شناسه مشتری حساب شریک داده
`account_type`	`DATA_PARTNER`

linked_account فیلد linked_account را تنظیم نکنید.

product_destination_id شناسه مخاطب یا اقدام تبدیل.

در اینجا مثالی از سناریوی Destination برای لینک مستقیم محصول جهت ارسال داده‌ها به یک تبلیغ‌کننده Display & Video 360 آورده شده است:

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

اگر می‌خواهید داده‌ها را به یک حساب همکار Display & Video 360 ارسال کنید، باید یک لینک محصول بین حساب همکار Display & Video 360 و حساب همکار داده خود داشته باشید.

مقصد

operating_account

`account_id`	شناسه حساب کاربری همکار Display & Video 360
`account_type`	`DISPLAY_VIDEO_PARTNER`

login_account

`account_id`	شناسه مشتری حساب شریک داده
`account_type`	`DATA_PARTNER`

linked_account فیلد linked_account را تنظیم نکنید.

product_destination_id شناسه مخاطب یا اقدام تبدیل.

در اینجا مثالی از سناریوی Destination for a direct product link برای ارسال داده‌ها به یک شریک 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"
    }
  ]
}

سناریوی نمایش و ویدئوی ۳۶۰ درجه برای لینک محصول به شرکا

اگر می‌خواهید داده‌ها را به یک تبلیغ‌کننده Display & Video 360 ارسال کنید و لینک محصول به حساب شریک داده شما با یک حساب شریک Display & Video 360 است که در آن حساب تبلیغ‌کننده یک حساب فرزند است:

مقصد

operating_account

`account_id`	شناسه حساب تبلیغ‌کننده Display & Video 360
`account_type`	`DISPLAY_VIDEO_ADVERTISER`

login_account

`account_id`	شناسه مشتری حساب شریک داده
`account_type`	`DATA_PARTNER`

linked_account

`account_id`	شناسه حساب کاربری همکار Display & Video 360
`account_type`	`DISPLAY_VIDEO_PARTNER`

product_destination_id شناسه مخاطب یا اقدام تبدیل.

در اینجا مثالی از سناریوی « Destination برای پیوند محصول شریک» برای ارسال داده‌ها به یک تبلیغ‌کننده Display & Video 360 با استفاده از پیوند محصول بین شریک داده و شریک Display & Video 360 والد تبلیغ‌کننده آورده شده است:

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

گوگل آنالیتیکس

رابط برنامه‌نویسی کاربردی مدیریت داده (Data Manager API) از ارسال داده‌ها به حساب گوگل آنالیتیکس با استفاده از لینک محصول پشتیبانی نمی‌کند. در عوض، از رویکرد سناریوهای تبلیغ‌کننده برای گوگل آنالیتیکس استفاده کنید.

الزامات دقیق

این بخش شامل الزامات دقیقی برای فیلدهای حساب کاربری یک Destination ، نکاتی برای نحوه تنظیم product_destination_id و نحوه تعیین محل دسترسی اعتبارنامه‌های شما است .

فیلدهای حساب

یک Destination می‌تواند حداکثر ۳ حساب مختلف داشته باشد:

operating_account

operating_account مورد نیاز است.

operating_account نشان می‌دهد که کدام حساب، داده‌های درخواست را دریافت می‌کند. operating_account می‌تواند هر یک از موارد زیر باشد:

یک حساب کاربری گوگل ادز
یک حساب کاربری تبلیغ‌کننده Display & Video 360
حساب کاربری همکار Display & Video 360
یک ویژگی گوگل آنالیتیکس
یک حساب شریک داده در صورت ارسال داده به مخاطبی که متعلق به حساب شریک داده است.

login_account

login_account همیشه مورد نیاز نیست و به طور پیش‌فرض روی operating_account تنظیم می‌شود.

رابط برنامه‌نویسی کاربردی مدیریت داده (Data Manager API) موارد زیر را تأیید می‌کند:

حساب گوگلِ مربوط به اعتبارنامه‌ها، کاربری در login_account است.
login_account یکی از موارد زیر است:
- همانند operating_account . اگر login_account تنظیم نکنید، این مقدار پیش‌فرض است.
- یک حساب کاربری مدیر تبلیغات گوگل یا شریک Display & Video 360 که والد operating_account باشد.
- یک حساب شریک داده با لینک محصول به linked_account .

linked_account

linked_account نشان می‌دهد که کدام حساب کاربری دارای لینک محصول به login_account است.

شناسه مقصد محصول

product_destination_id ) یک Destination مشخص می‌کند که کدام شیء در operating_account داده‌ها را دریافت می‌کند. برای مثال، این می‌تواند شناسه مخاطب برای Google Ads یا Display & Video 360، شناسه اقدام تبدیل برای Google Ads یا شناسه اندازه‌گیری برای جریان Google Analytics باشد.

در اینجا نحوه یافتن شناسه برای هر نوع مقصد محصول آورده شده است.

مخاطبان گوگل ادز

شناسه مقصد محصول برای اعضای مخاطبِ در حال جذب، شناسه مخاطب است.

برای دریافت شناسه مخاطب از رابط کاربری گوگل ادز:

در رابط کاربری گوگل ادز به بخش مدیریت مخاطبان (Audience manager) بروید.
برای مشاهده جزئیات، روی نام مخاطب کلیک کنید.
شناسه مخاطب در کنار شناسه فهرست (List ID) فهرست شده است.

برای دریافت شناسه مخاطب از API تبلیغات گوگل:

یک درخواست Search یا SearchStream با عبارت زیر به GoogleAdsService ارسال کنید:

SELECT
  user_list.id,
  user_list.name
FROM user_list
WHERE user_list.name = 'USER_LIST_NAME'

شناسه مخاطب را از فیلد id در user_list در پاسخ دریافت کنید.

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

رویداد تبلیغات گوگل

شناسه مقصد محصول برای رویدادهای دریافت، شناسه اقدام تبدیل است.

برای دریافت شناسه اقدام تبدیل از رابط کاربری گوگل ادز:

در رابط کاربری گوگل ادز به بخش تبدیل‌ها (Conversions) بروید.
برای مشاهده جزئیات، روی نام عمل تبدیل کلیک کنید.
شناسه‌ی عمل تبدیل، مقداری برای پارامتر کوئری URL به نام ctId است.
```
https://ads.google.com/aw/conversions/detail?ocid=...&ctId=CONVERSION_ACTION_ID&...
```

برای دریافت شناسه اقدام تبدیل از API گوگل ادز:

یک درخواست Search یا SearchStream با عبارت زیر به GoogleAdsService ارسال کنید:

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

شناسه‌ی عمل تبدیل را از فیلد id در conversion_action در پاسخ دریافت کنید.

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

نمایش و ویدیوی ۳۶۰ درجه برای مخاطبان

شناسه مقصد محصول برای اعضای مخاطبِ در حال جذب، شناسه مخاطب است.

برای دریافت شناسه مخاطب از رابط کاربری Display & Video 360:

از طریق https://displayvideo.google.com وارد رابط کاربری Display & Video 360 شوید.
به شریک یا تبلیغ‌کننده‌ی Display & Video 360 که برای operating_account استفاده می‌کنید، بروید.
در منوی سمت چپ به بخش مخاطبان (Audiences) بروید، سپس همه مخاطبان (All audience) را انتخاب کنید.
مخاطب را در لیست پیدا کنید. شناسه مخاطب، عددی است که در کنار نام در ستون نام قرار دارد.

رویداد گوگل آنالیتیکس

شناسه مقصد محصول برای دریافت رویدادها، شناسه اندازه‌گیری جریان داده است.

تعیین محل دسترسی اعتبارنامه‌ها

اعتبارنامه‌هایی که برای تأیید درخواست API مدیریت داده استفاده می‌کنید با یک حساب Google خاص مرتبط هستند.

اگر از اعتبارنامه‌های کاربری استفاده می‌کنید، درخواست‌ها به عنوان حساب Google کاربری که هنگام ایجاد اعتبارنامه‌ها به شما اجازه اقدام از طرف خود را داده است، مجاز شناخته می‌شوند.
اگر از اعتبارنامه‌های حساب سرویس استفاده می‌کنید، درخواست‌ها به عنوان حساب گوگل آن حساب سرویس تأیید می‌شوند.

در اینجا نحوه تأیید دسترسی حساب گوگل شما به حساب Google Ads، Display & Video 360 یا Google Analytics آورده شده است.

گوگل ادز یا شریک داده

برای دسترسی به login_account در رابط کاربری گوگل ادز به بخش دسترسی و امنیت (Access and security) بروید.
برگه کاربران را انتخاب کنید.
اگر login_account یک حساب مدیریت تبلیغات گوگل است، برای مخفی کردن کاربران از حساب‌های فرزند، گزینه‌ی « نمایش کاربران در سلسله مراتب کامل» را غیرفعال کنید.
تأیید کنید که حساب گوگل مربوط به اعتبارنامه‌های شما در فهرست حساب‌های نمایش داده شده در برگه کاربران وجود دارد.

نمایش و ویدئو ۳۶۰

در رابط کاربری Display & Video 360 به بخش مدیریت کاربر و تنظیمات ایمیل بروید.
تأیید کنید که مدیریت کاربر نشان می‌دهد که حساب گوگل مربوط به اعتبارنامه‌های شما، کاربری در login_account است.

گوگل آنالیتیکس

در رابط کاربری گوگل آنالیتیکس به مدیریت دسترسی به دارایی‌ها (Property access management) بروید.
تأیید کنید که ویژگی Google Analytics که در login_account مشخص شده است، انتخاب شده باشد.
تأیید کنید که حساب گوگل مربوط به اعتبارنامه‌های شما ، نقش ویرایشگر یا مدیر را در آن ملک دارد.

بعدی

فرمت داده های کاربر

پیکربندی مقصدها با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

سناریوهای تبلیغ‌کننده

تبلیغات گوگل

سناریوی دسترسی مستقیم

سناریوی دسترسی مدیر

نمایش و ویدئو ۳۶۰

سناریوهای دسترسی مستقیم

سناریوی دسترسی شریک نمایش و ویدئو ۳۶۰

گوگل آنالیتیکس

سناریوهای شریک داده

تبلیغات گوگل

سناریوی لینک مستقیم محصول

سناریوی مدیریت لینک محصول

نمایش و ویدئو ۳۶۰

سناریوهای لینک مستقیم محصول

سناریوی نمایش و ویدئوی ۳۶۰ درجه برای لینک محصول به شرکا

گوگل آنالیتیکس

الزامات دقیق

فیلدهای حساب

شناسه مقصد محصول

مخاطبان گوگل ادز

رویداد تبلیغات گوگل

نمایش و ویدیوی ۳۶۰ درجه برای مخاطبان

رویداد گوگل آنالیتیکس

تعیین محل دسترسی اعتبارنامه‌ها

گوگل ادز یا شریک داده

نمایش و ویدئو ۳۶۰

گوگل آنالیتیکس

پیکربندی مقصدها