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

هنگام کار با Data Manager API، هم مفهوم Destination و هم سرایندهای درخواست به‌دفعات ظاهر می‌شوند. این راهنما را بخوانید تا با نحوه پیکربندی مقصدها و سرایندها برای سناریوهای مختلف آشنا شوید.

چه زمانی از مقصدها یا سرصفحه‌ها استفاده کنیم

• از Destination در درخواست‌های انتقال استفاده کنید. درخواست درج از IngestionService برای افزودن یا برداشتن اعضا در مخاطب یا ارسال رویدادها استفاده می‌کند. فهرست destinations در IngestAudienceMembersRequest یا IngestEventsRequest موارد زیر را تعریف می‌کند:

  1. حسابی که داده‌ها را دریافت می‌کند. برای مثال، حساب Google Ads یا دارایی Google Analytics.
  2. نهاد مقصد برای داده‌های درون حساب، مانند کنش تبدیل Google Ads یا جریان Google Analytics.
  3. مسیر دسترسی برای اطلاعات کاربری درخواست به حسابی که داده‌ها را دریافت می‌کند.

  می‌توانید چند مقصد را در یک درخواست جذب قرار دهید.

  نکته: سرایندهای درخواست را در درخواست IngestionService تنظیم نکنید. ‫Data Manager API سرصفحه‌ها را در درخواست جذب نادیده می‌گیرد.

• از سرایندهای درخواست در درخواست‌های مدیریت منابع که منابع را ایجاد، به‌روزرسانی، حذف، یا بازیابی می‌کنند استفاده کنید. سرصفحه‌ها مسیر دسترسی اعتبارنامه درخواست به حساب هدف درخواست مدیریت منبع را تعریف می‌کنند. در اینجا فهرست منابعی که روش‌های مدیریت منابع آن‌ها از سرایندهای درخواست پشتیبانی می‌کنند آورده شده است:

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

برای مثال، اگر می‌خواهید مخاطبی ایجاد کنید، اعضایی را به مخاطب اضافه کنید، عیب‌یابی‌ها را بررسی کنید، و سپس مخاطب را برای بررسی اندازه آن بازیابی کنید، در اینجا هر مرحله، نوع درخواستی که باید استفاده شود، و اینکه آیا باید از مقصدها یا سرایندهای درخواست استفاده کنید، آورده شده است:

مرحله	نوع درخواست	مقصد یا سرایندهای درخواست
ایجاد مخاطب	مدیریت منابع	سرایندهای درخواست
افزودن اعضا به مخاطب	انتقال داده	مقصدها
بررسی تشخیص خرابی	انتقال داده	مقصدها
بازیابی مخاطب	مدیریت منابع	سرایندهای درخواست

توجه: درخواست RetrieveRequestStatus مقصدها یا سرایندهای درخواست را مستقیماً نمی‌پذیرد. درعوض، Data Manager API مجوز را بااستفاده از مقصدها و مسیر دسترسی از درخواست دریافت اصلی تأیید می‌کند. برای جزئیات، مجوز را در راهنمای عیب‌یابی ببینید.

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

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

• Google Ads
• Display & Video 360
• Google Analytics
• نورافکن

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

• Google Ads
• Display & Video 360
• Google Ad Manager
• Google Analytics
• نورافکن

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

سناریوهای آگهی‌دهنده

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

Google Ads

در اینجا نموداری وجود دارد که نمونه‌ای از مجموعه‌ای از حساب‌ها و کاربران Google Ads را نشان می‌دهد.

حساب مدیر M1

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

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

«حساب Google»‏ [e-mail] کاربری در M1 است.

حساب مدیر M2

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

1. حساب مشتری C1
2. حساب مشتری C2

«حساب Google» [e-mail] کاربری در M2 است.

حساب مشتری C1

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

1. حساب مدیر M1
2. حساب مدیر M2

«حساب Google»‏ [e-mail] کاربری در C1 است.

حساب مشتری C2

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

