نقشه برداری های میدانی

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

فیلدهای درخواست

UploadClickConversionRequest (API تبلیغات گوگل) IngestEventsRequest (رابط برنامه‌نویسی کاربردی مدیریت داده) یادداشت‌ها
  • customer_id
  • هدر درخواست developer-token
  • هدر درخواست login-customer_id
  • هدر درخواست linked-customer-id
  • conversion_action
 destinations به فیلدهای مشتری و عملیات تبدیل مراجعه کنید.
معادلی وجود ندارد consent تنظیمات رضایت پیش‌فرض اختیاری برای رویدادهای موجود در درخواست. می‌توانید با تنظیم فیلد consent Event ، این مقدار را برای یک رویداد خاص لغو کنید.
معادلی وجود ندارد encoding الزامی: روی Encoding مورد استفاده برای مقادیر UserIdentifier تنظیم شود.
معادلی وجود ندارد encryption_info تنظیم کنید که آیا درخواست حاوی مقادیر رمزگذاری شده است یا خیر. برای جزئیات بیشتر به بخش رمزگذاری مراجعه کنید.
job_id معادلی وجود ندارد برای بازیابی تشخیص، از request_id برگردانده شده در پاسخ استفاده کنید.
partial_failure معادلی وجود ندارد رابط برنامه‌نویسی کاربردی مدیریت داده (Data Manager API) از خطای جزئی پشتیبانی نمی‌کند. اگر اعتبارسنجی هر فیلد از IngestEventsRequest با شکست مواجه شود، رابط برنامه‌نویسی کاربردی مدیریت داده (Data Manager API) کل درخواست را رد می‌کند.
validate_only validate_only
conversions events فهرست تبدیل‌ها یا رویدادها. برای جزئیات بیشتر به بخش فیلدهای تبدیل مراجعه کنید.

فیلدهای مشتری و عملیات تبدیل

API گوگل ادز به هدر درخواست developer-token نیاز دارد و شما هدرهای درخواست login-customer-id و linked-customer-id را برای سناریوهای مختلف احراز هویت تنظیم می‌کنید.

رابط برنامه‌نویسی کاربردی مدیریت داده (Data Manager API) به توکن توسعه‌دهنده نیاز ندارد و شما می‌توانید اطلاعات ورود و اطلاعات مشتری مرتبط را با استفاده از فیلدهای یک Destination به جای هدرهای درخواست، مشخص کنید. برای اطلاعات بیشتر در مورد مقصدها ، به Configure destinations مراجعه کنید.

در اینجا نحوه نگاشت فیلدهای API گوگل ادز برای یک conversion_action واحد به فیلدهای معادل در یک Destination آورده شده است:

رابط برنامه‌نویسی کاربردی گوگل ادز Destination (رابط برنامه‌نویسی کاربردی مدیریت داده) یادداشت‌ها
customer_id درخواست operating_account مقدار account_id برابر با شناسه مشتری حساب تبدیل گوگل ادز قرار دهید. account_type مربوط به operating_account را برابر با GOOGLE_ADS قرار دهید.

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

هدر درخواست developer-token معادلی وجود ندارد برای رابط برنامه‌نویسی کاربردی (API) مدیریت داده، نیازی به توکن توسعه‌دهنده نیست.
هدر درخواست login-customer-id login_account مقدار account_id روی شناسه مشتری حساب کاربری ورود به سیستم تنظیم کنید. اگر حساب کاربری ورود به سیستم یک حساب Google Ads است، account_type روی GOOGLE_ADS یا اگر حساب کاربری ورود به سیستم یک حساب همکاری داده است، DATA_PARTNER تنظیم کنید.
هدر درخواست linked-customer-id linked_account account_id برابر با شناسه مشتری حساب لینک‌شده قرار دهید. account_type برابر با DATA_PARTNER قرار دهید.
conversion_action یک ClickConversion product_destination_id روی شناسه عددی عمل تبدیل تنظیم کنید. از نام منبع ConversionAction استفاده نکنید.
معادلی وجود ندارد reference یک شناسه تعریف‌شده توسط کاربر برای Destination . اگر می‌خواهید تبدیل‌ها را برای چندین اقدام تبدیل در یک درخواست واحد ارسال کنید ، این فیلد را تنظیم کنید.

فیلدهای تبدیل

ClickConversion (API تبلیغات گوگل) Event (رابط برنامه‌نویسی کاربردی مدیریت داده) یادداشت‌ها
cart_data cart_data برای جزئیات بیشتر به فیلدهای داده‌های سبد خرید مراجعه کنید.
consent consent هر دو API از یک شیء Consent مشابه ( ad_user_data ، ad_personalization ) استفاده می‌کنند.
برای رابط برنامه‌نویسی کاربردی مدیریت داده (Data Manager API)، می‌توانید با تنظیم فیلد consent در سطح درخواست، برای همه رویدادها در یک درخواست، رضایت تعیین کنید.
conversion_action destination_references اگر تبدیل‌ها را برای چندین اقدام تبدیل در یک درخواست واحد ارسال می‌کنید ، این فیلد را روی reference مربوطه در مقصد تنظیم کنید.
conversion_date_time event_timestamp
  • اگر از فرمت JSON استفاده می‌کنید، مقداری با فرمت RFC 3339 تنظیم کنید که کمی با فرمت تاریخ و زمان API تبلیغات گوگل متفاوت باشد.
  • اگر از بافرهای پروتکل استفاده می‌کنید، از یک Timestamp استفاده کنید و فیلدهای seconds و (اختیاری) nanoseconds را تنظیم کنید.

