メインコンテンツへスキップ
GET
Ayrshare で作成したキャンペーン、広告グループ、または広告について、Google Ads のパフォーマンスを1日1行でリアルタイムに取得します。
  • 数値は夜間に作成されたコピーではなく、呼び出し時に Google から読み取られます。
  • すべての金額は広告アカウントの通貨で表され、各行の currency で返されます。
  • Google はアクティビティのない日を省略するため、期間の日数より少ない行が返されることがあります。
  • Google は、日が終わってから数日間はその日の費用とコンバージョンを調整するため、直近の日の数値は読み取るたびに変わることがあります。
  • Performance Max キャンペーンの場合は、キャンペーン ID とともに level=campaign を使用してください。Performance Max キャンペーンには独自の広告がないため、level=ad では行が返されません。

ヘッダーパラメータ

クエリパラメータ

string
必須
各行のレポート対象: campaign(作成時の campaignId)、adSet(作成時の adGroupId)、または ad(作成時の adId)。
string
必須
カンマ区切りのキャンペーン ID、広告グループ ID、または広告 ID(最大50件)。すべて1つの広告アカウント内にある必要があります。
string
10桁の Google Ads お客様 ID。ハイフンの有無は問いません(123-456-7890)。広告と広告グループのレポートは、ここで指定した広告アカウントを読み取ります。指定しない場合、広告レポートは Google Ads の連携でアクセスできるすべての広告アカウント(最大25件)を検索し、広告グループレポートは連携でアクセスできる広告アカウントが1つの場合にのみ機能します。連携でアクセスできる広告アカウントが25件を超える場合、または広告グループレポートで2件以上ある場合は、アカウントを指定してください。指定しないと code: 101 が返されます。
string
返す指標をカンマ区切りで指定します。省略するとすべての指標が返されます。指標を参照してください。
string
デフォルト:"30日前"
開始日(YYYY-MM-DD形式)。Google は日次の数値を37か月間保持します。それより前の startDate を指定すると code: 101 が返されます。
string
デフォルト:"今日"
終了日(YYYY-MM-DD形式)。

指標

actions と conversionValue は、Google Ads アカウントでコンバージョン トラッキングを設定するまで 0 のままです。Google は検索のユニークリーチを報告しないため reach は利用できず、Google では breakdowns も利用できません。どちらかをリクエストすると code: 101 が返されます。

ページング

すべての行が1つのレスポンスで返されるため、nextCursor は常に null です。

エラー