هیچ‌کدام از «حساب‌های Google» فهرست‌شده کاربر C2 نیستند.

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

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

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

انتقال داده

مقصد
operating_account	account_id شناسه مشتری حساب Google Ads account_type GOOGLE_ADS
login_account	یا login_account را تنظیم نکنید، یا آن را روی همان مقادیر operating_account تنظیم کنید.
linked_account	فیلد linked_account را تنظیم نکنید.
product_destination_id	شناسه مخاطب یا کنش تبدیل.

مدیریت منابع

سرایندهای درخواست
login-account	accountTypes/GOOGLE_ADS/accounts/GOOGLE_ADS_CUSTOMER_ID
linked-account	سرصفحه linked-account را تنظیم نکنید.

در اینجا مثالی از سناریوی دسترسی مستقیم بااستفاده از حساب‌های موجود در نمودار و اطلاعات کاربری «حساب Google» [e-mail] آورده شده است:

انتقال داده

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

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

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

مدیریت منابع

سرایندهای درخواست
login-account	accountTypes/GOOGLE_ADS/accounts/C1_CUSTOMER_ID
linked-account	سرصفحه linked-account را تنظیم نکنید.

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

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

انتقال داده

مقصد
operating_account	account_id شناسه مشتری حساب مشتری Google Ads account_type GOOGLE_ADS
login_account	account_id شناسه مشتری حساب مدیر Google Ads account_type GOOGLE_ADS
linked_account	فیلد linked_account را تنظیم نکنید.
product_destination_id	شناسه مخاطب یا کنش تبدیل.

مدیریت منابع

سرایندهای درخواست
login-account	accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID
linked-account	سرصفحه linked-account را تنظیم نکنید.

در اینجا نمونه‌ای از سناریوی دسترسی مدیر برای حساب مشتری Google Ads C2 از نمودار و اطلاعات کاربری برای «حساب Google» [e-mail] آورده شده است:

انتقال داده

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

مدیریت منابع

سرایندهای درخواست
login-account	accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID
linked-account	سرصفحه linked-account را تنظیم نکنید.

در اینجا نمونه دیگری از سناریوی دسترسی مدیر برای حساب مشتری Google Ads C2 و اطلاعات کاربری «حساب Google» [e-mail] آورده شده است که کاربری در حساب مدیر Google Ads M1 است:

انتقال داده

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

مدیریت منابع

سرایندهای درخواست
login-account	accountTypes/GOOGLE_ADS/accounts/M1_CUSTOMER_ID
linked-account	سرصفحه linked-account را تنظیم نکنید.

Display & Video 360

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

1. دسترسی مستقیم، که در آن اطلاعات کاربری مربوط به «حساب Google» است که کاربر در حساب شریک یا تبلیغ‌کننده Display & Video 360 است.
2. دسترسی شریک Display & Video 360، که در آن اطلاعات کاربری برای «حساب Google» است که کاربری در حساب شریک 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	شناسه مخاطب.

مدیریت منابع

سرایندهای درخواست
login-account	accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID
linked-account	سرصفحه linked-account را تنظیم نکنید.

در اینجا نمونه‌ای از Destination برای سناریوی دسترسی مستقیم برای ارسال داده به تبلیغ‌کننده 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"
    }
  ]
}

مدیریت منابع

سرایندهای درخواست
login-account	accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID
linked-account	سرصفحه linked-account را تنظیم نکنید.

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

انتقال داده

مقصد
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	شناسه مخاطب.

مدیریت منابع

سرایندهای درخواست
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	سرصفحه linked-account را تنظیم نکنید.

در اینجا نمونه‌ای از Destination برای سناریوی دسترسی مستقیم برای ارسال داده به شریک 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"
    }
  ]
}

مدیریت منابع

سرایندهای درخواست
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	سرصفحه linked-account را تنظیم نکنید.

سناریوی دسترسی شریک Display & Video 360

