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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

مسیر دسترسی آگهی‌دهنده

Google Ads

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

حساب‌ها و کاربران Google Ads

حساب مدیر M1

‫M1 دو حساب کودک مستقیم دارد:

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

«حساب Google» cloudysanfrancisco@gmail.com کاربری در M1 است.

حساب مدیر M2

‫M2 دو حساب کودک مستقیم دارد:

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

«حساب Google» baklavainthebalkans@gmail.com کاربری در M2 است.

حساب مشتری C1

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

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

«حساب Google» jeffersonloveshiking@gmail.com کاربری در 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» jeffersonloveshiking@gmail.com آورده شده است:

انتقال داده
{
  "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» baklavainthebalkans@gmail.com آورده شده است:

انتقال داده
{
  "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» cloudysanfrancisco@gmail.com، که کاربری در حساب مدیر 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
مدیریت منابع
سرایندهای درخواست
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
account_id شناسه پیکربندی Floodlight
اگر تبلیغ‌کننده شما فرزند تبلیغ‌کننده والد باشد، از شناسه تبلیغ‌کننده والد در «مدیر پویش ۳۶۰» به‌عنوان شناسه پیکربندی Floodlight استفاده کنید. درغیراین‌صورت، از شناسه تبلیغ‌کننده خود استفاده کنید. ببینید چگونه شناسه تبلیغ‌کننده را در «واسط کاربر Campaign Manager 360» پیدا کنید.
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 برای سناریوهای رایج شریک داده‌ای که داده‌ها را به حساب‌های تبلیغ‌کننده‌ای با پیوند شریک ایجادشده به حساب شریک داده ارسال می‌کند آمده است.

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

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

Google Ads

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

حساب‌ها و کاربران Google Ads و شریک داده

شریک داده D1

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

«حساب Google» 222larabrown@gmail.com کاربری در D1 است.

شریک داده D2

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

«حساب Google» jeffersonloveshiking@gmail.com کاربری در 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» 222larabrown@gmail.com برای ارسال داده به حساب مدیر M2، حساب مشتری C1، یا حساب مشتری C2 استفاده کنید، و از مقصدی با login_account تنظیم‌شده روی حساب شریک داده D1 و linked_account تنظیم‌شده روی حساب مدیر M2 استفاده کنید.

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

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

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

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

تفاوت اصلی بین شرکای داده D1 و 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 و مشتری Google Ads یعنی C1 و اطلاعات اعتباری «حساب Google» jeffersonloveshiking@gmail.com به مشتری 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» 222larabrown@gmail.com به مشتری 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 برای سناریو پیوند شریک مستقیم برای ارسال داده به تبلیغ‌کننده «شبکه تبلیغات» و «ویدیو ۳۶۰» و سرایندهای درخواست مربوطه برای درخواست‌های مدیریت منبع آورده شده است:

انتقال داده
{
  "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 برای سناریو پیوند شریک مستقیم برای ارسال داده به شریک «شبکه تبلیغات» و «ویدیو ۳۶۰» و سرایندهای درخواست مربوطه برای درخواست‌های مدیریت منبع آورده شده است:

انتقال داده
{
  "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 Ad Manager ارسال کنید و بین حساب شریک داده و حساب Google Ad Manager پیوند شریک دارید:

انتقال داده
مقصد
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

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

الزامات دقیق

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

فیلدهای حساب

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

operating_account

‫operating_account الزامی است.

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

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

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

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

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

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

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

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

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

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

‫linked_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»:

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

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

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

رویداد Google Ads

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

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

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

برای دریافت شناسه کنش تبدیل از 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»:

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

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

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

رویداد Google Analytics

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

جریان داده‌های وب
از شناسه اندازه‌گیری جاری‌سازی داده استفاده کنید.
جریان داده‌های برنامه

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

رویداد Floodlight

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

واسط کاربر 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 (مدیر پویش ۳۶۰)

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