برای جزئیات بیشتر به قالب مهر زمانی مراجعه کنید.
conversion_environment معادلی وجود ندارد
conversion_value conversion_value روی مقدار ارز تنظیم کنید، نه مقدار بر حسب میکرو. برای مثال، برای مقدار تبدیل ۵.۲۳ دلار، از مقدار 5.23 استفاده کنید.
currency_code currency
custom_variables custom_variables برای جزئیات بیشتر به فیلدهای متغیر سفارشی مراجعه کنید.
customer_type
معادلی وجود ندارد event_source
معادلی وجود ندارد event_device_info
external_attribution_data معادلی وجود ندارد
gbraid ad_identifiers.gbraid
gclid ad_identifiers.gclid
معادلی وجود ندارد last_updated_timestamp
order_id transaction_id
session_attributes_encoded ad_identifiers.session_attributes برای جزئیات بیشتر به افزودن ویژگی‌های جلسه مراجعه کنید.
session_attributes_key_value_pairs experimental_fields برای جزئیات بیشتر به افزودن ویژگی‌های جلسه مراجعه کنید.
user_identifiers user_data.user_identifiers برای جزئیات بیشتر به فیلدهای شناسه کاربر مراجعه کنید.
user_ip_address landing_page_device_info.ip_address
wbraid ad_identifiers.wbraid

فیلدهای داده سبد خرید

CartData (رابط برنامه‌نویسی کاربردی تبلیغات گوگل) CartData (رابط برنامه‌نویسی کاربردی مدیریت داده) یادداشت‌ها
feed_country_code merchant_feed_label روی برچسب فید تنظیم کنید.
feed_language_code merchant_feed_language_code
items items
local_transaction_cost transaction_discount
merchant_id merchant_id

فیلدهای کالا برای داده‌های سبد خرید

Item (API تبلیغات گوگل) Item (API مدیریت داده) یادداشت‌ها
product_id merchant_product_id
quantity quantity
unit_price unit_price
معادلی وجود ندارد item_id
معادلی وجود ندارد additional_item_parameters

فیلدهای متغیر سفارشی

CustomVariable (API تبلیغات گوگل) CustomVariable (رابط برنامه‌نویسی کاربردی مدیریت داده) یادداشت‌ها
معادلی وجود ندارد destination_references API گوگل ادز برای هر اقدام تبدیل، درخواست‌های جداگانه‌ای را می‌طلبد. API مدیریت داده از ارسال تبدیل‌ها برای چندین اقدام تبدیل در یک درخواست واحد و همچنین استفاده از این فیلد destination_references برای نشان دادن اینکه کدام مقصدها باید یک متغیر سفارشی خاص را دریافت کنند، پشتیبانی می‌کند.
conversion_custom_variable variable به جای نام منبع، نام متغیر را تنظیم کنید.
value value

فیلدهای شناسه کاربر

UserIdentifier (API تبلیغات گوگل) UserIdentifier (رابط برنامه‌نویسی کاربردی مدیریت داده)
address_info address دستورالعمل‌های قالب‌بندی و هش کردن را دنبال کنید. همچنین می‌توانید ویژگی‌های هش شده یک آدرس را رمزگذاری کنید .
hashed_email email_address روی آدرس ایمیل قالب‌بندی و هش‌شده تنظیم کنید. همچنین می‌توانید آدرس ایمیل هش‌شده را رمزگذاری کنید .
hashed_phone_number phone_number روی شماره تلفن فرمت شده و هش شده تنظیم کنید. همچنین می‌توانید شماره تلفن هش شده را رمزگذاری کنید .
سایر زمینه‌ها:
  • mobile_id
  • third_party_user_id
  • user_identifier_source
 مربوط نیست هیچ‌کدام از APIها از این شناسه‌ها برای تبدیل‌های آفلاین یا تبدیل‌های پیشرفته برای سرنخ‌ها پشتیبانی نمی‌کنند و API مدیریت داده هنگام ارسال رویدادهای تبدیل به عنوان یک منبع داده اضافی، از این شناسه‌ها پشتیبانی نمی‌کند.

فیلدهای پاسخ

UploadClickConversionResponse (API تبلیغات گوگل) IngestEventsResponse (رابط برنامه‌نویسی کاربردی مدیریت داده) یادداشت‌ها
job_id معادلی وجود ندارد برای بازیابی تشخیص، از request_id برگردانده شده در پاسخ استفاده کنید.
partial_failure_error معادلی وجود ندارد رابط برنامه‌نویسی کاربردی مدیریت داده (Data Manager API) از خطای جزئی پشتیبانی نمی‌کند. اگر اعتبارسنجی هر فیلد از IngestEventsRequest با شکست مواجه شود، رابط برنامه‌نویسی کاربردی مدیریت داده (Data Manager API) کل درخواست را رد می‌کند.
هدر پاسخ request-id request_id شناسه درخواست به جای هدر پاسخ، به عنوان یک فیلد پاسخ در رابط برنامه‌نویسی کاربردی مدیریت داده (Data Manager API) بازگردانده می‌شود.
results معادلی وجود ندارد رابط برنامه‌نویسی کاربردی مدیریت داده (Data Manager API) رویدادها را به صورت ناهمگام پردازش می‌کند. نتایج پردازش را با استفاده از ابزار تشخیص عیب (diagnostics) بررسی کنید.
قبلی
مراحل ارتقاء، مراحل ارتقاء