اگر می‌خواهید داده‌ها را به آگهی‌دهنده Display & Video 360 ارسال کنید و اطلاعات اعتباری شما برای «حساب Google» است که کاربر در حساب شریک 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	شناسه مخاطب.

مدیریت منابع

سرایندهای درخواست
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	سرصفحه linked-account را تنظیم نکنید.

در اینجا نمونه‌ای از Destination برای سناریوی دسترسی شریک برای ارسال داده به تبلیغ‌کننده Display & Video 360 آورده شده است. در این سناریو، اعتبارنامه‌ها باید برای «حساب Google» باشد که کاربر حساب شریک Display & Video 360 است DISPLAY_VIDEO_PARTNER_ID، و حساب آگهی‌دهنده Display & Video 360 DISPLAY_VIDEO_ADVERTISER_ID باید فرزند حساب شریک باشد 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"
    }
  ]
}

مدیریت منابع

سرایندهای درخواست
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	سرصفحه linked-account را تنظیم نکنید.

Google Analytics

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

انتقال داده

مقصد
operating_account	account_id شناسه دارایی Google Analytics account_type GOOGLE_ANALYTICS_PROPERTY
login_account	یا login_account را تنظیم نکنید، یا آن را روی همان مقادیر operating_account تنظیم کنید.
linked_account	فیلد linked_account را تنظیم نکنید.
product_destination_id	شناسه سنجش جریان داده‌های وب. شناسه برنامه Firebase مربوط به جریان داده‌های برنامه.

مدیریت منابع

سرایندهای درخواست
login-account	accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account	سرصفحه linked-account را تنظیم نکنید.

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

انتقال داده

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

مدیریت منابع

سرایندهای درخواست
login-account	accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account	سرصفحه linked-account را تنظیم نکنید.

Floodlight

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

انتقال داده

مقصد
operating_account	account_id شناسه پیکربندی Floodlight اگر آگهی‌دهنده شما فرزند آگهی‌دهنده والد است، از شناسه آگهی‌دهنده والد در «مدیر پویش ۳۶۰» به‌عنوان شناسه پیکربندی Floodlight خود استفاده کنید. درغیراین‌صورت، از شناسه تبلیغ‌کننده خود استفاده کنید. ببینید چگونه شناسه آگهی‌دهنده را در Campaign Manager 360 UI پیدا کنید. account_type FLOODLIGHT_CONFIG
login_account	یا login_account را تنظیم نکنید، یا آن را روی همان مقادیر operating_account تنظیم کنید.
linked_account	فیلد linked_account را تنظیم نکنید.
product_destination_id	شناسه فعالیت Floodlight

در اینجا نمونه‌ای از Destination برای ارسال رویدادها به Floodlight آورده شده است:

انتقال داده

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

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

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

توجه: در هر سناریو شریک داده، اعتبارنامه‌ها باید برای «حساب Google» باشد که کاربر در حساب شریک داده است.

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

Google Ads

در اینجا نموداری آورده شده است که نمونه‌ای از مجموعه‌ای از حساب‌های Google Ads و شریک داده را نشان می‌دهد. این نمودار همچنین نشان می‌دهد که کدام «حساب Google» در هر حساب Google Ads یا شریک داده کاربر است، و همچنین پیوندهای شریک بین حساب‌ها را نشان می‌دهد.

شریک داده D1

پیوند شریک بین D1 و حساب مدیر Google Ads‏ M2 وجود دارد.

«حساب Google» [e-mail] کاربری در D1 است.

شریک داده D2

پیوند شریک بین D2 و حساب مشتری Google Ads‏ C1 وجود دارد.

«حساب Google» [e-mail] کاربری در D2 است.

حساب مدیر M1

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

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

حساب مدیر M2

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

1. حساب مشتری C1
2. حساب مشتری C2

حساب مشتری C1

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

1. حساب مدیر M1
2. حساب مدیر M2

حساب مشتری C2

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

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

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

برای عمل کردن به‌عنوان شریک داده D1، از اطلاعات کاربری «حساب Google» [e-mail] برای موارد زیر استفاده کنید:

• داده‌ها را به حساب مشتری C1 یا حساب مشتری C2 ارسال کنید، بااستفاده از مقصدی که login_account آن روی حساب شریک داده D1 و linked_account آن روی حساب مدیر M2 تنظیم شده باشد.

• داده‌ها را مستقیماً به حساب مدیر M2 ارسال کنید، بااستفاده از مقصدی که login_account روی حساب شریک داده D1 تنظیم شده است. تنظیم نشود linked_account.

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

Act as data partner D2

برای اینکه به‌عنوان شریک داده D2 عمل کنید، از اعتبارنامه «حساب Google» [e-mail] برای ارسال داده به حساب مشتری C1 استفاده کنید، و از مقصدی استفاده کنید که login_account آن روی حساب شریک داده D2 تنظیم شده باشد. تنظیم نشود linked_account.

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

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

• شریک داده D1 به حساب مدیر Google Ads پیوند داده شده است. این نمونه‌ای از سناریوی پیوند شریک مدیر است.
• شریک داده D2 به حساب مشتری Google Ads پیوند داده شده است. این نمونه‌ای از سناریو پیوند مستقیم شریک است.

سناریوی پیوند مستقیم شریک

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

انتقال داده

مقصد
operating_account	account_id شناسه مشتری حساب Google Ads account_type GOOGLE_ADS
login_account	account_id شناسه مشتری حساب شریک داده account_type DATA_PARTNER
linked_account	فیلد linked_account را تنظیم نکنید.
product_destination_id	شناسه مخاطب یا کنش تبدیل.

مدیریت منابع

سرایندهای درخواست
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	سرصفحه linked-account را تنظیم نکنید.

در اینجا نمونه‌ای از سناریو پیوند شریک مستقیم بااستفاده از حساب‌های نمودار و سرایندهای درخواست مربوطه برای درخواست‌های مدیریت منابع آورده شده است. در این سناریو، شریک داده D2 داده‌های عضو مخاطب را بااستفاده از پیوند شریک بین D2 و C1 و اطلاعات کاربری «حساب Google» [e-mail] به مشتری کارخواه Google Ads (یعنی C1) ارسال می‌کند:

انتقال داده

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

مدیریت منابع

سرایندهای درخواست
login-account	accountTypes/DATA_PARTNER/accounts/D2_CUSTOMER_ID
linked-account	سرصفحه linked-account را تنظیم نکنید.

سناریوی پیوند شریک مدیر

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

انتقال داده

مقصد
operating_account	account_id شناسه مشتری حساب مشتری Google Ads account_type GOOGLE_ADS
login_account	account_id شناسه مشتری حساب شریک داده account_type DATA_PARTNER
linked_account	account_id شناسه مشتری حساب مدیر Google Ads account_type GOOGLE_ADS
product_destination_id	شناسه مخاطب یا کنش تبدیل.

مدیریت منابع

سرایندهای درخواست
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID

در اینجا مثالی از سناریوی پیوند شریک مدیر بااستفاده از حساب‌های نمودار آورده شده است. در این سناریو، شریک داده D1 داده‌های عضو مخاطب را بااستفاده از پیوند شریک بین D1 و M2 و اطلاعات کاربری «حساب Google» [e-mail] به مشتری کارخواه Google Ads‏ C2 ارسال می‌کند:

انتقال داده

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

مدیریت منابع

سرایندهای درخواست
login-account	accountTypes/DATA_PARTNER/accounts/D1_CUSTOMER_ID
linked-account	accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID

Display & Video 360

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

1. از پیوند شریک مستقیم بین حساب شریک داده و حساب شریک یا تبلیغ‌کننده Display & Video 360 استفاده کنید.
2. ارسال داده به آگهی‌دهنده 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	شناسه مخاطب یا کنش تبدیل.

مدیریت منابع

سرایندهای درخواست
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	سرصفحه linked-account را تنظیم نکنید.

