ایجاد یا حذف پیوند شریک

نحوه ایجاد یا حذف منبع PartnerLink در زیر آمده است. ‫Data Manager API از ایجاد پیوندهای شریک برای انواع حساب‌های زیر پشتیبانی می‌کند:

• حساب‌های Google Ads
• حساب‌های شریک Display & Video 360 یا تبلیغ‌کننده Display & Video 360
• حساب‌های Google Ad Manager

ایجاد پیوند

با ارسال CreatePartnerLinkRequest، PartnerLink ایجاد کنید.

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

منبع PartnerLink ایجاد کنید. فیلدهای تنظیم در اینجا آمده است.

owning_account

حساب تبلیغ‌کننده‌ای را که مالک پیوند است شناسایی می‌کند. روی شیء ProductAccount تنظیم شده است.

account_type را روی AccountType حساب آگهی‌دهنده تنظیم کنید.

account_id را روی شناسه حساب آگهی‌دهنده تنظیم کنید.

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

partner_account

حساب شریک را شناسایی می‌کند. روی شیء ProductAccount تنظیم شده است.

account_type را روی AccountType حساب شریک تنظیم کنید. برای مثال، اگر پیوند از حساب آگهی‌دهنده به حساب شریک داده است، این فیلد را روی DATA_PARTNER تنظیم کنید.

account_id را روی شناسه حساب شریک تنظیم کنید.

ساختن درخواست

برای ایجاد پیوند شریک، CreatePartnerLinkRequest بسازید.

1. parent را روی نام منبع حساب آگهی‌دهنده تنظیم کنید. از این قالب استفاده کنید:

   accountTypes/{account_type}/accounts/{account}
   

2. partner_link را روی منبع PartnerLink که ساخته‌اید تنظیم کنید.

3. اگر اطلاعات اعتباری شما برای «حساب Google» با دسترسی به حساب اصلی حساب تبلیغ‌کننده است، مانند حساب مدیر Google Ads یا حساب شریک Display & Video 360، سرصفحه login-account را همان‌طور که در پیکربندی مقصدها و سرصفحه‌ها شرح داده شده است تنظیم کنید.

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

Google Ads

باز کردن در API Explorer

{
    "owningAccount": {
        "accountType": "GOOGLE_ADS",
        "accountId": "INSERT_GOOGLE_ADS_CUSTOMER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

آگهی‌دهنده DV360

باز کردن در API Explorer

{
    "owningAccount": {
        "accountType": "DISPLAY_VIDEO_ADVERTISER",
        "accountId": "INSERT_DISPLAY_VIDEO_ADVERTISER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

شریک DV360

باز کردن در API Explorer

{
    "owningAccount": {
        "accountType": "DISPLAY_VIDEO_PARTNER",
        "accountId": "INSERT_DISPLAY_VIDEO_PARTNER_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

Google Ad Manager

باز کردن در API Explorer

{
    "owningAccount": {
        "accountType": "GOOGLE_AD_MANAGER_AUDIENCE_LINK",
        "accountId": "INSERT_GAM_AUDIENCE_LINK_ID"
    },
    "partnerAccount": {
        "accountType": "DATA_PARTNER",
        "accountId": "INSERT_DATA_PARTNER_ACCOUNT_ID"
    }
}

ارسال درخواست

درخواست را ارسال کنید و درصورت لزوم، سرایندهای درخواست را اضافه کنید. از اطلاعات کاربری «حساب Google» با دسترسی به owning_account استفاده کنید.

اگر درخواست موفقیت‌آمیز باشد، پاسخ حاوی PartnerLink ایجادشده با id و name تکمیل‌شده است.

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

حذف پیوند

برای حذف PartnerLink، DeletePartnerLinkRequest را با name تنظیم‌شده روی نام منبع ارسال کنید. درصورت نیاز، سرصفحه‌ها را تنظیم کنید.