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

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

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

  • استفاده از یک Destination در درخواست‌های مصرف (ingestion request) . یک درخواست مصرف از IngestionService برای اضافه یا حذف کردن اعضا در یک مخاطب یا ارسال رویدادها استفاده می‌کند. لیست destinations در IngestAudienceMembersRequest یا IngestEventsRequest را تعریف می‌کند:

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

    شما می‌توانید چندین مقصد را در یک درخواست مصرف (ingestion request) بگنجانید.

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

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

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

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

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

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

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

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

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

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

تبلیغات گوگل

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

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

حساب مدیر M1

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

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

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

حساب مدیر M2

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

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

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

حساب مشتری C1

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

  1. حساب مدیر M1
  2. حساب مدیر 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 شناسه مخاطب یا اقدام تبدیل.
مدیریت منابع
درخواست سربرگ‌ها
login-account accountTypes/GOOGLE_ADS/accounts/ GOOGLE_ADS_CUSTOMER_ID
linked-account هدر linked-account را تنظیم نکنید.

در اینجا مثالی از سناریوی دسترسی مستقیم، با استفاده از حساب‌های موجود در نمودار و اعتبارنامه‌های حساب گوگل 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 شناسه مشتری حساب کاربری گوگل ادز
account_type GOOGLE_ADS
login_account
account_id شناسه مشتری حساب مدیر تبلیغات گوگل
account_type GOOGLE_ADS
linked_account فیلد linked_account را تنظیم نکنید.
product_destination_id شناسه مخاطب یا اقدام تبدیل.
مدیریت منابع
درخواست سربرگ‌ها
login-account accountTypes/GOOGLE_ADS/accounts/ MANAGER_CUSTOMER_ID
linked-account هدر linked-account را تنظیم نکنید.

در اینجا مثالی از سناریوی دسترسی مدیر برای حساب کاربری گوگل ادز 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"
    }
  ]
}
مدیریت منابع
درخواست سربرگ‌ها
login-account accountTypes/GOOGLE_ADS/accounts/ M2_CUSTOMER_ID
linked-account هدر linked-account را تنظیم نکنید.

در اینجا مثال دیگری از سناریوی دسترسی مدیر برای حساب کاربری گوگل ادز 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"
    }
  ]
}
مدیریت منابع
درخواست سربرگ‌ها
login-account accountTypes/GOOGLE_ADS/accounts/ M1_CUSTOMER_ID
linked-account هدر linked-account را تنظیم نکنید.

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

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

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

بلع
مقصد
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 والد تبلیغ‌کننده قرار دارد:

بلع
مقصد
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 آورده شده است. در این سناریو، اعتبارنامه‌ها باید برای یک حساب گوگل باشد که کاربر در حساب شریک 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 را تنظیم نکنید.

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

توجه: اگر operating_account یک حساب Google Analytics است، یا login_account تنظیم نکنید یا آن را روی مقادیر مشابه operating_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 شناسه اندازه‌گیری جریان داده.
مدیریت منابع
درخواست سربرگ‌ها
login-account accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/ PROPERTY_ID
linked-account هدر linked-account را تنظیم نکنید.

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

بلع 
{
  "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 را تنظیم نکنید.

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

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

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

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

تبلیغات گوگل

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

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

شریک داده D1

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

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

شریک داده D2

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

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

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

اگر می‌خواهید داده‌ها را به یک حساب 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 شناسه مخاطب یا اقدام تبدیل.
مدیریت منابع
درخواست سربرگ‌ها
login-account accountTypes/DATA_PARTNER/accounts/ DATA_PARTNER_ID
linked-account هدر linked-account را تنظیم نکنید.

در اینجا مثالی از سناریوی پیوند مستقیم محصول با استفاده از حساب‌های موجود در نمودار و هدرهای درخواست مربوطه برای درخواست‌های مدیریت منابع آورده شده است. در این سناریو، شریک داده 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"
    }
  ]
}
مدیریت منابع
درخواست سربرگ‌ها
login-account accountTypes/DATA_PARTNER/accounts/ D2_CUSTOMER_ID
linked-account هدر linked-account را تنظیم نکنید.

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

اگر می‌خواهید داده‌ها را به یک حساب 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 شناسه مخاطب یا اقدام تبدیل.
مدیریت منابع
درخواست سربرگ‌ها
login-account accountTypes/DATA_PARTNER/accounts/ DATA_PARTNER_ID
linked-account accountTypes/GOOGLE_ADS/accounts/ MANAGER_CUSTOMER_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"
    }
  ]
}
مدیریت منابع
درخواست سربرگ‌ها
login-account accountTypes/DATA_PARTNER/accounts/ D1_CUSTOMER_ID
linked-account accountTypes/GOOGLE_ADS/accounts/ M2_CUSTOMER_ID

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

به عنوان یک شریک داده، می‌توانید با استفاده از دو رویکرد، داده‌ها را به یک حساب 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 for a direct product link برای ارسال داده به یک تبلیغ‌کننده 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 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"
    }
  ]
}
مدیریت منابع
درخواست سربرگ‌ها
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

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

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

الزامات دقیق

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

فیلدهای حساب

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

operating_account

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

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

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

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

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

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

  1. حساب گوگلِ مربوط به اعتبارنامه‌ها، یک کاربر در حساب ورود به سیستم است.

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

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

    • یک حساب کاربری مدیر تبلیغات گوگل یا شریک 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 باشد.

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

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

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

رابط کاربری تبلیغات گوگل

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

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

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

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

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

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

  1. در رابط کاربری گوگل ادز به بخش تبدیل‌ها (Conversions) بروید.
  2. برای مشاهده جزئیات، روی نام عمل تبدیل کلیک کنید.

  3. شناسه‌ی عمل تبدیل، مقداری برای پارامتر کوئری URL به نام ctId است. 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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