در اینجا نمونه‌ای از Destination برای سناریوی پیوند شریک مستقیم برای ارسال داده به آگهی‌دهنده Display & Video 360 و سرایندهای درخواست مربوطه برای درخواست‌های مدیریت منابع آورده شده است:

انتقال داده

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

مدیریت منابع

سرایندهای درخواست
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	سرصفحه linked-account را تنظیم نکنید.

اگر می‌خواهید داده‌ها را به حساب شریک 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	شناسه مخاطب یا کنش تبدیل.

مدیریت منابع

سرایندهای درخواست
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	سرصفحه linked-account را تنظیم نکنید.

در اینجا نمونه‌ای از Destination برای سناریوی پیوند شریک مستقیم برای ارسال داده به شریک 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"
    }
  ]
}

مدیریت منابع

سرایندهای درخواست
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	سرصفحه linked-account را تنظیم نکنید.

سناریوی پیوند شریک ولی

اگر می‌خواهید داده‌ها را به تبلیغ‌کننده 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	شناسه مخاطب یا کنش تبدیل.

مدیریت منابع

سرایندهای درخواست
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_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"
    }
  ]
}

مدیریت منابع

سرایندهای درخواست
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID

Google Ad Manager

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

انتقال داده

مقصد
operating_account	account_id شناسه پیوند مخاطب حساب Google Ad Manager account_type GOOGLE_AD_MANAGER_AUDIENCE_LINK
login_account	account_id شناسه مشتری حساب شریک داده account_type DATA_PARTNER
linked_account	فیلد linked_account را تنظیم نکنید.
product_destination_id	شناسه مخاطب.

مدیریت منابع

سرایندهای درخواست
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	سرصفحه linked-account را تنظیم نکنید.

در اینجا نمونه‌ای از Destination برای ارسال داده به حساب «مدیر Google Ads» بااستفاده از پیوند شریک آورده شده است:

انتقال داده

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

مدیریت منابع

سرایندهای درخواست
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	سرصفحه linked-account را تنظیم نکنید.

Google Analytics

‫Data Manager API از ارسال داده به حساب Google Analytics بااستفاده از پیوند شریک پشتیبانی نمی‌کند. به‌جای آن، از رویکرد سناریوهای تبلیغ‌کننده برای Google Analytics استفاده کنید.

Floodlight

‫Data Manager API از ارسال داده به پیکربندی Floodlight بااستفاده از پیوند شریک پشتیبانی نمی‌کند. به‌جای آن، از رویکرد سناریوهای تبلیغ‌کننده برای Floodlight استفاده کنید.

الزامات دقیق

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

فیلدهای حساب

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

operating_account

operating_account الزامی است.

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

• حساب Google Ads
• حساب تبلیغ‌کننده Display & Video 360
• حساب شریک Display & Video 360
• حساب Google Ad Manager
• دارایی Google Analytics
• حساب شریک داده، اگر داده‌ها به مخاطبی ارسال شود که متعلق به حساب شریک داده است.

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

فیلد login_account و سرایند درخواست login-account

login_account همیشه لازم نیست و به‌طور پیش‌فرض به operating_account در درخواست IngestionService و حساب هدف در درخواست مدیریت منابع تبدیل می‌شود. در درخواست مدیریت منبع، از سرایند درخواست login-account برای شناسایی حساب ورود به سیستم استفاده کنید.

‫Data Manager API تأیید می‌کند که:

1. «حساب Google» مربوط به اطلاعات کاربری، کاربری در حساب ورود به سیستم است.

2. حساب ورود به سیستم یکی از موارد زیر است:

   • همانند operating_account. اگر login_account مربوط به Destination را در درخواست IngestionService تنظیم نکنید، یا سرصفحه login-account را در درخواست مدیریت منابع تنظیم نکنید، این گزینه پیش‌فرض است.

   • حساب مدیر Google Ads یا شریک Display & Video 360 که حساب اصلی operating_account در درخواست IngestionService یا حساب اصلی حساب هدف در درخواست مدیریت منابع است.

   • حساب شریک داده با پیوند شریک به linked_account در درخواست IngestionService، یا سرصفحه linked-account در درخواست مدیریت منابع.

