راهنمای توسعه دهنده مخاطبان بازاریابی مجدد

این سند نحوه استفاده از مدیریت API برای مدیریت مخاطبان بازاریابی مجدد Google Analytics را شرح می دهد.

توجه: هنگام استفاده از این API، باید از خط‌مشی ویژگی‌های تبلیغاتی Google Analytics ، از جمله قوانین مربوط به دسته‌های حساس، پیروی کنید.

معرفی

مدیریت API به شما این امکان را می دهد که مخاطبان بازاریابی مجدد را برای یک ویژگی Google Analytics create ، get ، delete ، list کنید، update و patch . برای کسب اطلاعات بیشتر در مورد نحوه عملکرد مخاطبان بازاریابی مجدد، به مقاله درباره مخاطبان بازاریابی مجدد در مرکز راهنمایی Analytics مراجعه کنید.

موارد استفاده کنید

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

• مخاطبان بازاریابی مجدد را فهرست کنید .
• یک مخاطب بازاریابی مجدد جدید ایجاد کنید .
• یک مخاطب بازاریابی مجدد موجود را به روز کنید .

توجه: اگر تگ خود را برای جمع آوری داده های مناسب فعال نکنید، مخاطبان بازاریابی مجدد شما خالی خواهند ماند و کمپین های بازاریابی مجدد شما ممکن است اجرا نشوند. با فعال کردن ویژگی‌های تبلیغاتی در تنظیمات ویژگی Google Analytics خود شروع کنید.

مخاطبان بازاریابی مجدد را فهرست کنید

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

1. از مدیریت API یا Account Explorer برای بازیابی accountId و webPropertyId استفاده کنید.
2. روش list منبع مخاطبان بازاریابی مجدد را اجرا کنید.

برای جزئیات روش list برای بازاریابی مجدد منابع مخاطب، به مرجع API مراجعه کنید.

یک مخاطب بازاریابی مجدد جدید ایجاد کنید

برای ایجاد یک مخاطب بازاریابی مجدد جدید برای یک ملک:

1. از مدیریت API یا Account Explorer برای بازیابی accountId و webPropertyId استفاده کنید.
2. از مدیریت API یا Account Explorer برای بازیابی شناسه view (نمایه) برای ویژگی linkedViews [] استفاده کنید.
3. از مجموعه پیوندهای Google Ads برای بازیابی شناسه حساب Google Ads برای linkedAdAccounts.linkedAccountId استفاده کنید.
   • ویژگی linkedAdAccounts[] در حال حاضر تنها به یک linkedForeignAccount محدود شده است.
   • linkedAdAccounts[].type را می توان روی ADWORDS_LINKS ، DBM_LINKS ، MCC_LINKS یا OPTIMIZE تنظیم کرد.
4. از مجموعه Segments برای گزینه‌هایی برای تنظیم ویژگی segment از includeConditions استفاده کنید، و در صورت ایجاد یک مخاطب مبتنی بر حالت، همین کار را برای excludeConditions انجام دهید. همچنین به مرجع بخش ها برای تعریف یک بخش مراجعه کنید.
   • includeConditions به صورت اختیاری می تواند مقادیر membershipDurationDays و daysToLookBack را داشته باشد
   • excludeConditions.exclusionDuration به صورت اختیاری می تواند روی PERMANENT تنظیم شود.
5. روش insert منبع مخاطبان بازاریابی مجدد را اجرا کنید.

API به شما امکان می دهد دو نوع مخاطب ایجاد کنید: SIMPLE و STATE_BASED . برای مخاطبان SIMPLE فقط باید audienceDefinition با یک segment مثبت، بدون عملگر NOT (کاراکتر ! ) بسازید. اگر بخواهید یک شرط exclude را اضافه کنید، باید یک statebasedDefinition تعریف کنید. برای کسب اطلاعات بیشتر به مخاطبین مبتنی بر ایالت مراجعه کنید. برای جزئیات به مثال مرجع مراجعه کنید.

توجه: می‌توانید یک audienceDefinition یا یک stateBasedAudienceDefinition تعریف کنید و audienceType را روی مقدار مربوطه تنظیم کنید. همچنین محدودیت 2000 مخاطب بازاریابی مجدد وجود دارد. هنگام ایجاد خودکار مخاطبان بازاریابی مجدد، احتیاط کنید.

مخاطبان بازاریابی مجدد موجود را به روز کنید

برای به‌روزرسانی مخاطبان بازاریابی مجدد موجود برای یک ملک:

1. اگر از قبل شناسه مخاطب بازاریابی مجدد دارید، می‌توانید با get تماس بگیرید، در غیر این صورت می‌توانید با list تماس بگیرید و مخاطبی را که می‌خواهید به‌روزرسانی کنید انتخاب کنید.
2. هر یک از فیلدهای قابل نوشتن را به روز کنید و update در شی به روز شده مخاطب فراخوانی کنید.

توجه: پس از ایجاد مخاطب، نمی‌توانید audienceType آن را تغییر دهید. به عبارت دیگر، اگر مخاطبی مقداری برای audienceDefinition داشته باشد، نمی‌توانید update را با مقدار stateBasedAudienceDefinition فراخوانی کنید. برای کسب اطلاعات بیشتر به مخاطبین مبتنی بر ایالت مراجعه کنید. برای جزئیات به مثال مرجع مراجعه کنید.