فیلد linked_account و سرایند درخواست linked-account

توجه: فقط درصورتی حساب پیوندشده را مشخص کنید که حساب ورود به سیستم account_type روی DATA_PARTNER تنظیم شده باشد و ولی operating_account به حساب شریک داده پیوند شده باشد. اگر operating_account مستقیماً به حساب شریک داده پیوند شده است، linked_account را تنظیم نکنید.

linked_account نشان می‌دهد کدام حساب دارای پیوند شریک به login_account درخواست IngestionService است، یا حساب هدف درخواست مدیریت منابع را نشان می‌دهد.

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

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

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

مخاطب Google Ads

شناسه مقصد محصول برای جذب اعضای مخاطب همان شناسه مخاطب است. این شناسه را بااستفاده از میانای کاربری Google Ads یا Data Manager API بازیابی کنید.

واسط کاربر Google Ads

برای دریافت شناسه مخاطب از میانای کاربری Google Ads:

1. به مدیر مخاطبان در میانای کاربری Google Ads بروید.
2. روی نام مخاطب کلیک کنید تا جزئیات را ببینید.
3. شناسه مخاطب در کنار شناسه فهرست فهرست شده است.

میانای برنامه‌سازی کاربردی مدیر داده‌ها

UserList را بااستفاده از روش فهرست بازیابی کنید، درصورت نیاز سرایندهای درخواست را ارائه دهید، و از id مربوط به UserList برای شناسه مقصد محصول استفاده کنید.

رویداد Google Ads

شناسه مقصد محصول برای دریافت رویدادها همان شناسه کنش تبدیل است. این شناسه را بااستفاده از میانای کاربر Google Ads یا Google Ads API بازیابی کنید.

واسط کاربر Google Ads

برای دریافت شناسه کنش تبدیل از میانای کاربر Google Ads:

1. به تبدیل‌ها در رابط کاربری Google Ads بروید.
2. روی نام کنش تبدیل کلیک کنید.
3. به برگه جزئیات بروید.
4. شناسه کنش تبدیل عددی است که در کنار شناسه نوع تبدیل قرار دارد.

Google Ads API

برای دریافت شناسه کنش تبدیل از Google Ads API:

1. درخواست Search یا SearchStream را به GoogleAdsService با پُرسمان زیر ارسال کنید:

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

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

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

مخاطب Display & Video 360

شناسه مقصد محصول برای جذب اعضای مخاطب همان شناسه مخاطب است. این شناسه را بااستفاده از میانای کاربر Display & Video 360 یا Data Manager API بازیابی کنید.

رابط کاربری Display & Video 360

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

1. در https://displayvideo.google.com به سیستم میانای کاربر Display & Video 360 وارد شوید.
2. به شریک یا تبلیغ‌کننده Display & Video 360 که برای operating_account استفاده می‌کنید بروید.
3. به مخاطبان در منوِ سمت راست بروید، سپس همه مخاطبان را انتخاب کنید.
4. مخاطب را در فهرست پیدا کنید. شناسه مخاطب عددی است که در کنار نام در ستون نام قرار دارد.

میانای برنامه‌سازی کاربردی مدیر داده‌ها

UserList را بااستفاده از روش فهرست بازیابی کنید، درصورت نیاز، سرایندهای درخواست را ارائه دهید، و از id UserList برای شناسه مقصد محصول استفاده کنید.

رویداد Google Analytics

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

جریان داده‌های وب

از شناسه سنجش جاری‌سازی داده استفاده کنید.

جریان داده‌های برنامه

از شناسه Firebase App جاری‌سازی داده استفاده کنید. در اینجا دو گزینه برای پیدا کردن شناسه Firebase App شما ارائه شده است:

• در میانای کاربری Google Analytics، به جریان‌های داده بروید، روی جریان داده کلیک کنید، و شناسه برنامه FIREBASE را پیدا کنید.
• از کنسول Firebase استفاده کنید.

رویداد Floodlight

شناسه مقصد محصول برای دریافت رویدادها در Floodlight شناسه فعالیت Floodlight است. این شناسه را بااستفاده از میانای کاربر Campaign Manager 360 یا Campaign Manager 360 API بازیابی کنید.

رابط کاربری Campaign Manager 360

برای دریافت شناسه فعالیت Floodlight از واسط کاربر Campaign Manager 360:

1. وارد سیستم واسط کاربر Campaign Manager 360 شوید.
2. به تبلیغ‌کننده Campaign Manager 360 که برای operating_account استفاده می‌کنید بروید.
3. به Floodlight در منوِ سمت راست بروید، سپس فعالیت‌ها را انتخاب کنید.
4. فعالیت Floodlight را در فهرست پیدا کنید. شناسه همان عدد کنار نام در ستون نام فعالیت است.

Campaign Manager 360 API

برای دریافت شناسه فعالیت Floodlight از Campaign Manager 360 API:

1. درخواست list به منبع floodlightActivities ارسال کنید.
2. floodlightConfigurationId پیکربندی Floodlight را مشخص کنید.
3. درصورت تمایل، از پارامتر searchString برای فیلتر کردن براساس نام فعالیت استفاده کنید.
4. شناسه فعالیت Floodlight را از فیلد id FloodlightActivity انتخاب‌شده در پاسخ دریافت کنید.

تعیین کردن اینکه اطلاعات کاربری به کجا دسترسی دارند

اعتبارنامه‌هایی که برای صدور مجوز درخواست Data Manager API استفاده می‌کنید با «حساب Google» خاصی مرتبط است.

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

در اینجا نحوه تأیید اینکه «حساب Google» برای اطلاعات اعتباری شما به حساب Google Ads،‏ Display & Video 360،‏ Google Analytics، یا Campaign Manager 360 دسترسی دارد آورده شده است.

Google Ads یا شریک داده

1. به دسترسی و امنیت در واسط کاربری Google Ads برای login_account بروید.
2. برگه کاربران را انتخاب کنید.
3. اگر login_account حساب مدیر Google Ads است، کلید نمایش کاربران در سلسله‌مراتب کامل را خاموش کنید تا کاربران حساب‌های فرعی پنهان شوند.
4. بررسی کنید که «حساب Google» مربوط به اطلاعات کاربری‌تان در فهرست حساب‌های نشان‌داده‌شده در برگه کاربران باشد.

Display & Video 360

1. به مدیریت کاربر و اولویت‌های ایمیل در میانای کاربری Display & Video 360 بروید.
2. تأیید کنید که مدیریت کاربر نشان می‌دهد «حساب Google» برای اعتبارنامه‌های شما کاربری در login_account است.

Google Analytics

1. به مدیریت دسترسی به دارایی در میانای کاربری Google Analytics بروید.
2. مطمئن شوید دارایی Google Analytics مشخص‌شده در login_account انتخاب شده باشد.
3. تأیید کنید که «حساب Google» مربوط به اطلاعات کاربری شما نقش «ویرایشگر» یا «سرپرست» را در دارایی دارد.

Floodlight (Campaign Manager 360)

1. وارد سیستم واسط کاربر Campaign Manager 360 شوید.
2. در منوِ سمت راست، به سرپرست > نمایه‌های کاربر بروید.
3. بررسی کنید که «حساب Google» مربوط به اطلاعات اعتباری‌تان در فهرست نمایه‌های نشان‌داده‌شده باشد.
4. روی نمایه کلیک کنید و درستی‌سنجی کنید که به حساب تبلیغ‌کننده استفاده‌شده به‌عنوان login_account دسترسی دارد. اگر login_account را در درخواست تنظیم نکنید، به‌طور پیش‌فرض روی operating_account تنظیم می‌شود. مطمئن شوید حساب نقش کاربری با اجازه درج تبدیل‌های آفلاین داشته باشد.